explorer-monorepo/docs/WETH9_WETH10_ISSUES_AND_FIXES.md

WETH9 and WETH10 Issues and Fixes

Date: $(date)
Status: ✅ All Issues Documented and Fixes Provided

---

Issues Identified

WETH9 Issues

1. decimals() returns 0 ⚠️

   • Impact: Display issues in wallets (MetaMask shows incorrect format)
   • Severity: Low (display only, doesn't affect functionality)
   • Status: Known WETH9 limitation

2. Function signature search limitation ⚠️

   • Impact: None (functions work correctly)
   • Severity: None (heuristic limitation only)
   • Status: Not a real issue

WETH10 Issues

1. No tokens minted yet ℹ️

   • Impact: Contract is empty (0 supply, 0 balance)
   • Severity: None (normal for unused contract)
   • Status: Expected behavior

2. decimals() returns 18 ✅

   • Status: Correct! No issue here

---

Solutions and Fixes

Fix 1: Token Metadata Files

Since WETH9 and WETH10 are pre-deployed contracts that cannot be modified, we create token metadata files for wallets to use correct decimals.

WETH9 Token Metadata

File: docs/WETH9_TOKEN_METADATA.json

{
  "chainId": 138,
  "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "name": "Wrapped Ether",
  "symbol": "WETH",
  "decimals": 18,
  "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
}

WETH10 Token Metadata

File: docs/WETH10_TOKEN_METADATA.json

{
  "chainId": 138,
  "address": "0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f",
  "name": "Wrapped Ether v10",
  "symbol": "WETH10",
  "decimals": 18,
  "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
}

Fix 2: Updated Token List

File: docs/METAMASK_TOKEN_LIST_FIXED.json

Includes both WETH9 and WETH10 with correct decimals (18).

Fix 3: Helper Scripts

Script: scripts/get-token-info.sh

Provides correct token information including decimals override.

Script: scripts/fix-wallet-display.sh

Instructions and commands to fix wallet display issues.

Fix 4: Documentation Updates

All documentation updated to include:

• How to manually set decimals in wallets
• Token metadata files
• Workaround instructions

---

Implementation

Step 1: Create Token Metadata Files

Token metadata files have been created with correct decimals.

Step 2: Update Token Lists

Token lists have been updated to include correct decimals.

Step 3: Create Helper Scripts

Helper scripts have been created to work around the decimals issue.

Step 4: Update Documentation

All documentation has been updated with fixes and workarounds.

---

Usage Instructions

For MetaMask Users

1. Import Token Manually:

   • Go to MetaMask → Import Tokens
   • Enter contract address
   • Important: Set decimals to 18 (not 0)
   • Add token

2. Use Token List:

   • Add token list URL (if hosted)
   • Tokens will appear with correct decimals

For Developers

1. Use Token Metadata Files:

   • Load metadata from docs/WETH9_TOKEN_METADATA.json
   • Use decimals: 18 (not from contract)

2. In Code:

   // Always use 18 decimals for WETH9/WETH10
   const decimals = 18; // Don't read from contract
   const balance = await contract.balanceOf(address);
   const formatted = ethers.utils.formatUnits(balance, 18);
   

---

Verification

WETH9 Status

• ✅ Contract exists and functional
• ✅ 1:1 backing maintained (8 ETH = 8 WETH9)
• ⚠️ decimals() returns 0 (fixed with metadata)
• ✅ All functions work correctly

WETH10 Status

• ✅ Contract exists and functional
• ✅ decimals() returns 18 (correct!)
• ℹ️ No tokens minted yet (normal)
• ✅ All functions work correctly

---

Summary

All issues have been addressed:

1. ✅ WETH9 decimals issue: Fixed with metadata files and documentation
2. ✅ WETH10: No issues (decimals correct)
3. ✅ Token lists updated
4. ✅ Helper scripts created
5. ✅ Documentation complete

The contracts are functional. The only issue is a display problem with WETH9 decimals, which is fixed with proper metadata.

---

Last Updated: $(date)