TeQoin L2 Blockchain Documentation - Developer Guides & API Reference

TeQoin is an EVM-compatible Layer-2 (L2) blockchain built on Ethereum using Optimistic Rollup technology. It provides developers and users with a scalable, cost-efficient alternative to Ethereum mainnet while maintaining the security guarantees of the Ethereum network.

Layer-2 Scaling Solution

TeQoin operates as a separate blockchain that runs in parallel to Ethereum (Layer-1), processing transactions off-chain and periodically posting transaction data back to Ethereum mainnet.

How TeQoin Relates to Ethereum

Aspect	Ethereum L1	TeQoin L2
Transaction Speed	~12-15 seconds	5 seconds
Transaction Fees	$1-50+ per transaction	8 wei baseline on L2 today
Security	Ethereum consensus	Inherits from Ethereum
Smart Contracts	EVM-compatible	Fully EVM-compatible
Finality	Probabilistic	Instant (optimistic)

Optimistic Rollup Technology

TeQoin uses Optimistic Rollup - a specific type of Layer-2 scaling that:

1. Assumes Transactions are Valid

Transactions are assumed to be correct by default. This allows for fast processing without requiring validators to verify every transaction immediately.

2. Posts Data to Ethereum

All transaction data is posted to Ethereum L1, ensuring data availability and transparency. Anyone can reconstruct the L2 state from L1 data.

3. Allows Fraud Proofs

If someone submits an invalid transaction, anyone can challenge it by submitting a fraud proof within the 7-day challenge period.

4. Inherits Ethereum Security

Because transaction data lives on Ethereum and fraud proofs are enforced, TeQoin inherits Ethereum’s security model.

Core Components

🔄 Sequencer

The sequencer is responsible for:

Accepting user transactions
Ordering transactions into blocks
Executing transactions and updating state
Posting transaction data to Ethereum L1

The sequencer provides instant transaction confirmation while batching transactions for efficient L1 posting.

🌉 Bridge Contracts

Bridge contracts on L1 and L2 enable:

Deposits (L1 → L2): Lock ETH on L1, mint on L2
Withdrawals (L2 → L1): Burn on L2, unlock on L1 after 7-day challenge period

Learn more about bridging →

🔐 Fraud Proof System

The fraud proof system ensures:

Anyone can challenge invalid state transitions
Challengers submit fraud proofs to L1
Invalid transactions are reverted
System remains secure without trusting the sequencer

Learn more about fraud proofs →

Key Characteristics

Low Transaction Fees

Gasless Transactions

Users currently pay a very small 8 wei L2 transaction fee baseline on TeQoin. This keeps microtransactions, gaming, and frequent interactions economically viable while TeQoin prepares the fuller mainnet fee model.

How is this possible?

The sequencer covers gas costs
Transaction costs are amortized across many users
L2 execution is much cheaper than L1

Mainnet L1 Data Fee Model

TeQoin mainnet is designed to use an L1 gas price oracle plus a scalar algorithm for L1 data-fee accounting.

The current low-fee testnet experience should not be treated as the final TeQoin mainnet fee policy. Mainnet fee accounting is expected to include both the L2 execution component and an L1 data component derived from the TeQoin oracle.

At a high level, the mainnet pricing model is:

L1 fee = adjustedDataGas * l1Price * scalar / 1e6
adjustedDataGas = compressedGas * priceScalar / 1e6
compressedGas = rawDataGas * compressionRatio / 1e6
rawDataGas = zeroBytes * 4 + nonZeroBytes * 16 + 1088

What that means in practice:

l1Price is sourced from the TeQoin L1 gas oracle
compressionRatio reflects how TeQoin batches and compresses posted transaction data
scalar is the dynamic multiplier used to tune fee recovery against real L1 posting costs
the scalar algorithm is intended to keep TeQoin fee recovery aligned with actual mainnet data-availability costs over time

For developers, the important takeaway is simple: TeQoin mainnet fee estimation will eventually be oracle-driven, not hardcoded to a fixed zero-fee model.

Full EVM Compatibility

TeQoin is 100% compatible with Ethereum’s EVM (Ethereum Virtual Machine):

// Your existing Ethereum contracts work on TeQoin
contract MyToken {
    mapping(address => uint256) public balances;
    
    function transfer(address to, uint256 amount) public {
        require(balances[msg.sender] >= amount);
        balances[msg.sender] -= amount;
        balances[to] += amount;
    }
}

No code changes required

Same development tools (Hardhat, Foundry)

Same libraries (Web3.js, Ethers.js)

Same wallets (MetaMask, WalletConnect)

Lightning-Fast Blocks

5-second block times provide near-instant confirmation
Transactions feel instantaneous to users
Perfect for interactive applications and gaming

Ethereum-Grade Security

Data Availability

All transaction data is posted to Ethereum, ensuring anyone can verify the state.

Fraud Proofs

Invalid transactions can be challenged and reverted, protecting user funds.

Censorship Resistance

Users can force transactions through L1 if the sequencer censors them.

Decentralization

Security doesn’t depend on trusting the sequencer - it’s enforced by Ethereum.

TeQoin vs. Other Solutions

Comparison with L1 (Ethereum Mainnet)

