Docs

eth_gasPrice - Immutable RPC Method

Get current gas price on Immutable. Essential for transaction cost estimation for Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets.

Returns the current gas price on Immutable in wei.

Why Immutable? Build on the gaming-optimized zkEVM with 660+ games, 5.5M+ Passport signups, and $40M TVL with first EVM chain with enforceable royalties, Polygon zkEVM technology, $2B+ ecosystem funding, and Agglayer cross-chain liquidity.

When to Use This Method

The eth_gasPrice method serves these key scenarios for AAA game studios, indie game developers, and NFT gaming teams seeking enforceable royalties:

  • Set gas price for legacy transactions - Use the returned wei value as the gasPrice field in legacy (pre-EIP-1559) transactions on Immutable
  • Monitor network congestion - Track gas price fluctuations to determine the best time to submit transactions for lower fees
  • Estimate transaction costs - Multiply gas price by estimated gas units to calculate the total cost before sending any transaction
  • Build gas price oracles - Feed real-time gas price data into fee estimation UIs, automated trading bots, and wallet applications

Common Use Cases

1. Calculate Total Transaction Cost

Multiply the current gas price by the estimated gas for a transaction to determine the total cost in the native currency of Immutable. This lets users see the expected fee before confirming any transaction.

JavaScript
import { JsonRpcProvider, formatUnits } from 'ethers';

const provider = new JsonRpcProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY');

async function calculateTransactionCost(gasLimit) {
  const gasPrice = await provider.send('eth_gasPrice', []);
  const costWei = BigInt(gasPrice) * BigInt(gasLimit);
  const costEth = formatUnits(costWei, 'ether');
  console.log(`Gas price: ${formatUnits(gasPrice, 'gwei')} Gwei`);
  console.log(`Estimated cost: ${costEth} ETH`);
  return costEth;
}

await calculateTransactionCost(21000);

2. Build Dynamic Gas Price Strategy

Adjust gas prices dynamically based on current network conditions. During peak congestion on Immutable, multiply the base gas price by 1.2-1.5x for faster inclusion; during quiet periods, use the raw gas price for the most economical confirmation.

JavaScript
import { JsonRpcProvider, formatUnits } from 'ethers';

const provider = new JsonRpcProvider('https://api-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY');

async function getDynamicGasPrice(strategy = 'medium') {
  const baseGasPrice = BigInt(await provider.send('eth_gasPrice', []));
  const multipliers = { low: 1.0, medium: 1.2, high: 1.5 };

  const adjustedPrice = baseGasPrice * BigInt(Math.floor(multipliers[strategy] * 100)) / 100n;

  console.log(`Base gas price: ${formatUnits(baseGasPrice, 'gwei')} Gwei`);
  console.log(`Strategy (${strategy}): ${formatUnits(adjustedPrice, 'gwei')} Gwei`);
  return adjustedPrice;
}

await getDynamicGasPrice('medium');

3. Compare Gas Prices Across Chains

If your application supports multiple chains, compare gas prices to route transactions to the most cost-effective network. This is particularly useful for cross-chain bridges and multi-chain DeFi aggregators.

JavaScript
const chains = {
  ethereum: 'https://eth.dwellir.com',
  polygon: 'https://polygon.dwellir.com',
  arbitrum: 'https://arb.dwellir.com'
};

async function compareGasPrices() {
  const results = {};
  for (const [name, rpcUrl] of Object.entries(chains)) {
    const provider = new JsonRpcProvider(rpcUrl);
    const gasPrice = await provider.send('eth_gasPrice', []);
    results[name] = {
      wei: BigInt(gasPrice).toString(),
      gwei: Number(BigInt(gasPrice)) / 1e9
    };
  }

  const sorted = Object.entries(results).sort((a, b) => a[1].gwei - b[1].gwei);
  console.log('Cheapest chain:', sorted[0][0], '-', sorted[0][1].gwei, 'Gwei');
  return results;
}

compareGasPrices();

Best Practices

  • Legacy gas price is a single number: for EIP-1559 transactions, prefer using eth_feeHistory combined with eth_maxPriorityFeePerGas instead
  • The return value is in wei: divide by 1e9 to convert to gwei, which is the standard unit for gas price display
  • Consider current network conditions on Immutable: multiply by 1.2-1.5x for faster block inclusion during congestion
  • Most modern chains use EIP-1559 exclusively: check if Immutable supports dynamic fee transactions before relying on legacy gas price

Code Examples

Error Handling

Error CodeMessageDescription
-32603Internal errorNode error