Runbook'lar

Eksiksiz masa hazırlık kontrol listesi ve entegrasyon sertifikasyon testleri.

Masa Hazırlık Kontrol Listesi

Canlıya geçmeden önce şunları doğrulayın:

API Bağlantısı

• Üretim uç noktaları yapılandırıldı
• Sağlık kontrolü uç noktası yanıt veriyor
• WebSocket bağlantısı kararlı

Kimlik Doğrulama

• EIP-712 imzalama çalışıyor
• Agent yetkilendirmesi yapılandırıldı (varsa)
• Nonce yönetimi uygulandı
• İmza doğrulaması test edildi

Kotasyon Sistemi

• Toplu emir gönderimi test edildi
• Emir yaşam döngüsü mutabakatı doğrulandı
• Gerçekleşme takibi uygulandı
• İptal işlevi test edildi

Risk Kontrolleri

• MMP yapılandırıldı ve test edildi
• Teminat modeli anlaşıldı
• Seviye kısıtlamaları doğrulandı
• Portföy izleme uygulandı

İzleme

• WebSocket akışlarına abone olundu
• Emir/gerçekleşme mutabakatı otomatikleştirildi
• Sağlık kontrolleri yapılandırıldı
• Uyarı mekanizması kuruldu

Acil Durdurma (Kill Switch)

• Tüm emirleri iptal edebilme
• Bağlantıyı anında kesebilme
• Acil durum prosedürleri belgelendi

Riskten Korunma (Hedge)

• Hyperliquid perp entegrasyonu doğrulandı
• Delta hedge stratejisi uygulandı
• Perp teminat hesaplaması anlaşıldı

Uzlaşma

• Vade sonu işleme test edildi
• Pozisyon uzlaşması doğrulandı
• Referans fiyat kaynağı anlaşıldı

Entegrasyon Sertifikasyon Testleri

Test 1: Emir Gönderimi

Adımlar:

1. POST /order ile tek bir emir gönderin
2. Emir yanıt durumunun ACKED veya OPEN olduğunu doğrulayın
3. Emrin GET /orders?wallet=... içinde göründüğünü kontrol edin
4. WebSocket order_updates mesajının alındığını doğrulayın

Beklenen: Emir başarıyla gönderildi, durum güncellemeleri alındı

Test 2: Toplu Emir Gönderimi

Adımlar:

1. POST /bulk_order ile 10 emir gönderin
2. Tüm emirlerin kabul edildiğini doğrulayın
3. Emir durumlarını REST ve WS üzerinden kontrol edin
4. İmza/kimlik doğrulama hatası olmadığını doğrulayın

Beklenen: Tüm emirler başarıyla gönderildi

Test 3: Gerçekleşme Takibi

Adımlar:

1. Gerçekleşecek bir emir gönderin
2. WebSocket fills kanalını izleyin
3. Gerçekleşmenin doğru order_id ile alındığını doğrulayın
4. Gerçekleşmenin GET /fills?wallet=... içinde göründüğünü kontrol edin
5. Emir durumunun FILLED olarak güncellendiğini doğrulayın

Beklenen: Gerçekleşmeler doğru takip edildi, emir durumu güncellendi

Test 4: Kısmi Gerçekleşme Takibi

Adımlar:

1. Kısmen gerçekleşecek bir emir gönderin
2. WebSocket fills ve order_updates kanallarını izleyin
3. Kısmi gerçekleşmenin fills üzerinden geldiğini doğrulayın
4. order_updates mesajının kümülatif filled_size ile PARTIALLY_FILLED bildirdiğini doğrulayın
5. Gerçekleşmeleri order_id bazında toplayın ve toplamın filled_size değerine eşit olduğunu kontrol edin

Beklenen: fills üzerinde gerçekleşme başına miktarlar, order_updates üzerinde kümülatif gerçekleşen büyüklük

Test 5: Emir İptali

Adımlar:

1. POST /order ile emir gönderin
2. DELETE /order ile emri iptal edin
3. Emir durumunu doğrulayın: CANCELED
4. WebSocket order_updates mesajının alındığını kontrol edin

Beklenen: Emir başarıyla iptal edildi, durum güncellemeleri alındı

Test 6: MMP Tetiklenmesi

Adımlar:

1. İmzalı POST /mmp-config ile MMP'yi yapılandırın. İstemci projeksiyonu hemen okuyacaksa X-Hypercall-Fence-Wait: 1 gönderin ve dönen X-Hypercall-Fence değerini saklayın.
2. MMP etkin emirler gönderin
3. Limitleri aşarak MMP'yi tetikleyin
4. Emirlerin MMP gerekçesiyle iptal edildiğini doğrulayın
5. Diğer MMP etkin emirlerin de iptal edildiğini kontrol edin

Beklenen: MMP doğru şekilde tetiklendi, emirler iptal edildi

MMP yapılandırma okumaları da kimlik doğrulama gerektirir. GetMmpConfig imzalayın ve vade sonunu ve imzayı X-Hypercall-Expires-At-Ms ve X-Hypercall-Signature başlıkları olarak gönderin. Tam olarak o commit edilmiş yapılandırmayı beklemek için yazma yanıtındaki X-Hypercall-Fence değerini bu GET isteğinde geri gönderin. X-Hypercall-Fence-Wait: 1 içermeyen yazma istekleri bilinçli olarak fence başlığı döndürmez.

Test 7: Teminat Reddi

Adımlar:

1. Teminatı aşan bir emir gönderin
2. Emrin "Insufficient margin" gerekçesiyle reddedildiğini doğrulayın
3. Red gerekçesinin gereken, özkaynak ve açık değerlerini içerdiğini kontrol edin
4. Emir durumunu doğrulayın: REJECTED

Beklenen: Emir açık bir gerekçeyle reddedildi

Test 8: Seviye Kısıtlaması

Adımlar:

1. Seviyesi yalnızca karşılıklı (covered) satışlara izin veren bir cüzdan kullanın (GET /risk/limits?wallet=... ile kontrol edin)
2. Long pozisyon olmadan satış emri göndermeyi deneyin
3. Emrin seviye gerekçesiyle reddedildiğini doğrulayın
4. Alış emri gönderin (başarılı olmalı)
5. Kapatmak için satış emri gönderin (başarılı olmalı)

Beklenen: Seviye kısıtlamaları doğru şekilde uygulandı

Test 9: WebSocket Yeniden Bağlanma

Adımlar:

1. WebSocket'e bağlanın
2. Kanallara abone olun
3. WebSocket bağlantısını kesin
4. Üstel geri çekilme (exponential backoff) ile yeniden bağlanın
5. Kanallara yeniden abone olun
6. Kaçırılan güncellemeleri yakalamak için REST'i sorgulayın

Beklenen: Yeniden bağlanma çalışıyor, durum kurtarıldı

Test 10: Portföy Mutabakatı

Adımlar:

1. Emir gönderin ve gerçekleştirin
2. Portföyü GET /portfolio?wallet=... ile kontrol edin
3. Pozisyonların gerçekleşmelerle eşleştiğini doğrulayın
4. Teminat kullanımının doğru olduğunu kontrol edin
5. WebSocket portfolio güncellemeleriyle mutabakat yapın

Beklenen: Portföy durumu doğru, mutabakat başarılı

Üretime Hazırlık

Üretim Öncesi Kontrol Listesi

• Tüm entegrasyon testleri geçti
• İzleme ve uyarı mekanizması yapılandırıldı
• Acil durdurma test edildi
• Acil durum prosedürleri belgelendi
• Ekip olay müdahalesi konusunda eğitildi
• Destek irtibat kişileri belirlendi

Canlıya Geçiş Kontrol Listesi

• Sertifikasyon testleri üretimde küçük büyüklükle geçti
• Üretim uç noktaları doğrulandı
• İzleme panoları hazır
• Uyarı mekanizması yapılandırıldı
• Ekip nöbet çizelgesi oluşturuldu
• Dokümantasyon gözden geçirildi

Referanslar

• Hızlı başlangıç: Hızlı Başlangıç
• API referansı: REST API
• Hatalar ve redler: Hatalar
• Olay müdahale kılavuzu: Olaylar