RPC API 레퍼런스

StableNet 노드에서 사용할 수 있는 모든 JSON-RPC 메서드를 네임스페이스별로 정리했습니다.

연결 엔드포인트

트랜스포트	URL
HTTP RPC	`https://api.test.stablenet.network`
WebSocket	`wss://api.test.stablenet.network/ws`

eth_subscribe 메서드는 WebSocket 연결이 필요합니다.

eth 네임스페이스

네트워크 및 수수료

메서드	설명
`eth_chainId`	체인 ID 반환
`eth_gasPrice`	레거시 트랜잭션의 가스 가격 반환
`eth_maxPriorityFeePerGas`	GovValidator 컨트랙트가 설정한 우선순위 수수료 반환
`eth_feeHistory`	과거 수수료 데이터 반환
`eth_syncing`	노드 동기화 상태 반환

Anzeon WBFT가 활성화된 StableNet에서 eth_maxPriorityFeePerGas는 오라클 추정값이 아니라 GovValidator 컨트랙트가 설정한 가스 팁 값을 반환합니다.

블록 및 상태

메서드	설명
`eth_blockNumber`	현재 블록 번호 반환
`eth_getBalance`	계정 잔액 반환
`eth_getCode`	컨트랙트 바이트코드 반환
`eth_getStorageAt`	특정 스토리지 슬롯 값 반환
`eth_getProof`	계정 및 스토리지 Merkle 증명 반환
`eth_getBlockByNumber`	블록 번호로 블록 조회
`eth_getBlockByHash`	블록 해시로 블록 조회
`eth_getTransactionByHash`	트랜잭션 해시로 트랜잭션 조회
`eth_getTransactionReceipt`	트랜잭션 영수증 조회

트랜잭션

메서드	설명
`eth_sendTransaction`	트랜잭션 서명 후 제출 (잠금 해제된 계정 필요)
`eth_sendRawTransaction`	미리 서명된 트랜잭션 제출
`eth_signTransaction`	제출 없이 트랜잭션만 서명
`eth_fillTransaction`	트랜잭션의 누락된 기본 필드 채우기
`eth_estimateGas`	트랜잭션 실행에 필요한 가스 추정
`eth_call`	상태 변경 없는 읽기 전용 호출 실행

수수료 위임 확장 메서드

StableNet은 수수료 위임 서명을 위한 확장 API를 제공합니다.

메서드	설명
`personal_signRawFeeDelegateTransaction`	패스워드로 잠금 해제된 계정으로 수수료 지불자 서명 추가
`eth_signRawFeeDelegateTransaction`	이미 잠금 해제된 계정으로 수수료 지불자 서명 추가

서명된 트랜잭션은 eth_sendRawTransaction으로 제출합니다. 가스 비용은 수수료 지불자에게 청구됩니다.

eth 필터 메서드

폴링 기반 필터

메서드	반환값	설명
`eth_newFilter`	필터 ID	조건에 맞는 로그 필터 생성
`eth_newBlockFilter`	필터 ID	새 블록 해시 필터 생성
`eth_newPendingTransactionFilter`	필터 ID	보류 중인 트랜잭션 필터 생성
`eth_getFilterChanges`	로그 / 해시	마지막 폴링 이후 변경 내역 반환
`eth_getFilterLogs`	로그 배열	필터와 일치하는 모든 로그 반환
`eth_getLogs`	로그 배열	영구 필터 없이 1회성 로그 조회
`eth_uninstallFilter`	Boolean	필터 삭제

폴링 필터는 5분 동안 사용이 없으면 만료됩니다. eth_getFilterChanges 호출 시마다 타이머가 초기화됩니다.

WebSocket 구독

메서드	이벤트 타입	설명
`eth_subscribe("newHeads")`	블록 헤더	새 블록마다 발생
`eth_subscribe("logs", criteria)`	로그	조건에 맞는 로그 발생 시
`eth_subscribe("newPendingTransactions")`	Tx 해시	보류 트랜잭션마다 발생
`eth_unsubscribe`	Boolean	구독 취소

로그 구독의 FilterCriteria 필드:

필드	타입	설명
`fromBlock`	`string` (블록 태그 또는 hex)	시작 블록 (`null` = 최신)
`toBlock`	`string` (블록 태그 또는 hex)	종료 블록 (`null` = 최신)
`address`	`string \| string[]`	필터링할 컨트랙트 주소
`topics`	`string[][]`	토픽 필터 (위치 간 AND, 같은 위치 내 OR)

토픽 매칭: 최대 4개 위치 지원. 위치에 null을 지정하면 모든 값에 매칭됩니다.

txpool 네임스페이스

메서드	설명
`txpool_content`	보류 및 대기 중인 모든 트랜잭션 목록
`txpool_contentFrom`	특정 주소의 트랜잭션 목록
`txpool_status`	보류/대기 트랜잭션 수 반환
`txpool_inspect`	트랜잭션 풀 요약 정보 (읽기 쉬운 형식)

트랜잭션 상태:

pending — 다음 블록에 포함될 수 있는 트랜잭션
queued — 논스 공백 또는 잔액 부족으로 대기 중인 트랜잭션

web3 네임스페이스

메서드	설명
`web3_clientVersion`	노드 클라이언트 버전 문자열 반환
`web3_sha3`	입력 데이터의 Keccak-256 해시 계산

istanbul 네임스페이스

Anzeon WBFT 합의가 활성화된 경우에만 사용 가능합니다.

메서드	설명
`istanbul_nodeAddress`	서명자 노드 주소 반환
`istanbul_getCommitSignersFromBlock`	블록 번호의 제안자 및 커밋 서명자 반환
`istanbul_getCommitSignersFromBlockByHash`	블록 해시로 서명자 반환
`istanbul_getValidators`	현재 밸리데이터 목록 반환
`istanbul_getValidatorsAtHash`	특정 블록 해시의 밸리데이터 반환
`istanbul_status`	라운드 및 실러 통계 반환

personal 네임스페이스

personal은 공개 RPC 엔드포인트에서 비활성화되어 있습니다. 로컬 노드에서만 사용 가능합니다.

메서드	설명
`personal_newAccount`	새 계정 생성
`personal_listAccounts`	관리 중인 계정 목록
`personal_unlockAccount`	패스워드로 계정 잠금 해제
`personal_lockAccount`	계정 잠금
`personal_sendTransaction`	패스워드로 서명 후 트랜잭션 전송
`personal_signTransaction`	패스워드로 트랜잭션 서명
`personal_sign`	패스워드로 임의 데이터 서명
`personal_importRawKey`	개인 키 가져오기

​연결 엔드포인트

​eth 네임스페이스

​네트워크 및 수수료

​블록 및 상태

​트랜잭션

​수수료 위임 확장 메서드

​eth 필터 메서드

​폴링 기반 필터

​WebSocket 구독

​txpool 네임스페이스

​web3 네임스페이스

​istanbul 네임스페이스

​personal 네임스페이스

​관련 문서