Diese Seite wurde maschinell übersetzt. Das englische Original ist maßgeblich. Auf Englisch lesen →
Zum Hauptinhalt springen

Fehlermodi

Systemverhalten bei Ausfällen und eingeschränktem Betrieb.

Designphilosophie​

Hypercall hält den Handel aufrecht, wo es möglich ist, und schlägt geschlossen fehl, wo ein Preis- oder Margin-Input fehlt. Bei Ausfällen gilt:

  • Der Handel läuft weiter, sofern die erforderlichen Inputs gültig sind
  • Ausgefallene Komponenten werden isoliert
  • Nutzer erhalten explizite Fehlermeldungen statt veralteter Daten oder erfundener Preise

L1-Ausfall​

Wenn Hyperliquid L1 (HyperCore) nicht verfügbar ist:

FunktionVerhalten
Options-MatchingLäuft im Orderbuch von Hypercall weiter, solange Preis- und Volatilitäts-Inputs gültig bleiben
Perp-OrdersNicht verfügbar. Perps werden auf Hyperliquid ausgeführt.
SettlementsVerzögert, bis genügend Oracle-Samples vorliegen (siehe unten)
EinzahlungenBlockiert, bis L1 wieder verfügbar ist
AuszahlungenBlockiert, bis L1 wieder verfügbar ist

Die Wiederherstellung erfolgt automatisch, sobald L1 wieder verfügbar ist.

Oracle-Ausfälle​

Preis-Oracle​

Wenn das Preis-Oracle nicht verfügbar ist:

AuswirkungVerhalten
Risikoerhöhende OrdersAbgelehnt, sobald der zuletzt erfasste Spotpreis älter als 30 Sekunden ist
Risikoreduzierende OrdersAkzeptiert, bewertet zum zuletzt erfassten Preis
Margin- und LiquidationsbewertungLäuft zum zuletzt erfassten Preis weiter. Es wird kein Ersatzpreis erzeugt.
Settlement-Preis bei VerfallWird nie aus dem zuletzt erfassten Preis abgeleitet. Siehe Oracle beim Verfall nicht verfügbar.

Ein funktionierender Feed erfasst einen unveränderten Preis mindestens alle 10 Sekunden erneut, sodass ein seitwärts laufender Markt das 30-Sekunden-Limit nicht auslöst. Die Wiederherstellung erfolgt automatisch, sobald das Oracle zurückkehrt.

IV-Oracle​

Wenn das IV-Oracle ausfällt:

AuswirkungVerhalten
Neue OrdersRisikoerhöhende Orders auf den betroffenen Basiswert werden abgelehnt
OptionsbepreisungKein Fallback-Preis. Berechnungen, die die fehlende IV benötigen, schlagen fehl.
Margin-BerechnungenSchlagen geschlossen fehl, statt eine Ersatzvolatilität zu verwenden

Die genauen Bedingungen finden Sie unter Volatilitäts-Oracle.

Settlement-Ausfälle​

Oracle beim Verfall nicht verfügbar​

Settlement-Preise verwenden ein 30-minütiges TWAP-Fenster vor dem Verfall. Die obigen Ausfallregeln für die Bewertung gelten nicht für den Settlement-Preis. Wenn keine Oracle-Daten verfügbar sind:

  1. Teilausfall: Der TWAP wird nur berechnet, wenn das Fenster mindestens 500 Samples enthält. Hypercall kann ein kurzes Fenster aus archivierter Hyperliquid-Oracle-Historie rekonstruieren, wobei dasselbe Minimum gilt.
  2. Vollständiger Ausfall: Das Settlement wartet, bis ein Fenster mit mindestens 500 Samples verfügbar ist. Es wird weder zum zuletzt erfassten Preis noch auf Basis eines unvollständigen Fensters oder eines Ersatzpreises abgerechnet.

Das Settlement kann sich auch ohne Ausfall verzögern, wenn der finalisierte TWAP zum exakten Verfallszeitpunkt nicht verfügbar ist. In diesem Fall verbleibt das Instrument im Status Expired Pending Price, der Handel bleibt deaktiviert, und das Settlement wird automatisch erneut versucht, bis der finalisierte Preis vorliegt.

Der TWAP-Algorithmus ist so konzipiert, dass er Manipulationen widersteht. Details finden Sie unter Oracles.

API-Ausfall​

Wenn die Hypercall-API nicht verfügbar ist:

KomponenteStatus
HandelNicht verfügbar. Options-Orders, Stornierungen und Perp-Orders laufen alle über die Hypercall-API.
Positionen und GuthabenIm dauerhaften Journal der Engine gespeichert und beim Neustart wiederhergestellt
Offene OrdersTeil des Engine-Zustands und beim Neustart wiederhergestellt. Sie können sie erst stornieren, wenn die API wieder verfügbar ist.
Perp-PositionenVerbleiben auf Ihrem Hyperliquid-Konto
WebSocket-SubscriptionsGetrennt

Empfehlungen​

  • Implementieren Sie Wiederverbindungslogik mit exponentiellem Backoff
  • Speichern Sie kritische Daten lokal im Cache
  • Prüfen Sie GET /health vor dem Handel
  • Gehen Sie davon aus, dass ruhende Orders während eines API-Ausfalls aktiv bleiben, und dimensionieren Sie ruhende Quotes entsprechend

Health-Endpunkt​

EndpunktZweck
GET /healthEinfache Liveness-Prüfung
GET /readyVollständige Bereitschaftsprüfung einschließlich Abhängigkeiten

Kommunikation bei Vorfällen​

Prüfen Sie bei Vorfällen: