-
Notifications
You must be signed in to change notification settings - Fork 331
feat(dev-hub): hip-3 price pusher technical spec #3441
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,99 @@ | ||
| --- | ||
| title: HIP-3 as a Service | ||
| description: Complete oracle solution for Hyperliquid HIP-3 perpetual market deployers | ||
| slug: /price-feeds/core/hip-3-service | ||
| --- | ||
|
|
||
| import { Callout } from "fumadocs-ui/components/callout"; | ||
| import Link from "next/link"; | ||
| import { IntegrationCard } from "../../../../src/components/IntegrationCard"; | ||
| import { | ||
| Lightning, | ||
| FileText, | ||
| Shield, | ||
| RocketLaunch, | ||
| } from "@phosphor-icons/react/dist/ssr"; | ||
|
|
||
| Pyth Network provides **HIP-3 as a Service**, a complete end-to-end solution for deployers launching permissionless perpetual markets on Hyperliquid. This service combines institutional-grade data, managed infrastructure, capital support, and market operations to help you successfully deploy and maintain HIP-3 markets. | ||
|
|
||
| <Callout type="info"> | ||
| New to HIP-3? Learn about Hyperliquid's permissionless perpetual markets in | ||
| the [official Hyperliquid | ||
| documentation](https://hyperliquid.gitbook.io/hyperliquid-docs/hyperliquid-improvement-proposals-hips/hip-3-builder-deployed-perpetuals). | ||
| </Callout> | ||
|
|
||
| {/* prettier-ignore */} | ||
| <Callout type="info" title="Technical Specification"> | ||
| For full technical details on the HIP-3 pusher including price sources, feed | ||
| composition, security model, and limitations, see the{" "} | ||
| <Link href="/price-feeds/pro/hip-3-service/technical-specification" target="_blank" rel="noopener noreferrer">Technical Specification</Link>{" "} | ||
| page. | ||
| </Callout> | ||
|
Comment on lines
+26
to
+31
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. added this link if anyone wants to check out the technical spec from Pyth Core. To have a good devEx, the link will get opened in a new tab by default.
|
||
|
|
||
| ## What You Get | ||
|
|
||
| HIP-3 as a Service provides everything you need to launch and maintain a successful perpetual market on Hyperliquid: | ||
|
|
||
| <Cards> | ||
| <Card icon={<Lightning size={18} />} title="Oracle Data & Infrastructure"> | ||
| First-party data with automated updates and 24/7 monitoring | ||
| </Card> | ||
| <Card icon={<FileText size={18} />} title="Capital & Liquidity Support"> | ||
| Market maker relationships, loan capital, and HYPE sourcing | ||
| </Card> | ||
| <Card icon={<Shield size={18} />} title="Security & Go-to-Market"> | ||
| Audit discounts, 24/7 support, and co-marketing | ||
| </Card> | ||
| </Cards> | ||
|
|
||
| ## What problem this solves | ||
|
|
||
| Deploying and operating a HIP-3 market typically requires all of the following: | ||
|
|
||
| - Maintaining continuous **oracle updates every 3 seconds** to meet HIP-3 requirements | ||
| - Securing **keys and operational processes** to reduce downtime and update failures | ||
| - Coordinating **market-maker liquidity** and launch operations | ||
|
|
||
| ## How It Works | ||
|
|
||
| The HIP-3 pusher service monitors price changes and submits signed updates to the Hyperliquid blockchain whenever specific conditions are met (e.g., price deviation or time-based heartbeat). | ||
|
|
||
| 1. **Data Sourcing**: The pusher is fully configurable and can connect to any data source that exposes price data via REST API or WebSocket. You can use [Pyth Core](/price-feeds/core), [Pyth Pro](/price-feeds/pro), [SEDA](https://www.seda.xyz/) or [Hyperliquid](https://hyperliquid.xyz/), or plug in your own custom data feeds. | ||
| 2. **Robustness & Redundancy**: The service supports fallback configurations to ensure reliability. If the primary data source is unavailable, the next source in the priority chain is used. | ||
| 3. **Submission**: Signed transactions are sent to the Hyperliquid validator network to update the market's oracle state. | ||
|
|
||
| ## Why Pyth | ||
|
|
||
| Pyth Network offers unique advantages that make it the ideal oracle partner for your HIP-3 market: | ||
|
|
||
| ### First-Party Data | ||
|
|
||
| Pyth sources data directly from 120+ institutional publishers including exchanges, market makers, and trading firms. This eliminates single points of failure that affect aggregated data providers. | ||
|
|
||
| ### Market Maker Trust | ||
|
|
||
| Pyth's market maker publishers (Jump, Flowdesk, IMC, Amber, Selini) trust Pyth data because they create it themselves. This leads to: | ||
|
|
||
| - Higher engagement rates for Pyth-powered markets | ||
| - Faster liquidity onboarding | ||
|
|
||
| ### Redundant Infrastructure | ||
|
|
||
| - Primary, secondary, and tertiary infrastructure across multiple regions | ||
| - Multi-cloud key management with automatic failover | ||
| - Support for multisig oracle updates for operational flexibility | ||
|
|
||
| ## Get Started | ||
|
|
||
| Ready to launch your HIP-3 market? Get in touch with our team to discuss your requirements and get started. | ||
|
|
||
| <div className="mt-6"> | ||
| <IntegrationCard | ||
| href="https://2fga8d.share-eu1.hsforms.com/2ftdPrASCTLCxtP5YMzAq_Q" | ||
| colorScheme="yellow" | ||
| title="Request Access" | ||
| description="Fill out our contact form to get started with HIP-3 as a Service." | ||
| icon={<RocketLaunch size={16} />} | ||
| external | ||
| /> | ||
| </div> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,7 @@ | ||
| { | ||
| "title": "HIP-3 as a Service", | ||
| "description": "Complete oracle solution for Hyperliquid HIP-3 perpetual market deployers", | ||
| "pages": ["index"] | ||
| "pages": [ | ||
| "[Technical Specification](/price-feeds/pro/hip-3-service/technical-specification)" | ||
| ] | ||
| } |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
we had this earlier in the docs, just adding it as a separate page under core so the UX is good