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>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>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"
}'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"]}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 status | Anlamı |
|---|---|
| 200 | Upstream JSON-RPC yanıtı. |
| 400 | Eksik API key veya geçersiz JSON-RPC isteği. |
| 401 | Yetkisiz API key. |
| 429 | Hız sınırlaması uygulandı. retry-after başlığı bekleme süresini saniye cinsinden verir. |
| 502 | Upstream RPC isteği tamamlanamadı. |
| 503 | Hizmet 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.
- C-Chain (EVM JSON-RPC): https://build.avax.network/docs/rpcs/c-chain
- X-Chain (
avm.*): https://build.avax.network/docs/rpcs/x-chain - P-Chain (
platform.*): https://build.avax.network/docs/rpcs/p-chain






