Runbook'lar
Tam 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ı
- Staging uç noktaları test edildi
- Üretim (production) uç noktaları yapılandırıldı (mevcut olduğunda)
- Health check uç noktası yanıt veriyor
- WebSocket bağlantısı kararlı
Kimlik Doğrulama
- EIP-712 imzalama çalışıyor
- Agent yetkilendirmesi yapılandırıldı (geçerliyse)
- Nonce yönetimi uygulandı
- İmza doğrulama test edildi
Kotasyon Sistemi
- Toplu emir gönderimi test edildi
- Emir yaşam döngüsü mutabakatı doğrulandı
- Gerçekleşme (fill) takibi uygulandı
- İptal işlevi test edildi
Risk Kontrolleri
- MMP yapılandırıldı ve test edildi
- Teminat modeli anlaşıldı
- Kademe (tier) kısıtlamaları doğrulandı
- Portföy izleme uygulandı
İzleme
- WebSocket akışlarına abone olundu
- Emir/gerçekleşme mutabakatı otomatikleştirildi
- Health check'ler yapılandırıldı
- Uyarı sistemi kuruldu
Kill Switch
- Tüm emirleri iptal etme yeteneği
- Anında bağlantıyı kesme yeteneği
- Acil durum prosedürleri belgelendi
Riskten Korunma (Hedging)
- Hyperliquid perp'lerle entegrasyon doğrulandı
- Delta hedge stratejisi uygulandı
- Perp teminat hesaplaması anlaşıldı
Uzlaşma
- Vade sonu işleme testi yapıldı
- Pozisyon uzlaşması doğrulandı
- Referans fiyat kaynağı anlaşıldı
Entegrasyon Sertifikasyon Testleri
Test 1: Emir Gönderimi
Adımlar:
POST /orderile tek emir gönderin- Emir durumunu doğrulayın:
ACKED→OPEN - Emrin
GET /orders?wallet=...içinde göründüğünü kontrol edin - WebSocket
order_updatesmesajı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:
POST /bulk_orderile 10 emir gönderin- Tüm emirlerin kabul edildiğini doğrulayın
- Emir durumlarını REST ve WS üzerinden kontrol edin
- İ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:
- Gerçekleşecek bir emir gönderin
- WebSocket
fillskanalını izleyin - Gerçekleşmenin doğru
order_idile alındığını doğrulayın - Gerçekleşmenin
GET /fills?wallet=...içinde göründüğünü kontrol edin - Emir durumunun
FILLEDolarak 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:
- Kısmen gerçekleşecek bir emir gönderin
- WebSocket
fillskanalını izleyin (order_updatesdeğil) - Kısmi gerçekleşmenin alındığını doğrulayın
- Gerçekleşen büyüklüğü hesaplamak için gerçekleşmeleri
order_idbazında toplayın - Emir durumunun
OPENolarak kaldığını doğrulayın (WS üzerindePARTIALLY_FILLEDdeğil)
Beklenen: Kısmi gerçekleşmeler fills kanalı üzerinden takip edildi, emir durumu doğru
Test 5: Emir İptali
Adımlar:
POST /orderile emir gönderinDELETE /orderile emri iptal edin- Emir durumunu doğrulayın:
CANCELED - WebSocket
order_updatesmesajının alındığını kontrol edin
Beklenen: Emir başarıyla iptal edildi, durum güncellemeleri alındı
Test 6: MMP Tetikleme
Adımlar:
POST /mmp-configile MMP'yi yapılandırın- MMP etkin emirler gönderin
- Limitleri aşarak MMP'yi tetikleyin
- Emirlerin MMP nedeniyle iptal edildiğini doğrulayın
- Diğer MMP etkin emirlerin de iptal edildiğini kontrol edin
Beklenen: MMP doğru şekilde tetiklendi, emirler iptal edildi
Test 7: Teminat Reddi
Adımlar:
- Teminatı aşan bir emir gönderin
- Emrin "Insufficient margin" nedeniyle reddedildiğini doğrulayın
- Ret nedeninin gereken, mevcut ve eksik değerleri içerdiğini kontrol edin
- Emir durumunu doğrulayın:
REJECTED
Beklenen: Emir net bir nedenle reddedildi
Test 8: Kademe Kısıtlaması
Adımlar:
- Yalnızca uzun pozisyon (long-only) erişimi için yapılandırılmış bir cüzdan kullanın
- Uzun pozisyon olmadan satış emri göndermeyi deneyin
- Emrin kademe nedeniyle reddedildiğini doğrulayın
- Alış emri gönderin (başarılı olmalı)
- Kapatmak için satış emri gönderin (başarılı olmalı)
Beklenen: Kademe kısıtlamaları doğru şekilde uygulandı
Test 9: WebSocket Yeniden Bağlanma
Adımlar:
- WebSocket'e bağlanın
- Kanallara abone olun
- WebSocket bağlantısını kesin
- Üstel geri çekilme (exponential backoff) ile yeniden bağlanın
- Kanallara yeniden abone olun
- 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:
- Emir gönderin ve gerçekleştirin
GET /portfolio?wallet=...ile portföyü kontrol edin- Pozisyonların gerçekleşmelerle eşleştiğini doğrulayın
- Teminat kullanımının doğru olduğunu kontrol edin
- WebSocket
portfoliogüncellemeleriyle mutabakat sağlayın
Beklenen: Portföy durumu doğru, mutabakat başarılı
Üretim Hazırlığı
Üretim Öncesi Kontrol Listesi
- Tüm entegrasyon testleri geçildi
- İzleme ve uyarı sistemi yapılandırıldı
- Kill switch test edildi
- Acil durum prosedürleri belgelendi
- Ekip olay müdahalesi konusunda eğitildi
- Destek iletişim kişileri belirlendi
Canlıya Geçiş Kontrol Listesi
- Staging ortamı tamamen test edildi
- Üretim uç noktaları doğrulandı
- İzleme panoları hazır
- Uyarı sistemi yapılandırıldı
- Ekip nöbet çizelgesi oluşturuldu
- Dokümantasyon gözden geçirildi
Referanslar
- Hızlı başlangıç: Quickstart
- API referansı: REST API
- Hatalar ve retler: Errors
- Olay müdahale kılavuzu: Incidents