Kaia RPC Endpoint Dokümantasyonu | ERPC
Kaia RPC Endpoint Dokümantasyonu
ERPC'yi HTTP JSON-RPC istekleri için Kaia RPC endpoint'iniz olarak kullanabilirsiniz. Kaia 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, Ethereum ve Avalanche ile aynı RPC key'i kullanabilirsiniz.
API key'inizi
api-key query parametresiyle iletin ya da Authorization: Bearer <YOUR_API_KEY> olarak gönderin. İkisi birlikte gönderilirse query parametresi kullanılır.Endpoints
JSON-RPC 2.0 isteklerini HTTP POST olarak şuraya gönderin:
text
https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>ya da özel host'a:
text
https://kaia.erpc.global?api-key=<YOUR_API_KEY>https://kaia.erpc.global?api-key=<YOUR_API_KEY>İstekler yalnızca
/ yolunda kabul edilir.Örnekler
Aşağıda, API key'in query parametresinde gönderildiği bir HTTP istek örneği yer alır.
bash
curl 'https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Aşağıda, API key'in
Authorization başlığında gönderildiği aynı istek yer alır.bash
curl 'https://edge.erpc.global/kaia' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/kaia' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'API key'inizi ERPC Web Dashboard üzerinden alabilir ve kontrol edebilirsiniz: ERPC Web Dashboard
Toplu İstekler
HTTP isteği başına 1 ile 100 arasında çağrı içeren JSON-RPC toplu istekleri desteklenir. Her çağrının kendine ait bir
id değeri olmalıdır ve bir toplu istek içinde id değerleri tekrar etmemelidir. Bir toplu istekteki her çağrı kendi başına bir çağrı olarak ücretlendirilir. İstek gövdesi en fazla 1 MiB olabilir.Kullanım Ücretlendirmesi
Kullanım token cinsinden ücretlendirilir ve token oranı yönteme göre değişebilir. Bir HTTP toplu isteğindeki her çağrı ayrı ayrı ücretlendirilir.
Free Plan Sınırları
Free planda hesabınız 10 saniyede bir istek gönderebilir. Sınır endpoint başına değil, hesap başına sayılır; bu nedenle başka bir zincire gönderilen bir istek de bu sınıra dahil edilebilir. Daha erken gönderilen bir istek HTTP
429 ile yanıtlanır ve retry-after başlığı bekleme süresini saniye cinsinden verir.Free planda, iki veya daha fazla JSON-RPC çağrısı içeren bir istek HTTP
429 ile yanıtlanır ve çağrılarının hiçbiri gönderilmez: her çağrı -32041 koduyla bir JSON-RPC hatası alır. Bunun yerine bu çağrıları tek tek gönderin.Desteklenen Yöntemler
Endpoint, ad alanlarına göre gruplanmış şu 60 yöntemi sunar.
eth_*(24):eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getProof,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_syncingkaia_*(22):kaia_blockNumber,kaia_call,kaia_chainId,kaia_estimateGas,kaia_feeHistory,kaia_gasPrice,kaia_getBalance,kaia_getBlockByHash,kaia_getBlockByNumber,kaia_getBlockTransactionCountByHash,kaia_getBlockTransactionCountByNumber,kaia_getCode,kaia_getProof,kaia_getStorageAt,kaia_getTransactionByBlockHashAndIndex,kaia_getTransactionByBlockNumberAndIndex,kaia_getTransactionByHash,kaia_getTransactionCount,kaia_getTransactionReceipt,kaia_maxPriorityFeePerGas,kaia_sendRawTransaction,kaia_syncingtrace_*(2):trace_block,trace_transactionweb3_*(2):web3_clientVersion,web3_sha3net_*(3):net_listening,net_peerCount,net_versiondebug_*(4):debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceCall,debug_traceTransactiontxpool_*(3):txpool_content,txpool_inspect,txpool_status
Listede olmayan bir yöntem veya yol HTTP
400 ile yanıtlanır.Yanıt Durum Kodları
| HTTP status | Anlamı |
|---|---|
| 200 | Upstream JSON-RPC yanıtı. JSON-RPC hataları da HTTP 200 ile döner: istekteki id ve error.code korunur, error.message değeri ERPC upstream error olur ve error.data döndürülmez. |
| 400 | Desteklenen Yöntemler listesinde olmayan bir yöntem veya yol, geçersiz bir JSON-RPC isteği, boş bir toplu istek veya 100'den fazla çağrı içeren bir toplu istek, bir toplu istekte yinelenen bir id ya da 1 MiB sınırını aşan bir gövde. |
| 401 | Eksik veya geçersiz API key ya da anahtar için tanımlanan IP veya Origin kısıtlamasının karşılanmaması. |
| 405 | POST dışında bir HTTP istek yöntemi. |
| 426 | WebSocket Upgrade istendi. Endpoint yalnızca HTTP üzerinden çalışır. |
| 429 | Hız sınırlaması uygulandı; yukarıdaki Free plan sınırları da buna dahildir: 10 saniyede birden fazla istek veya tek bir istekte iki ya da daha fazla çağrı. retry-after başlığı varsa, belirtilen saniye kadar bekleyin. |
| 502 | Upstream isteği tamamlanamadı: upstream başarısız bir yanıt döndürdü, yanıt 8 MiB sınırını aştı ya da 30 saniye içinde yanıt gelmedi. |
| 503 | Hizmet geçici olarak kullanılamıyor. |
Kaia RPC Yöntemleri ve Dokümantasyon
Tüm standart yöntemler, parametreler ve özellikler için lütfen resmi dokümantasyona bakın.