Base RPC 엔드포인트 문서 | ERPC
Base RPC 엔드포인트 문서
ERPC를 Base RPC 엔드포인트로 사용하여 HTTP JSON-RPC 요청과 WebSocket 구독을 처리할 수 있습니다. Base RPC는 Global Edge Blockchain Infrastructure 내에 있는 ERPC의 RPC APIs 중 하나이며, API key는 ERPC Web Dashboard에서 관리할 수 있습니다.
Solana, Ethereum, Avalanche와 동일한 RPC key를 그대로 사용할 수 있습니다.
api-key 매개변수에 API key를 추가해 주세요.엔드포인트
JSON-RPC 2.0 요청은 다음 주소로 HTTP POST로 전송합니다.
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>구독의 경우 다음 주소에 WebSocket으로 연결합니다.
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>/ 경로에서만 요청을 받습니다.예시
다음은 HTTP 요청 예시입니다.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'API key는 ERPC Web Dashboard에서 발급받고 확인할 수 있습니다.
배치 요청
HTTP 요청당 최대 256개 호출의 JSON-RPC 배치를 지원합니다. 배치 내 각 호출은 개별 호출로 계량됩니다.
사용량 측정
사용량은 JSON-RPC 호출마다 token 단위로 계량됩니다. HTTP 배치의 각 항목과 WebSocket 연결을 통해 전송된 각 JSON-RPC 호출은 개별적으로 계량됩니다.
Free 요금제 제한
Free 요금제에서는 사용자의 계정이 10초당 요청 한 건을 보낼 수 있습니다. 이 제한은 엔드포인트별이 아니라 계정별로 집계되므로, 다른 체인으로 보낸 요청도 집계에 포함될 수 있습니다. 그보다 빨리 보낸 요청에는 HTTP
429로 응답하며, retry-after 헤더가 대기할 시간(초)을 알려 줍니다.Free 요금제에서는 JSON-RPC 호출을 두 개 이상 담은 요청에 HTTP
429로 응답하며, 그 요청의 호출은 하나도 전송되지 않습니다. 각 호출은 코드 -32041의 JSON-RPC 오류를 받습니다. 대신 이 호출들을 하나씩 보내세요.Free 요금제에서는 WebSocket 연결을 사용할 수 없으며 HTTP
403으로 응답합니다.지원 메서드
Base는 EVM 호환 체인으로, Ethereum과 동일한 JSON-RPC 메서드를 사용합니다. ERPC는 Base 엔드포인트에 고정된 메서드 허용 목록(allowlist)을 적용하지 않습니다. Ethereum 메서드 패밀리는 Ethereum RPC 엔드포인트 문서를 참고하세요.
응답 상태 코드
| HTTP 상태 | 의미 |
|---|---|
| 200 | 업스트림 JSON-RPC 응답 |
| 400 | Missing API key, Invalid JSON-RPC request 또는 JSON-RPC batch exceeds 256 calls |
| 401 | Unauthorized API KEY |
| 403 | Free 요금제에서의 WebSocket 연결 |
| 404 | / 이외의 경로 |
| 429 | 속도 제한됨. 위의 Free 요금제 제한(10초당 요청 한 건 초과, 또는 한 요청에 호출 두 개 이상)도 포함됨. retry-after 헤더가 대기 시간(초)을 알려줌 |
| 502 | 업스트림 RPC 요청을 완료할 수 없음 |
| 503 | 서비스를 일시적으로 사용할 수 없음 |
WebSocket 연결에서는 위의 코드 외에
101(프로토콜 업그레이드 승인됨)이 사용됩니다.Base RPC method 및 문서
표준 method, 매개변수, 사양의 전체 목록은 공식 문서를 참고하세요.