Boba Network - Build on the Multichain Hybrid L2

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

Boba Network is the only multichain Layer 2 that delivers off-chain data and compute, enabling smarter applications for mass adoption. Built with hybrid blockchain technology, Boba Network offers:

🚀 Hybrid Technology

• HybridCompute™ - Connect on-chain smart contracts to off-chain data and APIs
• Up to 100x cheaper than underlying blockchains
• Fast finality - Lightning-fast transactions and confirmations

🛡️ Proven Security

• Optimistic Rollup - Secured by the underlying blockchain
• Battle-tested - Based on proven Optimism technology
• EVM compatible - Full compatibility with existing Ethereum tools

🌍 Multichain Innovation

• First multichain L2 - Deployed on Ethereum and BNB Chain
• Dual-fee tokens - Pay fees in $BOBA or native currency
• Growing ecosystem - Active developer community and partnerships

Quick Start with Boba Network

Connect to Boba Network in seconds with Dwellir's optimized endpoints:

🔗 RPC Endpoints

Boba Network Mainnet (Chain ID: 288)Live

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

✓ Archive Node✓ Trace API✓ Debug API✓ WebSocket

Quick Connect:

curl -X POST https://api-boba-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 Boba Network mainnet
const provider = new JsonRpcProvider(
  'https://api-boba-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 Boba Network mainnet
const web3 = new Web3(
  'https://api-boba-mainnet.n.dwellir.com/YOUR_API_KEY'
);

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

// 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';

// Create Boba Network client
const client = createPublicClient({
  chain: {
    id: 288,
    name: 'Boba Network',
    network: 'boba',
    nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
    rpcUrls: {
      default: { http: ['https://api-boba-mainnet.n.dwellir.com/YOUR_API_KEY'] },
      public: { http: ['https://api-boba-mainnet.n.dwellir.com/YOUR_API_KEY'] },
    },
  },
  transport: http('https://api-boba-mainnet.n.dwellir.com/YOUR_API_KEY'),
});

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

Network Information

Chain ID

288

Mainnet

Block Time

~2 seconds

Average

Gas Token

ETH

Native token

RPC Standard

Ethereum

JSON-RPC 2.0

JSON-RPC API Reference

Boba Network supports the full Ethereum JSON-RPC API specification. Access all standard methods plus hybrid compute features.

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 Boba Network's multichain L2?

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);
  
  // Boba Network: Check transaction details
  console.log('Transaction confirmed on Boba Network');
  console.log('Block number:', receipt.blockNumber);
  
  return receipt;
}

💰 Gas Optimization

Optimize gas costs on Boba Network:

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

// Get current gas price
const gasPrice = await provider.getGasPrice();

// Calculate total cost
const totalCost = gasEstimate * gasPrice;
console.log('Estimated cost:', totalCost.toString(), 'wei');

🔍 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; // Boba Network 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:

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 BobaProvider {
  static instance = null;
  
  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-boba-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: "Insufficient funds for gas"

Boba Network transactions require ETH for gas fees:

// Check balance and gas requirements
const balance = await provider.getBalance(address);
const gasEstimate = await provider.estimateGas(tx);
const gasPrice = await provider.getGasPrice();
const totalRequired = gasEstimate * gasPrice + (tx.value || 0n);

if (balance < totalRequired) {
  throw new Error(`Need ${totalRequired - balance} more ETH`);
}

Error: "Transaction underpriced"

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

Migration Guide

From Ethereum Mainnet

Moving from L1 to Boba Network requires minimal changes:

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

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

// ✅ Smart contracts work identically
// ✅ Same tooling and libraries
// ⚠️ Different chain ID (288)
// ⚠️ Separate block numbers
// ✅ Lower gas costs

Resources & Tools

Official Resources

• Boba Network Documentation
• Boba Gateway Bridge
• Boba Block Explorer

Developer Tools

• Hardhat Integration
• Foundry Setup
• Developer Resources

Need Help?

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

---

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