MetaMask WETH9 Display Fix Instructions

Date: $(date)
Issue: MetaMask showing "6,000,000,000.0T WETH" instead of "6 WETH"
Root Cause: WETH9 contract's decimals() returns 0 instead of 18

🔍 Problem Confirmed

Root Cause: The WETH9 contract at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 has a decimals() function that returns 0x0 instead of 18.

When MetaMask reads the token balance:

It gets: 6,000,000,000,000,000,000 wei (raw value)
It expects: decimals = 18 to format correctly
It gets: decimals = 0 (incorrect)
Result: Displays as 6,000,000,000.0T WETH ❌

Actual Balance: 6 WETH ✅

✅ Solution: Manual Token Import in MetaMask

Since the contract's decimals() function is incorrect, you need to manually specify the correct decimals when importing the token.

Step-by-Step Instructions

Open MetaMask
- Make sure you're connected to "Defi Oracle Meta Mainnet" (ChainID 138)
Go to Import Tokens
- Click on the token list (where you see "Wrapped Ether")
- Scroll down and click "Import tokens"
- Or go to: Settings → Tokens → Import tokens
Enter Token Details
- Token Contract Address: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
- Token Symbol: WETH
- Decimals of Precision: 18 ⚠️ IMPORTANT: Set this to 18
- Click "Add Custom Token"
Verify
- The token should now display as "6 WETH" instead of "6,000,000,000.0T WETH"
- You may need to remove the old token entry first if it exists

🔄 Alternative: Use Token List

If you have access to host a token list JSON file:

Use the Updated Token List
- File: docs/METAMASK_TOKEN_LIST.json
- Now includes WETH9 with correct decimals (18)
Host the Token List
- Upload to GitHub, IPFS, or any public URL
- Example: https://your-domain.com/token-list.json
Add to MetaMask
- Settings → Security & Privacy → Token Lists
- Add custom token list URL
- Or import directly in dApp

📊 Verification

After fixing, verify the display:

Check Balance Display
- Should show: 6 WETH or 6.0 WETH ✅
- Should NOT show: 6,000,000,000.0T WETH ❌

Verify On-Chain Balance (Optional)

cast call 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  "balanceOf(address)" <YOUR_ADDRESS> \
  --rpc-url http://192.168.11.250:8545 | \
  xargs -I {} cast --to-unit {} ether
# Should output: 6

🐛 Why This Happens

WETH9 Contract Issue

The WETH9 contract is an older implementation that:

✅ Implements ERC-20 balanceOf(), transfer(), etc.
❌ Does NOT properly implement decimals() (returns 0)
❌ May not implement other ERC-20 optional functions

MetaMask Behavior

When MetaMask encounters a token with decimals = 0:

It reads the raw balance: 6000000000000000000
Without proper decimals, it doesn't know to divide by 10¹⁸
It formats the number incorrectly
Result: 6,000,000,000.0T (treating it as a very large number)

✅ Expected Result

After applying the fix:

Before: 6,000,000,000.0T WETH ❌
After: 6 WETH or 6.0 WETH ✅

📝 Notes

This is a display issue only - your actual balance is correct on-chain
Transactions will work correctly regardless of the display
The fix only affects how MetaMask displays the balance
Other wallets may have the same issue if they rely on decimals()

Last Updated: $(date)

3.7 KiB Raw Blame History