> ## 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.

# Base JSON-RPC

> GoldRush JSON-RPC for Base. Endpoint URLs, supported methods, and code examples.

GoldRush JSON-RPC supports **Base**.

## Endpoint

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

| Property | Value |
| - | - |
| **Chain slug** | `base-mainnet` |
| **Native gas token** | ETH |
| **Block time** | \~2s |
| **Block explorer** | [https://basescan.org/](https://basescan.org/) |
| **Network type** | Mainnet |
| **Testnets** | `base-sepolia-testnet` |

## Quickstart

```bash theme={null}
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

Each method below has a dedicated reference page tuned for Base, with chain-specific examples.

### Blocks info

* [`eth_blockNumber`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-blocknumber): Returns the latest block number on the chain.
* [`eth_getBlockByHash`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getblockbyhash): Returns block information by block hash.
* [`eth_getBlockByNumber`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getblockbynumber): Returns block information by block number.
* [`eth_getBlockTransactionCountByHash`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getblocktransactioncountbyhash): Returns the number of transactions in a block, identified by hash.
* [`eth_getBlockTransactionCountByNumber`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getblocktransactioncountbynumber): Returns the number of transactions in a block, identified by number.

### Transactions info

* [`eth_getTransactionCount`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gettransactioncount): Returns the nonce (number of transactions sent) of an address.
* [`eth_getTransactionByHash`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gettransactionbyhash): Returns transaction details by transaction hash.
* [`eth_getTransactionByBlockHashAndIndex`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gettransactionbyblockhashandindex): Returns the transaction at a given index inside a block, identified by block hash.
* [`eth_getTransactionByBlockNumberAndIndex`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gettransactionbyblocknumberandindex): Returns the transaction at a given index inside a block, identified by block number.
* [`eth_getTransactionReceipt`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gettransactionreceipt): Returns the receipt for a mined transaction.

### Executing transactions

* [`eth_call`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-call): Executes a read-only contract call without creating a transaction.
* [`eth_estimateGas`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-estimategas): Estimates the gas required to execute a transaction.
* [`eth_sendRawTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-sendrawtransaction): Submits a signed raw transaction to the network.

### Accounts info

* [`eth_getBalance`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getbalance): Returns the native token balance of an address at a given block.
* [`eth_getCode`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getcode): Returns the contract bytecode at a given address.
* [`eth_getStorageAt`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getstorageat): Returns the value of a storage slot for a given address.
* [`eth_accounts`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-accounts): Returns the addresses owned by the connected node.
* [`eth_getProof`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getproof): Returns the Merkle proof for an account and storage slots.

### Logs and events

* [`eth_getLogs`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getlogs): Returns event logs matching a filter.
* [`eth_newFilter`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-newfilter): Creates a log filter that can be polled for new matches.
* [`eth_newBlockFilter`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-newblockfilter): Creates a filter that fires on new blocks.
* [`eth_newPendingTransactionFilter`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-newpendingtransactionfilter): Creates a filter that fires on new pending transactions.
* [`eth_uninstallFilter`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-uninstallfilter): Removes a server-side filter.
* [`eth_getFilterChanges`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getfilterchanges): Returns new entries for a filter since the last poll.
* [`eth_getFilterLogs`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-getfilterlogs): Returns all logs matching a log filter (one-shot).

### Gas data

* [`eth_gasPrice`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-gasprice): Returns the node's current suggested gas price.
* [`eth_maxPriorityFeePerGas`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-maxpriorityfeepergas): Returns the suggested priority fee per gas (EIP-1559).
* [`eth_feeHistory`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-feehistory): Returns historical fee market data over a range of blocks.
* [`eth_blobBaseFee`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-blobbasefee): Returns the current EIP-4844 blob base fee.

### Chain info

* [`eth_chainId`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-chainid): Returns the EIP-155 chain ID.
* [`eth_syncing`](https://goldrush.dev/docs/api-reference/json-rpc/base/eth-syncing): Returns the node's sync status.
* [`net_version`](https://goldrush.dev/docs/api-reference/json-rpc/base/net-version): Returns the network ID as a decimal string.
* [`net_listening`](https://goldrush.dev/docs/api-reference/json-rpc/base/net-listening): Returns whether the node is actively listening for peers.
* [`net_peerCount`](https://goldrush.dev/docs/api-reference/json-rpc/base/net-peercount): Returns the number of connected peers.

### Debug and trace

* [`debug_traceTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/base/debug-tracetransaction): Returns an opcode-level execution trace for a mined transaction.
* [`debug_traceCall`](https://goldrush.dev/docs/api-reference/json-rpc/base/debug-tracecall): Traces a `eth_call` without producing a transaction.
* [`debug_traceBlockByHash`](https://goldrush.dev/docs/api-reference/json-rpc/base/debug-traceblockbyhash): Traces every transaction in a block, identified by hash.
* [`debug_traceBlockByNumber`](https://goldrush.dev/docs/api-reference/json-rpc/base/debug-traceblockbynumber): Traces every transaction in a block, identified by number.
* [`trace_transaction`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-transaction): Returns the Parity-style trace of a mined transaction.
* [`trace_block`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-block): Returns Parity-style traces for every transaction in a block.
* [`trace_filter`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-filter): Returns Parity-style traces matching a filter.
* [`trace_call`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-call): Returns the Parity-style trace of an `eth_call`.
* [`trace_callMany`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-callmany): Returns Parity-style traces for a sequence of calls executed on top of the same block.
* [`trace_rawTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-rawtransaction): Returns Parity-style traces for a raw, signed transaction without broadcasting it.
* [`trace_replayBlockTransactions`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-replayblocktransactions): Replays every transaction in a block and returns the requested Parity-style traces.
* [`trace_replayTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-replaytransaction): Replays a mined transaction and returns the requested Parity-style traces.
* [`trace_get`](https://goldrush.dev/docs/api-reference/json-rpc/base/trace-get): Returns a single Parity-style trace at a given position within a transaction.

### Client information

* [`web3_clientVersion`](https://goldrush.dev/docs/api-reference/json-rpc/base/web3-clientversion): Returns the underlying client software version.
* [`web3_sha3`](https://goldrush.dev/docs/api-reference/json-rpc/base/web3-sha3): Returns the keccak-256 hash of the supplied data.

## Related

> [card] [JSON-RPC Overview](https://goldrush.dev/docs/goldrush-json-rpc/overview.md)
>
> Product overview and architecture.

> [card] [Authentication](https://goldrush.dev/docs/goldrush-json-rpc/authentication.md)
>
> Header reference and per-library setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.