tapoooooty/hypergrad

选用指南

AI 根据 README 整理 · 2026/10/31 00:32:04

适用场景

适用于部署和运营一个基于 Hyperliquid HIP-3 的永续合约 DEX，聚焦 Solana memecoin 市场。

查看 README 依据

<img alt="Docker" src="https://img.shields.io/badge/docker-compose-97FCE4?labelColor=0B2420"> <img alt="Status: testnet" src="https://img.shields.io/badge/status-testnet-F2B544?labelColor=0B2420"> <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-97FCE4?labelColor=0B2420"></a> </p> **HyperGrad** is a builder-deployed perpetuals DEX on [Hyperliquid](https://hyperliquid.xyz) for Solana memecoins that graduate from [pump.fun](https://pump.fun). - A coin that holds a **$500K** market cap joins **`grad:GRAD`**, an index perp of graduates.

目标用户

面向希望部署自有的永续合约交易所的构建者，需要具备加密货币和 Hyperliquid 相关知识。

查看 README 依据

- [Project layout](#project-layout) - [Risks and limits](#risks-and-limits) - [Documentation](#documentation) - [Links](#links) ## Why HyperGrad [HIP-3](https://hyperliquid.gitbook.io/hyperliquid-docs/hyperliquid-improvement-proposals-hips/hip-3-builder-deployed-perpetuals) lets anyone who stakes 500,000 HYPE run their own perp DEX on Hyperliquid's matching engine. The deployer brings the markets and the oracle; Hyperliquid handles order books, margin and liquidations. trade.xyz used this to build stock and commodity perps, and on October 29, 2026 ICE, the owner of the NYSE, signed with it

- [ ] **The 500,000 HYPE stake** (~$45M). Crowdfund it through [Kinetiq Launch](https://kinetiq.xyz/launch), bring in a partner, or stake your own. - [ ] **A server near Hyperliquid.** Tokyo has the lowest latency: [AWS Lightsail](https://aws.amazon.com/lightsail/), [Vultr](https://www.vultr.com/). A second provider for the standby: [Hetzner](https://www.hetzner.com/cloud), [DigitalOcean](https://www.digitalocean.com/). - [ ] **A private Solana RPC**: [Helius](https://www.helius.dev/), [QuickNode](https://www.quicknode.com/chains/sol), [Triton](https://triton.one/).

使用方式

通过命令行操作，包括扫描币种、初始化 DEX、运行预言机和做市商等。需要配置环境和密钥。

查看 README 依据

1. Run **`setup.bat`**. It creates `.venv`, installs dependencies and copies `.env.example` to `.env`. 2. Fill in **`.env`**: deployer key, oracle key, market maker key, Telegram. 3. Run **`doctor.bat`** and fix anything marked FAIL. 4. Run **`scan.bat`**, then leave **`start_manager.bat`** running. Coins need about 6 hours of history to reach tier 0. 5. Open the dashboard with **`start_dashboard.bat`**. 6. When the index has coins, create the DEX: ```powershell .venv\Scripts\activate python -m hip3 init-dex ```

7. Start **`start_oracle.bat`** and keep it running while any market is live. 8. Set `market_maker.enabled` to `true` and start **`start_mm.bat`**. 9. List single perps as candidates appear: `python -m hip3 list <mint>`. ### macOS and Linux ```bash python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt cp .env.example .env # then fill it in python -m hip3 doctor python -m hip3 scan python -m hip3 manager & # leave running python -m hip3 serve # http://localhost:8787 python -m hip3 init-dex # once the index has coins

python -m hip3 oracle & # keep running python -m hip3 mm # after enabling it in config.json ``` <p align="center"><img src="docs/assets/term-scan.png" alt="Scanner output" width="88%"></p> ## Preflight: doctor `python -m hip3 doctor` runs every check it can without sending a transaction. Run it before `init-dex` and after every change to `.env` or `config.json`. | Area | What it checks | |---|---| | Environment | Python version, installed packages, `.env` present |

部署要求

需要 Python 3.10 或更新版本、Hyperliquid 钱包、Docker（可选）、VPS 服务器以及 500,000 HYPE 的质押。

查看 README 依据

<p align="center"><img src="docs/assets/oracle.png" alt="Oracle pipeline" width="100%"></p> Memecoins trade at fractions of a cent and Hyperliquid prices allow five significant figures, so HyperGrad lists bundles the way Hyperliquid lists `kPEPE`: `MWIF` is one million WIF. The bundle size is picked when a coin is listed. <p align="center"><img src="docs/assets/term-oracle.png" alt="Oracle log" width="88%"></p> ## Quick start You need Python 3.10 or newer and a Hyperliquid wallet. Everything defaults to testnet. ### Windows

The oracle cannot sleep, so production runs on a VPS. Docker is the shortest path: ```bash scp -r ./HIP-3/* root@SERVER:/opt/hypergrad/ ssh root@SERVER 'bash /opt/hypergrad/deploy/vps-setup.sh' # Docker, firewall, NTP, updates ssh root@SERVER 'nano /opt/hypergrad/.env' ssh root@SERVER 'cd /opt/hypergrad && docker compose run --rm oracle doctor' ssh root@SERVER 'cd /opt/hypergrad && docker compose up -d' # oracle, manager, dashboard ssh root@SERVER 'cd /opt/hypergrad && docker compose --profile mm up -d' # plus the market maker

- [ ] **The 500,000 HYPE stake** (~$45M). Crowdfund it through [Kinetiq Launch](https://kinetiq.xyz/launch), bring in a partner, or stake your own. - [ ] **A server near Hyperliquid.** Tokyo has the lowest latency: [AWS Lightsail](https://aws.amazon.com/lightsail/), [Vultr](https://www.vultr.com/). A second provider for the standby: [Hetzner](https://www.hetzner.com/cloud), [DigitalOcean](https://www.digitalocean.com/). - [ ] **A private Solana RPC**: [Helius](https://www.helius.dev/), [QuickNode](https://www.quicknode.com/chains/sol), [Triton](https://triton.one/).

已知限制

预言机在崩溃时标记价格滞后，做市商可能持有亏损头寸，依赖非官方 API，且存在质押资金被削减的风险。

查看 README 依据

├── docs/ concept, rules, policy, economics, roadmap, operations ├── .github/workflows/ci.yml tests and Docker build on every push ├── Dockerfile, docker-compose.yml ├── config.json, .env.example └── *.bat Windows launchers ``` ## Risks and limits - **Stake at risk.** A bad oracle input can be slashed by up to 100% of 500,000 HYPE, whether the cause is malice, a bug or a stolen key. Keep the oracle key separate and the deployer key offline.

- **Rugs outrun the mark.** Hyperliquid moves a HIP-3 mark at most 1% per update, so in a −90% crash positions sit on a stale price for a while. Leverage stays low and margin isolated for this reason. `backtest` shows how bad it would have been for a given coin. - **Market maker inventory.** The bot can end up holding a position in a coin that rugs. `max_position_usd` limits the damage; size it to what you can lose. - **Data dependencies.** The pump.fun API is unofficial and may change; the scanner falls back to DexScreener alone. Run the oracle with at least two sources on mainnet.