TeQoin L2 Blockchain Documentation - Developer Guides & API Reference

Transfer ETH between Ethereum (L1) and TeQoin L2 using the official TeQoin bridge.

What is Bridging?Bridging lets you move assets between different blockchain networks. The TeQoin bridge allows you to:

Deposit: Move ETH from Ethereum L1 → TeQoin L2 (Fast: ~15 minutes)
Withdraw: Move ETH from TeQoin L2 → Ethereum L1 (Secure: 7 days)

🌉 Bridge Overview

Deposit (L1 → L2)

Fast & EasyMove ETH from Ethereum to TeQoin L2⏱️ Time: ~15 minutes

Withdraw (L2 → L1)

Secure with Fraud ProofsMove ETH from TeQoin L2 to Ethereum⏱️ Time: 7 days + finalization

📥 Deposit (L1 → L2)

Move ETH from Ethereum mainnet to TeQoin L2.

How It Works

You send ETH to the L1 bridge contract
Your ETH is locked on Ethereum L1
Equivalent ETH is minted on TeQoin L2
You receive ETH on L2 (1:1 ratio)

Step-by-Step Guide

Visit the Bridge

Go to the official TeQoin bridge:🔗 https://bridge.teqoin.io

TeQoin Bridge

Official bridge interfaceOpen Bridge →

Connect Your Wallet

Click “Connect Wallet”
Select your wallet (MetaMask, WalletConnect, etc.)
Approve the connection

Make sure you’re connected to Ethereum Mainnet (not a testnet) when depositing.

Enter Deposit Amount

Select “Deposit” tab (L1 → L2)
Enter the amount of ETH to bridge
Review the details:
- Amount to send
- Amount to receive (same, minus L1 gas)
- Estimated time (~15 minutes)

Minimum Amount: 0.01 ETH recommended (to cover L1 gas fees)

Confirm Transaction on L1

Click “Deposit” or “Bridge ETH”
Your wallet will pop up requesting approval
Review the transaction:
- To: L1 Bridge Contract (0x919aa27d5278BC98bf40BA5A79be468B91f061dA)
- Amount: ETH you’re depositing
- Gas Fee: Ethereum L1 gas fee (can be $10-50)
Click “Confirm” in your wallet

Wait for L1 Confirmation

Wait for Ethereum L1 transaction to confirm (~2-5 minutes)
You’ll see a pending status on the bridge interface
Transaction hash will be displayed

Automatic L2 Minting

Once L1 transaction confirms:

The bridge automatically processes your deposit
Equivalent ETH is minted on TeQoin L2
ETH appears in your L2 wallet (~10-15 minutes total)

✅ Deposit Complete!

Verify on L2

Switch to TeQoin L2 network in your wallet and verify:

Your L2 balance increased
Transaction appears on https://explorer.teqoin.io

Deposit Information

Parameter	Value
Direction	Ethereum L1 → TeQoin L2
Time	~15 minutes
L1 Gas Fee	$10-50 (varies with Ethereum gas)
L2 Gas Fee	~$0 (covered by bridge)
Minimum	0.001 ETH (0.01 recommended)
1:1 Ratio	1 ETH on L1 = 1 ETH on L2

📤 Withdraw (L2 → L1)

Move ETH from TeQoin L2 back to Ethereum mainnet.

Important: Withdrawals take 7 daysDue to the optimistic rollup security model, withdrawals require a 7-day challenge period to ensure transaction validity. This protects your funds from invalid transactions.Timeline:

Initiate withdrawal: Instant
Challenge period: 7 days
Finalize withdrawal: ~15 minutes

Total time: 7 days + 15 minutes

How It Works

You initiate withdrawal on TeQoin L2
Your ETH is burned on L2
7-day challenge period begins (fraud proof security)
After 7 days, you finalize on L1
ETH is unlocked on Ethereum L1

Step-by-Step Guide

Visit the Bridge

Go to https://bridge.teqoin.io

Connect to TeQoin L2

Connect your wallet
Switch to TeQoin L2 network
Verify you’re on L2 (check network in wallet)

Initiate Withdrawal

Select “Withdraw” tab (L2 → L1)
Enter the amount of ETH to withdraw
Review:
- Amount to withdraw
- Estimated L1 gas for finalization
- 7-day waiting period notice
Click “Withdraw” or “Initiate Withdrawal”

Confirm on L2

Your wallet pops up (connected to TeQoin L2)
Review transaction
Click “Confirm”
Transaction confirms in ~5 seconds

✅ Withdrawal Initiated!

Wait 7 Days (Challenge Period)

Now you must wait for the challenge period:

