TeQoin L2 Blockchain Documentation - Developer Guides & API Reference

A comprehensive look at TeQoin’s Layer-2 architecture, components, and how they work together to provide fast, low-fee transactions while maintaining Ethereum’s security.

Target Audience: Developers, researchers, and technical users who want to understand how TeQoin works internally.

🎯 What is TeQoin?

TeQoin is an Optimistic Rollup Layer-2 scaling solution built on Ethereum.

Key Characteristics

Aspect	Details
Type	Optimistic Rollup
Base Layer	Ethereum (L1)
EVM Compatibility	100% compatible
Block Time	5 seconds
Transaction Fees	Very low (~$0.001)
Finality	Instant (optimistic) + 7 days (final)
Security	Inherits from Ethereum

🏗️ Architecture Overview

System Components

Core Components

Sequencer

Block Production

Receives transactions from users
Orders and batches transactions
Produces L2 blocks every 5 seconds
Posts batches to Ethereum L1

L2 Execution Layer

Transaction Processing

Executes EVM transactions
Maintains L2 state
100% EVM compatible
Geth-based execution

Bridge Contracts

L1 ↔ L2 Communication

Deposit ETH from L1 to L2
Withdraw ETH from L2 to L1
Message passing
Asset backing (1:1)

State Contract (L1)

Data Availability

Stores transaction batches
Records state roots
Enables fraud proofs
Guarantees data availability

🔄 Transaction Flow

User Transaction Lifecycle

User Submits Transaction

User sends transaction to the sequencer via RPC endpoint

    // User's wallet sends transaction
    const tx = await signer.sendTransaction({
      to: recipient,
      value: ethers.parseEther('0.1')
    });

Sequencer Receives & Orders

Sequencer receives transaction and adds it to the mempool

Validates transaction format
Checks signature
Orders by gas price (if needed) or FIFO

Execution on L2

Transaction is executed in the next L2 block (~5 seconds)

EVM executes transaction
State is updated
Receipt is generated
User gets confirmation (instant)

Batching

Sequencer batches multiple transactions together

Collects transactions over time window (e.g., 10 minutes)
Compresses transaction data
Creates batch with hundreds/thousands of TXs

Posting to L1

Batch is posted to Ethereum L1

Transaction data posted to L1 calldata
State root committed
Data becomes publicly available

L1 Finalization

After 7-day challenge period, transaction is final

No fraud proofs submitted = valid
Withdrawal can be finalized
Transaction is permanently settled

📊 Data Flow

How Data Moves Through the System

🔐 Security Model

Layered Security Approach

Layer 1: Data Availability
Layer 2: Fraud Proofs
Layer 3: Smart Contract Security
Layer 4: Decentralization

All data on Ethereum L1Every transaction’s data is posted to Ethereum:

Transaction inputs
Signatures
State transitions

Why this matters:

Anyone can reconstruct L2 state from L1 data
No data can be hidden or censored
If sequencer disappears, users can recover funds

Cost optimization:

Data is compressed before posting
Batching reduces per-transaction cost
Calldata is cheaper than storage

⚙️ Key Technical Specifications

Network Parameters

Parameter	Value	Purpose
Chain ID	420377	Network identifier
Block Time	5 seconds	Time between blocks
Block Gas Limit	30,000,000	Maximum gas per block
Batch Interval	~10 minutes	How often batches post to L1
Challenge Period	7 days	Fraud proof window
EVM Version	Shanghai	Ethereum compatibility

Performance Metrics

Metric	TeQoin L2	Ethereum L1	Improvement
Block Time	5 seconds	12 seconds	2.4x faster
TPS	1000+	15-30	50x+ more
Finality (Soft)	5 seconds	12 seconds	2.4x faster
Finality (Hard)	7 days	15 minutes	Slower (trade-off)
Gas Cost	~$0.001/tx	$5-50/tx	5000x+ cheaper

🧩 Component Deep Dives

Optimistic Rollup

How optimistic rollups enable scaling while maintaining security

Fraud Proofs

Fraud detection and prevention system

Sequencer

Block production and transaction ordering

Security Model

Complete security analysis and threat model

💡 Design Philosophy

Core Principles

1. Security First

Never compromise on security for performance

All data on L1 (data availability)
Fraud proofs for verification
7-day challenge period (no shortcuts)
Inherit Ethereum’s security guarantees

Trade-offs accepted:

Slower withdrawals (7 days) for security
Higher L1 costs for data availability

2. EVM Equivalence

100% compatible with Ethereum

Same opcodes
Same precompiles
Same gas costs
Same developer tools

Benefits:

Zero migration effort
Familiar development experience
Reuse existing contracts
Compatible with all Ethereum tooling

3. Decentralization Path

Start centralized, move to decentralizedCurrent state:

Centralized sequencer (for simplicity)
Decentralized verification (anyone can challenge)

Future plans:

Decentralized sequencer set
Proposer selection mechanism
MEV-resistant ordering

4. User Experience

Make it feel like Ethereum, but better

Instant confirmations (5 seconds)
Low fees (near-zero)
Same wallet experience
MetaMask compatibility

No compromises on UX for technical purity.

🆚 Comparison with Other Solutions

TeQoin vs Other Scaling Approaches

Feature	TeQoin (Optimistic)	ZK Rollup	Sidechain	State Channel
Security	Ethereum-grade	Ethereum-grade	Lower	High (limited)
Withdrawal Time	7 days	Hours	Instant	Instant
EVM Compatibility	100%	Varies	100%	Limited
Transaction Cost	Very Low	Low	Very Low	Near-zero
Throughput	High	High	Very High	Unlimited
Complexity	Medium	High	Low	Medium
Proving Cost	Low	High	None	None

Why Optimistic Rollup?

✅ Best balance of security and cost
✅ Full EVM compatibility
✅ Lower operational costs than ZK
✅ Proven technology (Optimism, Arbitrum)

📈 Scalability Analysis

How TeQoin Achieves 1000+ TPS

Technique #1: Off-chain Execution

Ethereum L1: Execute on-chain
TeQoin L2: Execute off-chain, post results

Cost Savings: 100x+ cheaper execution

Technique #2: Batch Compression

Individual TXs on L1: ~180 bytes each
Batched TXs on L2: ~12 bytes each (compressed)

Data Savings: 15x compression

Technique #3: Calldata Optimization

Using calldata (cheap) instead of storage (expensive)

Cost Reduction: 10x cheaper per byte

Combined Effect:

Total Scalability: 100x (execution) × 15x (compression) × 10x (calldata)
                  ≈ 15,000x cost reduction
                  ≈ 1000+ TPS (vs. 15-30 on L1)

🔮 Future Enhancements

Roadmap Items

Short Term (3-6 months)
Medium Term (6-12 months)
Long Term (12+ months)

Performance & Features:

✅ ERC-20 token bridging
✅ ERC-721 NFT support
🔄 Improved batch compression
🔄 Multi-call optimizations

Infrastructure:

🔄 Additional RPC endpoints
🔄 Enhanced block explorer
🔄 Better monitoring tools

🛠️ For Developers

Building on TeQoin

Network Information

RPC endpoints, chain ID, and network parameters

Deploy Contracts

Deploy your smart contracts to TeQoin L2

Integration Guide

Integrate TeQoin into your dApp

Smart Contracts

Write contracts for TeQoin L2

📚 Technical Resources

Optimistic Rollup Specs

Detailed optimistic rollup mechanics

Fraud Proof System

How fraud proofs work

Sequencer Design

Block production and ordering

Security Analysis

Comprehensive security model

External Resources

Ethereum.org: https://ethereum.org/en/developers/docs/scaling/
Optimism Specs: https://github.com/ethereum-optimism/specs
Rollup Research: https://l2beat.com

🎓 Academic Background

Research Papers

Optimistic Rollup Fundamentals

Key Papers:

“Arbitrum: Scalable, private smart contracts” (Kalodner et al., 2018)
“Optimistic vs. ZK Rollup: Deep Dive” (StarkWare, 2021)
“A rollup-centric ethereum roadmap” (Vitalik Buterin, 2020)

Core Concepts:

Optimistic execution
Fraud proof construction
Data availability guarantees
Economic security model

State Channels & Plasma

Historical Context:TeQoin’s design builds on lessons from:

State channels (Lightning Network, Raiden)
Plasma (Plasma MVP, Plasma Cash)
Validium (off-chain data)

Why Optimistic Rollups Won:

Better data availability than Plasma
Higher throughput than state channels
Simpler than ZK rollups
Full EVM compatibility

🔬 System Invariants

Guaranteed Properties

TeQoin maintains these invariants:

Conservation of Funds

   ∀ time t: ETH_on_L2(t) ≤ ETH_locked_on_L1(t)

L2 ETH never exceeds L1 backing

Data Availability

   ∀ L2_block: transaction_data ∈ L1_calldata

All transaction data on L1

State Validity

   ∀ state_root: ∃ fraud_proof ⟹ state_reverted

Invalid states can be proven and reverted

Liveness

   Users_can_force_include_transactions_via_L1

Censorship resistance guarantee

Ready to dive deeper? Continue to Optimistic Rollup Details →

​🎯 What is TeQoin?

​Key Characteristics

​🏗️ Architecture Overview

​System Components

​Core Components

Sequencer

L2 Execution Layer

Bridge Contracts

State Contract (L1)

​🔄 Transaction Flow

​User Transaction Lifecycle

​📊 Data Flow

​How Data Moves Through the System

​🔐 Security Model

​Layered Security Approach

​⚙️ Key Technical Specifications

​Network Parameters

​Performance Metrics

​🧩 Component Deep Dives

Optimistic Rollup

Fraud Proofs

Sequencer

Security Model

​💡 Design Philosophy

​Core Principles

​🆚 Comparison with Other Solutions

​TeQoin vs Other Scaling Approaches

​📈 Scalability Analysis

​How TeQoin Achieves 1000+ TPS

​🔮 Future Enhancements

​Roadmap Items

​🛠️ For Developers

​Building on TeQoin

Network Information

Deploy Contracts

Integration Guide

Smart Contracts

​📚 Technical Resources

​Further Reading

Optimistic Rollup Specs

Fraud Proof System

Sequencer Design

Security Analysis

​External Resources

​🎓 Academic Background

​Research Papers

​🔬 System Invariants

​Guaranteed Properties

🎯 What is TeQoin?

Key Characteristics

🏗️ Architecture Overview

System Components

Core Components

🔄 Transaction Flow

User Transaction Lifecycle

📊 Data Flow

How Data Moves Through the System

🔐 Security Model

Layered Security Approach

⚙️ Key Technical Specifications

Network Parameters

Performance Metrics

🧩 Component Deep Dives

💡 Design Philosophy

Core Principles

🆚 Comparison with Other Solutions

TeQoin vs Other Scaling Approaches

📈 Scalability Analysis

How TeQoin Achieves 1000+ TPS

🔮 Future Enhancements

Roadmap Items

🛠️ For Developers

Building on TeQoin

📚 Technical Resources

Further Reading

External Resources

🎓 Academic Background

Research Papers

🔬 System Invariants

Guaranteed Properties