Avalanche RPC Endpoint Dokümantasyonu | ERPC

Avalanche RPC Endpoint Dokümantasyonu

ERPC'yi HTTP JSON-RPC istekleri ve WebSocket abonelikleri için Avalanche RPC endpoint'iniz olarak kullanabilirsiniz. Avalanche RPC, Global Edge Blockchain Infrastructure'ımız kapsamındaki ERPC'nin RPC APIs'inin bir parçasıdır ve API key, ERPC Web Dashboard üzerinden yönetilebilir.
Solana ve Ethereum ile aynı RPC key'i kullanabilirsiniz.
Lütfen API key'inizi api-key parametresine ekleyin.

Endpoints

JSON-RPC 2.0 isteklerini HTTP POST olarak şuraya gönderin:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Abonelikler için WebSocket üzerinden şuraya bağlanın:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Upstream API, tam JSON-RPC yöntem adına göre seçilir; bu nedenle C-Chain, X-Chain ve P-Chain çağrılarının tümü aynı endpoint'e gider.

Örnekler

Aşağıda bir HTTP istek örneği yer alır.
bash
curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Aşağıda bir WebSocket abonelik örneği yer alır.
bash
wscat -c "wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}
API key'inizi ERPC Web Dashboard üzerinden alabilir ve kontrol edebilirsiniz: ERPC Web Dashboard

Toplu İstekler

Bir HTTP isteği başına 256'ya kadar JSON-RPC toplu isteği C-Chain EVM yöntemleri için desteklenir ve JSON-RPC notifications da kabul edilir. Yerel Avalanche ad alanları — avax.*, avm.*, platform.*, proposervm.* ve info.upgrades — tek tek çağrılır. Bir toplu istekteki her çağrı kendi başına bir çağrı olarak ücretlendirilir.

Kullanım Ücretlendirmesi

Kullanım, her JSON-RPC çağrısı için sabit bir oranda token cinsinden ücretlendirilir — bu oran her Avalanche RPC yöntemi için aynıdır. Bir HTTP toplu isteğindeki her girdi ve bir WebSocket bağlantısı üzerinden gönderilen her JSON-RPC çağrısı ayrı ayrı ücretlendirilir. Güncel çağrı başına token oranını Avalanche RPC API Referansı sayfasında kontrol edebilirsiniz.

Desteklenen Yöntemler

Endpoint, C-Chain EVM JSON-RPC yöntem ailelerini kapsar — eth_*, net_*, txpool_* ve web3_* — hesap ve blok okumaları (eth_getBalance, eth_getBlockByNumber, eth_getLogs), işlem akışı (eth_sendRawTransaction, eth_getTransactionReceipt), ücret verileri (eth_gasPrice, eth_maxPriorityFeePerGas), çağrı simülasyonu (eth_call, eth_estimateGas), filtreler (eth_newFilter, eth_getFilterChanges), txpool incelemesi (txpool_status, txpool_content), C-Chain uzantıları (eth_getAssetBalance, eth_baseFee) ve WebSocket abonelikleri (eth_subscribe, eth_unsubscribe) dahil.
Yerel Avalanche API'leri aynı endpoint'ten sunulur: C-Chain atomik işlemleri (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), X-Chain (avm.getBalance, avm.getTx, avm.issueTx), P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight) ve ağ yükseltme zamanlamaları (info.upgrades).
İstek ve yanıt biçimleriyle birlikte tam yöntem listesi için bkz. Avalanche RPC API Referansı.

Yanıt Durum Kodları

HTTP statusAnlamı
200Upstream JSON-RPC yanıtı.
400Eksik API key veya geçersiz JSON-RPC isteği.
401Yetkisiz API key.
429Hız sınırlaması uygulandı. retry-after başlığı bekleme süresini saniye cinsinden verir.
502Upstream RPC isteği tamamlanamadı.
503Hizmet geçici olarak kullanılamıyor.
Yayınlanan katalog dışındaki bir JSON-RPC yöntemi HTTP 400 ve JSON-RPC hatası -32601 (Method not found) ile yanıtlanır ve 256'dan fazla çağrı içeren bir toplu istek HTTP 400 ile yanıtlanır.
WebSocket bağlantıları, yukarıdaki kodlara ek olarak 101 (protokol yükseltmesi kabul edildi) ve 426 (WebSocket Upgrade handshake gereklidir) kodlarını kullanır.

Avalanche RPC Yöntemleri ve Dokümantasyon

Tüm standart yöntemler, parametreler ve abonelik özellikleri için lütfen resmi dokümantasyona bakın. Hem HTTP hem de WebSocket kullanımını kapsar.