Base JSON-RPC

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Endpoint

https://rpc.goldrushdata.com/v1/base-mainnet

​

Quickstart

curl https://rpc.goldrushdata.com/v1/base-mainnet \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_blockNumber",
    "params": []
  }'

​

Supported methods

​

Blocks info

• eth_blockNumber: Returns the latest block number on the chain.
• eth_getBlockByHash: Returns block information by block hash.
• eth_getBlockByNumber: Returns block information by block number.
• eth_getBlockTransactionCountByHash: Returns the number of transactions in a block, identified by hash.
• eth_getBlockTransactionCountByNumber: Returns the number of transactions in a block, identified by number.

​

Transactions info

• eth_getTransactionCount: Returns the nonce (number of transactions sent) of an address.
• eth_getTransactionByHash: Returns transaction details by transaction hash.
• eth_getTransactionByBlockHashAndIndex: Returns the transaction at a given index inside a block, identified by block hash.
• eth_getTransactionByBlockNumberAndIndex: Returns the transaction at a given index inside a block, identified by block number.
• eth_getTransactionReceipt: Returns the receipt for a mined transaction.

​

Executing transactions

• eth_call: Executes a read-only contract call without creating a transaction.
• eth_estimateGas: Estimates the gas required to execute a transaction.
• eth_sendRawTransaction: Submits a signed raw transaction to the network.

​

Accounts info

• eth_getBalance: Returns the native token balance of an address at a given block.
• eth_getCode: Returns the contract bytecode at a given address.
• eth_getStorageAt: Returns the value of a storage slot for a given address.
• eth_accounts: Returns the addresses owned by the connected node.
• eth_getProof: Returns the Merkle proof for an account and storage slots.

​

Logs and events

• eth_getLogs: Returns event logs matching a filter.
• eth_newFilter: Creates a log filter that can be polled for new matches.
• eth_newBlockFilter: Creates a filter that fires on new blocks.
• eth_newPendingTransactionFilter: Creates a filter that fires on new pending transactions.
• eth_uninstallFilter: Removes a server-side filter.
• eth_getFilterChanges: Returns new entries for a filter since the last poll.
• eth_getFilterLogs: Returns all logs matching a log filter (one-shot).

​

Gas data

• eth_gasPrice: Returns the node’s current suggested gas price.
• eth_maxPriorityFeePerGas: Returns the suggested priority fee per gas (EIP-1559).
• eth_feeHistory: Returns historical fee market data over a range of blocks.
• eth_blobBaseFee: Returns the current EIP-4844 blob base fee.

​

Chain info

• eth_chainId: Returns the EIP-155 chain ID.
• eth_syncing: Returns the node’s sync status.
• net_version: Returns the network ID as a decimal string.
• net_listening: Returns whether the node is actively listening for peers.
• net_peerCount: Returns the number of connected peers.

​

Debug and trace

• debug_traceTransaction: Returns an opcode-level execution trace for a mined transaction.
• debug_traceCall: Traces a eth_call without producing a transaction.
• debug_traceBlockByHash: Traces every transaction in a block, identified by hash.
• debug_traceBlockByNumber: Traces every transaction in a block, identified by number.
• trace_transaction: Returns the Parity-style trace of a mined transaction.
• trace_block: Returns Parity-style traces for every transaction in a block.
• trace_filter: Returns Parity-style traces matching a filter.
• trace_call: Returns the Parity-style trace of an eth_call.

​

Client information

• web3_clientVersion: Returns the underlying client software version.
• web3_sha3: Returns the keccak-256 hash of the supplied data.

​

Related