Skip to main content

Documentation Index

Fetch the complete documentation index at: https://daehan-base.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Base는 두 가지 성능 티어에서 완전히 EVM 호환인 단일 JSON-RPC API를 제공합니다. URL 하나와 block tag 하나만 바꾸면 2초 블록 확정에서 200ms 사전 확인(pre-confirmation)으로 전환할 수 있습니다.

​
네트워크

네트워크Chain ID유형Archive 지원
Mainnet8453프로덕션예
Sepolia84532테스트넷예

​
엔드포인트

티어HTTPWSS
Standardhttps://mainnet.base.orgwss://mainnet.base.org
Flashblockshttps://mainnet-preconf.base.orgwss://mainnet-preconf.base.org
위 공개 엔드포인트에는 rate limit이 적용되므로 프로덕션 트래픽에는 적합하지 않습니다. 프로덕션에서는 노드 제공업체를 통해 연결하세요.

​
What is the Flashblocks Tier?

Flashblocks 엔드포인트는 완전히 EVM 동등하며, 모든 표준 eth_ 메서드가 동일하게 동작합니다. 차이는 pending block tag가 무엇을 반환하느냐에 있습니다.
  • Standard 엔드포인트에서 pending은 트랜잭션 풀(미채굴 상태)을 반영합니다.
  • Flashblocks 엔드포인트에서 pending은 현재 진행 중인 사전 확인 블록을 반영하며, 시퀀서가 정렬한 트랜잭션 배치가 들어올 때마다 약 200ms마다 갱신됩니다.
eth_getBalance, eth_getStorageAt, eth_call 같은 호출은 블록이 seal되기 최대 1.8초 전의 실제 시퀀서 상태를 기준으로 실행되며, 지연 시간은 1초 미만입니다.

​
API 레퍼런스

​
Ethereum JSON-RPC API

계정 조회, 블록 및 트랜잭션 데이터 조회, 가스 추정, 로그 필터링에 사용하는 핵심 Ethereum 프로토콜 메서드입니다. 모든 메서드는 Standard와 Flashblocks 엔드포인트에서 모두 동작합니다.
✓ 표시가 있는 메서드는 Flashblocks 엔드포인트에서 "pending" block tag를 지원합니다.
메서드설명Flashblocks pending
eth_blockNumber현재 블록 번호—
eth_getBalance계정 ETH 잔액✓
eth_getTransactionCount계정 nonce / 트랜잭션 수✓
eth_getCode배포된 컨트랙트 바이트코드✓
eth_getStorageAt컨트랙트 스토리지 슬롯 값✓
eth_call읽기 전용 호출 실행✓
eth_getBlockByNumber번호로 블록 데이터 조회✓
eth_getBlockByHash해시로 블록 데이터 조회—
eth_getBlockReceipts블록 내 모든 영수증 조회✓
eth_getBlockTransactionCountByNumber블록 번호 기준 트랜잭션 수✓
eth_getBlockTransactionCountByHash블록 해시 기준 트랜잭션 수—
eth_getTransactionByHash해시로 트랜잭션 데이터 조회—
eth_getTransactionByBlockHashAndIndex블록 해시와 인덱스로 트랜잭션 조회—
eth_getTransactionByBlockNumberAndIndex블록 번호와 인덱스로 트랜잭션 조회—
eth_getTransactionReceipt채굴 완료된 트랜잭션 영수증—
eth_sendRawTransaction서명된 트랜잭션 제출—
eth_gasPrice현재 가스 가격—
eth_maxPriorityFeePerGas최대 priority fee 추정값—
eth_feeHistory과거 base fee 및 reward 데이터—
eth_estimateGas트랜잭션 가스 추정✓
eth_getLogs필터 기준 이벤트 로그 조회✓
eth_chainId네트워크 chain ID—
eth_syncing노드 동기화 상태—
net_version네트워크 버전 ID—
web3_clientVersion클라이언트 버전 문자열—
eth_subscribe이벤트 구독(WSS)✓
eth_unsubscribe구독 취소(WSS)—

​
Flashblocks API

Base에서 서브초 단위 트랜잭션 신호를 다루기 위한 사전 확인 메서드입니다. 이 메서드들은 Flashblocks 엔드포인트에서만 사용할 수 있으며, 블록이 seal되기 최대 약 1.8초 전까지 상태 조회, 번들 시뮬레이션, 이벤트 스트리밍을 지원합니다.
메서드설명
eth_simulateV1사전 확인 상태를 기준으로 트랜잭션 번들 시뮬레이션
base_transactionStatus트랜잭션이 mempool에 수신되었는지 확인
newFlashblockTransactions개별 사전 확인 트랜잭션 구독
pendingLogs사전 확인 트랜잭션의 필터링된 로그 구독
newFlashblocks전체 Flashblock payload 스트림 구독

​
Debug API

트랜잭션 상세 분석과 블록 재현을 위한 개발/디버깅 유틸리티입니다. Debug 메서드는 트랜잭션을 재실행하므로 계산 비용이 크며, 사용 가능 여부와 rate limit은 노드 제공업체마다 다를 수 있습니다.
메서드설명
debug_traceTransaction트랜잭션의 전체 EVM 실행 추적
debug_traceBlockByHash블록 해시 기준 모든 트랜잭션의 EVM 추적
debug_traceBlockByNumber블록 번호 기준 모든 트랜잭션의 EVM 추적

​
요청 및 응답 형식

모든 요청은 Content-Type: application/json을 사용하는 HTTP POST입니다.
필드타입설명
jsonrpcstring항상 "2.0"
methodstringRPC 메서드 이름
paramsarray순서대로 전달하는 메서드 파라미터
idnumber | string응답에 그대로 반환되는 식별자
요청 예시: 
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": ["0x742d35Cc6634C0532925a3b8D4C9dD0b4f3BaEa", "pending"],
  "id": 1
}
성공 응답: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1a055690d9db80000"
}
오류 응답: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

​
오류 코드

코드이름설명
-32700Parse error유효하지 않은 JSON
-32600Invalid request유효한 JSON-RPC 2.0 객체가 아님
-32601Method not found메서드가 없거나 사용할 수 없음
-32602Invalid params잘못된 메서드 파라미터
-32603Internal error내부 JSON-RPC 오류
-32000Server error노드별 오류(메시지 참고)

​
블록 파라미터

ValueStandardFlashblocks
"latest"가장 최근에 seal된 블록가장 최근에 seal된 블록
"pending"미채굴 트랜잭션 풀 상태현재 진행 중인 Flashblock 상태(약 200ms 해상도)
"safe"최신 safe 블록최신 safe 블록
"finalized"최신 finalized 블록최신 finalized 블록
"earliest"제네시스 블록제네시스 블록
"0x<n>"번호로 지정한 특정 블록번호로 지정한 특정 블록