Ana içeriğe atla

Mevcut Uç Noktalar

Jetstream, tüm OrbitFlare bölgelerinde kullanılabilir. En düşük gecikme için altyapınıza en yakın bölgeye bağlanın.
Jetstream, gRPC bağlantıları için düz http:// kullanır (https:// değil). gRPC, HTTP/2 üzerinde kendi taşıma güvenliği müzakeresini kullanır. https:// yalnızca özel düğümünüz bunu açıkça gerektiriyorsa kullanın.

Protocol Buffer Belirtimi

Bu belge, OrbitFlare Jetstream tarafından kullanılan Protocol Buffer (protobuf) belirtimini özetlemektedir. Tam belirtim GitHub depomuzdaki belgede bulunabilir.

Hizmet Tanımı

İstek Mesajları

SubscribeRequest

Veri güncellemelerine abone olmak için ana istek mesajı:

İşlem Filtreleme

Hesap Filtreleme

Ping İsteği

Yanıt Mesajları

SubscribeUpdate

Güncellemeleri içeren ana yanıt mesajı:

İşlem Güncellemesi

Hesap Güncellemesi

Ping/Pong Güncellemeleri

Paylaşılan Türler

Ayrıştırılmış Talimat Desteği

Ayrıştırılmış İstek

Ayrıştırılmış İşlem Güncellemesi

Talimat Türleri

Akışsız Metotlar

Protokolü Kullanma

Jetstream için bir istemci uygularken şunları yapmanız gerekecektir:
  1. Protobuf tanımından istemci kodu oluşturma
  2. Veri akışı için Subscribe RPC metodunu uygulama
  3. Ayrıştırılmış talimat desteği için SubscribeParsed kullanma
  4. Bağlantı sağlık kontrolleri için Ping/Pong kullanma
  5. Sunucu uyumluluğunu kontrol etmek için GetVersion kullanma
  6. Farklı türdeki güncellemeleri işleme (işlemler, hesaplar, pong’lar)

Kod Oluşturma

TypeScript/JavaScript için:
Rust için:

En İyi Uygulamalar

  1. Sürüm Uyumluluğu
    • Protokol uyumluluğunu kontrol etmek için GetVersion kullanın
    • Beta sürümlerindeki kırıcı değişiklikler için izleyin
    • Yükseltme yaparken kapsamlı test yapın
  2. Hata İşleme
    • Tüm mesaj türleri için uygun hata işleme uygulayın
    • Bağlantı hatalarını zarif bir şekilde yönetin
    • İşlemeden önce mesaj alanlarını doğrulayın
  3. Bağlantı Yönetimi
    • Bağlantı sağlık kontrolleri için Ping/Pong kullanın
    • Otomatik yeniden bağlanma mantığı uygulayın
    • Uygun zaman aşımı değerleri belirleyin
  4. Performans
    • Gereksiz veriyi en aza indirmek için uygun filtreler kullanın
    • Büyük veri kümeleri için hesap filtrelemesini düşünün
    • Özellikle hesap aboneliklerinde kaynak kullanımını izleyin
    • Gerektiğinde ayrıştırılmış talimat desteği için SubscribeParsed kullanın

Ayrıca Bakınız

Jetstream Genel Bakış

Başlangıç kılavuzu, örnekler ve filtreleme belgeleri.

Değişiklik Günlüğü

Sürüm geçmişi ve protokol güncellemeleri.

Destek

Protokol belirtimi veya uygulama ayrıntıları hakkındaki teknik sorularınız için GitHub depomuzu ziyaret edin veya Discord topluluğumuza katılın.