# Hyperliquid build codes

By [石小龙](https://paragraph.com/@0x994cd38723375a0eb0d55fcbc1e2a862fd49d007) · 2025-10-07

---

### Builder Codes 详解

Builder Codes 是 Hyperliquid 区块链（Layer 1）上的一个内置核心功能，旨在为开发者提供一种无许可（permissionless）、链上（onchain）和信任less 的方式来连接他们的应用前端与 Hyperliquid 的后端流动性基础设施。它类似于一个开发者工具或 referral（推荐）机制，但更专注于 monetization（变现），允许开发者通过简单集成（如添加一行代码）从用户交易中赚取费用分成，从而激励生态系统的创新和增长。 这项功能是 Hyperliquid 作为“流动性 AWS”（Amazon Web Services）的关键组成部分，帮助开发者避免从零构建流动性池，而是直接利用 HyperCore（Hyperliquid 的核心交易引擎）的深度流动性、订单簿和执行速度。

#### Builder Codes 的核心工作原理

Builder Codes 本质上是一个独特的标识符（unique identifier）或标签（tag），开发者可以将它附加到交易中。当用户通过开发者的应用（如前端界面、移动钱包、Telegram bot 或社交交易平台）执行交易时，这个代码会触发费用分成机制。具体流程如下：

1.  **集成与连接**：开发者在他们的应用中集成 Hyperliquid 的 API 或 SDK（如 TypeScript SDK 或 Rust SDK Ferrofluid），使用 Builder Codes 作为桥梁连接到 HyperCore。HyperCore 是 Hyperliquid L1 的核心部分，支持永续合约（perps）、现货交易（spot）、资金存款和 HYPE 质押等功能。它能处理高达 200,000 笔订单/秒，中位延迟约 0.2 秒，所有操作（如订单、交易、取消）均在链上发生，由 HyperBFT 共识机制支持。
    
2.  **交易执行**：用户在应用中下单时，订单路由到 HyperCore 的订单簿。Builder Codes 确保交易归属于该开发者，同时应用可以自定义交易路由、执行逻辑或 UI（如实时价格更新、余额显示）。为了安全性，系统支持“代理（agent）基于交易系统”：代理只能执行交易，无法转移用户资金，减少黑客风险。
    
3.  **费用分成与变现**：开发者设置自定义费用（在 Hyperliquid 标准费用之上），用户需批准这些费用。交易完成后，开发者从生成的流量中赚取分成。这是一个原生的、无需批准的机制，确保开发者按比例获得收益（如交易量的百分比）。
    

Builder Codes 解决了 DeFi 应用的常见痛点：流动性引导问题（bootstrapping liquidity）。开发者无需自己构建订单簿或吸引做市商，就能访问 HyperCore 的 CEX 级流动性（低滑点、深度市场），从而专注于用户体验（如本地化界面或 AI 交易工具）。这类似于 Shopify 的应用商店模式，但链上化：开发者构建，平台提供基础设施，并分享收益。

#### 费用结构

*   **自定义费用上限**：对于永续合约，开发者可设置高达 0.1% 的费用；对于现货交易，高达 1%。这些费用以基点（basis points）的十分之一表示（例如，f=10 表示 1 个基点）。
    
*   **查询与监控**：使用 API 查询已批准费用（JSON payload: {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."}）或检查收益（{"type": "referral", "user": "0x..."}）。交易数据可通过 CSV 文件下载（如 [https://stats-data.hyperliquid.xyz/Mainnet/builder\_fills/{builder\_address}/{YYYYMMDD}.csv.lz4），地址需小写。](https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/%7Bbuilder_address%7D/%7BYYYYMMDD%7D.csv.lz4%EF%BC%89%EF%BC%8C%E5%9C%B0%E5%9D%80%E9%9C%80%E5%B0%8F%E5%86%99%E3%80%82)
    
*   **分成机制**：收益与应用驱动的交易量成正比，可能超过 L1 自身费用数倍。Hyperliquid 也从中获益，形成飞轮效应：更多应用 → 更多流量 → 更深流动性。
    

#### 设置与自定义指南

设置 Builder Codes 相对简单，通常只需一行代码集成。官方推荐使用 @SovrunOfficial 的 boilerplate 模板作为起点：

1.  **克隆模板**：从 GitHub 克隆 boilerplate，验证钱包连接、交易界面和 UI。
    
2.  **替换 API 调用**：使用 Unofficial TypeScript SDK（[https://github.com/nomeida/hyperliquid/tree/main）或](https://github.com/nomeida/hyperliquid/tree/main%EF%BC%89%E6%88%96) Rust SDK Ferrofluid 替换直接 API 调用，提高效率。
    
3.  **自定义**：添加功能如高级策略、分析仪表盘或 DeFi 集成。使用 Tailwind CSS、shadcn/ui、Wagmi、Viem 等工具构建 UI；Zustand 管理状态；TanStack Query 处理数据获取。TypeScript 确保类型安全。
    

示例代码片段（查询费用）：

    {
      "type": "maxBuilderFee",
      "user": "0xYourUserAddress",
      "builder": "0xYourBuilderAddress"
    }
    

Python SDK 示例可在 [https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic\_builder\_fee.py](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py) 找到。

#### 使用例子

*   **@pvp\_dot\_trade**（Telegram 交易 bot）：累计收入 ~$7.11M-$7.5M，占 Builder 交易量 78%。
    
*   **@Okto\_wallet**（移动前端）：收入 ~$825K。
    
*   **@AxiomExchange**：收入 ~$691K-$1.3M。
    
*   **Phantom 和 Rabby 钱包**：集成后，提供 perps 交易，收入达数百万美元。
    
*   **其他**：区域化前端、 fiat onramps、社会交易 app、AI bot 等。2025 年 5 月 3 日，Builder Codes 交易量达 $650M，占总量的 4.2%。
    

#### 技术细节与未来影响

技术上，Builder Codes 支持自定义贸易执行、路由和代理系统，与 HIP-3（perps-as-a-service）结合，允许开发者部署自定义市场。 未来，它将加速 Hyperliquid 的分布扩展，超越 CEX：开发者蜂拥而至，创建股票、预测市场、商品等新产品，形成“一切交易所”。 截至 2025 年，Builder Codes 收入接近 $10M，预示着大规模采用。

---

*Originally published on [石小龙](https://paragraph.com/@0x994cd38723375a0eb0d55fcbc1e2a862fd49d007/hyperliquid-build-codes)*