⛓️ Blockchain Integration Guides

Production-ready implementation guides for integrating major blockchain networks with the Quub Exchange Chain API. Each guide provides comprehensive coverage of chain registration, RPC adapter setup, wallet management, transaction tracking, security best practices, and production deployment checklists.

1️⃣

Layer 1 Blockchains

Ethereum, BNB Chain, Avalanche, Solana

2️⃣

Network Comparison

Performance metrics and feature matrix

🏗️

🌐 Layer 1 Blockchains

Ethereum — The EVM Foundation

⟠

Ethereum Integration Guide

Most mature smart contract platform with robust tooling and ecosystem

✅ 12-second block times with ~15 minute finality
✅ EIP-1559 dynamic gas pricing with priority fees
✅ MEV protection strategies (private mempools, Flashbots)
✅ Comprehensive ERC standards (20, 721, 1155, 4337)
✅ Account abstraction and smart contract wallets

View Ethereum Guide →

Best For: DeFi protocols, NFT platforms, high-value transactions, complex smart contracts

BNB Chain — High Throughput, Low Cost

🔶

BNB Chain Integration Guide

EVM-compatible chain optimized for fast, low-cost transactions

✅ 3-second block times with ~15 second finality
✅ Ultra-low gas fees (typically <$0.10 per transaction)
✅ BEP-20 token standard (ERC-20 compatible)
✅ High throughput for retail and gaming applications
✅ Proof of Staked Authority (PoSA) consensus

View BNB Guide →

Best For: Gaming, retail payments, high-frequency trading, token launches

Avalanche — Sub-Second Finality

🔺

Avalanche Integration Guide

High-performance platform with near-instant finality and subnet architecture

✅ Sub-second block times with <2 second finality
✅ C-Chain (EVM-compatible) for smart contracts
✅ Dynamic fee adjustment based on network load
✅ Subnet support for custom blockchain instances
✅ Native cross-chain messaging

View Avalanche Guide →

Best For: Real-time applications, institutional DeFi, custom subnets, low-latency trading

Solana — Non-EVM High Performance

◎

Solana Integration Guide

Ultra-fast non-EVM blockchain with unique architecture and SPL token standard

✅ 400ms slot times with 12.8s finality (67 slots)
✅ Base58 signatures and account-based architecture
✅ SPL token standard (distinct from ERC-20)
✅ Commitment levels (processed, confirmed, finalized)
✅ Ultra-low transaction costs ($0.00025 per tx)

View Solana Guide →

Best For: High-frequency trading, on-chain order books, NFT minting, payment processing

🔗 Layer 2 Networks

Polygon — Mature PoS Sidechain

🟣

Polygon Integration Guide

Established PoS sidechain with Ethereum bridging and checkpoint finality

✅ 2-second block times with ~30 minute checkpoint finality
✅ Native Ethereum bridge with security guarantees
✅ Tiered confirmation strategy (probabilistic → checkpointed)
✅ Very low gas fees (~$0.01 per transaction)
✅ zkEVM rollup option for enhanced security

View Polygon Guide →

Best For: NFT marketplaces, gaming, enterprise applications, Ethereum scaling

Arbitrum One — Leading Optimistic Rollup

🔵

Arbitrum Integration Guide

Most adopted optimistic rollup with full EVM equivalence

✅ 250ms block times with 7-day challenge period
✅ Full EVM compatibility with fraud proofs
✅ Standard bridge operations (deposit/withdraw)
✅ Nitro upgrade for improved performance
✅ Low L2 gas fees, batched L1 settlement

View Arbitrum Guide →

Best For: DeFi protocols, complex dApps, Ethereum L2 scaling with security priority

Optimism — OP Stack Foundation

🔴

Optimism Integration Guide

Modular OP Stack rollup with governance token and public goods funding

✅ 2-second block times with 7-day challenge period
✅ Standard Bridge and fault proof system
✅ OP Stack modularity for custom chains
✅ Batch submission for cost efficiency
✅ Bedrock upgrade for improved performance

View Optimism Guide →

Best For: Superchain ecosystem, custom OP Stack rollups, DeFi and governance applications

