LCX Logo

    Connect Your Wallet

    To interact with Liberty Chain, you need a wallet that supports custom EVM networks. This guide walks you through connecting MetaMask, but the same network details work with any compatible wallet.

    Correct RPC URL

    Make sure you are connected to the correct RPC URL. The official Liberty Chain Testnet RPC endpoint is https://testnet-rpc.lcx.com. Do not use unofficial or third-party RPC URLs.

    Network Details

    Use the following values when adding Liberty Chain to any wallet:

    Network NameLiberty Chain Testnet
    RPC URLhttps://testnet-rpc.lcx.com
    Chain ID76847801
    Currency SymbolETH
    Block Explorerhttps://testnet-explorer.lcx.com

    Add to MetaMask (Manual)

    Follow these steps to manually add Liberty Chain to MetaMask:

    1. Open MetaMask and click the network selector at the top of the window.
    2. Click Add network, then Add a network manually at the bottom.
    3. Fill in the network details from the table above:
      • Network Name: Liberty Chain Testnet
      • New RPC URL: https://testnet-rpc.lcx.com
      • Chain ID: 76847801
      • Currency Symbol: ETH
      • Block Explorer URL: https://testnet-explorer.lcx.com
    4. Click Save. Liberty Chain Testnet will now appear in your network list.
    5. Select Liberty Chain Testnet from the network dropdown to switch to it.

    One-Click Add (Programmatic)

    If you are building a dApp and want to let users add Liberty Chain with a single click, use the wallet_addEthereumChain RPC method:

    Add Liberty Chain to MetaMask
    javascript
    async function addLibertyChain() {
      try {
        await window.ethereum.request({
          method: 'wallet_addEthereumChain',
          params: [{
            chainId: '0x4949AB9',  // 76847801 in hex
            chainName: 'Liberty Chain Testnet',
            nativeCurrency: {
              name: 'Ether',
              symbol: 'ETH',
              decimals: 18,
            },
            rpcUrls: ['https://testnet-rpc.lcx.com'],
            blockExplorerUrls: ['https://testnet-explorer.lcx.com'],
          }],
        });
        console.log('Liberty Chain Testnet added successfully');
      } catch (error) {
        console.error('Failed to add network:', error);
      }
    }

    Chain ID Format

    The chain ID must be passed as a hexadecimal string when using wallet_addEthereumChain. The decimal value 76847801 converts to 0x4949AB9 in hex.

    Other Wallets

    Liberty Chain is compatible with any wallet that supports custom EVM networks. In addition to MetaMask, you can use:

    • Rabby Wallet — go to Settings → Custom Networks and enter the same network details above. Rabby typically auto-detects networks when you visit a dApp.
    • Coinbase Wallet — navigate to Settings → Networks → Add Custom Network and provide the RPC URL, Chain ID, and explorer URL.
    • Rainbow Wallet — supports custom networks through its settings menu. Use the same connection details.

    Info

    All wallets use the same network parameters. If a wallet supports wallet_addEthereumChain, the one-click add code above will work regardless of the wallet provider.

    Next Steps

    Once your wallet is connected to Liberty Chain Testnet, you will need test ETH to pay for transactions. Follow the Get Test ETH guide to bridge Sepolia ETH to Liberty Chain.