Kaia RPC 엔드포인트 문서 | ERPC
Kaia RPC 엔드포인트 문서
ERPC를 Kaia RPC 엔드포인트로 사용하여 HTTP JSON-RPC 요청을 처리할 수 있습니다. Kaia RPC는 Global Edge Blockchain Infrastructure 내에 있는 ERPC의 RPC APIs 중 하나이며, API key는 ERPC Web Dashboard에서 관리할 수 있습니다.
Solana, Ethereum, Avalanche와 동일한 RPC key를 그대로 사용할 수 있습니다.
API key는
api-key 쿼리 매개변수로 전달하거나 Authorization: Bearer <YOUR_API_KEY>로 보내세요. 둘 다 있으면 쿼리 매개변수가 사용됩니다.엔드포인트
JSON-RPC 2.0 요청은 다음 주소로 HTTP POST로 전송합니다.
text
https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>https://edge.erpc.global/kaia?api-key=<YOUR_API_KEY>또는 다음 전용 호스트로 전송합니다.
text
https://kaia.erpc.global?api-key=<YOUR_API_KEY>https://kaia.erpc.global?api-key=<YOUR_API_KEY>/ 경로에서만 요청을 받습니다.예시
다음은 API key를 쿼리 매개변수에 넣은 HTTP 요청 예시입니다.
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"
}'다음은 API key를
Authorization 헤더에 넣어 같은 요청을 보내는 예시입니다.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는 ERPC Web Dashboard에서 발급받고 확인할 수 있습니다.
배치 요청
HTTP 요청당 1~100개 호출의 JSON-RPC 배치를 지원합니다. 각 호출에는 고유한
id가 필요하며, 배치 내에서 id 값이 중복되면 안 됩니다. 배치 내 각 호출은 개별 호출로 계량됩니다. 요청 본문은 최대 1 MiB까지 보낼 수 있습니다.사용량 측정
사용량은 token 단위로 계량되며, token 요금은 메서드에 따라 다를 수 있습니다. HTTP 배치 내 각 호출은 개별적으로 계량됩니다.
Free 요금제 제한
Free 요금제에서는 사용자의 계정이 10초당 요청 한 건을 보낼 수 있습니다. 이 제한은 엔드포인트별이 아니라 계정별로 집계되므로, 다른 체인으로 보낸 요청도 집계에 포함될 수 있습니다. 그보다 빨리 보낸 요청에는 HTTP
429로 응답하며, retry-after 헤더가 대기할 시간(초)을 알려 줍니다.Free 요금제에서는 JSON-RPC 호출을 두 개 이상 담은 요청에 HTTP
429로 응답하며, 그 요청의 호출은 하나도 전송되지 않습니다. 각 호출은 코드 -32041의 JSON-RPC 오류를 받습니다. 대신 이 호출들을 하나씩 보내세요.지원 메서드
이 엔드포인트는 다음 60개의 메서드를 네임스페이스별로 제공합니다.
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
목록에 없는 메서드 또는 경로에는 HTTP
400으로 응답합니다.응답 상태 코드
| HTTP 상태 | 의미 |
|---|---|
| 200 | 업스트림 JSON-RPC 응답. JSON-RPC 오류도 HTTP 200으로 반환됨. 요청의 id와 error.code는 유지되고, error.message는 ERPC upstream error이며, error.data는 반환되지 않음 |
| 400 | 지원 메서드 목록에 없는 메서드 또는 경로, 잘못된 JSON-RPC 요청, 빈 배치 또는 100개를 초과하는 배치, 배치 내 중복된 id, 1 MiB를 초과하는 본문 |
| 401 | API key가 없거나 유효하지 않거나, key에 설정된 IP 또는 Origin 제한을 충족하지 않음 |
| 405 | POST 이외의 요청 메서드 |
| 426 | WebSocket Upgrade가 요청됨. 이 엔드포인트는 HTTP만 지원함 |
| 429 | 속도 제한됨. 위의 Free 요금제 제한(10초당 요청 한 건 초과, 또는 한 요청에 호출 두 개 이상)도 포함됨. retry-after 헤더가 있으면 표시된 시간(초)만큼 대기 |
| 502 | 업스트림 요청을 완료할 수 없음: 업스트림 응답 실패, 8 MiB를 초과하는 응답, 또는 30초 이내 무응답 |
| 503 | 서비스를 일시적으로 사용할 수 없음 |
Kaia RPC method 및 문서
표준 method, 매개변수, 사양의 전체 목록은 공식 문서를 참고하세요.