Skip to main content

Wallet Setup

Connect your wallet to Umbraline Testnet.

One-Click Setup​

Manual Configuration​

If the button doesn't work, add the network manually:

  1. Open MetaMask
  2. Click the network dropdown
  3. Select "Add Network" → "Add a network manually"
  4. Enter the following:
FieldValue
Network NameUmbraline Testnet
New RPC URLhttps://testnet-rpc.umbraline.com
Chain ID47474
Currency SymbolGHOST
Block Explorer URLhttps://umbrascan.com
  1. Click "Save"

Getting Testnet GHOST​

After connecting, you'll need testnet GHOST for gas and commitment fees.

Option 1: Faucet

Visit portal.ghostcoin.com/faucet

  • Rate limit: 1 request per address per 24 hours
  • Amount: 100 GHOST per request

Option 2: Bridge USDC

Bridge USDC from Avalanche Fuji to receive USDG on Umbraline Testnet.

See USDG Gateway for details.

Verifying Connection​

After adding the network, verify you're connected:

  1. Check the network name shows "Umbraline Testnet"
  2. Check your GHOST balance appears
  3. Try viewing the explorer

Programmatic Network Addition​

For dApps, you can prompt users to add the network:

const addUmbralineNetwork = async () => {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0xB99A', // 47474 in hex
        chainName: 'Umbraline Testnet',
        nativeCurrency: {
          name: 'GHOST',
          symbol: 'GHOST',
          decimals: 18,
        },
        rpcUrls: ['https://testnet-rpc.umbraline.com'],
        blockExplorerUrls: ['https://umbrascan.com'],
      }],
    });
    console.log('Network added successfully');
  } catch (error) {
    console.error('Failed to add network:', error);
  }
};

Troubleshooting​

"Chain ID already exists"​

You may already have a network with chain ID 47474. Check your networks list and remove any duplicate entries.

"RPC URL is not valid"​

Ensure you're using https:// (not http://) and the URL is exactly:

https://testnet-rpc.umbraline.com

Transactions stuck as pending​

Umbraline Testnet requires --legacy transactions (type 0). If using cast:

cast send ... --legacy

If using ethers.js, the library handles this automatically.