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

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），地址需小写。

• 分成机制：收益与应用驱动的交易量成正比，可能超过 L1 自身费用数倍。Hyperliquid 也从中获益，形成飞轮效应：更多应用 → 更多流量 → 更深流动性。

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

1. 克隆模板：从 GitHub 克隆 boilerplate，验证钱包连接、交易界面和 UI。

2. 替换 API 调用：使用 Unofficial TypeScript SDK（https://github.com/nomeida/hyperliquid/tree/main）或 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 找到。

• @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，预示着大规模采用。

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

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），地址需小写。

• 分成机制：收益与应用驱动的交易量成正比，可能超过 L1 自身费用数倍。Hyperliquid 也从中获益，形成飞轮效应：更多应用 → 更多流量 → 更深流动性。

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

1. 克隆模板：从 GitHub 克隆 boilerplate，验证钱包连接、交易界面和 UI。

2. 替换 API 调用：使用 Unofficial TypeScript SDK（https://github.com/nomeida/hyperliquid/tree/main）或 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 找到。

• @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，预示着大规模采用。