Contracts

Mainnet Alpha

Dies sind die aktuellen Contract-Adressen der Hypercall Mainnet Alpha. Der Launch-Umfang ist bewusst eingeschränkt, während die Handelsplattform erweitert wird.

Die On-Chain-Komponenten von Hypercall sind auf Hyperliquid L1 (HyperEVM) bereitgestellt. Das System verwendet eine modulare Architektur mit separaten Contracts für Kontoverwaltung, Orderverarbeitung und Options-Token-Handhabung.

Architekturübersicht

Zuständigkeiten der Contracts

Exchange

Die Exchange ist der Haupteinstiegspunkt und verwendet ein Upgradeable-Proxy-Muster.

Zuständigkeiten:

• Erstellt Benutzer-Accounts über das BeaconProxy-Muster
• Verwahrt eingezahltes USDC auf HyperCore (Versicherungsfonds + Optionspositionen)
• Einstiegspunkt für den RSM-Sequencer für On-Chain-Aktionen/-Anfragen
• Verarbeitet Ein- und Auszahlungen von Options-ERC20s (Bridging zwischen HyperEVM und RSM-Ledger)
• Verfolgt und löst vollständige Liquidationsauktionen auf
• Emittiert Events mit rohen ActionCaster-Aktionen

Wichtige Funktionen:

• createAccount() - Erstellt ein neues Konto mit dem Aufrufer als Manager
• deposit(account, token, amount) - Zahlt Token auf ein Konto ein
• addApiWallet(account, apiWallet) - Autorisiert eine API-Wallet für den Handel
• hlRequestOrder(...) - Platziert HyperLiquid-Perp-/Spot-Orders über ActionCaster
• hlRequestCancel(...) - Storniert HyperLiquid-Orders
• hlActionSendAsset(...) - Sendet Assets vom Account an einen Empfänger
• hcActionWithdrawToken(...) - Zieht Token von der Exchange auf das Konto ab
• hcActionWithdrawOption(...) - Zieht Optionen an einen HyperEVM-Empfänger ab
• rsmCommandRebalance(...) - Vom RSM initiierte Reduce-Only-Orders
• rsmCommandRepay(...) - Vom RSM initiierte Schuldenrückzahlung

Account

Jeder Benutzer hat einen eigenen Account-Contract (BeaconProxy, der auf eine gemeinsame Implementierung verweist).

Zuständigkeiten:

• Verwahrt Sicherheiten auf der HyperCore-Seite für Trader/MMs, die Nicht-USDC-Assets verwenden
• Hat einen einzelnen Manager, der mehrere Agent Keys hinzufügen kann
• Agent Keys können nur Orders/Stornierungen signieren; andere Aktionen erfordern die Manager-Signatur
• Einstiegspunkt für Manager für alle kontobezogenen Aktionen

Wichtige Konzepte:

• Manager: Der Kontoinhaber, der Agents autorisieren und Auszahlungen signieren kann
• Agent Keys: Autorisierte Signierer, ausschließlich für Orderplatzierung/-stornierung
• API-Wallets: Autorisierte Adressen, die Orders im Namen des Kontos einreichen können

Einzahlungen:

• Options-ERC20s werden durch Aufruf von Exchange.deposit() eingezahlt
• Andere Assets werden über die HyperEVM-→-HyperCore-Bridge des jeweiligen Assets zu HyperCore gebridged
• USDC-Einzahlungen in die "Option-USDC-Position" erfolgen über einen HyperCore-Transfer vom Account zur Exchange

Processor

Der Processor übernimmt die Signaturverifizierung und die Aktionskodierung.

Zuständigkeiten:

• Rekonstruiert Signierer-Adressen aus Signaturen
• Kodiert Aktionen in das ActionCaster-Format
• Konvertiert USD-Beträge in HYPE für Einzahlungsberechnungen

Wichtige Funktionen:

