Docs

eth_mining - Base RPC Method

Check the legacy eth_mining compatibility method on Base. Public endpoints often return a client-specific unsupported-method response instead of a boolean.

Checks the legacy eth_mining compatibility method on Base. Depending on the client behind the endpoint, this call may return a boolean, unimplemented, or a method-not-found style error.

Why Base? Build on Coinbase's L2 with 54% of L2 market revenue and direct access to 110M+ Coinbase users with $8B+ TVL, $0.08 gas fees, built-in Coinbase distribution, and seamless fiat rails.

Note: eth_mining is best treated as a node-local diagnostic and compatibility probe. Public endpoints often return false, unimplemented, or a method-not-found error, so it is not a reliable chain-health signal.

When to Use This Method

eth_mining is relevant for consumer app developers, SocialFi builders, and teams seeking easy fiat onramps:

  • Node Capability Checks — Verify whether the connected client still exposes this legacy method
  • Migration Audits — Remove assumptions that Ethereum-era mining RPCs always return a boolean
  • Fallback Design — Switch dashboards and health probes to eth_syncing, eth_blockNumber, or net_version

Code Examples

Common Use Cases

1. Capability-Aware Health Check

Combine eth_mining with other status RPCs, but treat unsupported responses as normal:

JavaScript
async function getNodeStatus(provider) {
  const [syncing, blockNumber] = await Promise.all([
    provider.send('eth_syncing', []),
    provider.getBlockNumber()
  ]);

  let miningStatus = { supported: false };
  try {
    miningStatus = {
      supported: true,
      result: await provider.send('eth_mining', [])
    };
  } catch {}

  return {
    miningStatus,
    isSynced: syncing === false,
    currentBlock: blockNumber
  };
}

2. Client Compatibility Check

Check whether the connected client still implements the legacy method:

JavaScript
async function checkEthMiningSupport(provider) {
  try {
    const mining = await provider.send('eth_mining', []);
    return { supported: true, mining };
  } catch (error) {
    return { supported: false, message: error.message };
  }
}

const status = await checkEthMiningSupport(provider);
console.log(status);

For production dashboards and health checks, prefer:

  • eth_blockNumber for liveness
  • eth_syncing for sync state
  • net_version or eth_chainId for endpoint identity

Error Handling

Common errors and solutions:

Error CodeDescriptionSolution
-32603Internal errorSome clients report unsupported legacy methods through the generic internal-error path
-32601Method not foundThe connected client does not expose this legacy method
-32005Rate limit exceededReduce polling frequency