Kurulum
--features "ws grpc".
Neler dahil
| Hizmet | Ne yapar |
|---|---|
| RPC | Yaygın Solana yöntemleri için tiplenmiş yardımcılar ve ham kaçış noktaları içeren JSON-RPC istemcisi |
| WebSocket | Yeniden bağlanmada otomatik yeniden abonelik ile hesaplar, günlükler, slotlar, imzalar |
| gRPC (Yellowstone) | İşlemler, hesaplar, slotlar ve bloklar için Yellowstone Geyser akışı. YAML yapılandırması veya programatik filtreler |
| JetStream | gRPC akışları olarak OrbitFlare’ın çözümlenmiş shred’leri. Yellowstone ile aynı istemci deseni, farklı proto |
Ortam değişkenleri
Uç noktaları açıkça geçmezseniz SDK ortamdan okur. Ajan tarafından üretilen kod için önerilen desendir: ajan URL veya anahtarları sabitlemek zorunda kalmaz, aynı ikili bölgeler ve ağlar arasında çalışır.| Değişken | Kullanan | Amaç |
|---|---|---|
ORBITFLARE_LICENSE_KEY | RPC, WebSocket | Uç nokta URL’lerine eklenen API anahtarı |
ORBITFLARE_RPC_URL | RPC | .url() çağrılmazsa varsayılan uç nokta |
ORBITFLARE_WS_URL | WebSocket | .url() çağrılmazsa varsayılan uç nokta |
ORBITFLARE_GRPC_URL | gRPC | .url() çağrılmazsa varsayılan uç nokta |
ORBITFLARE_JETSTREAM_URL | JetStream | .url() çağrılmazsa varsayılan uç nokta |
Hızlı örnek
Uç noktasını ortamdan okuyan ve bakiyeyi yeniden deneme / yedek uç nokta ile otomatik sorgulayan minimal bir RPC ajanı:Yellowstone gRPC ile akış
subscribe_yaml filtreleri bir YAML yapılandırmasından okur; programatik filtreler için bunun yerine client.subscribe(SubscribeRequest { .. }) kullanın. Jetstream istemcisi bu deseni yansıtır. GeyserClientBuilder yerine JetstreamClientBuilder koyun.
Ham HTTP yerine SDK kullanma nedenleri
Ajan tarafından yazılan üretim kodunda SDK, yanlış yapılması kolay çapraz kesen kaygıları halleder:- yapılandırılabilir üstel geri çekilme ile yeniden denemeler
- Çok bölgeli yedek uç nokta: birincil başarısız olunca yedekler sırayla
- Kimlik enjeksiyonu: lisans anahtarı her isteğe eklenir, uç noktada saklanmaz
- WebSocket yeniden bağlanma: abonelikler kopma sonrası otomatik yenilenir
- gRPC kanal yönetimi: keepalive, yeniden bağlanma, geri çekilme
- Tiplenmiş yanıtlar: yaygın yöntemler Rust yapılarına ayrıştırılır; geri kalanı için ham kaçışlar
Kaynak
- SDK deposu: github.com/orbitflare/orbitflare-sdk-rs
- Tam referans: SDK genel bakış, RPC, WebSocket, gRPC, Jetstream