Builder Codes

注：builder code の文脈における「builder」とは、コンセンサス内のブロックビルダーではなく、Hyperliquid 上にアプリケーションを構築する「DeFiビルダー」を指します。

Builder codes を使用すると、builder はユーザーの代理で送信した約定に対して手数料を受け取ることができます。最大の柔軟性のために注文ごとに設定されます。ユーザーは各 builder について最大 builder 手数料を承認する必要があり、権限はいつでも取り消せます。Builder codes は手数料ロジックの一部として完全にオンチェーンで処理されます。

Builder codes を使用するには、エンドユーザーはまず ApproveBuilderFee アクションを通じて builder アドレスに対する最大手数料を承認します。このアクションは、エージェント/APIウォレットではなく、ユーザーのメインウォレットによって署名されている必要があります。builder は永続契約アカウント価値に最低 100 USDC を保有し、アカウント抽象化モードとして standard を使用している必要があります。

現在、builder codes はクォート資産または担保資産で徴収される手数料にのみ適用されます。言い換えると、builder codes はスポット取引の買い側には適用されませんが、永続契約取引の両側には適用されます。徴収される builder 手数料は、永続契約で最大 0.1%、スポットで最大 1% です。

承認が完了すると、ユーザーの代理で送信される以降の注文アクションに、オプションの builder パラメータ {"b": address, "f": number} を含められます。b は builder のアドレス、f はベーシスポイントの 10 分の 1 単位で徴収される builder 手数料です。すなわち、値 10 は 1 ベーシスポイントを意味します。

Builder は、通常のリファラル報酬の請求プロセスを通じて、builder codes からの手数料を請求できます。

各ユーザーは、同時に最大 10 件のアクティブな builder code 承認を持てます。

サンプルコードは Python SDK を参照してください https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py

Builder 向け API

ユーザーについて承認済みの最大 builder 手数料は、インフォリクエスト {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."} で照会できます。

builder について徴収された builder 手数料の合計は、インフォリクエスト {"type": "referral", "user": "0x..."} のリファラル状態レスポンスの一部です。

特定の 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 が完全に小文字であることが必要です。