Architektur
Hypercall verwendet ein hybrides Ausführungsmodell: Off-Chain-Matching für Geschwindigkeit, On-Chain-Settlement und On-Chain-Kontoverwaltung für Sicherheit.
Vertrauensgrenzen
Off-Chain (Hypercall-Backend)
Zuständigkeiten:
- Order-Matching und -Ausführung
- Verwaltung des Orderbuchs
- Margin-Prüfungen vor dem Handel, einschließlich der Portfolio-Prüfung vor jeder Perp-Order
- Steuerung von Liquidationen
- Marktdaten und Preisbildung
- WebSocket-Streams
Vertrauensannahme: Für all das vertrauen Sie dem Betreiber. Siehe Vertrauensmodell.
On-Chain (Smart Contracts)
Zuständigkeiten:
- Kontoinhaberschaft und Kontrolle durch den Manager
- Einzahlungen und Auszahlungen
- RSM-Befehle (Risikomanagement-Vorgänge)
- Options-Token (Contracts OptionRegistry und OptionToken)
- Builder-Freigabe für Perp-Orders (einmaliges
approveZeroFeeBuildervon Ihrem Account aus)
Vertrauensannahme: On-Chain-Vorgänge werden auf Hyperliquid aufgezeichnet und können vom Betreiber nicht allein geändert werden. Wer die Contracts upgraden kann, steht unter Vertrauensmodell.
Ablauf der Order-Ausführung
1. Order-Übermittlung
Nutzeraktion: Übermitteln Sie die Order über POST /order mit einer EIP-712-Signatur.
Validierung im Backend:
- Signaturprüfung (EIP-712)
- Margin-Prüfungen vor dem Handel (szenariobasiert)
- Order-Zulassung (Stufe, Verfall, Ratenlimits)
Ergebnis: Die Order wird angenommen (ACKED) und für das Matching eingereiht oder mit Begründung abgelehnt.
2. Order-Matching
Ablauf: Orders werden im Orderbuch nach Preis-Zeit-Priorität zusammengeführt.
Ausführung: Wenn Orders zusammengeführt werden, entstehen Fills und die Positionen werden im Engine-Zustand aktualisiert. Jede Zustandsänderung wird in das dauerhafte Journal der Engine geschrieben, bevor sie bestätigt wird, und die Datenbanktabellen werden aus diesem Journal abgeleitet.
Nicht on-chain: Einzelne Options-Matches werden nicht on-chain aufgezeichnet.
3. Positionsaktualisierungen
Ablauf: Optionspositionen und Barguthaben werden im Engine-Zustand geführt und in Echtzeit aktualisiert. Perp-Positionen liegen im HyperCore-Ledger Ihres Accounts auf Hyperliquid.
Nutzerzugriff: Fragen Sie Positionen über GET /portfolio oder den WebSocket-Kanal portfolio ab.
4. Settlement
Settlement bei Verfall: Optionen werden bei Verfall bar abgerechnet, und zwar gegen einen Settlement-Preis, der aus dem Hyperliquid-Oracle abgeleitet wird. Die Engine zeichnet den Settlement-Preis in ihrem Journal auf, berechnet den inneren Wert jeder Position, aktualisiert die Barguthaben und schließt die Positionen.
Zu den Verfallszeiten je Basiswert, zur Berechnung des Settlement-Preises und zum Vorgehen bei dünner Datenlage siehe Settlement und Oracles.
Kontoverwaltung
Kontoerstellung
Ablauf: Die Manager-Wallet ruft createAccount auf der Factory mit einer kleinen HYPE-Einlage zur Erstellung auf. Die App erledigt das für Sie, wenn Sie Perps oder Portfolio Margin aktivieren. Siehe Onboarding (Contracts).
Manager: Jeder Account hat einen Manager (eine EOA), der ihn kontrolliert und API-Wallets zum Signieren von Orders und Stornierungen autorisieren kann.
Einzahlungen und Auszahlungen
Einzahlungen:
- USDC: wird auf HyperEVM an den Exchange-Contract (
depositUsdcFor) gesendet, der es auf das HyperCore-Guthaben der Exchange überbrückt. Hypercall schreibt es gut, sobald die HyperCore-Einzahlung erkannt wurde. - Options-ERC20s: werden über den Exchange-Contract eingezahlt, der sie verbrennt und die Position gutschreibt.
Auszahlungen:
- Müssen die Margin-Prüfung von Hypercall bestehen (ausreichende Margin nach der Auszahlung)
- Werden von Ihrer Wallet signiert. Standard-USDC-Auszahlungen werden auf HyperCore aus dem Guthaben der Exchange über eine RSM-Direktive ausgezahlt. Auszahlungen aus Portfolio Margin sind eine vom Manager signierte Überweisung von Ihrem Account auf HyperCore.
Vertrauensgrenze: Einzahlungen und Auszahlungen erfolgen on-chain und sind überprüfbar.
Liquidation
Wenn das Eigenkapital eines Kontos unter seine Maintenance-Anforderung fällt, geht es in die Vorliquidation über:
- Risikoerhöhende Orders werden blockiert; schließende Orders sind weiterhin erlaubt.
- Der Liquidator arbeitet Teilliquidations-Orders ab, um die Margin wiederherzustellen, mit einem Liquidator-Bonus, der mit der Zeit steigt.
- Hat sich das Konto innerhalb des Eskalationsfensters nicht erholt, geht es in die vollständige Liquidation über, die die Hypercall-Engine durchführt.
Alle Einzelheiten finden Sie unter Liquidation.
Hyperliquid-Integration
Perps
Hypercall leitet Perp-Orders an Hyperliquid weiter, einschließlich HIP-3-Märkten auf der xyz-DEX. Jede Perp-Order wird zunächst gegen Ihr gesamtes Portfolio-Margin-Konto geprüft. Danach gibt es zwei Wege. Die App nutzt standardmäßig TEE, der Smart-Contract-Weg ist eine erweiterte Einstellung; API-Clients wählen den Weg über den aufgerufenen Endpunkt:
Smart-Contract-Weg (erweiterte Einstellung in der App): Sie signieren die Order → die Hypercall-Engine prüft sie gegen Ihr gesamtes Portfolio-Margin-Konto → die Order geht über Ihren Account-Contract on-chain an HyperCore → Hyperliquid führt das Matching durch
TEE-Weg (Standard in der App, über die API optional): Sie signieren die Order → die Engine prüft sie → eine sichere Enklave (TEE), die den Hyperliquid-Trading-Schlüssel Ihres Accounts hält, signiert die native Order → Hyperliquid führt das Matching durch
Nur Orders auf dem TEE-Weg laufen über die Enklave. Diese Orders tragen die Builder-Adresse von Hypercall, daher gibt der Account den Builder einmalig frei (Enable trading), und die Enklave signiert nur von der Engine genehmigte Orders, Stornierungen und Hebeländerungen. Siehe Perps auf Hypercall.
Anwendungsfälle:
- Delta-Hedging von Optionspositionen
- Cross-Margin: Perp-Positionen werden auf die Portfolio Margin angerechnet
Cross-Margin
HyperCore-Perp-Positionen fließen in die Portfolio-Margin-Berechnung ein, und die Anforderung ist der größere Wert aus dem Portfolio-Margin-Ergebnis und der eigenen Margin von Hyperliquid. Portfolio Margin steht jedem Konto offen; siehe Onboarding für Portfolio Margin.
RSM-Befehle
RSM: die replizierte Zustandsmaschine (Replicated State Machine) der Engine. Wenn der Engine-Zustand eine On-Chain-Aktion erfordert (eine Gutschrift, eine Auszahlung, einen Liquidationsschritt oder eine Recovery-Order), signiert der RSM-Signer eine Direktive, und der Sequencer von Hypercall übermittelt sie. Das Settlement bei Optionsverfall ist keine RSM-Direktive: Es wird im Engine-Zustand auf das Barguthaben angewendet. Was jede Direktive darf, steht unter RSM-Direktiven.
Was Sie überprüfen können
On-Chain (überprüfbar)
- Kontoinhaberschaft (Manager-Adresse)
- Einzahlungen und Auszahlungen
- Hyperliquid-Orders und Perp-Positionen (auf Hyperliquid)
- RSM-Befehle (On-Chain-Ausführung)
Off-Chain (Vertrauen erforderlich)
- Fairness des Order-Matchings
- Margin-Berechnungen
- Berechnung des Settlement-Preises (die Eingangsdaten des Hyperliquid-Oracles sind öffentlich)
- Genauigkeit der Positionsführung
- Genauigkeit der Marktdaten
- Zeitpunkt der Liquidationsauslösung
Vertrauensmodell
Mainnet Alpha wird vom Betreiber geführt. Sie vertrauen darauf, dass Hypercall Orders fair zusammenführt (Preis-Zeit-Priorität), korrekte Marktdaten erfasst, Margin und Settlement-Preise korrekt berechnet, Liquidationen rechtzeitig auslöst, nur korrekte RSM-Direktiven ausgibt und auf Störungen reagiert. Nichts davon ist bisher kryptografisch überprüfbar; Off-Chain-Matching erkauft Geschwindigkeit mit diesem Vertrauen. Den Rest erzwingt die Chain: Kontoinhaberschaft, Einzahlungen und Auszahlungen liegen on-chain, ein Account führt nur Direktiven aus, die von seinem Manager, einer seiner API-Wallets oder dem registrierten RSM-Signer signiert sind, und die Contracts beschränken RSM-Direktiven auf Gutschriften, Auszahlungen, Liquidationsstatus und eng begrenzte Recovery-Aktionen. Perp-Orders auf dem TEE-Weg (Standard in der App) werden in einer attestierten Enklave signiert, die nur von der Engine genehmigte Orders annimmt. Der RSM-Signer, der Sequencer sowie die Admin- und Upgrade-Schlüssel der Contracts werden vom Betreiber kontrolliert, und ein Account-Upgrade gilt für jeden Account. Genaue Befugnisse, Rollen und Adressen stehen unter Vertrauen und Berechtigungen. Die Roadmap zur Dezentralisierung der RSM wird festlegen, wie State Commitments, Signer-Rollen, Streitbeilegungswege und Betreiberkontrollen überprüfbar werden; Mainnet Alpha ist die eingeschränkte erste Phase, nicht das endgültige Vertrauensmodell.
Siehe auch:
- Settlement & Verfall - Settlement-Prozess und Lebenszyklus
- Liquidation - Zustandsmaschine und Mechanik der Liquidation
- Contracts - Dokumentation der Smart Contracts