Skip to main content

Set Up a Wallet

Learn how to set up your wallet for Circle Layer testnet access.

Supported Wallets​

  • MetaMask (Recommended - Desktop and Mobile)
  • WalletConnect (Register on WalletConnect and follow their guidelines)
  • Custom Wallets (EVM-compatible software wallets)
  • Mobile Wallets (Trust Wallet, Rainbow, Coinbase Wallet, etc.)
Hardware Wallet Limitation

Ledger hardware wallets are NOT supported on Circle Layer at this time. Please use software wallets like MetaMask for Circle Layer testnet access.

Wallet Compatibility Details​

✅ Fully Supported​

  • MetaMask: Browser extension and mobile app
  • Trust Wallet: Mobile and desktop versions
  • Rainbow Wallet: Mobile and browser support
  • Coinbase Wallet: Full EVM compatibility
  • WalletConnect: All WalletConnect-compatible wallets
  • Brave Wallet: Built-in Ethereum wallet
  • Frame: Desktop wallet with hardware isolation

❌ Not Supported​

  • Ledger Hardware Wallets: Due to technical limitations
  • Trezor Hardware Wallets: Due to technical limitations
  • Other Hardware Wallets: Currently not compatible

Preparation Steps​

  1. Choose your preferred wallet
  2. Install the wallet extension or application
  3. Create a new wallet or import existing
  4. Configure network settings
  5. Add Circle Layer testnet

MetaMask Configuration​

Testnet Network Settings​

{
  "networkName": "Circle Layer Testnet",
  "rpcUrl": "https://testnet-rpc.circlelayer.com",
  "chainId": 28525,
  "currencySymbol": "CLAYER",
  "currencyDecimals": 18,
  "blockExplorerUrl": "https://explorer-testnet.circlelayer.com"
}

Manual Network Addition​

Method 1: Manual Configuration​

  1. Open MetaMask and click the network dropdown
  2. Select "Add Network" → "Add a network manually"
  3. Fill in the network details:
    • Network Name: Circle Layer Testnet
    • New RPC URL: https://testnet-rpc.circlelayer.com
    • Chain ID: 28525
    • Currency Symbol: CLAYER
    • Block Explorer URL: https://explorer-testnet.circlelayer.com
  4. Click "Save" to add the network
  5. Switch to Circle Layer from the network dropdown

Method 2: Programmatic Addition​

// Add Circle Layer Testnet programmatically
async function addCircleLayerNetwork() {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0x6F75', // 28525 in hexadecimal
        chainName: 'Circle Layer Testnet',
        nativeCurrency: {
          name: 'CLAYER',
          symbol: 'CLAYER',
          decimals: 18
        },
        rpcUrls: ['https://testnet-rpc.circlelayer.com'],
        blockExplorerUrls: ['https://explorer-testnet.circlelayer.com']
      }]
    });
    console.log('Circle Layer Testnet added successfully');
  } catch (error) {
    console.error('Error adding network:', error);
  }
}

Network Verification​

After adding the network, verify the configuration:

  1. Check Network Display: Should show "Circle Layer Testnet"
  2. Verify Chain ID: Should display 28525
  3. Currency Symbol: Should show CLAYER
  4. Test Connection: Try viewing account balance

Advanced MetaMask Settings​

Gas Configuration​

// Recommended gas settings for Circle Layer
const gasSettings = {
  gasPrice: '21000000000', // 0.000021 CLAYER in wei
  gasLimit: '21000', // Standard transfer
  maxFeePerGas: '25000000000', // 0.000025 CLAYER
  maxPriorityFeePerGas: '2000000000' // 0.000002 CLAYER
};

Custom RPC Configuration​

  • Primary RPC: https://testnet-rpc.circlelayer.com
  • WebSocket: wss://testnet-rpc.circlelayer.com
  • Backup RPC: Contact support for additional endpoints
  • Connection Timeout: 30 seconds (default)

WalletConnect Setup​

For WalletConnect integration, you need to register on WalletConnect and follow their guidelines for EVM-compatible chains.

WalletConnect Configuration​

// WalletConnect v2 setup for Circle Layer
import { Web3Modal } from '@web3modal/wagmi/react';
import { configureChains, createConfig, WagmiConfig } from 'wagmi';
import { jsonRpcProvider } from 'wagmi/providers/jsonRpc';

const circleLayerTestnet = {
  id: 28525,
  name: 'Circle Layer Testnet',
  network: 'circle-layer-testnet',
  nativeCurrency: {
    decimals: 18,
    name: 'CLAYER',
    symbol: 'CLAYER',
  },
  rpcUrls: {
    default: { http: ['https://testnet-rpc.circlelayer.com'] },
    public: { http: ['https://testnet-rpc.circlelayer.com'] },
  },
  blockExplorers: {
    default: { 
      name: 'Circle Layer Explorer', 
      url: 'https://explorer-testnet.circlelayer.com' 
    },
  },
};

const { chains, publicClient } = configureChains(
  [circleLayerTestnet],
  [
    jsonRpcProvider({
      rpc: (chain) => ({
        http: 'https://testnet-rpc.circlelayer.com',
      }),
    }),
  ]
);

Mobile Wallet Configuration​

Trust Wallet Setup​

  1. Open Trust Wallet → Settings → Wallets
  2. Add Network → Select "Custom"
  3. Enter Network Details:
    • Network Name: Circle Layer Testnet
    • RPC URL: https://testnet-rpc.circlelayer.com
    • Chain ID: 28525
    • Symbol: CLAYER
    • Explorer: https://explorer-testnet.circlelayer.com

Rainbow Wallet Setup​

  1. Open Rainbow Wallet → Settings → Networks
  2. Add Network → Custom Network
  3. Configure Circle Layer:
    • Name: Circle Layer Testnet
    • RPC: https://testnet-rpc.circlelayer.com
    • Chain ID: 28525
    • Currency: CLAYER

Coinbase Wallet Setup​

  1. Open Coinbase Wallet → Settings → Active Networks
  2. Add Network → Custom RPC
  3. Fill Network Information:
    • Network Name: Circle Layer Testnet
    • RPC URL: https://testnet-rpc.circlelayer.com
    • Chain ID: 28525
    • Currency Symbol: CLAYER

Troubleshooting​

Common Issues​

Connection Problems​

  • Verify RPC URL: Ensure https://testnet-rpc.circlelayer.com is correct
  • Check Chain ID: Must be exactly 28525
  • Network Status: Check Circle Layer testnet status
  • Clear Cache: Clear wallet cache and retry

Transaction Issues​

  • Insufficient Gas: Ensure you have CLAYER for gas fees
  • Gas Price: Use minimum 0.000021 CLAYER gas price
  • Network Congestion: Wait for network to clear
  • Wallet Update: Ensure wallet is updated to latest version

Balance Display​

  • Token Not Visible: May need to manually add CLAYER token
  • Incorrect Network: Ensure you're on Circle Layer Testnet
  • Sync Issues: Try refreshing wallet or switching networks

Support Contacts​

Development Integration​

Circle Layer follows standard EVM integration patterns, making it compatible with existing Ethereum development tools and wallets.