GoldRush JSON-RPC Methods
eth_*
net_*
web3_*
debug_*
trace_*
Per-method details
eth_blockNumber
Summary: Returns the latest block number on the chain.
Parameters: none
Returns: QUANTITY. Hex-encoded integer of the current block number.
eth_getBalance
Summary: Returns the native token balance of an address at a given block.
Parameters:
Returns:
QUANTITY. Hex-encoded balance in wei.
eth_getCode
Summary: Returns the contract bytecode at a given address.
Parameters:
Returns:
DATA. Hex-encoded contract bytecode, or 0x if none.
eth_getStorageAt
Summary: Returns the value of a storage slot for a given address.
Parameters:
Returns:
DATA, 32 bytes. 32-byte hex-encoded value at the given slot.
eth_getTransactionCount
Summary: Returns the nonce (number of transactions sent) of an address.
Parameters:
Returns:
QUANTITY. Hex-encoded transaction count.
eth_getBlockByHash
Summary: Returns block information by block hash.
Parameters:
Returns:
Object | null. Block object, or null if no block was found.
eth_getBlockByNumber
Summary: Returns block information by block number.
Parameters:
Returns:
Object | null. Block object, or null if no block was found.
eth_getBlockTransactionCountByHash
Summary: Returns the number of transactions in a block, identified by hash.
Parameters:
Returns:
QUANTITY | null. Hex-encoded transaction count, or null if the block is unknown.
eth_getBlockTransactionCountByNumber
Summary: Returns the number of transactions in a block, identified by number.
Parameters:
Returns:
QUANTITY. Hex-encoded transaction count.
eth_getTransactionByHash
Summary: Returns transaction details by transaction hash.
Parameters:
Returns:
Object | null. Transaction object, or null if unknown.
eth_getTransactionByBlockHashAndIndex
Summary: Returns the transaction at a given index inside a block, identified by block hash.
Parameters:
Returns:
Object | null. Transaction object, or null if the index is out of range.
eth_getTransactionByBlockNumberAndIndex
Summary: Returns the transaction at a given index inside a block, identified by block number.
Parameters:
Returns:
Object | null. Transaction object, or null if the index is out of range.
eth_getTransactionReceipt
Summary: Returns the receipt for a mined transaction.
Parameters:
Returns:
Object | null. Receipt object, or null if the transaction has not been mined.
eth_call
Summary: Executes a read-only contract call without creating a transaction.
Parameters:
Returns:
DATA. Hex-encoded ABI return data.
eth_estimateGas
Summary: Estimates the gas required to execute a transaction.
Parameters:
Returns:
QUANTITY. Hex-encoded gas estimate.
eth_gasPrice
Summary: Returns the node’s current suggested gas price.
Parameters: none
Returns: QUANTITY. Hex-encoded gas price in wei.
eth_maxPriorityFeePerGas
Summary: Returns the suggested priority fee per gas (EIP-1559).
Parameters: none
Returns: QUANTITY. Hex-encoded priority fee in wei.
eth_feeHistory
Summary: Returns historical fee market data over a range of blocks.
Parameters:
Returns:
Object. {oldestBlock, baseFeePerGas[], gasUsedRatio[], reward[][]}
eth_chainId
Summary: Returns the EIP-155 chain ID.
Parameters: none
Returns: QUANTITY. Hex-encoded chain ID.
eth_sendRawTransaction
Summary: Submits a signed raw transaction to the network.
Parameters:
Returns:
DATA, 32 bytes. Transaction hash.
eth_getLogs
Summary: Returns event logs matching a filter.
Parameters:
Returns:
Array<Object>. Array of matching log objects.
eth_newFilter
Summary: Creates a log filter that can be polled for new matches.
Parameters:
Returns:
QUANTITY. Hex-encoded filter ID.
eth_newBlockFilter
Summary: Creates a filter that fires on new blocks.
Parameters: none
Returns: QUANTITY. Hex-encoded filter ID.
eth_newPendingTransactionFilter
Summary: Creates a filter that fires on new pending transactions.
Parameters: none
Returns: QUANTITY. Hex-encoded filter ID.
eth_uninstallFilter
Summary: Removes a server-side filter.
Parameters:
Returns:
Boolean. true if the filter was uninstalled.
eth_getFilterChanges
Summary: Returns new entries for a filter since the last poll.
Parameters:
Returns:
Array. Array of matches; element shape depends on filter type.
eth_getFilterLogs
Summary: Returns all logs matching a log filter (one-shot).
Parameters:
Returns:
Array<Object>. All matching log objects.
eth_syncing
Summary: Returns the node’s sync status.
Parameters: none
Returns: Boolean | Object. false if synced; otherwise {startingBlock, currentBlock, highestBlock}.
eth_accounts
Summary: Returns the addresses owned by the connected node.
Parameters: none
Returns: Array<DATA>. Always [] on GoldRush.
eth_blobBaseFee
Summary: Returns the current EIP-4844 blob base fee.
Parameters: none
Returns: QUANTITY. Hex-encoded blob base fee in wei.
eth_getProof
Summary: Returns the Merkle proof for an account and storage slots.
Parameters:
Returns:
Object. {address, accountProof[], balance, codeHash, nonce, storageHash, storageProof[]}
net_version
Summary: Returns the network ID as a decimal string.
Parameters: none
Returns: String. Decimal network ID.
net_listening
Summary: Returns whether the node is actively listening for peers.
Parameters: none
Returns: Boolean. true if the node is listening.
net_peerCount
Summary: Returns the number of connected peers.
Parameters: none
Returns: QUANTITY. Hex-encoded peer count.
web3_clientVersion
Summary: Returns the underlying client software version.
Parameters: none
Returns: String. Client version string.
web3_sha3
Summary: Returns the keccak-256 hash of the supplied data.
Parameters:
Returns:
DATA, 32 bytes. Keccak-256 hash.
debug_traceTransaction
Summary: Returns an opcode-level execution trace for a mined transaction.
Parameters:
Returns:
Object. Tracer-specific output. With callTracer, the call graph rooted at the transaction’s from/to.
debug_traceCall
Summary: Traces a eth_call without producing a transaction.
Parameters:
Returns:
Object. Tracer-specific output.
debug_traceBlockByHash
Summary: Traces every transaction in a block, identified by hash.
Parameters:
Returns:
Array<Object>. Array of per-transaction tracer outputs.
debug_traceBlockByNumber
Summary: Traces every transaction in a block, identified by number.
Parameters:
Returns:
Array<Object>. Array of per-transaction tracer outputs.
trace_transaction
Summary: Returns the Parity-style trace of a mined transaction.
Parameters:
Returns:
Array<Object>. Array of trace objects.
trace_block
Summary: Returns Parity-style traces for every transaction in a block.
Parameters:
Returns:
Array<Object>. Array of trace objects across all transactions in the block.
trace_filter
Summary: Returns Parity-style traces matching a filter.
Parameters:
Returns:
Array<Object>. Array of matching trace objects.
trace_call
Summary: Returns the Parity-style trace of an eth_call.
Parameters:
Returns:
Object. {output, trace[], stateDiff?, vmTrace?}
trace_callMany
Summary: Returns Parity-style traces for a sequence of calls executed on top of the same block.
Parameters:
Returns:
Array<Object>. Array of trace result objects, one per input call, each shaped like a trace_call result ({output, trace[], stateDiff?, vmTrace?}).
trace_rawTransaction
Summary: Returns Parity-style traces for a raw, signed transaction without broadcasting it.
Parameters:
Returns:
Object. {output, trace[], stateDiff?, vmTrace?}
trace_replayBlockTransactions
Summary: Replays every transaction in a block and returns the requested Parity-style traces.
Parameters:
Returns:
Array<Object>. Array of replay results, one per transaction in the block. Each entry has {transactionHash, output, trace[], stateDiff?, vmTrace?}.
trace_replayTransaction
Summary: Replays a mined transaction and returns the requested Parity-style traces.
Parameters:
Returns:
Object. {output, trace[], stateDiff?, vmTrace?}
trace_get
Summary: Returns a single Parity-style trace at a given position within a transaction.
Parameters:
Returns:
Object. A single trace object at the requested position.
The
debug_* and trace_* namespaces give you opcode-level visibility into transaction execution. They’re used by block explorers, security tools, MEV searchers, and indexers that need internal-call data.
Both namespaces are served from https://rpc.goldrushdata.com/v1/{chain}.
Note: Looking for a wallet’s internal transaction history? These methods are per-transaction and per-block primitives, not a wallet-history endpoint. Reconstructing one address’s internal transfers from raw traces means scanning a block range twice withtrace_filter(once byfromAddress, once bytoAddress) - and on chains wheretrace_filterisn’t available (e.g. OP-stack L2s) falling back todebug_traceBlockByNumberblock-by-block. For decoded, wallet-level internal transfers across chains with no client-side call-tree walking, use the Foundational API’swith-internalparam instead.
debug_* methods (Geth-style)
All four accept a tracer config:
callTracer (call graph), prestateTracer (state diff), 4byteTracer (4-byte selector frequency), or omit for the default opcode-level trace.
trace_* methods (Parity-style)
trace_* is the canonical Erigon/Parity format. Prefer it when integrating with tooling that expects Erigon traces (e.g. block-explorer pipelines).
Per-chain availability
Trace and debug support depends on what the upstream node software exposes. Erigon and Reth both exposetrace_* natively, while Geth-based upstreams expose debug_*. GoldRush surfaces whichever is available, and falls back to a normalized translation where one namespace is missing.
⚠️ “Rolling” means the upstream archive window slides forward over time. For deeper history on these chains, contact GoldRush support to discuss dedicated archive nodes.
Solana
Solana does not expose thedebug_* or trace_* namespaces; they are EVM-specific. For transaction introspection on Solana, use:
simulateTransaction is the closest analogue to debug_traceCall / trace_call: it returns the program logs, the error (if any), compute units consumed, and optionally post-simulation account state, without broadcasting the transaction.
Pricing
debug_* and trace_* are heavier than standard eth_* reads. See pricing for full rates.