Flow EVM Gateway RPC Documentation

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

JavaScript

import { JsonRpcProvider } from 'ethers';

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

// Get the latest block
const block = await provider.getBlock('latest');
console.log('Latest block:', block.number);

// Query account balance
const balance = await provider.getBalance('0x...');
console.log('Balance:', balance.toString());

JavaScript

const Web3 = require('web3');

// Connect to Flow EVM mainnet
const web3 = new Web3(
  'https://api-flow-evm-gateway-mainnet.n.dwellir.com/YOUR_API_KEY'
);

// Get chain ID to verify connection
const chainId = await web3.eth.getChainId();
console.log('Connected to Flow EVM:', chainId === 747);

// Get gas price for optimal transaction pricing
const gasPrice = await web3.eth.getGasPrice();
console.log('Current gas price:', gasPrice);

TypeScript

import { createPublicClient, http } from 'viem';

// Create Flow EVM client
const client = createPublicClient({
  transport: http('https://api-flow-evm-gateway-mainnet.n.dwellir.com/YOUR_API_KEY'),
});

// Read contract data
const data = await client.readContract({
  address: '0x...',
  abi: contractAbi,
  functionName: 'balanceOf',
  args: ['0x...'],
});

Python

from web3 import Web3

# Connect to Flow EVM mainnet
web3 = Web3(Web3.HTTPProvider(
  'https://api-flow-evm-gateway-mainnet.n.dwellir.com/YOUR_API_KEY'
))

# Verify connection
print('Connected:', web3.is_connected())
print('Chain ID:', web3.eth.chain_id)

# Get latest block
latest_block = web3.eth.get_block('latest')
print(f'Latest block: {latest_block.number}')

Network Information

Parameter	Value	Details
Mainnet Chain ID	747 (0x2eb)	Flow EVM Mainnet
Testnet Chain ID	545 (0x221)	Flow EVM Testnet
RPC Standard	Ethereum JSON-RPC 2.0	EVM-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?

Email: support@dwellir.com
Dashboard: dashboard.dwellir.com
Get Access: Get your API key

Flow EVM RPC with Dwellir

Why Build on Flow EVM?

Quick Start with Flow EVM

Installation & Setup

Network Information

API Reference

Common Integration Patterns

Transaction Monitoring

Gas Optimization

Event Filtering

Performance Best Practices

1. Batch Requests

2. Connection Pooling

3. Smart Caching

Troubleshooting Common Issues

Error: "Transaction underpriced"

Error: "Rate limit exceeded"

Migration Guide

From Ethereum Mainnet

Resources & Tools

Need Help?

On this page