Wallet setup

MetaMask — manual add

1. Open MetaMask → Click network selector → Add network.

2. Fill in:

   • Network Name: Buburuza Mainnet

   • RPC URL: https://rpc-mainnet.buburuza.com

   • Chain ID: 30143370385

   • Symbol: BUB

   • Block Explorer URL: https://explorer-mainnet.buburuza.com

3. Save and switch to the network.

MetaMask — programmatic (add & switch)

// chainIdHex must be '0x' + chainId in hex (use ethers.utils.hexValue)
await window.ethereum.request({
  method: 'wallet_addEthereumChain',
  params: [{
    chainId: '0x<MAINNET_CHAIN_ID_HEX>',
    chainName: 'Buburuza Mainnet',
    nativeCurrency: { name: 'Buburuza', symbol: 'BUBU', decimals: 18 },
    rpcUrls: ['https://rpc.buburuza.com'],
    blockExplorerUrls: ['https://explorer.buburuza.com']
  }]
});

(If wallet_addEthereumChain is not supported by the wallet, show manual steps to the user.)

WalletConnect (Web / Mobile)

Use a WalletConnect provider or Web3Modal. Example with @walletconnect/web3-provider:

import WalletConnectProvider from "@walletconnect/web3-provider";
import { ethers } from "ethers";

const provider = new WalletConnectProvider({
  rpc: { 
    <TESTNET_CHAIN_ID_DECIMAL>: "https://rpc.buburuza.com"
  }
});
await provider.enable();
const web3provider = new ethers.providers.Web3Provider(provider);

This lets mobile wallets connect and sign transactions on Buburuza.

Hardware wallets (Ledger / Trezor)

• Hardware wallets are supported when used through MetaMask or WalletConnect.

• Users should connect the hardware wallet in their wallet UI (MetaMask → Connect Hardware Wallet) and then switch MetaMask to Buburuza network.

Security note: never paste private keys or seed phrases into web UIs. For automation, use secure key management (HSM or environment vars for CI).