Base — Coinbase L2

🔵

Base Integration Guide

Coinbase-backed OP Stack L2 with seamless onramp integration

✅ 2-second block times with OP Stack architecture
✅ Ultra-low gas fees and high throughput
✅ Native Coinbase integration for fiat onramps
✅ Standard Bridge compatibility with Optimism
✅ Growing ecosystem with retail focus

View Base Guide →

Best For: Consumer applications, social platforms, onchain products with fiat connectivity

📊 Network Comparison Matrix

Performance Metrics

Blockchain	Type	Block Time	Finality	Gas Token	Avg Gas Cost	TPS
Ethereum	L1	12s	~15 min	ETH	$5-50	15-30
BNB Chain	L1	3s	~15s	BNB	<$0.10	160+
Avalanche	L1	<1s	<2s	AVAX	$0.10-1	4,500+
Solana	L1	400ms	12.8s	SOL	<$0.001	2,000+
Polygon	L2	2s	~30 min*	MATIC	~$0.01	7,000+
Arbitrum	L2	250ms	7 days*	ETH	$0.10-1	4,000+
Optimism	L2	2s	7 days*	ETH	$0.10-1	2,000+
Base	L2	2s	7 days*	ETH	$0.10-1	2,000+

* Finality times represent withdrawal/challenge periods. Practical/probabilistic finality is much faster.

Feature Compatibility

Feature	Ethereum	BNB	Avalanche	Solana	Polygon	Arbitrum	Optimism	Base
EVM Compatible	✅ Native	✅ Yes	✅ C-Chain	❌ No	✅ Yes	✅ Yes	✅ Yes	✅ Yes
Smart Contracts	✅ Solidity	✅ Solidity	✅ Solidity	✅ Rust	✅ Solidity	✅ Solidity	✅ Solidity	✅ Solidity
Token Standard	ERC-20	BEP-20	ERC-20	SPL	ERC-20	ERC-20	ERC-20	ERC-20
Bridge Required	-	-	-	-	✅ Yes	✅ Yes	✅ Yes	✅ Yes
MEV Protection	✅ Flashbots	⚠️ Limited	⚠️ Limited	✅ Jito	⚠️ Limited	✅ Available	✅ Available	✅ Available
Account Abstraction	✅ EIP-4337	⚠️ Limited	✅ Yes	✅ Native	✅ EIP-4337	✅ EIP-4337	✅ EIP-4337	✅ EIP-4337

Use Case Recommendations

Use Case	Recommended Networks	Rationale
DeFi Protocols	Ethereum, Arbitrum, Optimism	Deep liquidity, security, composability
NFT Marketplaces	Ethereum, Polygon, Base	Established standards, low minting costs
Gaming	BNB Chain, Polygon, Avalanche	High throughput, low costs, fast finality
Payment Processing	Solana, BNB Chain, Base	Ultra-low fees, fast confirmation
High-Frequency Trading	Solana, Avalanche	Sub-second finality, low latency
Enterprise Apps	Polygon, Avalanche Subnets	Scalability, custom network options
Consumer Social	Base, Polygon	Low barrier to entry, fiat integration

🏗️ Common Integration Architecture

Standard Integration Pattern

All blockchain integrations follow a consistent pattern with the Quub Exchange Chain API:

┌─────────────────────────────────────────────────────────────┐
│                     Your Application                         │
│  (Trading Platform, DeFi Protocol, Exchange, etc.)           │
└────────────────────────┬────────────────────────────────────┘
                         │
                         │ REST API Calls
                         │ (JWT Bearer Token)
                         ▼
┌─────────────────────────────────────────────────────────────┐
│              Quub Exchange Chain API                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │   Chains     │  │   Wallets    │  │ OnChainTxs   │      │
│  │  Registry    │  │  Management  │  │   Tracking   │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │   Chain      │  │   Health     │  │   Events     │      │
│  │  Adapters    │  │  Monitoring  │  │   Webhooks   │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└────────────────────────┬────────────────────────────────────┘
                         │
                         │ RPC Calls / Indexer Queries
                         ▼
