Builder Codes

注意：Builder Code 语境中的 "builder" 并非指共识内的区块构建者，而是指在 Hyperliquid 上构建应用的"DeFi Builder"。

Builder Code 允许 Builder 就其代表用户发送的成交收取费用。Builder Code 按订单设置，以获得最大的灵活性。用户必须为每个 Builder 批准一个最高 Builder 费用，并可以随时撤销授权。Builder Code 完全在链上作为费用逻辑的一部分处理。

要使用 Builder Code，终端用户需先通过 ApproveBuilderFee 操作为 Builder 地址批准一个最高费用。该操作必须由用户的主钱包签名，而不能是代理/API 钱包。Builder 的永续合约账户价值必须至少为 100 USDC，且必须使用 standard 作为账户抽象模式。

Builder Code 目前仅适用于以计价资产或抵押资产收取的手续费。换言之，Builder Code 不适用于现货交易的买方，但适用于永续合约交易的双方。收取的 Builder 费用在永续合约上最高为 0.1%，在现货上最高为 1%。

授权完成后，代表用户发送的后续订单操作可以包含一个可选的 builder 参数：{"b": address, "f": number}。b 是 Builder 的地址，f 是要收取的 Builder 费用，以十分之一个基点为单位。即值 10 表示 1 个基点。

Builder 可以通过常规的推荐奖励领取流程来领取 Builder Code 的费用。

每个用户同一时间最多可以有 10 个有效的 Builder Code 授权。

示例代码请参见 Python SDK https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py

面向 Builder 的 API

可以通过 info 请求 {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."} 查询为用户批准的最高 Builder 费用。

为某个 Builder 收取的 Builder 费用总额包含在 info 请求 {"type": "referral", "user": "0x..."} 的 referral 状态响应中。

使用特定 Builder Code 的成交记录以 LZ4 压缩格式上传至 https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/{builder_address}/{YYYYMMDD}.csv.lz4，例如 https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/0x123.../20241031.csv.lz4

重要提示：这些 URL 区分大小写，且要求 builder_address 全部为小写。