ERPC

Ethereum RPC 엔드포인트 문서 | ERPC

Ethereum RPC 엔드포인트 문서

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

엔드포인트

JSON-RPC 2.0 요청은 다음 주소로 HTTP POST로 전송합니다.
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>
구독의 경우 다음 주소에 WebSocket으로 연결합니다.
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

예시

다음은 HTTP 요청 예시입니다.
bash
curl https://edge.erpc.global/eth?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/eth?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 배치를 지원하며, JSON-RPC notification도 허용됩니다. 배치 내 각 호출은 개별 호출로 계량됩니다.

사용량 측정

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

지원 메서드

이 엔드포인트는 표준 Ethereum JSON-RPC 메서드 패밀리 — eth_*, net_*, txpool_*, web3_* — 를 지원합니다. 계정 및 블록 조회(eth_getBalance, eth_getBlockByNumber, eth_getLogs), 트랜잭션 처리(eth_sendRawTransaction, eth_getTransactionReceipt), 수수료 데이터(eth_feeHistory, eth_maxPriorityFeePerGas), 호출 시뮬레이션(eth_call, eth_callMany, eth_simulateV1), 상태 증명(eth_getProof), 필터(eth_newFilter, eth_getFilterChanges), txpool 조회(txpool_status, txpool_content), WebSocket 구독(eth_subscribe, eth_unsubscribe)이 포함됩니다.
요청 및 응답 형식을 포함한 전체 메서드 목록은 Ethereum RPC API 참조를 참고하세요.

응답 상태 코드

HTTP 상태의미
200업스트림 JSON-RPC 응답
400잘못된 JSON-RPC 요청
401API key가 없거나 인증되지 않음
429다운스트림 RPC 정책에 의한 속도 제한
502프록시를 사용할 수 없음
503다운스트림 RPC 서비스를 사용할 수 없음
WebSocket 연결에서는 위의 코드 외에 101(프로토콜 업그레이드 승인됨)과 426(WebSocket Upgrade 핸드셰이크 필요)이 사용됩니다.

Ethereum RPC method 및 문서

표준 method, 매개변수, 구독 사양의 전체 목록은 공식 문서를 참고하세요. HTTP와 WebSocket 사용 방법을 모두 다룹니다.
https://ethereum.org/en/developers/docs/apis/json-rpc/

이전

Ethereum RPC 빠른 시작 | ERPC

다음

SLV AI