Wallet Configuration

Connect wallets like MetaMask to your Local Blockchain for testing transactions and dApp interactions.

MetaMask Setup

Add Network

Open MetaMask
Click network dropdown → “Add Network” → “Add Network Manually”
Enter these details:

Field	Value
Network Name	Local PoA (or any name)
RPC URL	`http://localhost:8545`
Chain ID	`90999999` (or your LOCAL_CHAIN_ID)
Currency Symbol	ETH (or any symbol)
Block Explorer URL	`http://localhost:4000`

You can also replace “localhost” with your local DHCP IP address if your on a separate device than what is running Geth and Blockscout as long as they are on the same wi-fi.

Important: The Chain ID must match your LOCAL_CHAIN_ID from your .env that was used to produce the first genesis block with the genesis.json file. If you changed the .env or genesis.json after generating the genesis block, the system still only recognizes the value used during that genesis block’s creation. Other fields are cosmetic.

Import Accounts

Import Validator Account

Get private key: pnpm run reveal:key
In MetaMask: Menu → “Import Account”
Select “Private Key” and paste
This account has 10,000 ETH for gas

Use Test Account

The pre-funded test account from .env:

Default: 0xee1520c50f0ee31a37fd9699db29b69565c9eda9
Has 10,000 ETH balance
Import via private key if you have it

Other Wallets

Most Ethereum wallets support custom networks:

Trust Wallet

Settings → Networks → Add Custom Network
Use same RPC and Chain ID

WalletConnect

Works automatically once MetaMask is configured
Ensure Chain ID matches exactly

Hardware Wallets

Connect through MetaMask or MyCrypto
Set custom network before signing

Connection Verification

After adding the network:

Switch to your Local Blockchain in wallet
Check ETH balance appears
Try sending a test transaction
Verify on Blockscout: http://localhost:4000

Troubleshooting

”Wrong Network” Errors

Verify Chain ID matches exactly
Clear wallet cache/activity data
Re-add network

No Balance Showing

Ensure node is running: pnpm run status
Check correct account is selected
Verify address in genesis has funds

Transaction Failures

Check node is mining: pnpm run geth:attach then miner.start()
Ensure sufficient gas price (1 gwei minimum)
Verify account has ETH for gas

Block Explorer Integration

Blockscout URL in wallet settings enables:

Click-through from wallet to explorer
Transaction status tracking
Contract interaction history
Token balance verification