Builder Codes

Hinweis: Der Begriff „Builder" im Kontext von Builder Codes bezieht sich nicht auf Block-Builder innerhalb des Konsenses, sondern auf „DeFi-Builder", die Anwendungen auf Hyperliquid entwickeln.

Builder Codes ermöglichen es Buildern, eine Gebühr auf Fills zu erhalten, die sie im Auftrag eines Nutzers senden. Sie werden pro Order festgelegt, um maximale Flexibilität zu bieten. Der Nutzer muss für jeden Builder eine maximale Builder-Gebühr genehmigen und kann die Berechtigungen jederzeit widerrufen. Builder Codes werden vollständig on-chain als Teil der Gebührenlogik verarbeitet.

Um Builder Codes zu nutzen, genehmigt der Endnutzer zunächst über die Aktion ApproveBuilderFee eine maximale Gebühr für die Builder-Adresse. Diese Aktion muss von der Haupt-Wallet des Nutzers signiert werden, nicht von einer Agenten-/API-Wallet. Der Builder muss über einen Perps-Kontowert von mindestens 100 USDC verfügen und muss standard als Kontoabstraktionsmodus verwenden.

Builder Codes gelten derzeit nur für Gebühren, die im Quote- oder Collateral-Asset erhoben werden. Mit anderen Worten: Builder Codes gelten nicht für die Kaufseite von Spot-Trades, wohl aber für beide Seiten von Perp-Trades. Die erhobenen Builder-Gebühren dürfen höchstens 0.1% bei Perps und 1% bei Spot betragen.

Nach Abschluss der Autorisierung können künftige Order-Aktionen, die im Auftrag des Nutzers gesendet werden, einen optionalen builder-Parameter enthalten: {"b": address, "f": number}. b ist die Adresse des Builders und f die zu erhebende Builder-Gebühr in Zehnteln von Basispunkten. D. h. ein Wert von 10 entspricht 1 Basispunkt.

Builder können Gebühren aus Builder Codes über den üblichen Prozess zur Einlösung von Empfehlungsbelohnungen einfordern.

Jeder Nutzer kann gleichzeitig maximal 10 aktive Builder-Code-Genehmigungen haben.

Beispielcode finden Sie im Python SDK https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py

API für Builder

Die genehmigte maximale Builder-Gebühr für einen Nutzer kann über eine Info-Anfrage {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."}. abgefragt werden.

Die insgesamt für einen Builder eingenommenen Builder-Gebühren sind Teil der Antwort zum Empfehlungsstatus aus der Info-Anfrage {"type": "referral", "user": "0x..."}.

Die Trades, die einen bestimmten Builder Code verwenden, werden im komprimierten LZ4-Format unter https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/{builder_address}/{YYYYMMDD}.csv.lz4 hochgeladen, z. B. https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/0x123.../20241031.csv.lz4

Wichtig: Beachten Sie, dass diese URLs zwischen Groß- und Kleinschreibung unterscheiden und builder_address vollständig kleingeschrieben sein muss.