Why? This allows anyone to submit fraud proofs if the withdrawal is invalid
Duration: Exactly 7 days (168 hours)
What happens: Your ETH is held securely in the L1 bridge contract

Track Your Withdrawal:The bridge interface shows:

Time remaining in challenge period
Withdrawal status (Pending → Ready to Finalize)
Estimated completion time

💡 Set a reminder for 7 days from now to finalize!

Finalize Withdrawal on L1

After 7 days:

Return to https://bridge.teqoin.io
Connect wallet (switch to Ethereum L1)
You’ll see “Ready to Finalize” status
Click “Finalize Withdrawal”
Approve the L1 transaction in your wallet
Pay Ethereum L1 gas fee ($5-30)
Wait for L1 confirmation (~2-5 minutes)

✅ Withdrawal Complete! ETH is now on Ethereum L1.

Withdrawal Information

Parameter	Value
Direction	TeQoin L2 → Ethereum L1
Time	7 days + 15 minutes
L2 Gas Fee	Very low (~$0.001)
L1 Gas Fee	$10-50 (for finalization)
Challenge Period	7 days (required)
Security	Fraud proof protected

🔍 Track Your Bridge Transaction

Via Bridge Interface
Via Block Explorer
Via Wallet

On bridge.teqoin.io:

Connect your wallet
View “Transaction History” or “My Bridges”
See all your deposits and withdrawals
Track status in real-time

Status Indicators:

🟡 Pending - Transaction submitted, waiting confirmation
🔵 Processing - L1 confirmed, minting on L2
🟢 Completed - Deposit successful
🟠 Challenge Period - Withdrawal waiting 7 days
✅ Ready to Finalize - Can finalize withdrawal

On explorer.teqoin.io:

Copy your wallet address
Visit https://explorer.teqoin.io
Search for your address
Look for transactions to/from bridge contracts:
- L1 Bridge: 0x919aa27d5278BC98bf40BA5A79be468B91f061dA
- L2 Bridge: 0x4200000000000000000000000000000000000010

💰 Bridge Costs Breakdown

Deposit (L1 → L2) Costs

Example: Bridge 1 ETH from L1 to L2

L1 Transaction Fee:  ~0.005 ETH ($10-20)
L2 Credit Fee:       0 ETH (free)
─────────────────────────────────────
Total Cost:          ~0.005 ETH

You Receive on L2:   1 ETH

Withdraw (L2 → L1) Costs

Example: Bridge 1 ETH from L2 to L1

L2 Initiate Fee:     ~0.0001 ETH ($0.20)
L1 Finalize Fee:     ~0.005 ETH ($10-20)
─────────────────────────────────────
Total Cost:          ~0.0051 ETH

You Receive on L1:   ~0.995 ETH

Gas Price Optimization:Bridge during low gas periods on Ethereum L1 to save on fees:

Cheapest: Weekends, late night (US time)
Most Expensive: Weekday afternoons (US time)

Check gas prices: https://etherscan.io/gastracker

🔧 Troubleshooting

Deposit stuck on 'Pending' for over 1 hour

Deposits should complete in ~15 minutes.Possible reasons:

L1 transaction hasn’t confirmed yet (check Etherscan)
Network congestion on Ethereum
Bridge indexer delay

Solution:

Check L1 transaction on https://etherscan.io
If L1 confirmed, wait another 30 minutes
If still pending, contact support with TX hash

Can I cancel a withdrawal?

No, withdrawals cannot be canceled once initiated.Once you start the withdrawal process:

Your L2 ETH is burned immediately
You must wait the full 7-day challenge period
You must finalize on L1 to receive funds

If you don’t finalize after 7 days, your funds remain safe in the L1 bridge contract. You can finalize at any time after the 7-day period.

I didn't finalize after 7 days. Are my funds lost?

No, your funds are safe!You can finalize your withdrawal at any time after the 7-day challenge period:

8 days later ✅
30 days later ✅
1 year later ✅

Just visit the bridge, connect your wallet, and finalize whenever ready.

Why does withdrawal take 7 days?

The 7-day challenge period is a security feature of optimistic rollups.How it protects you:

Sequencer posts withdrawal to L1
7 days for anyone to challenge if invalid
If challenged successfully, withdrawal is blocked
If no challenges, withdrawal proceeds

This ensures no one can steal funds through invalid withdrawals, even if the sequencer is compromised.

Sent ETH to bridge contract by mistake

Do NOT send ETH directly to the bridge contract!Always use the bridge interface at https://bridge.teqoin.ioIf you accidentally sent ETH directly:

It may be lost
Contact support immediately with transaction details
We’ll assess if recovery is possible

Wrong network - bridged on testnet instead of mainnet

Make sure you’re using the correct network:For real ETH:

Use Ethereum Mainnet (L1)
Use TeQoin L2 Mainnet (L2)

For testing:

Use Sepolia Testnet (L1)
Use TeQoin L2 Testnet (L2)

Testnet and mainnet assets cannot be mixed!

📊 Bridge Statistics

Total Value Locked

$5.2METH locked in bridge

Total Bridges

25,000+Successful deposits/withdrawals

Success Rate

99.99%Bridge success rate

⚠️ Important Security Notes

Only Use Official Bridge

✅ Official: https://bridge.teqoin.io
❌ Never use third-party bridges
❌ Don’t trust DMs offering “faster” bridges
❌ Beware of phishing sites

Always verify you’re on the official bridge URL!

Bridge Contracts (Verify These Addresses)L1 Bridge Contract (Ethereum): 0x919aa27d5278BC98bf40BA5A79be468B91f061dAL2 Bridge Contract (TeQoin L2): 0x4200000000000000000000000000000000000010You can verify these on the block explorers.

💡 Pro Tips

Plan Withdrawals Ahead: Need ETH on L1? Start your withdrawal 7 days before you need it!

Batch Deposits: If bridging multiple times, consider bridging larger amounts less frequently to save on L1 gas fees.

Keep Some ETH on Both: Maintain balances on both L1 and L2 so you’re never stuck waiting for a bridge.

Use L2 for Most Activity: Keep the majority of your funds on TeQoin L2 for low-fee transactions, only bridge to L1 when necessary.

🎯 Next Steps

Start Building

Deploy smart contracts on TeQoin L2

Bridge Documentation

Deep dive into bridge architecture

Developer Guide

Integrate TeQoin into your dApp

Architecture Overview

Learn how TeQoin works

🆘 Need Help?

Discord Support

Get help from the community

Bridge FAQ

Common bridge questions

Bridge Status

Check if bridge is operational

Successfully bridged? You’re now ready to build on TeQoin L2! 🚀

Introduction

Quick Start

Developer Documentation

Bridge

Architecture

Tutorials

Resources

Bridge Assets Between L1 and L2

🌉 Bridge Overview

Deposit (L1 → L2)

Withdraw (L2 → L1)

📥 Deposit (L1 → L2)

How It Works

Step-by-Step Guide

TeQoin Bridge

Deposit Information

📤 Withdraw (L2 → L1)

How It Works

Step-by-Step Guide

Withdrawal Information

🔍 Track Your Bridge Transaction

💰 Bridge Costs Breakdown

Deposit (L1 → L2) Costs

Withdraw (L2 → L1) Costs

🔧 Troubleshooting

📊 Bridge Statistics

Total Value Locked

Total Bridges

Success Rate

⚠️ Important Security Notes

💡 Pro Tips

🎯 Next Steps

Start Building

Bridge Documentation

Developer Guide

Architecture Overview

🆘 Need Help?

Discord Support

Bridge FAQ

Bridge Status

Introduction

Quick Start

Developer Documentation

Bridge

Architecture

Tutorials

Resources

​🌉 Bridge Overview

Deposit (L1 → L2)

Withdraw (L2 → L1)

​📥 Deposit (L1 → L2)

​How It Works

​Step-by-Step Guide

TeQoin Bridge

​Deposit Information

​📤 Withdraw (L2 → L1)

​How It Works

​Step-by-Step Guide

​Withdrawal Information

​🔍 Track Your Bridge Transaction

​💰 Bridge Costs Breakdown

​Deposit (L1 → L2) Costs

​Withdraw (L2 → L1) Costs

​🔧 Troubleshooting

​📊 Bridge Statistics

Total Value Locked

Total Bridges

Success Rate

​⚠️ Important Security Notes

​💡 Pro Tips

​🎯 Next Steps

Start Building

Bridge Documentation

Developer Guide

Architecture Overview

​🆘 Need Help?

Discord Support

Bridge FAQ

Bridge Status

🌉 Bridge Overview

📥 Deposit (L1 → L2)

How It Works

Step-by-Step Guide

Deposit Information

📤 Withdraw (L2 → L1)

How It Works

Step-by-Step Guide

Withdrawal Information

🔍 Track Your Bridge Transaction

💰 Bridge Costs Breakdown

Deposit (L1 → L2) Costs

Withdraw (L2 → L1) Costs

🔧 Troubleshooting

📊 Bridge Statistics

⚠️ Important Security Notes

💡 Pro Tips

🎯 Next Steps

🆘 Need Help?