Avalanche RPC 빠른 시작 | ERPC

Avalanche RPC 빠른 시작

이 가이드는 처음부터 ERPC로 첫 Avalanche JSON-RPC 응답을 받기까지의 과정을 안내합니다.

1. API key 발급받기

API key는 ERPC Web Dashboard에서 발급받고 확인할 수 있습니다.
이미 Solana 또는 Ethereum용으로 ERPC를 사용 중이신가요? 동일한 RPC key를 그대로 사용할 수 있습니다.

2. 첫 요청 보내기

api-key 매개변수에 API key를 지정하여 JSON-RPC 2.0 요청을 HTTP POST로 전송합니다.
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"
}'
응답에는 최신 C-Chain 블록 번호가 16진수로 반환됩니다.
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
엔드포인트가 어떤 체인을 제공하는지는 eth_chainId로 확인할 수 있습니다. 결과는 0xa86a — 즉 43114이며, Avalanche C-Chain 메인넷의 체인 ID입니다.
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_chainId"
}'
동일한 엔드포인트에서 Avalanche의 네이티브 API도 제공됩니다. 업스트림 API는 정확한 메서드 이름에 따라 선택되므로, X-Chain(avm.*)과 P-Chain(platform.*) 호출에는 별도의 경로나 호스트가 필요하지 않습니다.
bash
curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"platform.getHeight",
  "params":{}
}'

3. WebSocket으로 구독하기

WebSocket 엔드포인트는 C-Chain의 표준 eth_subscribe 구독을 지원합니다.
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"]}
사용 가능한 구독 유형은 아래 링크된 공식 Avalanche C-Chain 문서를 참고하세요.

4. 배치 요청

하나의 HTTP 요청으로 C-Chain의 EVM 메서드에 대해 최대 256개의 JSON-RPC 호출을 보낼 수 있습니다. 배치 내 각 호출은 개별 호출로 계량됩니다.
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"},
  {"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'

다음 단계