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

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',
      }),
    }),
  ]
);