Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.teqoin.io/llms.txt

Use this file to discover all available pages before exploring further.

The TeQoin bridge allows you to move ETH between Ethereum (L1) and TeQoin L2 safely and efficiently.
Key Concepts:
  • Deposit (L1 → L2): Fast (~15 minutes)
  • Withdraw (L2 → L1): Secure (7 days)
  • 1:1 Backing: 1 ETH on L1 = 1 ETH on L2
  • Security: Optimistic rollup with fraud proofs

​
🌉 What is the Bridge?

The TeQoin bridge is a set of smart contracts that enables trustless transfer of assets between Ethereum L1 and TeQoin L2.

​
How It Works

Process:
  1. You send ETH to the L1 bridge contract
  2. Your ETH is locked on Ethereum
  3. Bridge sends a message to L2
  4. Equivalent ETH is minted on TeQoin L2
  5. You receive ETH on L2 (1:1 ratio)
Time: ~15 minutes
Cost: Ethereum L1 gas fee ($10-50)

​
🔑 Key Features

Trustless

No intermediaries - secured by smart contracts and fraud proofs

1:1 Backing

Every ETH on L2 is backed by locked ETH on L1

Secure

Optimistic rollup with 7-day challenge period

Transparent

All transactions visible on-chain

​
📊 Comparison: Deposit vs Withdraw

FeatureDeposit (L1 → L2)Withdraw (L2 → L1)
Time~15 minutes7 days + 15 min
L1 Gas$10-50 (deposit)$10-30 (finalize)
L2 Gas~$0 (covered)~$0.001 (initiate)
Steps1 transaction2 transactions
ComplexitySimpleModerate
CancellableNoNo

​
🔐 Security Model

​
Optimistic Rollup Security

TeQoin uses optimistic rollup technology, which means:
1

Optimistic Assumption

Transactions are assumed to be valid by default
2

Challenge Period

For withdrawals, there’s a 7-day window where anyone can challenge invalid transactions
3

Fraud Proofs

If someone submits invalid data, fraud proofs can be submitted to prove it’s wrong
4

Automatic Reversion

Invalid transactions are reverted, and the challenger is rewarded
Why 7 Days?The 7-day challenge period is a security feature, not a limitation. It ensures:
  • ✅ Enough time for fraud detection
  • ✅ Decentralized security (anyone can verify)
  • ✅ No trust in the sequencer required
  • ✅ Your funds are always safe

​
💰 Bridge Contracts

​
L1 Bridge Contract (Ethereum)

Address: 0x919aa27d5278BC98bf40BA5A79be468B91f061dA
Network: Ethereum Mainnet
Chain ID: 1
Functions:
  • depositETH() - Deposit ETH to L2
  • finalizeWithdrawal() - Complete withdrawal from L2

​
L2 Bridge Contract (TeQoin)

Address: 0x4200000000000000000000000000000000000010
Network: TeQoin L2
Chain ID: 420377
Functions:
  • initiateWithdrawal() - Start withdrawal to L1
  • withdraw() - Alias for initiateWithdrawal
View Contract ABIs →

​
📈 Bridge Statistics

Total Value Locked

$5.2METH locked in bridge

Total Bridges

25,000+Successful transfers

Success Rate

99.99%Bridge reliability

Average Deposit Time

12 minutesL1 → L2 transfer

Total Users

8,500+Unique addresses

Uptime

99.9%Bridge availability

​
🎯 Use Cases

​
When to Use Deposits (L1 → L2)

Start Using TeQoin

Move ETH to L2 to start making low-fee transactions

Deploy Contracts

Bridge ETH to deploy smart contracts on L2

Use dApps

Access TeQoin L2 DeFi, NFTs, and games

Save on Fees

Move funds to L2 for low-cost operations

​
When to Use Withdrawals (L2 → L1)

Return to L1

Move funds back to Ethereum mainnet

Use L1 DeFi

Access Ethereum L1 DeFi protocols

Cash Out

Withdraw to L1 for exchange deposits

Long-term Storage

Move to L1 cold storage

​
⚠️ Important Considerations

Withdrawals take 7 days due to the challenge period.Plan accordingly:
  • Need L1 funds urgently? Keep some on L1
  • Start withdrawal 7 days before you need the funds
  • Use third-party bridges for faster withdrawals (less secure)
Why can’t it be instant?The 7-day period is a security feature. It allows time for:
  • Fraud detection
  • Challenge submission
  • Proof verification
This is what makes TeQoin secure without trusting centralized parties.
L1 Gas Fees:
  • Deposits: $10-50 (depends on Ethereum gas price)
  • Finalization: $10-30 (depends on Ethereum gas price)
L2 Gas Fees:
  • Initiate withdrawal: ~$0.001 (very low)
  • Covered by bridge for deposits
Tips to save on gas:
Recommended Minimums:
  • Deposit: 0.01 ETH (to cover L1 gas)
  • Withdraw: 0.05 ETH (to cover both L2 and L1 gas)
Maximum:
  • No hard limit
  • Practical limit: Bridge capacity (~1000 ETH per transaction)
For large amounts:
  • Consider splitting into multiple transactions
  • Contact support for assistance with very large transfers
The bridge is highly reliable:
  • 99.9% uptime
  • Automated monitoring
  • Redundant infrastructure
In rare cases of downtime:
  • Your funds are always safe in the smart contracts
  • Deposits/withdrawals will process when bridge resumes
  • Check status at https://status.teqoin.io
Current Support:
  • ✅ ETH (native currency)
Coming Soon:
  • ERC-20 token bridging
  • ERC-721 NFT bridging
For now, only ETH can be bridged between L1 and L2.

​
🛠️ Bridge Interface

​
Official Bridge

URL: https://bridge.teqoin.io Features:
  • User-friendly interface
  • Transaction tracking
  • Real-time status updates
  • Historical bridge transactions
  • Gas price estimates

​
Alternative Methods

Interact with bridge contracts directly via code.View developer guide →

​
📚 Learn More

Deposit Guide

Step-by-step guide to deposit ETH from L1 to L2

Withdrawal Guide

Complete guide to withdraw ETH from L2 to L1

Challenge Period

Understanding the 7-day security period

Bridge FAQ

Common questions and answers

​
🔐 Security Tips

Only Use Official Bridge
  • ✅ Use: https://bridge.teqoin.io
  • ❌ Avoid: Third-party bridges (less secure)
  • ❌ Never: Send ETH directly to contract addresses
Always verify the URL before connecting your wallet!
Verify TransactionsAfter bridging:
  1. Check transaction on block explorer
  2. Verify contract addresses match official ones
  3. Confirm amounts are correct
  4. Save transaction hashes for records

​
💬 Get Help

Discord Support

Ask questions in our community

Bridge FAQ

Common issues and solutions

Status Page

Check bridge operational status
Ready to bridge? Start with Deposit (L1 → L2) →