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.
All JSON-RPC methods available on StableNet nodes, organized by namespace.
Connection Endpoints
| Transport | URL |
|---|
| HTTP RPC | https://api.test.stablenet.network |
| WebSocket | wss://api.test.stablenet.network/ws |
WebSocket is required for eth_subscribe methods.
eth Namespace
Network and Fees
| Method | Description |
|---|
eth_chainId | Returns the chain ID |
eth_gasPrice | Returns gas price for legacy transactions |
eth_maxPriorityFeePerGas | Returns priority fee enforced by GovValidator contract |
eth_feeHistory | Returns historical fee data |
eth_syncing | Returns node synchronization status |
In StableNet with Anzeon WBFT enabled, eth_maxPriorityFeePerGas returns the gas tip value set by the GovValidator contract — not an oracle estimate.
Blocks and State
| Method | Description |
|---|
eth_blockNumber | Returns current block number |
eth_getBalance | Returns account balance |
eth_getCode | Returns contract bytecode |
eth_getStorageAt | Returns a specific storage slot value |
eth_getProof | Returns Merkle proof for account and storage |
eth_getBlockByNumber | Returns a block by number |
eth_getBlockByHash | Returns a block by hash |
eth_getTransactionByHash | Returns a transaction by hash |
eth_getTransactionReceipt | Returns a transaction receipt |
Transactions
| Method | Description |
|---|
eth_sendTransaction | Signs and submits a transaction (requires unlocked account) |
eth_sendRawTransaction | Submits a pre-signed transaction |
eth_signTransaction | Signs a transaction without submitting |
eth_fillTransaction | Fills missing default fields in a transaction |
eth_estimateGas | Estimates gas required for a transaction |
eth_call | Executes a read-only call without state changes |
Fee Delegation Extensions
StableNet extends the standard API with fee delegation signing methods.
| Method | Description |
|---|
personal_signRawFeeDelegateTransaction | Appends fee-payer signature using password-unlocked account |
eth_signRawFeeDelegateTransaction | Appends fee-payer signature using already-unlocked account |
Submit the resulting signed transaction via eth_sendRawTransaction. Gas costs are charged to the fee payer.
eth Filter Methods
Polling-Based Filters
| Method | Returns | Description |
|---|
eth_newFilter | Filter ID | Creates a log filter with specified criteria |
eth_newBlockFilter | Filter ID | Creates a filter for new block hashes |
eth_newPendingTransactionFilter | Filter ID | Creates a filter for pending transactions |
eth_getFilterChanges | Logs / Hashes | Returns changes since last poll |
eth_getFilterLogs | Logs array | Returns all logs matching the filter |
eth_getLogs | Logs array | One-time log query without a persistent filter |
eth_uninstallFilter | Boolean | Removes a filter |
Polling filters expire after 5 minutes of inactivity. Each eth_getFilterChanges call resets the timer.
WebSocket Subscriptions
| Method | Event Type | Description |
|---|
eth_subscribe("newHeads") | Block header | Fires on each new block |
eth_subscribe("logs", criteria) | Log | Fires for logs matching criteria |
eth_subscribe("newPendingTransactions") | Tx hash | Fires for each pending transaction |
eth_unsubscribe | Boolean | Cancels a subscription |
FilterCriteria fields for log subscriptions:
| Field | Type | Description |
|---|
fromBlock | string (block tag or hex) | Start block (null = latest) |
toBlock | string (block tag or hex) | End block (null = latest) |
address | string | string[] | Contract address(es) to filter |
topics | string[][] | Topic filters (AND across positions, OR within a position) |
Topic matching: up to 4 positions; null at a position matches any value.
txpool Namespace
| Method | Description |
|---|
txpool_content | Lists all pending and queued transactions |
txpool_contentFrom | Lists transactions from a specific address |
txpool_status | Returns pending/queued counts |
txpool_inspect | Returns human-readable transaction pool summary |
Transaction states:
- pending — eligible for inclusion in the next block
- queued — waiting due to nonce gaps or insufficient balance
web3 Namespace
| Method | Description |
|---|
web3_clientVersion | Returns the node client version string |
web3_sha3 | Computes the Keccak-256 hash of input data |
istanbul Namespace
Available only when Anzeon WBFT consensus is active.
| Method | Description |
|---|
istanbul_nodeAddress | Returns the signer node address |
istanbul_getCommitSignersFromBlock | Returns proposer and commit signers for a block number |
istanbul_getCommitSignersFromBlockByHash | Returns signers for a block hash |
istanbul_getValidators | Returns the current validator list |
istanbul_getValidatorsAtHash | Returns validators at a specific block hash |
istanbul_status | Returns round and sealer statistics |
personal Namespace
personal is disabled on public RPC endpoints. Available on local nodes only.
| Method | Description |
|---|
personal_newAccount | Creates a new account |
personal_listAccounts | Lists managed accounts |
personal_unlockAccount | Unlocks an account with password |
personal_lockAccount | Locks an account |
personal_sendTransaction | Signs and sends a transaction using password |
personal_signTransaction | Signs a transaction using password |
personal_sign | Signs arbitrary data using password |
personal_importRawKey | Imports a private key |