Skip to main content

Kurulum

İstemciyi oluşturma

Tüm seçeneklerin ayarlı olduğu bir istemci:
Minimal kurulum:

Builder yöntemleri

.url(url) — Birincil gRPC uç noktası. ORBITFLARE_GRPC_URL ortam değişkenine düşer.
.urls(&[...]) — Tek çağrıda birincil + yedekler. İlk eleman birincildir.
.fallback_url(url) / .fallback_urls(&[...]) — Yedek uç noktalar ekler. Bağlantı hatasında SDK aralarında döner.
.retry(policy) — Yeniden bağlanma geri çekilmesini denetler. Bağlantı koptuğunda SDK önce initial_delay bekler, sonra her denemede gecikmeyi iki katına çıkarır (max_delay ile sınırlı). max_attempts değerini 0 yaparak sonsuz yeniden deneme ayarlayın. Varsayılan: 100 ms başlangıç, 30 sn üst sınır, 2x çarpan, sonsuz.
.timeout_secs(n) — İstek başına gRPC zaman aşımı. Varsayılan: 30.
.keepalive_secs(n) — TCP keepalive aralığı. İşletim sistemi bu aralıkta ölü bağlantıları TCP düzeyinde tespit etmek için probe gönderir. Varsayılan: 60.
.ping_interval_secs(n) — SDK’nın sunucuya proto düzeyinde Ping gönderme sıklığı. Sunucunun Pong ile yanıt vermesi beklenir. Varsayılan: 10.
.max_missed_pongs(n) — SDK’nın bağlantıyı ölü sayıp yeniden bağlanmadan önce ardışık kaç ping’in yanıtsız kalabileceği. Varsayılan: 3. Varsayılanlarla ölü bağlantı yaklaşık 30 saniye içinde tespit edilir.
.channel_capacity(n) — Arka plan görevi ile kodunuz arasındaki sınırlı kanal. Olayları tüketmek yavaşsa ve bu dolarsa arka plan görevi sınırsız bellek yemek yerine bloklanır. Varsayılan: 4096.

YAML yapılandırması yazma

İstediğiniz filtrelerle bir YAML dosyası oluşturun:

YAML filtre referansı

transactions — her giriş adlı bir filtredir. Bir işlem account_include adreslerinden herhangi birini içeriyorsa eşleşir. account_exclude eşleşmeleri çıkarır. account_required listelenen tüm adreslerin bulunmasını gerektirir. vote ve failed işlem tipine göre filtreler. accounts — adresle belirli hesapları izleyin veya owner ile bir programa ait tüm hesapları izleyin. slots — slot güncellemelerine abone olun. filter_by_commitment yalnızca taahhüt düzeminizdeki güncellemeleri gönderir. commitment"processed", "confirmed" veya "finalized". Varsayılan: "confirmed". YAML ${ENV_VAR} genişletmesini destekler:

Olaylara abone olma ve okuma

YAML’dan

Programatik olarak

Çalışma zamanında oluşturulan dinamik filtreler için:

Akışı okuma

Hem subscribe_yaml hem subscribe bir GeyserStream döndürür. Sonraki olay için .next() çağırın:
stream.next() bir olay gelene kadar bloklar. Akış kapandığında None döner. Her olay bir Resulttır — Err, tüm yeniden denemeler tükendi ve bağlantı kalıcı olarak gitti anlamına gelir. Pong iletileri dahili tüketilir ve akışınızda asla görünmez.

Kapatma

Arka plan görevini anında durdurur. Ya da akışı düşürün.

Birden çok akış

Tek istemci aynı anda birçok akış çalıştırabilir. Her biri kendi arka plan bağlantısını alır:
Uç nokta sağlık durumunu paylaşırlar — bir akış başarısız bir uç noktayı karantinaya alırsa diğerleri bir sonraki yeniden bağlanmada onu atlar. Ancak bağlantıları ve yaşam döngüleri tamamen bağımsızdır. Mevcut bir akıştan gelen veriye dayalı olarak da dahil olmak üzere istediğiniz zaman yeni akışlar başlatabilirsiniz.

Tam örnek

pump.fun işlemlerini izleyen, imzayı çözen ve her biri için bir özet yazdıran bir akış.
Bu grpc.yml ile: