TeQoin L2 Blockchain Documentation - Developer Guides & API Reference

Transfer ETH from TeQoin L2 back to Ethereum mainnet securely.

Important: Withdrawals take 7 daysDue to the optimistic rollup security model, withdrawals require a 7-day challenge period. This is a security feature, not a limitation.Timeline:

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

Quick Facts:

⏱️ Time: 7 days + 15 minutes
💰 L2 Gas Fee: ~$0.001 (initiate)
💰 L1 Gas Fee: $10-30 (finalize)
🔄 Ratio: 1 ETH on L2 = 1 ETH on L1
✅ Cancellable: No (irreversible once initiated)

📋 Prerequisites

Before you start, make sure you have:

ETH on TeQoin L2

You need ETH on TeQoin L2 to withdraw.Minimum recommended: 0.05 ETH (to cover finalization gas)

Wallet Connected to L2

MetaMask or TeQoin Telegram Wallet
Connected to TeQoin L2 network
Sufficient ETH for L2 gas (~$0.001)

ETH for L1 Finalization

You’ll need ETH on L1 to finalize withdrawal after 7 daysAmount needed: ~0.01 ETH for L1 gas

Patience

Be prepared to wait 7 days before accessing funds on L1⏰ Set a reminder for 7 days from now!

🌉 How Withdrawals Work

The Process

Step-by-step:

You initiate withdrawal on L2
ETH is burned on TeQoin L2
Withdrawal is recorded in the bridge
7-day challenge period begins
After 7 days, withdrawal is ready
You finalize on Ethereum L1
ETH is unlocked and sent to you

Why 7 days? Learn about the challenge period →

🎯 Step-by-Step Guide

Phase 1: Initiate Withdrawal (Day 0)

Visit the Bridge

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

Security Alert: Always verify you’re on the official bridge URL.

Connect Wallet to L2

Click “Connect Wallet”
Select your wallet
Approve the connection

Important: Make sure you’re connected to TeQoin L2 (not Ethereum Mainnet)

Check your wallet network indicator. It should show “TeQoin L2” or chain ID “420377”.

Select Withdraw Tab

Click the “Withdraw” or “L2 → L1” tabThe interface should show:

From: TeQoin L2
To: Ethereum Mainnet

Enter Amount

Enter the amount of ETH you want to withdrawExamples:

0.1 - Withdraw 0.1 ETH
1.5 - Withdraw 1.5 ETH
Click “Max” to withdraw all ETH

Keep some ETH on L2 for future transactions and gas fees!

Review Transaction Details

The bridge will show:

Detail	Information
Amount to Withdraw	ETH you’re withdrawing
You’ll Receive	Same amount on L1 (minus gas)
L2 Gas Fee	~$0.001 (very low)
L1 Finalization Fee	~$10-30 (estimated)
Waiting Period	7 days
Ready to Finalize	Date/time (7 days from now)

Important Notice:⏰ You must wait 7 days before finalizingAfter initiating, you CANNOT cancel the withdrawal!

Initiate Withdrawal

Click “Withdraw” or “Initiate Withdrawal”
MetaMask popup appears
Review transaction (connected to L2):
- To: L2 Bridge Contract
- Amount: Your withdrawal amount
- Gas Fee: Very low (~$0.001)
Click “Confirm” in MetaMask

The transaction confirms in ~5 seconds on L2.

Save Transaction Info

IMPORTANT: Save this information:

    ✅ L2 Transaction Hash: 0x...
    ✅ Withdrawal Amount: X.XX ETH
    ✅ Initiated Date: [Today's Date]
    ✅ Ready to Finalize: [Date 7 days from now]

Set a calendar reminder for 7 days from now to finalize your withdrawal!

Wait 7 Days

Your withdrawal is now in the challenge period:

✅ L2 transaction confirmed
🔥 Your ETH is burned on L2
⏳ 7-day challenge period active
💤 Nothing more to do - just wait

The bridge interface shows:

Status: Challenge Period
Time Remaining: X days, Y hours
Ready to Finalize: [Date/Time]

✅ Withdrawal initiated! Come back in 7 days.

Phase 2: Finalize Withdrawal (Day 7)

After 7 days have passed:

Return to Bridge (After 7 Days)

Go back to https://bridge.teqoin.ioCheck the date: Make sure 7 full days have passed

Connect Wallet to L1

Connect your wallet
Switch to Ethereum Mainnet (not L2)
Make sure you have ~0.01 ETH for L1 gas

You MUST be on Ethereum L1 to finalize!

View Pending Withdrawals

The bridge shows your withdrawal:

Status: ✅ Ready to Finalize
Amount: Your withdrawal amount
Action: “Finalize” button enabled

If you see “Still in challenge period”, wait longer - the full 7 days must pass.

Finalize Withdrawal

Click “Finalize Withdrawal”
MetaMask popup appears (connected to L1)
Review transaction:
- To: L1 Bridge Contract
- Amount: 0 ETH (you’re claiming, not sending)
- Gas Fee: $10-30 (Ethereum L1 gas)
Click “Confirm” in MetaMask

Wait for L1 Confirmation

Your finalization transaction processes on Ethereum:

Time: 2-5 minutes
Confirmations: Wait for ~12 confirmations

The bridge shows:

⏳ Finalizing on L1
🔄 Processing transaction

Withdrawal Complete

✅ ETH received on Ethereum L1!Verify:

Check your L1 wallet balance (should increase)
View transaction on Etherscan
Confirm amount matches your withdrawal

🎉 Congratulations! Your withdrawal is complete.

💰 Cost Breakdown

Example: Withdraw 1 ETH

Phase 1: Initiate (Day 0)

Amount to Withdraw:          1.0 ETH
─────────────────────────────────────
L2 Gas Fee:                 ~0.0001 ETH ($0.20)
─────────────────────────────────────
Total L2 Cost:              ~$0.20

Phase 2: Finalize (Day 7)

L1 Gas Fee:                 ~0.005 ETH ($10-20)
─────────────────────────────────────
Total L1 Cost:              ~$10-20

Total Withdrawal Cost:

L2 Fee:                      $0.20
L1 Fee:                      $15.00 (average)
─────────────────────────────────────
Total Cost:                  $15.20

Amount Sent from L2:         1.0 ETH
You Receive on L1:          ~0.9925 ETH (after gas)

When to Finalize (Gas Optimization)

Best Times
Gas Monitoring
Set Alerts

Finalize during low Ethereum gas periods:

🌙 Late night (2-6 AM US Eastern)
📅 Weekends (Saturday-Sunday)
🏖️ Holidays

Potential savings: 50-70% on L1 gasExample:

High gas (100 gwei): $30 finalization
Low gas (20 gwei): $10 finalization
Savings: $20

📊 Tracking Your Withdrawal

On the Bridge Interface

The bridge tracks withdrawal status:

Day 0-7 (Challenge Period)
After 7 Days (Ready)
After Finalization

    Status: ⏳ Challenge Period Active
    
    Progress Bar: [████░░░░░░] 3/7 days
    
    Time Remaining: 4 days, 12 hours
    Ready to Finalize: Feb 29, 2026 10:30 AM
    
    Details:
    ✅ L2 Transaction: Confirmed
    ✅ ETH Burned: Yes
    ⏳ Challenge Period: In Progress
    ❌ Ready to Finalize: Not Yet
    
    Actions:
    [View on L2 Explorer]
    [Track Progress]

    Status: ✅ Ready to Finalize
    
    Progress Bar: [██████████] 7/7 days
    
    Ready Since: Feb 29, 2026 10:30 AM
    
    Details:
    ✅ L2 Transaction: Confirmed
    ✅ ETH Burned: Yes
    ✅ Challenge Period: Complete
    ✅ Ready to Finalize: Yes
    
    Actions:
    [Finalize Withdrawal] ← Click to complete
    [View on L1 Explorer]

    Status: ✅ Complete
    
    L2 Transaction: 0xabc...
    L1 Finalization: 0xdef...
    
    Amount: 1.0 ETH
    Received: 0.9925 ETH (after gas)
    
    Timeline:
    ✅ Initiated: Feb 22, 2026 10:30 AM
    ✅ Finalized: Feb 29, 2026 11:45 AM
    
    Total Time: 7 days, 1 hour, 15 minutes

On Block Explorers

TeQoin (L2) - Initiation
Ethereum (L1) - Finalization

View L2 transaction:

Go to https://explorer.teqoin.io
Paste your L2 transaction hash
Verify:
- ✅ Status: Success
- ✅ To: L2 Bridge Contract
- ✅ Function: initiateWithdrawal
- ✅ Amount: Your withdrawal amount

🔧 Troubleshooting

Can I cancel my withdrawal?

No, withdrawals cannot be cancelled once initiated.Once you initiate:

Your L2 ETH is immediately burned
Withdrawal enters 7-day challenge period
You must wait and finalize on L1

Options:

Complete the withdrawal (finalize after 7 days)
Once on L1, you can deposit back to L2 if needed

Finalize button is disabled / grayed out

The 7-day challenge period hasn’t completed yet.Solution:

Check “Time Remaining” on bridge interface
Wait until countdown reaches 0
Make sure 7 FULL days have passed
Refresh the page

The button enables exactly 7 days after initiation.

Forgot to finalize / Missed the deadline

There is no deadline!You can finalize your withdrawal:

7 days after initiation ✅
8 days later ✅
30 days later ✅
1 year later ✅

Your funds are safe in the L1 bridge contract. Finalize whenever you’re ready (preferably during low gas periods).

Wrong network when trying to finalize

You’re connected to L2 instead of L1.Solution:

Open your wallet (MetaMask)
Click network dropdown
Select “Ethereum Mainnet” (NOT TeQoin L2)
Return to bridge interface
Finalize button should now work

Finalization transaction failed

Common reasons:

Insufficient ETH on L1 for gas
Gas limit too low
Network congestion

Solution:

Check error message on Etherscan
Make sure you have ~0.01 ETH on L1
Try again with higher gas limit
Your withdrawal is still safe - just retry

Don't see my withdrawal on bridge interface

Solutions:

Wrong wallet:
- Make sure you’re using the same wallet that initiated
- Check wallet address matches
Wrong network:
- Bridge shows L2 → L1 withdrawals
- Make sure you’re looking at the right direction
Different browser/device:
- Withdrawal data is stored in browser cache
- Use same browser or manually enter TX hash
Clear cache:
- Refresh the page
- Clear browser cache
- Reconnect wallet

ETH not received after finalization

Finalized but ETH not in wallet.Solution:

Check finalization transaction on Etherscan
Verify status shows “Success”
Make sure you’re on Ethereum L1 network
Refresh wallet (disconnect/reconnect)
Check the correct wallet address

If finalization succeeded, ETH was sent to your address. Check you’re viewing the right network and wallet.

⏰ Important Timeline Reminders

Set Multiple RemindersDon’t forget to finalize your withdrawal!Recommended reminders:

📅 6 days after initiation: “Withdrawal ready tomorrow”
📅 7 days after initiation: “Withdrawal ready - finalize now”
📅 7 days + 1 week: “Finalize withdrawal (no rush, but don’t forget)”

Add to calendar:

Calendar app on phone
Google Calendar with email reminder
Outlook with notification

Gas Price AlertsSince you can finalize anytime after 7 days:

Wait for low gas periods
Set up gas price alerts on Etherscan
Finalize when notified about low gas
Save $10-20 on transaction costs!

✅ Post-Withdrawal Checklist

Verify L1 Balance

Switch to Ethereum Mainnet in wallet
Check balance increased by withdrawal amount
Account for gas fees

Save Transaction Records

    # Keep these for your records:
    - L2 initiation TX hash
    - L1 finalization TX hash
    - Withdrawal amount
    - Initiation date
    - Finalization date
    - Total time taken

Update Records

If you track your portfolio:

Remove ETH from L2 balance
Add ETH to L1 balance
Note withdrawal fees for tax purposes

💡 Best Practices

Plan Withdrawals 7 Days in AdvanceIf you know you’ll need ETH on L1:

Start withdrawal 7 days early
Don’t wait until you urgently need funds
Withdrawals cannot be expedited

Keep Some ETH on Both NetworksMaintain balances on both L1 and L2:

L1: For mainnet operations and gas
L2: For low-fee transactions
Never withdraw everything at once

Batch WithdrawalsInstead of many small withdrawals:

Accumulate ETH on L2
Withdraw larger amounts less frequently
Save on L1 finalization fees

Finalize During Low GasYou can wait after the 7-day period:

Monitor Ethereum gas prices
Finalize during weekends or late night
Save 50-70% on finalization costs

🎯 Next Steps

Understand Challenge Period

Learn why withdrawals take 7 days

Bridge FAQ

Common questions about bridging

Deposit to L2

Move ETH from L1 back to L2

Bridge Overview

Learn more about the bridge

Withdrawal complete? Or learn more about the 7-day challenge period →

Documentation Index

​📋 Prerequisites

​🌉 How Withdrawals Work

​The Process

​🎯 Step-by-Step Guide

​Phase 1: Initiate Withdrawal (Day 0)

​Phase 2: Finalize Withdrawal (Day 7)

​💰 Cost Breakdown

​Example: Withdraw 1 ETH

​When to Finalize (Gas Optimization)

​📊 Tracking Your Withdrawal

​On the Bridge Interface

​On Block Explorers

​🔧 Troubleshooting

​⏰ Important Timeline Reminders

​✅ Post-Withdrawal Checklist

​💡 Best Practices

​🎯 Next Steps