Scroll zkEVM - Build on Ethereum's Zero-Knowledge Layer 2

Scroll RPC
With Dwellir, you get access to our global Scroll 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 Scroll?

Scroll is a zkRollup Layer 2 solution for Ethereum that maintains full EVM compatibility while leveraging zero-knowledge proofs for enhanced security and efficiency. Built by Ethereum developers for the Ethereum community, Scroll offers:

🔒 Zero-Knowledge Security

• zkEVM technology - Native EVM compatibility with ZK proof verification
• Ethereum-level security - Inherits L1 security guarantees through cryptographic proofs
• Type 3 zkEVM - Bytecode-compatible with plans to evolve to Type 1

⚡ Developer-First Experience

• Seamless migration - Existing Ethereum dApps work without code changes
• Native tooling support - Hardhat, Remix, MetaMask, and all Ethereum tools
• 100+ ecosystem projects - Growing DeFi and Web3 application ecosystem

💰 Cost-Effective Scaling

• Dramatically lower fees - Orders of magnitude cheaper than Ethereum L1
• $281M+ TVL - Strong and growing total value locked
• 119M+ transactions - Proven at scale with millions of transactions processed

Quick Start with Scroll

Connect to Scroll in seconds with Dwellir's optimized endpoints:

🔗 RPC Endpoints

Scroll Mainnet (Chain ID: 534352)Live

https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY

✓ Archive Node✓ Trace API✓ Debug API✓ WebSocket

Quick Connect:

curl -X POST https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Installation & Setup

Ethers.js v6

import { JsonRpcProvider } from 'ethers';

// Connect to Scroll mainnet
const provider = new JsonRpcProvider(
  'https://api-scroll-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());

Web3.js

const Web3 = require('web3');

// Connect to Scroll mainnet
const web3 = new Web3(
  'https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY'
);

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

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

Viem

import { createPublicClient, http } from 'viem';
import { scroll } from 'viem/chains';

// Create Scroll client
const client = createPublicClient({
  chain: scroll,
  transport: http('https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY'),
});

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

Web3.py

from web3 import Web3

# Connect to Scroll mainnet
w3 = Web3(Web3.HTTPProvider(
  'https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY'
))

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

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

Network Information

Chain ID

534352

Mainnet

Gas Token

ETH

Native token

RPC Standard

Ethereum

JSON-RPC 2.0

Consensus

zkRollup

Zero-Knowledge

JSON-RPC API Reference

Scroll supports the full Ethereum JSON-RPC API specification. Access all standard methods with zkEVM compatibility.

Available JSON-RPC Methods

📊 Reading Blockchain Data

Query blocks, transactions, and account states

+

📤 Sending Transactions

Submit and manage transactions

+

📝 Smart Contract Interaction

Call and interact with smart contracts

+

🔧 Node & Network Info

Query node status and network information

+

Ready to build on Scroll zkEVM?

Get your API key →

Common Integration Patterns

🔄 Transaction Monitoring

Monitor pending and confirmed transactions efficiently:

// Watch for transaction confirmation
async function waitForTransaction(txHash) {
  const receipt = await provider.waitForTransaction(txHash, 1);
  
  // Check transaction success
  if (receipt.status === 1) {
    console.log('Transaction confirmed:', receipt.transactionHash);
    console.log('Gas used:', receipt.gasUsed.toString());
  }
  
  return receipt;
}

💰 Gas Optimization

Optimize gas costs on Scroll zkEVM:

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

// Estimate gas for transaction
const gasLimit = await provider.estimateGas({
  to: recipient,
  value: ethers.parseEther("0.1"),
  data: "0x"
});

// Calculate total transaction cost
const maxFee = feeData.maxFeePerGas * gasLimit;
console.log('Max transaction cost:', ethers.formatEther(maxFee), 'ETH');

🔍 Event Filtering

Efficiently query contract events:

// 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
  const currentBlock = await provider.getBlockNumber();
  
  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:

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:

// Singleton pattern for provider
class ScrollProvider {
  static instance = null;
  
  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY'
      );
    }
    return this.instance;
  }
}

3. Smart Caching

Cache immutable data to reduce API calls:

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: "Wrong chain ID"

Scroll uses chain ID 534352. Ensure your wallet and application are configured correctly:

// Verify chain connection
const network = await provider.getNetwork();
if (network.chainId !== 534352n) {
  throw new Error(`Wrong network! Expected 534352, got ${network.chainId}`);
}

Error: "Transaction underpriced"

Scroll uses EIP-1559 pricing. Always use dynamic gas pricing:

// 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:

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;
      }
    }
  }
}

Smoke Tests

Basic Connectivity Tests

cURL

# Test connection and get latest block
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY

# Expected response: {"jsonrpc":"2.0","id":1,"result":"0x..."}

Ethers.js

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

// Test basic connectivity
const blockNumber = await provider.getBlockNumber();
const network = await provider.getNetwork();

console.log('Block number:', blockNumber);
console.log('Chain ID:', network.chainId); // Should be 534352n
console.log('Chain name:', network.name);

Web3.py

from web3 import Web3

w3 = Web3(Web3.HTTPProvider(
  'https://api-scroll-mainnet.n.dwellir.com/YOUR_API_KEY'
))

# Test connection
print('Connected:', w3.is_connected())
print('Chain ID:', w3.eth.chain_id)  # Should be 534352
print('Block number:', w3.eth.block_number)

Migration Guide

From Ethereum Mainnet

Moving from L1 to Scroll zkEVM requires minimal changes:

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

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

// ✅ Smart contracts work identically
// ✅ Same tooling and libraries
// ✅ Full EVM compatibility
// ⚠️ Different chain ID (534352)
// ⚠️ Separate block numbers
// ⚠️ Much lower gas costs

Resources & Tools

Official Resources

• Scroll Documentation
• Scroll Bridge
• Scroll Block Explorer

Developer Tools

• GitHub Repository
• Scroll Ecosystem
• Developer Portal

Need Help?

• 📧 Email: support@dwellir.com
• 📚 Docs: You're here!
• 🎯 Dashboard: dashboard.dwellir.com

---

Start building on Scroll zkEVM with Dwellir's enterprise-grade RPC infrastructure. Get your API key →