┌─────────────────────────────────────────────────────────────┐
│              Blockchain Networks                             │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │ Ethereum │  │   BNB    │  │  Solana  │  │ Polygon  │   │
│  │   RPC    │  │   RPC    │  │   RPC    │  │   RPC    │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │ Arbitrum │  │ Optimism │  │   Base   │  │Avalanche │   │
│  │   RPC    │  │   RPC    │  │   RPC    │  │   RPC    │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
└─────────────────────────────────────────────────────────────┘

Integration Workflow

1. Chain Registration

// Register blockchain network with metadata
POST /chains
{
  "chainId": 1,
  "name": "Ethereum Mainnet",
  "networkType": "MAINNET",
  "layer": "L1",
  "nativeCurrency": { "symbol": "ETH", "decimals": 18 }
}

2. RPC Adapter Configuration

// Configure chain adapter with RPC endpoints
POST /chain/adapters
{
  "chainId": 1,
  "name": "Ethereum Primary Adapter",
  "rpcEndpoint": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
  "signerPolicy": "HOT_WALLET",
  "priority": 1
}

3. Wallet Management

// Register organization wallet
POST /orgs/{orgId}/wallets
{
  "chainId": 1,
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "type": "HOT_WALLET",
  "label": "Trading Wallet"
}

4. Transaction Tracking

// Record on-chain transaction
POST /orgs/{orgId}/onchain/txs
{
  "chainId": 1,
  "hash": "0xabc123...",
  "fromAddress": "0x742d...",
  "toAddress": "0x123abc...",
  "direction": "OUTBOUND",
  "status": "PENDING"
}

5. Health Monitoring

// Monitor adapter health
GET / chain / adapters / { adapterId } / health;
// Returns: status, latencyMs, syncLag, lastBlockHeight

Security Best Practices (All Chains)

#### 🔐 Authentication & Authorization - ✅ Use OAuth2 with appropriate scopes (`read:chain`, `write:chain`) - ✅ Rotate API keys regularly (90-day maximum) - ✅ Implement rate limiting at application level - ✅ Use separate credentials for production and sandbox #### 🔒 Transaction Security - ✅ Validate all addresses using chain-specific formats - ✅ Implement multi-signature requirements for high-value transactions - ✅ Use hardware wallets or MPC for custody - ✅ Enable MEV protection on supported chains #### 🛡️ Data Protection - ✅ Encrypt sensitive data at rest and in transit - ✅ Never log private keys or seed phrases - ✅ Implement proper key management (HSM, KMS) - ✅ Regular security audits of wallet infrastructure #### ⚡ Operational Security - ✅ Monitor for unusual transaction patterns - ✅ Set up alerts for failed transactions - ✅ Maintain hot/cold wallet separation - ✅ Implement withdrawal limits and velocity checks

Performance Optimization Strategies

Gas Optimization

// Dynamic gas pricing based on network conditions
async function estimateOptimalGas(chainId, tx) {
  const adapter = await getChainAdapter(chainId);
  const health = await adapter.getHealth();

  if (health.congestion === "high") {
    return tx.gasLimit * 1.2; // 20% buffer
  }
  return tx.gasLimit;
}

Transaction Batching

// Batch multiple operations for efficiency
async function batchWalletCreation(orgId, wallets) {
  const promises = wallets.map((wallet) => createWallet(orgId, wallet));
  return Promise.all(promises);
}

Caching Strategy

// Cache chain metadata to reduce API calls
const chainCache = new Map();
const CACHE_TTL = 3600000; // 1 hour

async function getChainMetadata(chainId) {
  const cached = chainCache.get(chainId);
  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }

  const data = await fetchChainDetails(chainId);
  chainCache.set(chainId, { data, timestamp: Date.now() });
  return data;
}

🚀 Getting Started

Choose Your Integration Path

Start with a Specific Blockchain — Select from the guides above based on your use case
Review the Chain API Guide — Understand the core Chain API operations
Set Up Authentication — Configure OAuth2 credentials
Deploy to Production — Follow blockchain-specific production checklists