Binance Smart Chain - Build on the BNB Ecosystem

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

Binance Smart Chain (BSC) is a fast, low-cost blockchain that runs parallel to Binance Chain, offering EVM compatibility and a thriving ecosystem:

⚡ High Performance

• 3-second block times - Fast transaction confirmations
• Low transaction costs - Significantly cheaper than Ethereum
• High throughput - Handles high transaction volumes efficiently

🏗️ EVM Compatibility

• Binance ecosystem - Backed by world's largest crypto exchange
• Ethereum compatibility - Deploy Ethereum dApps without changes
• Mature infrastructure - Battle-tested with billions in TVL

🌐 Vibrant Ecosystem

• PancakeSwap - Leading DEX with massive liquidity
• BNB token integration - Native support for BNB ecosystem
• Cross-chain bridges - Easy asset transfers from other chains

Quick Start with Binance Smart Chain

Connect to Binance Smart Chain in seconds with Dwellir's optimized endpoints:

🔗 RPC Endpoints

Binance Smart Chain MainnetChain ID: 56

Mainnet

HTTPS

https://api-bsc-mainnet-full.n.dwellir.com/YOUR_API_KEY

✓ Full Node✓ Debug API✓ WebSocket

Quick Connect:

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

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

// 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 { bsc } from 'viem/chains';

// Create BSC client
const client = createPublicClient({
  chain: bsc,
  transport: http('https://api-bsc-mainnet-full.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

56

Mainnet

Block Time

3 seconds

Average

Gas Token

BNB

Native token

RPC Standard

Ethereum

JSON-RPC 2.0

JSON-RPC API Reference

Binance Smart Chain supports the full Ethereum JSON-RPC API specification with EVM compatibility. Access all standard Ethereum methods on the BNB ecosystem.

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 Binance Smart Chain?

Get your API key →

Common Integration Patterns

🔄 Transaction Monitoring

Monitor pending and confirmed transactions efficiently on BSC:

// Watch for transaction confirmation
async function waitForTransaction(txHash) {
  const receipt = await provider.waitForTransaction(txHash, 1);
  
  // BSC has fast 3-second block times
  console.log('Transaction confirmed in block:', receipt.blockNumber);
  console.log('Gas used:', receipt.gasUsed.toString());
  
  return receipt;
}

💰 Gas Optimization

Optimize gas costs on Binance Smart Chain:

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

// Get current gas price (BSC uses standard gas pricing)
const gasPrice = await provider.getGasPrice();

// Calculate total cost in BNB
const totalCost = gasEstimate * gasPrice;
console.log('Total cost in BNB:', formatEther(totalCost));

🔍 Event Filtering

Efficiently query contract events on BSC:

// Query events with automatic retry and pagination
async function getEvents(contract, eventName, fromBlock = 0) {
  const filter = contract.filters[eventName]();
  const events = [];
  const batchSize = 5000; // BSC can handle larger batch sizes
  
  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 BSCProvider {
  static instance = null;
  
  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-bsc-mainnet-full.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"

BSC transactions require BNB for gas fees:

// Check BNB balance for gas fees
const balance = await provider.getBalance(address);
const gasEstimate = await provider.estimateGas(tx);
const gasPrice = await provider.getGasPrice();
const totalRequired = gasEstimate * gasPrice + tx.value;

if (balance < totalRequired) {
  const needed = formatEther(totalRequired - balance);
  throw new Error(`Need ${needed} more BNB`);
}

Error: "Transaction underpriced"

BSC uses legacy gas pricing. Use current gas price:

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

const tx = {
  to: recipient,
  value: amount,
  gasPrice: gasPrice,
  gasLimit: 21000n,
  type: 0 // Legacy transaction type
};

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 Ethereum to Binance Smart Chain requires minimal changes:

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

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

// ✅ Smart contracts work identically
// ✅ Same tooling and libraries
// ⚠️ Different chain ID (56)
// ⚠️ Separate block numbers
// ⚠️ Different gas token (BNB instead of ETH)
// ⚠️ Legacy gas pricing (no EIP-1559)

Resources & Tools

Official Resources

• BSC Documentation
• BSC Bridge
• BscScan Block Explorer

Developer Tools

• Hardhat Config
• Truffle Integration
• Remix IDE

Need Help?

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

---

Start building on Binance Smart Chain with Dwellir's enterprise-grade RPC infrastructure. Get your API key →