ERPC

Avalanche RPC 엔드포인트 문서 | ERPC

Avalanche RPC 엔드포인트 문서

ERPC를 Avalanche RPC 엔드포인트로 사용하여 HTTP JSON-RPC 요청과 WebSocket 구독을 처리할 수 있습니다. Avalanche RPC는 Global Edge Blockchain Infrastructure 내에 있는 ERPC의 RPC APIs 중 하나이며, API key는 ERPC Web Dashboard에서 관리할 수 있습니다.
Solana 및 Ethereum과 동일한 RPC key를 그대로 사용할 수 있습니다.
'api-key' 매개변수에 API key를 추가해 주세요.

엔드포인트

JSON-RPC 2.0 요청은 다음 주소로 HTTP POST로 전송합니다.
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
구독의 경우 다음 주소에 WebSocket으로 연결합니다.
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
업스트림 API는 정확한 JSON-RPC 메서드 이름에 따라 선택되므로, C-Chain, X-Chain, P-Chain 호출은 모두 동일한 엔드포인트로 전달됩니다.

예시

다음은 HTTP 요청 예시입니다.
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"
}'
다음은 WebSocket 구독 예시입니다.
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는 ERPC Web Dashboard에서 발급받고 확인할 수 있습니다.

배치 요청

HTTP 요청당 최대 256개의 JSON-RPC 배치를 C-Chain의 EVM 메서드에 대해 지원하며, JSON-RPC notification도 허용됩니다. Avalanche의 네이티브 네임스페이스 — avax.*, avm.*, platform.*, proposervm.*, info.upgrades — 는 한 건씩 호출됩니다. 배치 내 각 호출은 개별 호출로 계량됩니다.

사용량 측정

사용량은 JSON-RPC 호출 1회당 균일한 요금으로 token 단위로 계량되며, 모든 Avalanche RPC 메서드에 동일한 요금이 적용됩니다. HTTP 배치의 각 항목과 WebSocket 연결을 통해 전송된 각 JSON-RPC 호출은 개별적으로 계량됩니다. 현재 호출당 token 요금은 Avalanche RPC API 참조에서 확인할 수 있습니다.

지원 메서드

이 엔드포인트는 C-Chain EVM JSON-RPC 메서드 패밀리 — eth_*, net_*, txpool_*, web3_* — 를 지원합니다. 계정 및 블록 조회(eth_getBalance, eth_getBlockByNumber, eth_getLogs), 트랜잭션 처리(eth_sendRawTransaction, eth_getTransactionReceipt), 수수료 데이터(eth_gasPrice, eth_maxPriorityFeePerGas), 호출 시뮬레이션(eth_call, eth_estimateGas), 필터(eth_newFilter, eth_getFilterChanges), txpool 조회(txpool_status, txpool_content), C-Chain 확장(eth_getAssetBalance, eth_baseFee), WebSocket 구독(eth_subscribe, eth_unsubscribe)이 포함됩니다.
Avalanche의 네이티브 API도 동일한 엔드포인트에서 제공됩니다. C-Chain의 원자적 연산(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), 네트워크 업그레이드 시점(info.upgrades)이 여기에 포함됩니다.
요청 및 응답 형식을 포함한 전체 메서드 목록은 Avalanche RPC API 참조를 참고하세요.

응답 상태 코드

HTTP 상태의미
200업스트림 JSON-RPC 응답
400API key가 없거나 JSON-RPC 요청이 잘못됨
401인증되지 않은 API key
429속도 제한됨. retry-after 헤더가 대기 시간(초)을 알려줌
502업스트림 RPC 요청을 완료할 수 없음
503서비스를 일시적으로 사용할 수 없음
공개된 목록에 없는 JSON-RPC 메서드는 HTTP 400과 JSON-RPC 오류 -32601(Method not found)로 응답되며, 256개를 초과하는 배치는 HTTP 400으로 응답됩니다.
WebSocket 연결에서는 위의 코드 외에 101(프로토콜 업그레이드 승인됨)과 426(WebSocket Upgrade 핸드셰이크 필요)이 사용됩니다.

Avalanche RPC method 및 문서

표준 method, 매개변수, 구독 사양의 전체 목록은 공식 문서를 참고하세요. HTTP와 WebSocket 사용 방법을 모두 다룹니다.

이전

Avalanche RPC 빠른 시작 | ERPC

다음

SLV AI