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

Runbooks

Vollständige Checkliste zur Desk-Bereitschaft und Integrations-Zertifizierungstests.

Checkliste zur Desk-Bereitschaft​

Prüfen Sie vor dem Livegang:

API-Konnektivität​

  • Produktions-Endpunkte konfiguriert
  • Health-Check-Endpunkt antwortet
  • WebSocket-Verbindung stabil

Authentifizierung​

  • EIP-712-Signierung funktioniert
  • Agent-Autorisierung konfiguriert (falls zutreffend)
  • Nonce-Verwaltung implementiert
  • Signaturprüfung getestet

Quotierungssystem​

  • Platzierung von Sammelorders getestet
  • Abgleich des Order-Lebenszyklus verifiziert
  • Fill-Tracking implementiert
  • Stornierungsfunktion getestet

Risikokontrollen​

  • MMP konfiguriert und getestet
  • Margin-Modell verstanden
  • Tier-Beschränkungen verifiziert
  • Portfolio-Überwachung implementiert

Überwachung​

  • WebSocket-Feeds abonniert
  • Order-/Fill-Abgleich automatisiert
  • Health-Checks konfiguriert
  • Alarmierung eingerichtet

Kill Switch​

  • Möglichkeit, alle Orders zu stornieren
  • Möglichkeit, die Verbindung sofort zu trennen
  • Notfallverfahren dokumentiert

Absicherung​

  • Integration mit Hyperliquid-Perpetuals verifiziert
  • Delta-Hedging-Strategie implementiert
  • Margin-Berechnung für Perpetuals verstanden

Settlement​

  • Behandlung des Verfalls getestet
  • Settlement von Positionen verifiziert
  • Quelle des Referenzpreises verstanden

Integrations-Zertifizierungstests​

Test 1: Order-Platzierung​

Schritte:

  1. Platzieren Sie eine einzelne Order über POST /order
  2. Prüfen Sie, dass der Status in der Order-Antwort ACKED oder OPEN ist
  3. Prüfen Sie, dass die Order in GET /orders?wallet=... erscheint
  4. Prüfen Sie, dass WebSocket-order_updates empfangen werden

Erwartet: Order erfolgreich platziert, Status-Updates empfangen

Test 2: Platzierung von Sammelorders​

Schritte:

  1. Platzieren Sie 10 Orders über POST /bulk_order
  2. Prüfen Sie, dass alle Orders akzeptiert wurden
  3. Prüfen Sie die Order-Status über REST und WS
  4. Prüfen Sie, dass keine Signatur-/Auth-Fehler auftreten

Erwartet: Alle Orders erfolgreich platziert

Test 3: Fill-Tracking​

Schritte:

  1. Platzieren Sie eine Order, die ausgeführt wird
  2. Überwachen Sie den WebSocket-Kanal fills
  3. Prüfen Sie, dass der Fill mit der korrekten order_id empfangen wird
  4. Prüfen Sie, dass der Fill in GET /fills?wallet=... erscheint
  5. Prüfen Sie, dass der Order-Status auf FILLED aktualisiert wird

Erwartet: Fills korrekt erfasst, Order-Status aktualisiert

Test 4: Tracking von Teilausführungen​

Schritte:

  1. Platzieren Sie eine Order, die teilweise ausgeführt wird
  2. Überwachen Sie die WebSocket-Kanäle fills und order_updates
  3. Prüfen Sie, dass die Teilausführung auf fills eintrifft
  4. Prüfen Sie, dass order_updates PARTIALLY_FILLED mit einer kumulativen filled_size meldet
  5. Aggregieren Sie die Fills nach order_id und prüfen Sie, dass die Summe filled_size entspricht

Erwartet: Mengen pro Fill auf fills, kumulative ausgeführte Größe auf order_updates

Test 5: Order-Stornierung​

Schritte:

  1. Platzieren Sie eine Order über POST /order
  2. Stornieren Sie die Order über DELETE /order
  3. Prüfen Sie den Order-Status: CANCELED
  4. Prüfen Sie, dass WebSocket-order_updates empfangen werden

Erwartet: Order erfolgreich storniert, Status-Updates empfangen

Test 6: MMP-Auslösung​

Schritte:

  1. Konfigurieren Sie MMP über ein signiertes POST /mmp-config. Senden Sie X-Hypercall-Fence-Wait: 1, wenn der Client die Projektion unmittelbar danach liest, und bewahren Sie den zurückgegebenen Wert X-Hypercall-Fence auf.
  2. Platzieren Sie MMP-aktivierte Orders
  3. Lösen Sie MMP durch Überschreiten der Limits aus
  4. Prüfen Sie, dass Orders mit MMP-Grund storniert werden
  5. Prüfen Sie, dass auch andere MMP-aktivierte Orders storniert werden

Erwartet: MMP löst korrekt aus, Orders werden storniert

Auch Lesezugriffe auf die MMP-Konfiguration erfordern eine Authentifizierung. Signieren Sie GetMmpConfig und senden Sie dessen Ablaufzeit und Signatur als Header X-Hypercall-Expires-At-Ms und X-Hypercall-Signature. Geben Sie bei diesem GET den Wert X-Hypercall-Fence aus der Schreibantwort zurück, um genau auf diese committete Konfiguration zu warten. Schreibvorgänge ohne X-Hypercall-Fence-Wait: 1 geben bewusst keinen Fence-Header zurück.

Test 7: Margin-Ablehnung​

Schritte:

  1. Platzieren Sie eine Order, die die Margin überschreitet
  2. Prüfen Sie, dass die Order mit dem Grund „Insufficient margin" abgelehnt wird
  3. Prüfen Sie, dass der Ablehnungsgrund die Werte für Anforderung, Equity und Fehlbetrag enthält
  4. Prüfen Sie den Order-Status: REJECTED

Erwartet: Order mit eindeutigem Grund abgelehnt

Test 8: Tier-Beschränkung​

Schritte:

  1. Verwenden Sie eine Wallet, deren Tier nur gedeckte Verkäufe erlaubt (prüfen Sie GET /risk/limits?wallet=...)
  2. Versuchen Sie, eine Verkaufsorder ohne Long-Position zu platzieren
  3. Prüfen Sie, dass die Order mit Tier-Grund abgelehnt wird
  4. Platzieren Sie eine Kauforder (sollte erfolgreich sein)
  5. Platzieren Sie eine Verkaufsorder zum Schließen (sollte erfolgreich sein)

Erwartet: Tier-Beschränkungen werden korrekt durchgesetzt

Test 9: WebSocket-Wiederverbindung​

Schritte:

  1. Verbinden Sie sich mit dem WebSocket
  2. Abonnieren Sie Kanäle
  3. Trennen Sie die WebSocket-Verbindung
  4. Verbinden Sie sich mit exponentiellem Backoff erneut
  5. Abonnieren Sie die Kanäle erneut
  6. Fragen Sie REST ab, um verpasste Updates nachzuholen

Erwartet: Wiederverbindung funktioniert, Zustand wiederhergestellt

Test 10: Portfolio-Abgleich​

Schritte:

  1. Platzieren Sie Orders und lassen Sie sie ausführen
  2. Prüfen Sie das Portfolio über GET /portfolio?wallet=...
  3. Prüfen Sie, dass die Positionen mit den Fills übereinstimmen
  4. Prüfen Sie, dass die Margin-Nutzung korrekt ist
  5. Gleichen Sie mit WebSocket-portfolio-Updates ab

Erwartet: Portfolio-Zustand korrekt, Abgleich erfolgreich

Produktionsbereitschaft​

Checkliste vor der Produktion​

  • Alle Integrationstests bestanden
  • Überwachung und Alarmierung konfiguriert
  • Kill Switch getestet
  • Notfallverfahren dokumentiert
  • Team in Incident Response geschult
  • Support-Kontakte festgelegt

Go-Live-Checkliste​

  • Zertifizierungstests mit kleiner Größe in der Produktion bestanden
  • Produktions-Endpunkte verifiziert
  • Überwachungs-Dashboards bereit
  • Alarmierung konfiguriert
  • Bereitschaftsplan des Teams festgelegt
  • Dokumentation geprüft

Referenzen​

Zuletzt aktualisiert am