Skip to main content

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 with trace_filter (once by fromAddress, once by toAddress) - and on chains where trace_filter isn’t available (e.g. OP-stack L2s) falling back to debug_traceBlockByNumber block-by-block. For decoded, wallet-level internal transfers across chains with no client-side call-tree walking, use the Foundational API’s with-internal param instead.

debug_* methods (Geth-style)

All four accept a tracer config:
Common tracer values: 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 expose trace_* 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 the debug_* 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.

debug_traceTransaction

Most-used debug method.

trace_transaction

Parity-style equivalent.