Skip to main content

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

TransportURL
HTTP RPChttps://api.test.stablenet.network
WebSocketwss://api.test.stablenet.network/ws
WebSocket is required for eth_subscribe methods.

eth Namespace

Network and Fees

MethodDescription
eth_chainIdReturns the chain ID
eth_gasPriceReturns gas price for legacy transactions
eth_maxPriorityFeePerGasReturns priority fee enforced by GovValidator contract
eth_feeHistoryReturns historical fee data
eth_syncingReturns 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

MethodDescription
eth_blockNumberReturns current block number
eth_getBalanceReturns account balance
eth_getCodeReturns contract bytecode
eth_getStorageAtReturns a specific storage slot value
eth_getProofReturns Merkle proof for account and storage
eth_getBlockByNumberReturns a block by number
eth_getBlockByHashReturns a block by hash
eth_getTransactionByHashReturns a transaction by hash
eth_getTransactionReceiptReturns a transaction receipt

Transactions

MethodDescription
eth_sendTransactionSigns and submits a transaction (requires unlocked account)
eth_sendRawTransactionSubmits a pre-signed transaction
eth_signTransactionSigns a transaction without submitting
eth_fillTransactionFills missing default fields in a transaction
eth_estimateGasEstimates gas required for a transaction
eth_callExecutes a read-only call without state changes

Fee Delegation Extensions

StableNet extends the standard API with fee delegation signing methods.
MethodDescription
personal_signRawFeeDelegateTransactionAppends fee-payer signature using password-unlocked account
eth_signRawFeeDelegateTransactionAppends 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

MethodReturnsDescription
eth_newFilterFilter IDCreates a log filter with specified criteria
eth_newBlockFilterFilter IDCreates a filter for new block hashes
eth_newPendingTransactionFilterFilter IDCreates a filter for pending transactions
eth_getFilterChangesLogs / HashesReturns changes since last poll
eth_getFilterLogsLogs arrayReturns all logs matching the filter
eth_getLogsLogs arrayOne-time log query without a persistent filter
eth_uninstallFilterBooleanRemoves a filter
Polling filters expire after 5 minutes of inactivity. Each eth_getFilterChanges call resets the timer.

WebSocket Subscriptions

MethodEvent TypeDescription
eth_subscribe("newHeads")Block headerFires on each new block
eth_subscribe("logs", criteria)LogFires for logs matching criteria
eth_subscribe("newPendingTransactions")Tx hashFires for each pending transaction
eth_unsubscribeBooleanCancels a subscription
FilterCriteria fields for log subscriptions:
FieldTypeDescription
fromBlockstring (block tag or hex)Start block (null = latest)
toBlockstring (block tag or hex)End block (null = latest)
addressstring | string[]Contract address(es) to filter
topicsstring[][]Topic filters (AND across positions, OR within a position)
Topic matching: up to 4 positions; null at a position matches any value.

txpool Namespace

MethodDescription
txpool_contentLists all pending and queued transactions
txpool_contentFromLists transactions from a specific address
txpool_statusReturns pending/queued counts
txpool_inspectReturns 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

MethodDescription
web3_clientVersionReturns the node client version string
web3_sha3Computes the Keccak-256 hash of input data

istanbul Namespace

Available only when Anzeon WBFT consensus is active.
MethodDescription
istanbul_nodeAddressReturns the signer node address
istanbul_getCommitSignersFromBlockReturns proposer and commit signers for a block number
istanbul_getCommitSignersFromBlockByHashReturns signers for a block hash
istanbul_getValidatorsReturns the current validator list
istanbul_getValidatorsAtHashReturns validators at a specific block hash
istanbul_statusReturns round and sealer statistics

personal Namespace

personal is disabled on public RPC endpoints. Available on local nodes only.
MethodDescription
personal_newAccountCreates a new account
personal_listAccountsLists managed accounts
personal_unlockAccountUnlocks an account with password
personal_lockAccountLocks an account
personal_sendTransactionSigns and sends a transaction using password
personal_signTransactionSigns a transaction using password
personal_signSigns arbitrary data using password
personal_importRawKeyImports a private key