Feature	Ethereum L1	TeQoin L2
Transaction Cost	$1-50+	low-fee
Confirmation Time	12-15 seconds	5 seconds
Throughput (TPS)	~15-30	1000+
Security Model	Ethereum consensus	Inherits from Ethereum
Finality	Probabilistic (~15 min)	Instant (optimistic)

Use Cases

TeQoin is ideal for:

DeFi Applications

Low-cost swaps, lending, and yield farming with low gas fees

Gaming & NFTs

Frequent in-game transactions and NFT mints at low cost

Social & Content

Microtransactions for tipping, subscriptions, and social interactions

Enterprise Solutions

High-throughput business applications requiring low costs

How TeQoin Works (Simplified)

User Submits Transaction

Alice wants to send 1 ETH to Bob on TeQoin L2. She submits the transaction through MetaMask.

Sequencer Processes Transaction

The TeQoin sequencer receives the transaction, validates it, and includes it in the next block (5 seconds).

Instant Confirmation

Alice sees the transaction confirmed instantly. Bob receives the ETH immediately.

Data Posted to Ethereum

The sequencer batches Alice’s transaction with hundreds of others and posts the compressed data to Ethereum L1.

Security Guaranteed

For 7 days, anyone can verify the transaction was correct. If invalid, it can be challenged with a fraud proof.

Final Settlement

After 7 days with no successful challenges, the transaction is considered final on Ethereum.

Getting Started

Ready to use TeQoin?

Add Network to Wallet

Add Teqoin Wallet for TeQoin L2

Get Testnet ETH

Request test funds from our faucet

Deploy a Contract

Deploy your first smart contract

Learn More

Deep dive into the architecture

Frequently Asked Questions

Is TeQoin secure?

Yes! TeQoin inherits Ethereum’s security through fraud proofs. All transaction data is posted to Ethereum, and anyone can challenge invalid transactions. This means you don’t need to trust the TeQoin sequencer - security is enforced by Ethereum L1.

How long do withdrawals take?

Withdrawals from TeQoin L2 to Ethereum L1 require a 7-day challenge period. This allows time for anyone to submit fraud proofs if the withdrawal is invalid. After 7 days, you can finalize your withdrawal on L1.

Can I use existing Ethereum tools?

Yes! TeQoin is 100% EVM-compatible. You can use:

MetaMask, WalletConnect for wallets
Hardhat, Foundry for development
Web3.js, Ethers.js for frontend
Solidity for smart contracts

What happens if the sequencer goes down?

TeQoin includes censorship resistance mechanisms. If the sequencer is offline or censoring transactions, users can force their transactions through Ethereum L1 directly. This ensures the network remains accessible even if the sequencer fails.

Are there transaction fees?

Yes, but they are currently extremely low. TeQoin L2 currently uses an 8 wei transaction fee baseline, and the planned mainnet fee model is expected to incorporate the TeQoin L1 gas oracle and scalar-based fee adjustment logic.

Next: Learn Why Choose TeQoin over other scaling solutions.

Introduction

Quick Start

Developer Documentation

Bridge

Architecture

Tutorials

Resources

What is TeQoin?

Layer-2 Scaling Solution

How TeQoin Relates to Ethereum

Optimistic Rollup Technology

Core Components

🔄 Sequencer

🌉 Bridge Contracts

🔐 Fraud Proof System

Key Characteristics

Low Transaction Fees

Gasless Transactions

Mainnet L1 Data Fee Model

Full EVM Compatibility

Lightning-Fast Blocks

Ethereum-Grade Security

Data Availability

Fraud Proofs

Censorship Resistance

Decentralization

TeQoin vs. Other Solutions

Comparison with L1 (Ethereum Mainnet)

Use Cases

DeFi Applications

Gaming & NFTs

Social & Content

Enterprise Solutions

How TeQoin Works (Simplified)

Getting Started

Add Network to Wallet

Get Testnet ETH

Deploy a Contract

Learn More

Frequently Asked Questions

​Layer-2 Scaling Solution

​How TeQoin Relates to Ethereum

​Optimistic Rollup Technology

​Core Components

​🔄 Sequencer

​🌉 Bridge Contracts

​🔐 Fraud Proof System

​Key Characteristics

​Low Transaction Fees

Gasless Transactions

​Mainnet L1 Data Fee Model

​Full EVM Compatibility

​Lightning-Fast Blocks

​Ethereum-Grade Security

Data Availability

Fraud Proofs

Censorship Resistance

Decentralization

​TeQoin vs. Other Solutions

​Comparison with L1 (Ethereum Mainnet)

​Use Cases

DeFi Applications

Gaming & NFTs

Social & Content

Enterprise Solutions

​How TeQoin Works (Simplified)

​Getting Started

Add Network to Wallet

Get Testnet ETH

Deploy a Contract

Learn More

​Frequently Asked Questions

Layer-2 Scaling Solution

How TeQoin Relates to Ethereum

Optimistic Rollup Technology

Core Components

🔄 Sequencer

🌉 Bridge Contracts

🔐 Fraud Proof System

Key Characteristics

Low Transaction Fees

Mainnet L1 Data Fee Model

Full EVM Compatibility

Lightning-Fast Blocks

Ethereum-Grade Security

TeQoin vs. Other Solutions

Comparison with L1 (Ethereum Mainnet)

Use Cases

How TeQoin Works (Simplified)

Getting Started

Frequently Asked Questions