• hlRequestOrder(...) - Verarbeitet Order-Anfragen
• hlRequestCancel(...) - Verarbeitet Stornierungsanfragen
• hlActionSendAsset(...) - Verarbeitet Send-Asset-Aktionen
• rsmCommandRebalance(...) - Verarbeitet RSM-Rebalance-Befehle
• rsmCommandRepay(...) - Verarbeitet RSM-Rückzahlungsbefehle
• usdToHype(amountUsd) - Konvertiert USD in HYPE basierend auf dem Spotpreis

Registry

Die Registry verwaltet die Bereitstellung und Validierung von Options-Token.

Zuständigkeiten:

• Stellt Options-ERC20-Token bereit
• Maßgebliche Quelle für die Frage, ob ein ERC20 ein unterstützter Options-Token ist
• Adressen auf der Whitelist können neue Options-Token bereitstellen

Zukünftige Schutzmechanismen:

• Zulässige Menge an Basiswerten
• Zulässige Verfallszeitstempel
• Zulässige Granularität der Ausübungspreise

Aktionstypen

HyperLiquid-Anfragen

Anfragen, die mit dem Orderbuch von HyperLiquid interagieren:

Aktion	Signierer	Beschreibung
hlRequestOrder	Agent/API-Wallet	Perp-/Spot-Orders platzieren
hlRequestCancel	Agent/API-Wallet	Orders per OID stornieren
hlRequestCancelByCloid	Agent/API-Wallet	Orders per CLOID stornieren

Manager-Aktionen

Aktionen, die die Signatur des Konto-Managers erfordern:

Aktion	Beschreibung
hlActionSendAsset	Assets vom Account an einen Empfänger senden
hcActionWithdrawToken	Token von der Exchange auf das Konto abziehen
hcActionWithdrawOption	Optionen an eine HyperEVM-Adresse abziehen

RSM-Befehle

Befehle, die vom RSM-Signierer signiert werden (keine Zustimmung des Managers erforderlich):

Befehl	Beschreibung
rsmCommandRebalance	Reduce-Only-Orders platzieren, um das USDC-Guthaben zu erhöhen
rsmCommandRepay	USDC-Transfer vom Account zur Exchange erzwingen

Signaturverifizierung

• Exchange verifiziert Signaturen des RSM-Signierers
• Account verifiziert Manager- und Agent-Signaturen
• RSM-Befehle werden ohne Manager-Signatur weitergeleitet (der RSM-Signierer ist vertrauenswürdig)

Liquidationsauktionen

Wenn ein Konto unterbesichert wird:

1. Der RSM-Sequencer löst eine vollständige Liquidationsauktion aus
2. Jeder kann bieten, indem er den angeforderten USDC-Betrag bereitstellt
3. Der Gewinner wird der neue Account-Manager
4. Der RSM-Sequencer kann laufende Auktionen stoppen, wenn sich die Bedingungen ändern

Bereitgestellte Adressen

Mainnet Alpha

Contract	Adresse	Beschreibung
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Haupt-Exchange-Contract
Exchange Implementation	0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf	Exchange-Implementierung hinter dem Proxy
Account Implementation	0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C	Account-Implementierung
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Account-Beacon
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Lesehilfs-Contract
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Options-Token-Implementierung
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Options-Token-Beacon
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Account-Factory
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Funding- und Routing-Helfer
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Options-Token-Registry
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Options-Registry-Implementierung hinter dem Proxy

Mainnet-Konfiguration

Parameter	Adresse oder Wert	Beschreibung
USDC	0xb88339CB7199b77E23DB6E890353E22632Ba630f	Von Hypercall verwendetes HyperEVM-USDC
Core Deposit	0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24	HyperCore-Einzahlungshelfer
RSM Signer	0x502E7fAbF34E84EeB115C34FE947b79A94dF886E	Aktueller betreibergesteuerter RSM-Signierer
Sequencer	0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944	Aktueller Sequencer
Legacy Sequencer	0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7	Legacy-Sequencer

Quellcode

Der Contract-Quellcode wird nach Abschluss des Audits verfügbar gemacht.

Verwandte Themen

• EIP-712-Signierung - Nachrichtenformate und Signierung
• Agent-Autorisierung - Einrichtung der API-Wallet
• Onboarding - Kontoerstellung und Einzahlungen
• API-Authentifizierung - Signieren von Anfragen