Skip to main content

Wallet Setup

Xphere is fully EVM-compatible, so any wallet that supports custom EVM networks works out of the box. This guide covers the four most common cases.

1. MetaMask (Browser & Mobile)​

Option A — One-click add​

Visit chainlist.org and click Connect Wallet → Add Xphere.

Option B — Manual​

  1. Open MetaMask → click the network selector (top-left) → Add network → Add a network manually

  2. Fill in the form:

    Mainnet

    Network Name:     Xphere Mainnet
    New RPC URL:      https://en-hkg.x-phere.com
    Chain ID:         20250217
    Currency Symbol:  XP
    Block Explorer:   https://xp.tamsa.io

    Testnet

    Network Name:     Xphere Testnet
    New RPC URL:      https://testnet.x-phere.com
    Chain ID:         1998991
    Currency Symbol:  XPT
    Block Explorer:   https://xpt.tamsa.io

  3. Click Save → MetaMask switches to Xphere automatically.

2. Rabby Wallet​

  1. Open Rabby → More → Add Custom Network
  2. Paste the RPC URL above and Rabby auto-detects Chain ID and currency.

3. Zigap Wallet (Native Xphere Wallet)​

Zigap is the Xphere Foundation's official wallet with built-in Xphere 2.0 support — no manual configuration needed.

  1. Install: about.zigap.io
  2. Create or import a wallet
  3. Select network: XPHERE 2.0 (Mainnet) or XPHERE 2.0 TESTNET

Zigap is required for Mining because the miner CLI uses the Zigap address format for targetMiner.

4. WalletConnect (Trust Wallet, Rainbow, etc.)​

In your dApp, request the chain programmatically:

await window.ethereum.request({
  method: "wallet_addEthereumChain",
  params: [{
    chainId: "0x134f269", // 20250217 in hex
    chainName: "Xphere Mainnet",
    nativeCurrency: { name: "Xphere", symbol: "XP", decimals: 18 },
    rpcUrls: ["https://en-hkg.x-phere.com"],
    blockExplorerUrls: ["https://xp.tamsa.io"],
  }],
});

Funding Your Wallet​

SourceNetworkNotes
Centralized exchangesMainnetSearch "XP" on supported exchanges
FaucetTestnetFree test tokens, rate-limited per address
MiningBothRun a mining node
Bridge from EthereumMainnetSee Bridge guide

Troubleshooting​

"Transaction underpriced" — Xphere's minimum gas price is 1 gwei. Set maxFeePerGas ≥ 1 gwei in your wallet/library.

"Nonce too low" — MetaMask cached the wrong nonce. Settings → Advanced → Clear activity tab data.

Wallet shows balance as 0 despite explorer showing XP — You're on the wrong network. Confirm Chain ID in MetaMask matches the explorer.

eth_chainId returns a different value than 20250217 — The RPC node is behind. Switch to another endpoint from the Network Info list.