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 全部爲小寫。