Builder Codes

Nota: il termine "builder" nel contesto dei builder codes non si riferisce ai block builder all'interno del consenso, bensì ai "defi builder" che realizzano applicazioni su Hyperliquid.

Builder codes consentono ai builder di ricevere una commissione sui fill che inviano per conto di un utente. Vengono impostati per singolo ordine per la massima flessibilità. L'utente deve approvare una commissione builder massima per ciascun builder e può revocare le autorizzazioni in qualsiasi momento. I builder codes vengono elaborati interamente on-chain come parte della logica delle commissioni.

Per utilizzare i builder codes, l'utente finale deve innanzitutto approvare una commissione massima per l'indirizzo del builder tramite l'azione ApproveBuilderFee. Questa azione deve essere firmata dal wallet principale dell'utente, non da un wallet agent/API. Il builder deve disporre di almeno 100 USDC di valore dell'account perps e deve utilizzare standard come modalità di astrazione dell'account.

Attualmente i builder codes si applicano solo alle commissioni riscosse nell'asset di quotazione o collateral. In altre parole, i builder codes non si applicano al lato acquisto delle operazioni spot, ma si applicano a entrambi i lati delle operazioni perp. Le commissioni builder applicate possono essere al massimo dello 0.1% sui perps e dell'1% sullo spot.

Una volta completata l'autorizzazione, le future azioni di ordine inviate per conto dell'utente possono includere un parametro builder facoltativo: {"b": address, "f": number}. b è l'indirizzo del builder e f è la commissione builder da applicare in decimi di punto base. Ossia, un valore di 10 significa 1 punto base.

I builder possono richiedere le commissioni derivanti dai builder codes tramite la consueta procedura di richiesta delle ricompense da referral.

Ciascun utente può avere al massimo 10 autorizzazioni attive di builder code alla volta.

Per un esempio di codice si veda il Python SDK https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py

API per i builder

La commissione builder massima approvata per un utente può essere interrogata tramite una richiesta info {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."}.

Il totale delle commissioni builder riscosse per un builder fa parte della risposta dello stato referral della richiesta info {"type": "referral", "user": "0x..."}.

Le operazioni che utilizzano un determinato builder code vengono caricate in formato LZ4 compresso su https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/{builder_address}/{YYYYMMDD}.csv.lz4 ad es. https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/0x123.../20241031.csv.lz4

Importante: si noti che questi URL distinguono tra maiuscole e minuscole e richiedono che builder_addresssia interamente in minuscolo.