> ## 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.

# Add TeQoin Network

> Configure your wallet to connect to TeQoin L2 in under 2 minutes

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

<Note>
  **Time Required:** Less than 2 minutes\
  **Prerequisites:** A compatible wallet (MetaMask, TeQoin Telegram Wallet, or other Web3 wallet)
</Note>

***

## 🎯 Choose Your Wallet

<CardGroup cols={2}>
  <Card title="TeQoin Telegram Wallet" icon="telegram" href="#telegram-wallet">
    **Easiest & Fastest** ⚡

    Built-in TeQoin support - No configuration needed!

    [Get Started →](#telegram-wallet)
  </Card>

  <Card title="MetaMask" icon="wallet" href="#metamask">
    **Most Popular** 🦊

    Works on desktop, mobile, and browser extension

    [Configure →](#metamask)
  </Card>
</CardGroup>

***

<div id="telegram-wallet" />

## 📱 Method 1: TeQoin Telegram Wallet (Recommended)

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

<Steps>
  <Step title="Open Telegram">
    Open the Telegram app on your phone or desktop
  </Step>

  <Step title="Search for TeQoin Wallet">
    Search for **@TeQoin\_Wallet\_Bot** in Telegram

    Or click this link: [t.me/TeQoin\_Wallet\_Bot](https://t.me/TeQoin_Wallet_Bot)
  </Step>

  <Step title="Start the Bot">
    Click **"Start"** or send `/start` to launch the wallet
  </Step>

  <Step title="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
  </Step>

  <Step title="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!
  </Step>
</Steps>

### ✨ TeQoin Telegram Wallet Features

<CardGroup cols={2}>
  <Card title="Pre-configured TeQoin L2" icon="check">
    TeQoin network is already set up - no manual configuration
  </Card>

  <Card title="Low-Fee Transactions" icon="coins">
    Send ETH and interact with dApps
  </Card>

  <Card title="Built-in Faucet" icon="faucet">
    Get testnet ETH directly in the wallet
  </Card>

  <Card title="Easy to Use" icon="mobile">
    Simple interface designed for everyone
  </Card>

  <Card title="Secure" icon="lock">
    Your keys, your crypto - non-custodial wallet
  </Card>

  <Card title="Cross-Device" icon="devices">
    Access from phone, tablet, or desktop
  </Card>
</CardGroup>

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

***

<div id="metamask" />

## 🦊 Method 2: MetaMask Wallet

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

### Option A: One-Click Add (Fastest)

<Steps>
  <Step title="Click the Button Below">
    Click the "Add to MetaMask" button to automatically configure the network.

    <Card title="Add TeQoin Network" icon="plus" href="https://chainlist.org/chain/420377">
      **One-Click Setup**

      Automatically adds TeQoin L2 to MetaMask

      [Add to MetaMask →](https://chainlist.org/chain/420377)
    </Card>

    <Tip>
      This will open a popup in MetaMask asking you to approve the network addition.
    </Tip>
  </Step>

  <Step title="Approve in MetaMask">
    When the MetaMask popup appears:

    1. Review the network details
    2. Click **"Approve"**
    3. Click **"Switch Network"** to start using TeQoin

    ✅ That's it! You're now connected to TeQoin L2.
  </Step>
</Steps>

### Option B: Manual Configuration

<Steps>
  <Step title="Open MetaMask Settings">
    1. Click the **MetaMask extension** in your browser
    2. Click the **network dropdown** (top of MetaMask)
    3. Click **"Add Network"** or **"Add a network manually"**
  </Step>

  <Step title="Enter Network Details">
    Copy and paste these exact values:

    <CodeGroup>
      ```text Network Configuration theme={null}
          Network Name: TeQoin L2
          RPC URL: https://rpc.teqoin.io
          Chain ID: 420377
          Currency Symbol: ETH
          Block Explorer URL: https://testnet-blockscan.teqoin.io/
      ```
    </CodeGroup>

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

    <Warning>
      **Important:** The Chain ID must be exactly `420377`. Double-check this value!
    </Warning>
  </Step>

  <Step title="Save and Switch">
    1. Click **"Save"**
    2. MetaMask will automatically switch to TeQoin L2
    3. You'll see "TeQoin L2" in the network dropdown

    ✅ Network added successfully!
  </Step>
</Steps>

***

## 📱 Method 3: MetaMask Mobile

Add TeQoin L2 on the MetaMask mobile app.

<Tabs>
  <Tab title="iOS">
    <Steps>
      <Step title="Open MetaMask App">
        Launch the MetaMask app on your iPhone
      </Step>

      <Step title="Access Settings">
        1. Tap the **hamburger menu** (☰) in top-left
        2. Tap **"Settings"**
        3. Tap **"Networks"**
        4. Tap **"Add Network"**
      </Step>

      <Step title="Enter Details">
        Fill in the network information:

        * **Network Name:** TeQoin L2
        * **RPC URL:** [https://rpc.teqoin.io](https://rpc.teqoin.io)
        * **Chain ID:** 420377
        * **Symbol:** ETH
        * **Block Explorer:** [https://testnet-blockscan.teqoin.io/](https://testnet-blockscan.teqoin.io/)
      </Step>

      <Step title="Save">
        Tap **"Add"** to save the network
      </Step>
    </Steps>
  </Tab>

  <Tab title="Android">
    <Steps>
      <Step title="Open MetaMask App">
        Launch the MetaMask app on your Android device
      </Step>

      <Step title="Access Settings">
        1. Tap the **hamburger menu** (☰) in top-left
        2. Tap **"Settings"**
        3. Tap **"Networks"**
        4. Tap **"Add Network"**
      </Step>

      <Step title="Enter Details">
        Fill in the network information:

        * **Network Name:** TeQoin L2
        * **RPC URL:** [https://rpc.teqoin.io](https://rpc.teqoin.io)
        * **Chain ID:** 420377
        * **Symbol:** ETH
        * **Block Explorer:** [https://testnet-blockscan.teqoin.io/](https://testnet-blockscan.teqoin.io/)
      </Step>

      <Step title="Save">
        Tap **"Add"** to save the network
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## 🔗 Method 4: Programmatic (For Developers)

Add TeQoin network programmatically from your dApp.

<CodeGroup>
  ```javascript JavaScript (Ethers.js) theme={null}
  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();
  ```

  ```javascript TypeScript theme={null}
  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;
    }
  }
  ```

  ```javascript React theme={null}
  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>
    );
  }
  ```
</CodeGroup>

***

## 📋 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](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/](https://testnet-blockscan.teqoin.io/) | View transactions                        |
| **Block Time**        | 5 seconds                                                                    | Average time between blocks              |

***

## ✅ Verify Connection

Make sure you're connected correctly.

<Tabs>
  <Tab title="TeQoin Telegram Wallet">
    <Steps>
      <Step title="Open Wallet">
        Open @TeQoin\_Wallet\_Bot in Telegram
      </Step>

      <Step title="Check Network">
        You should see **"TeQoin L2"** displayed at the top of the wallet
      </Step>

      <Step title="View Your Address">
        Your wallet address is shown and ready to receive funds
      </Step>
    </Steps>

    ✅ TeQoin Telegram Wallet is already configured correctly!
  </Tab>

  <Tab title="MetaMask">
    <Steps>
      <Step title="Check Network Name">
        Look at the top of MetaMask. It should say **"TeQoin L2"**
      </Step>

      <Step title="Check Chain ID">
        Open MetaMask Settings → Networks → TeQoin L2

        Verify Chain ID shows: **420377**
      </Step>

      <Step title="Test Connection">
        Try viewing your account on the block explorer:

        1. Copy your wallet address
        2. Visit [https://testnet-blockscan.teqoin.io/](https://testnet-blockscan.teqoin.io/)
        3. Paste your address in the search bar

        You should see your account page (even with 0 balance)
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## 🔧 Troubleshooting

<AccordionGroup>
  <Accordion title="Can't find @TeQoin_Wallet_Bot on Telegram">
    Make sure you're searching in the global Telegram search (not just in chats).

    **Solution:**

    1. Open Telegram
    2. Use the search bar at the top
    3. Type: `@TeQoin_Wallet_Bot`
    4. Or visit: [https://t.me/TeQoin\_Wallet\_Bot](https://t.me/TeQoin_Wallet_Bot)
  </Accordion>

  <Accordion title="MetaMask says 'Chain ID already exists'">
    This means TeQoin L2 is already added to your MetaMask.

    **Solution:**

    1. Click the network dropdown
    2. Look for "TeQoin L2" in the list
    3. Select it to switch

    If you don't see it, try searching for Chain ID `420377` in your network settings.
  </Accordion>

  <Accordion title="RPC URL not responding">
    TeQoin currently publishes a single public RPC endpoint.

    **Solution:**

    1. Re-check the primary RPC: `https://rpc.teqoin.io`
    2. Check your internet connection
    3. Try again in a few minutes
    4. Contact support through [/resources/support](/resources/support)
  </Accordion>

  <Accordion title="Wrong Chain ID error">
    Make sure you entered **420377** (not 42069 or other values).

    **Solution:**

    1. Edit the network in MetaMask
    2. Change Chain ID to exactly: `420377`
    3. Save changes
  </Accordion>
</AccordionGroup>

***

## 🎯 Next Steps

<CardGroup cols={2}>
  <Card title="Get Testnet ETH" icon="faucet" href="/quickstart/get-testnet-eth">
    Request free testnet ETH to start making transactions
  </Card>

  <Card title="Make Your First Transaction" icon="paper-plane" href="/quickstart/first-transaction">
    Send your first low-fee transaction on TeQoin L2
  </Card>

  <Card title="Bridge Assets" icon="bridge" href="/quickstart/bridge-assets">
    Move ETH from Ethereum L1 to TeQoin L2
  </Card>

  <Card title="Deploy a Contract" icon="code" href="/developers/deploy-contract">
    Deploy your first smart contract on TeQoin
  </Card>
</CardGroup>

***

## 💡 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           |

<Tip>
  **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!
</Tip>

***

**Wallet configured?** Head to [Get Testnet ETH](/quickstart/get-testnet-eth) to start using TeQoin! 🚀