TeQoin L2 Blockchain Documentation - Developer Guides & API Reference

Connect your wallet to TeQoin L2 and start making low-fee transactions.

Time Required: Less than 2 minutes
Prerequisites: A compatible wallet (MetaMask, TeQoin Telegram Wallet, or other Web3 wallet)

🎯 Choose Your Wallet

TeQoin Telegram Wallet

Easiest & Fastest ⚡Built-in TeQoin support - No configuration needed!Get Started →

MetaMask

Most Popular 🦊Works on desktop, mobile, and browser extensionConfigure →

📱 Method 1: TeQoin Telegram Wallet (Recommended)

The easiest way to use TeQoin - our official Telegram mini app with built-in TeQoin L2 support.

Open Telegram

Open the Telegram app on your phone or desktop

Search for TeQoin Wallet

Search for @TeQoin_Wallet_Bot in TelegramOr click this link: t.me/TeQoin_Wallet_Bot

Start the Bot

Click “Start” or send /start to launch the wallet

Create or Import Wallet

Choose one:

Create New Wallet - Get a new wallet instantly
Import Existing Wallet - Use your existing seed phrase or private key

Start Using TeQoin

✅ That’s it! TeQoin L2 is already configured and ready to use.No network setup needed - everything works out of the box!

✨ TeQoin Telegram Wallet Features

Pre-configured TeQoin L2

TeQoin network is already set up - no manual configuration

Low-Fee Transactions

Send ETH and interact with dApps

Built-in Faucet

Get testnet ETH directly in the wallet

Easy to Use

Simple interface designed for everyone

Secure

Your keys, your crypto - non-custodial wallet

Cross-Device

Access from phone, tablet, or desktop

Perfect for beginners! The TeQoin Telegram Wallet is the fastest way to start using TeQoin L2 without any technical setup.

🦊 Method 2: MetaMask Wallet

Already have MetaMask? Configure it to connect to TeQoin L2.

Option A: One-Click Add (Fastest)

Click the Button Below

Click the “Add to MetaMask” button to automatically configure the network.

Add TeQoin Network

One-Click SetupAutomatically adds TeQoin L2 to MetaMaskAdd to MetaMask →

This will open a popup in MetaMask asking you to approve the network addition.

Approve in MetaMask

When the MetaMask popup appears:

Review the network details
Click “Approve”
Click “Switch Network” to start using TeQoin

✅ That’s it! You’re now connected to TeQoin L2.

Option B: Manual Configuration

Open MetaMask Settings

Click the MetaMask extension in your browser
Click the network dropdown (top of MetaMask)
Click “Add Network” or “Add a network manually”

Enter Network Details

Copy and paste these exact values:

    Network Name: TeQoin L2
    RPC URL: https://rpc.teqoin.io
    Chain ID: 420377
    Currency Symbol: ETH
    Block Explorer URL: https://testnet-blockscan.teqoin.io/

TeQoin does not currently publish a backup RPC endpoint. Use https://rpc.teqoin.io as the active public RPC.

Important: The Chain ID must be exactly 420377. Double-check this value!

Save and Switch

Click “Save”
MetaMask will automatically switch to TeQoin L2
You’ll see “TeQoin L2” in the network dropdown

✅ Network added successfully!

📱 Method 3: MetaMask Mobile

Add TeQoin L2 on the MetaMask mobile app.

iOS
Android

Open MetaMask App

Launch the MetaMask app on your iPhone

Access Settings

Tap the hamburger menu (☰) in top-left
Tap “Settings”
Tap “Networks”
Tap “Add Network”

Enter Details

Fill in the network information:

Network Name: TeQoin L2
RPC URL: https://rpc.teqoin.io
Chain ID: 420377
Symbol: ETH
Block Explorer: https://testnet-blockscan.teqoin.io/

Save

Tap “Add” to save the network

🔗 Method 4: Programmatic (For Developers)

Add TeQoin network programmatically from your dApp.

async function addTeQoinNetwork() {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0x66B69', // 420377 in hex
        chainName: 'TeQoin L2',
        rpcUrls: ['https://rpc.teqoin.io'],
        nativeCurrency: {
          name: 'Ether',
          symbol: 'ETH',
          decimals: 18
        },
        blockExplorerUrls: ['https://testnet-blockscan.teqoin.io/']
      }]
    });
    
    console.log('TeQoin network added successfully!');
  } catch (error) {
    console.error('Failed to add network:', error);
  }
}

// Usage
addTeQoinNetwork();

import { providers } from 'ethers';

async function addTeQoinNetwork(): Promise<void> {
  if (!window.ethereum) {
    throw new Error('MetaMask not installed');
  }

  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0x66B69',
        chainName: 'TeQoin L2',
        rpcUrls: ['https://rpc.teqoin.io'],
        nativeCurrency: {
          name: 'Ether',
          symbol: 'ETH',
          decimals: 18
        },
        blockExplorerUrls: ['https://testnet-blockscan.teqoin.io/']
      }]
    });
  } catch (error) {
    if ((error as any).code === 4902) {
      console.log('Please add TeQoin network manually');
    }
    throw error;
  }
}

import { useEffect } from 'react';

function AddNetworkButton() {
  const addNetwork = async () => {
    try {
      await window.ethereum.request({
        method: 'wallet_addEthereumChain',
        params: [{
          chainId: '0x66B69',
          chainName: 'TeQoin L2',
          rpcUrls: ['https://rpc.teqoin.io'],
          nativeCurrency: {
            name: 'Ether',
            symbol: 'ETH',
            decimals: 18
          },
          blockExplorerUrls: ['https://testnet-blockscan.teqoin.io/']
        }]
      });
      alert('Network added! Please switch to TeQoin L2');
    } catch (error) {
      console.error(error);
    }
  };

  return (
    <button onClick={addNetwork}>
      Add TeQoin Network
    </button>
  );
}

📋 Network Information Reference

Quick reference for all TeQoin L2 network parameters.

Parameter	Value	Notes
Network Name	TeQoin L2	Display name in wallet
RPC URL	https://rpc.teqoin.io	Primary endpoint
RPC URL (Backup)	Not available currently	TeQoin does not publish a backup RPC yet
WebSocket URL	wss://ws.teqoin.io	For real-time data
Chain ID	420377	Decimal format
Chain ID (Hex)	0x66B69	Hexadecimal format
Currency Symbol	ETH	Native currency
Currency Decimals	18	Standard for ETH
Block Explorer	https://testnet-blockscan.teqoin.io/	View transactions
Block Time	5 seconds	Average time between blocks

✅ Verify Connection

Make sure you’re connected correctly.

TeQoin Telegram Wallet
MetaMask

Open Wallet

Open @TeQoin_Wallet_Bot in Telegram

Check Network

You should see “TeQoin L2” displayed at the top of the wallet

View Your Address

Your wallet address is shown and ready to receive funds

✅ TeQoin Telegram Wallet is already configured correctly!

🔧 Troubleshooting

Can't find @TeQoin_Wallet_Bot on Telegram

Make sure you’re searching in the global Telegram search (not just in chats).Solution:

Open Telegram
Use the search bar at the top
Type: @TeQoin_Wallet_Bot
Or visit: https://t.me/TeQoin_Wallet_Bot

MetaMask says 'Chain ID already exists'

This means TeQoin L2 is already added to your MetaMask.Solution:

Click the network dropdown
Look for “TeQoin L2” in the list
Select it to switch

If you don’t see it, try searching for Chain ID 420377 in your network settings.

RPC URL not responding

TeQoin currently publishes a single public RPC endpoint.Solution:

Re-check the primary RPC: https://rpc.teqoin.io
Check your internet connection
Try again in a few minutes
Contact support through /resources/support

Wrong Chain ID error

Make sure you entered 420377 (not 42069 or other values).Solution:

Edit the network in MetaMask
Change Chain ID to exactly: 420377
Save changes

🎯 Next Steps

Get Testnet ETH

Request free testnet ETH to start making transactions

Make Your First Transaction

Send your first low-fee transaction on TeQoin L2

Bridge Assets

Move ETH from Ethereum L1 to TeQoin L2

Deploy a Contract

Deploy your first smart contract on TeQoin

💡 Comparison: Which Wallet Should I Use?

Feature	TeQoin Telegram Wallet	MetaMask
Setup Time	30 seconds	2 minutes
TeQoin Pre-configured	✅ Yes	❌ No (manual setup)
Built-in Faucet	✅ Yes	❌ No
Browser Extension	❌ No	✅ Yes
Best For	New users, Telegram users	Experienced crypto users
Cross-Chain Support	TeQoin L2 only	All EVM chains

Our Recommendation:

New to crypto? Use TeQoin Telegram Wallet for the easiest experience
Experienced user? Use MetaMask if you already have it configured
Why not both? You can use the same wallet address in both!

Wallet configured? Head to Get Testnet ETH to start using TeQoin! 🚀

Introduction

Quick Start

Developer Documentation

Bridge

Architecture

Tutorials

Resources

Add TeQoin Network

🎯 Choose Your Wallet

TeQoin Telegram Wallet

MetaMask

📱 Method 1: TeQoin Telegram Wallet (Recommended)

✨ TeQoin Telegram Wallet Features

Pre-configured TeQoin L2

Low-Fee Transactions

Built-in Faucet

Easy to Use

Secure

Cross-Device

🦊 Method 2: MetaMask Wallet

Option A: One-Click Add (Fastest)

Add TeQoin Network

Option B: Manual Configuration

📱 Method 3: MetaMask Mobile

🔗 Method 4: Programmatic (For Developers)

📋 Network Information Reference

✅ Verify Connection

🔧 Troubleshooting

🎯 Next Steps

Get Testnet ETH

Make Your First Transaction

Bridge Assets

Deploy a Contract

💡 Comparison: Which Wallet Should I Use?

​🎯 Choose Your Wallet

TeQoin Telegram Wallet

MetaMask

​📱 Method 1: TeQoin Telegram Wallet (Recommended)

​✨ TeQoin Telegram Wallet Features

Pre-configured TeQoin L2

Low-Fee Transactions

Built-in Faucet

Easy to Use

Secure

Cross-Device

​🦊 Method 2: MetaMask Wallet

​Option A: One-Click Add (Fastest)

Add TeQoin Network

​Option B: Manual Configuration

​📱 Method 3: MetaMask Mobile

​🔗 Method 4: Programmatic (For Developers)

​📋 Network Information Reference

​✅ Verify Connection

​🔧 Troubleshooting

​🎯 Next Steps

Get Testnet ETH

Make Your First Transaction

Bridge Assets

Deploy a Contract

​💡 Comparison: Which Wallet Should I Use?

🎯 Choose Your Wallet

📱 Method 1: TeQoin Telegram Wallet (Recommended)

✨ TeQoin Telegram Wallet Features

🦊 Method 2: MetaMask Wallet

Option A: One-Click Add (Fastest)

Option B: Manual Configuration

📱 Method 3: MetaMask Mobile

🔗 Method 4: Programmatic (For Developers)

📋 Network Information Reference

✅ Verify Connection

🔧 Troubleshooting

🎯 Next Steps

💡 Comparison: Which Wallet Should I Use?