Ana içeriğe atla

​
Genel Bakış

OrbitFlare RPC düğümleri, JSON-RPC 2.0 spesifikasyonunu kullanarak HTTP isteklerini kabul eder. Bu API, veri sorgulamak ve işlemleri göndermek için Solana blok zinciriyle etkileşim kurmanıza olanak tanır.

​
İstek Formatı

JSON-RPC isteği yapmak için aşağıdaki özelliklere sahip bir HTTP POST isteği gönderin:
  • Endpoint: https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY
  • Başlık: Content-Type: application/json
  • Gövde: Şu alanları içeren JSON nesnesi:
AlanTürAçıklama
jsonrpcstring”2.0” olmalıdır
idstring/numberBenzersiz istek tanımlayıcısı
methodstringRPC metod adı
paramsarrayMetod parametrelerinin dizisi

​
Örnek İstek

curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
  ]
}'

​
Yanıt Formatı

Yanıtlar şunları içeren JSON nesneleri olacaktır:
AlanTürAçıklama
jsonrpcstringHer zaman “2.0”
idstring/numberİstek tanımlayıcısıyla eşleşir
resultçeşitliMetodun sonuç verisi
errorobjectHata ayrıntıları (varsa)

​
Onay Seviyesi (Commitment)

Birçok metod, verinin ne kadar onaylanmış olması gerektiğini belirlemek için bir commitment parametresini kabul eder:
  • processed: En son blok (en hızlı, onaylanmamış)
  • confirmed: Süper çoğunluk tarafından onaylanmış (hız ile kesinlik arasında denge)
  • finalized: Süper çoğunluk tarafından sonuçlandırılmış (en yavaş, tam onaylı)
Onay seviyesiyle örnek: 
curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    {"commitment": "finalized"}
  ]
}'

​
Toplu İstekler

Bir dizi istek nesnesi sağlayarak tek bir HTTP çağrısında birden fazla istek gönderebilirsiniz: 
curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBalance",
    "params": ["83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"]
  },
  {
    "jsonrpc": "2.0",
    "id": 2,
    "method": "getBlockHeight",
    "params": []
  }
]'

​
Ortak Türler

TürAçıklama
PubkeyBase-58 kodlu açık anahtar dizisi
HashBase-58 kodlu SHA-256 hash dizisi
SignatureBase-58 kodlu Ed25519 imzası
SlotTamsayı blok yüksekliği/slot numarası

​
Sağlık Kontrolü

Düğüm sağlığını bir GET isteğiyle kontrol edebilirsiniz: 
curl "https://fra.rpc.orbitflare.com/health?api_key=YOUR_LICENSE_KEY"
Olası yanıtlar:
  • ok: Düğüm sağlıklı ve güncel
  • behind { slots: number }: Düğüm N slot geride
  • error: Düğüm sağlıksız

​
Kullanılabilir Metodlar

Hesap & Program

  • getAccountInfo
  • getMultipleAccounts
  • getProgramAccounts
  • getMinimumBalanceForRentExemption

Bloklar & Slotlar

  • getBlock
  • getBlocks
  • getBlockHeight
  • getSlot
  • getSlotLeader

İşlemler

  • getTransaction
  • getSignatureStatuses
  • getSignaturesForAddress
  • sendTransaction
  • simulateTransaction

Token'lar

  • getTokenAccountBalance
  • getTokenAccountsByDelegate
  • getTokenAccountsByOwner
  • getTokenSupply

​
Hız Sınırları

Hız sınırları abonelik katmanına göre değişir. Plan başına kesin RPS ve TPS değerleri için Kimlik Doğrulama & Limitler sayfasına bakın.

​
En İyi Uygulamalar

  1. Uygun Onay Seviyelerini Kullanın
    • Arayüz güncellemeleri için processed kullanın
    • Çoğu işlem için confirmed kullanın
    • Kritik işlemler için finalized kullanın
  2. İstekleri Optimize Edin
    • Mümkün olduğunda toplu istekler kullanın
    • Uygun önbelleğe alma uygulayın
    • Uygun yoklama aralıklarını seçin
  3. Hataları Yönetin
    • Uygun hata yönetimi uygulayın
    • Yeniden denemeler için üstel geri çekilme kullanın
    • İstek başarısızlıklarını izleyin

​
Ayrıca Bakınız

Kimlik Doğrulama & Limitler

API anahtarı kurulumu, endpoint formatları, hız sınırları ve bağlantı limitleri.

Hata Kodları

HTTP durum kodları, JSON-RPC hataları ve bunların nasıl yönetileceği.

WebSocket API

Hesaplar, slotlar, günlükler ve daha fazlası için gerçek zamanlı abonelikler.

​
Destek

RPC hizmetimiz hakkında teknik destek veya sorularınız için: