PulseChain - Build on the Energy-Efficient EVM Layer 1

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

PulseChain is an EVM-compatible Layer 1 blockchain offering low transaction fees and energy-efficient Proof-of-Stake consensus. It features a full-state fork of Ethereum with native token duplication:

🚀 High Performance

• 3-second block times - Fast transaction confirmations
• 4x higher throughput than Ethereum
• Low gas fees - Significantly cheaper than Ethereum mainnet

🛡️ Robust Security

• Proof-of-Stake consensus - Energy-efficient validation
• 33 rotating validators - Decentralized network security
• Slashing mechanisms - Economic security guarantees

🌍 Growing Ecosystem

• Full Ethereum fork - All Ethereum state duplicated at launch
• Native asset duplication - PRC-20 token system
• EVM compatibility - Seamless migration for Ethereum dApps

Quick Start with PulseChain

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

🔗 RPC Endpoints

PulseChain Mainnet (Chain ID: 369)Live

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

✓ Archive Node✓ Trace API✓ Debug API✓ WebSocket

Quick Connect:

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

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

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

// Create PulseChain client
const client = createPublicClient({
  chain: pulsechain,
  transport: http('https://api-pulse-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

369

Mainnet

Block Time

3 seconds

Average

Gas Token

PLS

Native token

RPC Standard

Ethereum

JSON-RPC 2.0

JSON-RPC API Reference

PulseChain supports the full Ethereum JSON-RPC API specification. Access all standard methods for EVM-compatible development.

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 PulseChain's energy-efficient blockchain?

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 status
  if (receipt.status === 1) {
    console.log('Transaction successful');
  }
  
  return receipt;
}

💰 Gas Optimization

Optimize gas costs on PulseChain:

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

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

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

🔍 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; // PulseChain 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 PulseChainProvider {
  static instance = null;
  
  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-pulse-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"

PulseChain transactions require PLS for gas fees:

// Check balance before sending transaction
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) {
  throw new Error(`Need ${totalRequired - balance} more PLS`);
}

Error: "Transaction underpriced"

PulseChain 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 Ethereum to PulseChain requires minimal changes:

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

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

// ✅ Smart contracts work identically
// ✅ Same tooling and libraries
// ⚠️ Different chain ID (369)
// ⚠️ PLS gas token instead of ETH
// ⚠️ Separate block numbers

Resources & Tools

Official Resources

• PulseChain Website
• PulseChain Bridge
• PulseChain Explorer

Developer Tools

• Hardhat Config
• Foundry Setup
• PulseX DEX

Need Help?

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

---

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