Documentation Index
Fetch the complete documentation index at: https://docs.stablenet.network/llms.txt
Use this file to discover all available pages before exploring further.
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 | 필터 삭제 |
eth_getFilterChanges 호출 시마다 타이머가 초기화됩니다.
WebSocket 구독
| 메서드 | 이벤트 타입 | 설명 |
|---|
eth_subscribe("newHeads") | 블록 헤더 | 새 블록마다 발생 |
eth_subscribe("logs", criteria) | 로그 | 조건에 맞는 로그 발생 시 |
eth_subscribe("newPendingTransactions") | Tx 해시 | 보류 트랜잭션마다 발생 |
eth_unsubscribe | Boolean | 구독 취소 |
| 필드 | 타입 | 설명 |
|---|
fromBlock | string (블록 태그 또는 hex) | 시작 블록 (null = 최신) |
toBlock | string (블록 태그 또는 hex) | 종료 블록 (null = 최신) |
address | string | string[] | 필터링할 컨트랙트 주소 |
topics | string[][] | 토픽 필터 (위치 간 AND, 같은 위치 내 OR) |
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 | 개인 키 가져오기 |
관련 문서
