Docs

Flow EVM RPC with Dwellir

Flow EVM RPC endpoints for Mainnet and Testnet; EVM JSON-RPC quickstarts for curl, ethers.js, viem, and web3.py

Flow EVM RPC

With Dwellir, you get access to our global Flow EVM network which always routes your API requests to the nearest available location, ensuring low latency and the fastest speeds.

Get your API key

Why Build on Flow EVM?

Flow EVM brings Ethereum compatibility to the Flow ecosystem so you can reuse your Solidity code, tools, and workflows with minimal changes.

  • EVM JSON-RPC compatible: works with ethers, viem, web3.js, and web3.py
  • Common frameworks: Hardhat, Foundry, and Truffle supported
  • Familiar UX: MetaMask and other EVM wallets connect seamlessly
  • Dwellir infra: global anycast, Archive/Trace/Debug/WebSocket support, and 99.99% uptime SLA

Quick Start with Flow EVM

Connect to Flow EVM in seconds with Dwellir's optimized endpoints:

Flow EVM RPC Endpoints
HTTPS
curl -sS -X POST https://api-flow-evm-gateway-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots> \  -H 'Content-Type: application/json' \  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
import { JsonRpcProvider } from 'ethers';const provider = new JsonRpcProvider(  'https://api-flow-evm-gateway-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>');const latest = await provider.getBlockNumber();console.log('block', latest);
import requestsurl = 'https://api-flow-evm-gateway-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>'payload = {  'jsonrpc': '2.0', 'id': 1,  'method': 'eth_blockNumber', 'params': []}resp = requests.post(url, json=payload)print(resp.json())
package mainimport (  "bytes"  "fmt"  "io"  "net/http")func main() {  url := "https://api-flow-evm-gateway-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>"  payload := []byte(`{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}`)  resp, err := http.Post(url, "application/json",    bytes.NewBuffer(payload))  if err != nil { panic(err) }  defer resp.Body.Close()  body, _ := io.ReadAll(resp.Body)  fmt.Println(string(body))}

Installation & Setup

Network Information

ParameterValueDetails
Mainnet Chain ID747 (0x2eb)Flow EVM Mainnet
Testnet Chain ID545 (0x221)Flow EVM Testnet
RPC StandardEthereum JSON-RPC 2.0EVM-compatible

API Reference

Flow EVM supports the full Ethereum JSON-RPC API specification.

Common Integration Patterns

Transaction Monitoring

Monitor pending and confirmed transactions efficiently:

JavaScript
// Watch for transaction confirmation
async function waitForTransaction(txHash, confirmations = 1) {
  return provider.waitForTransaction(txHash, confirmations);
}

Gas Optimization

Optimize gas costs on Flow EVM:

JavaScript
// Get current fee data (EIP-1559)
const feeData = await provider.getFeeData();

// Estimate gas for transaction
const gasEstimate = await provider.estimateGas(tx);

// Calculate total cost (approx.)
const totalCost = gasEstimate * (feeData.gasPrice ?? 0n);
console.log('Estimated cost:', totalCost);

Event Filtering

Efficiently query contract events:

JavaScript
// Query events with automatic retry and pagination
async function getEvents(contract, eventName, fromBlock = 0) {
  const filter = contract.filters[eventName]();
  const events = [];
  const batchSize = 2000; // Recommended batch size

  for (let i = fromBlock; i <= currentBlock; i += batchSize) {
    const batch = await contract.queryFilter(
      filter,
      i,
      Math.min(i + batchSize - 1, currentBlock)
    );
    events.push(...batch);
  }

  return events;
}

Performance Best Practices

1. Batch Requests

Combine multiple RPC calls for optimal performance:

JavaScript
const batch = [
  { method: 'eth_blockNumber', params: [] },
  { method: 'eth_gasPrice', params: [] },
  { method: 'eth_getBalance', params: [address, 'latest'] }
];

const results = await provider.send(batch);

2. Connection Pooling

Reuse provider instances to minimize connection overhead:

JavaScript
import { JsonRpcProvider } from 'ethers';

class FlowProvider {
  static instance = null;
  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-flow-evm-gateway-mainnet.n.dwellir.com/YOUR_API_KEY'
      );
    }
    return this.instance;
  }
}

3. Smart Caching

Cache immutable data to reduce API calls:

JavaScript
const cache = new Map();

async function getCachedBlockData(blockNumber) {
  const key = `block_${blockNumber}`;

  if (!cache.has(key)) {
    const block = await provider.getBlock(blockNumber);
    cache.set(key, block);
  }

  return cache.get(key);
}

Troubleshooting Common Issues

Error: "Transaction underpriced"

Flow EVM uses EIP-1559 pricing. Always use dynamic gas pricing:

JavaScript
// Get current fee data
const feeData = await provider.getFeeData();

const tx = {
  to: recipient,
  value: amount,
  maxFeePerGas: feeData.maxFeePerGas,
  maxPriorityFeePerGas: feeData.maxPriorityFeePerGas,
  gasLimit: 21000n
};

Error: "Rate limit exceeded"

Implement exponential backoff for resilient applications:

JavaScript
async function callWithRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.code === 429 && i < maxRetries - 1) {
        await new Promise(r => setTimeout(r, 2 ** i * 1000));
      } else {
        throw error;
      }
    }
  }
}

Migration Guide

From Ethereum Mainnet

Moving from Ethereum to Flow EVM requires minimal changes:

JavaScript
// Before (Ethereum)
const provider = new JsonRpcProvider('https://eth-rpc.example.com');

// After (Flow EVM)
const provider = new JsonRpcProvider(
  'https://api-flow-evm-gateway-mainnet.n.dwellir.com/YOUR_API_KEY'
);

// Smart contracts work identically
// Same tooling and libraries
// Note: Different chain ID (747)
// Note: Separate block numbers

Resources & Tools

Need Help?