proxmox/docs/archive/completion/WETH_UTILITIES_EXPLORER_COMPLETE.md

WETH9/WETH10 Wrap/Unwrap Utilities - Complete ✅

Date: December 23, 2025
Status: ✅ COMPLETE
Location: https://explorer.d-bis.org/

---

✅ WETH Utilities Added

Features

1. WETH9 Wrap/Unwrap Interface

   • Wrap native ETH → WETH9
   • Unwrap WETH9 → native ETH
   • Real-time balance display
   • MAX button for quick selection

2. WETH10 Wrap/Unwrap Interface

   • Wrap native ETH → WETH10
   • Unwrap WETH10 → native ETH
   • Real-time balance display
   • MAX button for quick selection

3. MetaMask Integration

   • Automatic MetaMask connection
   • Chain 138 network detection
   • Automatic network switching
   • Account change detection
   • Transaction signing and submission

4. User Experience

   • Real-time balance updates
   • Transaction status feedback
   • Error handling and alerts
   • Loading states during transactions
   • Success confirmations

---

📋 Contract Information

WETH9

• Address: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
• Standard: ERC-20 Wrapped Ether (WETH9)
• Functions: deposit(), withdraw(uint256)

WETH10

• Address: 0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f
• Standard: ERC-20 Wrapped Ether (WETH10)
• Functions: deposit(), withdraw(uint256)

---

🎯 How to Use

Step 1: Connect MetaMask

1. Visit https://explorer.d-bis.org/
2. Click "WETH" in the navigation bar
3. Click "Connect MetaMask" button
4. Approve the connection in MetaMask
5. If prompted, add Chain 138 network (automatic)

Step 2: Select Token

• Choose WETH9 or WETH10 tab
• View your current balances (ETH and WETH)

Step 3: Wrap ETH

1. Enter the amount of ETH to wrap
2. Click "MAX" to use your full ETH balance (optional)
3. Click "Wrap ETH to WETH9/WETH10" button
4. Confirm the transaction in MetaMask
5. Wait for transaction confirmation
6. Balances update automatically

Step 4: Unwrap WETH

1. Enter the amount of WETH to unwrap
2. Click "MAX" to unwrap your full WETH balance (optional)
3. Click "Unwrap WETH9/WETH10 to ETH" button
4. Confirm the transaction in MetaMask
5. Wait for transaction confirmation
6. Balances update automatically

---

🔧 Technical Details

Web3 Integration

• Library: Ethers.js v5.7.2
• Provider: MetaMask Web3Provider
• RPC Endpoint: https://rpc-core.d-bis.org (Chain 138)

Smart Contract Functions

WETH9/WETH10 Standard Functions

// Wrap ETH to WETH
function deposit() payable

// Unwrap WETH to ETH
function withdraw(uint256 wad)

// Check balance
function balanceOf(address account) view returns (uint256)

Transaction Flow

1. Wrap ETH:

   • User enters ETH amount
   • Calls deposit() with ETH value
   • Receives WETH tokens
   • Balance updates automatically

2. Unwrap WETH:

   • User enters WETH amount
   • Calls withdraw(amount)
   • Receives native ETH
   • Balance updates automatically

---

🎨 Interface Features

Balance Display

• ETH Balance: Shows native ETH balance
• WETH Balance: Shows WETH9 or WETH10 balance
• Auto-refresh: Updates after transactions
• Manual Refresh: Refresh button available

Form Features

• Amount Input: Decimal input for precise amounts
• MAX Button: Quickly select maximum balance
• Validation: Prevents invalid amounts
• Transaction Feedback: Loading, success, error states

MetaMask Status

• Connection Status: Shows connected/disconnected state
• Account Display: Shows connected address (shortened)
• Network Detection: Automatically switches to Chain 138
• Auto-reconnect: Maintains connection across page reloads

---

🔒 Security Features

1. Transaction Validation

   • Amount validation before submission
   • Balance checks (can't wrap more than available)
   • Transaction confirmation required

2. MetaMask Security

   • All transactions require MetaMask approval
   • User confirms each transaction
   • Private keys never exposed

3. Error Handling

   • Clear error messages
   • Transaction failure handling
   • Network error recovery

---

📊 Usage Examples

Wrap 1 ETH to WETH9

1. Connect MetaMask
2. Go to WETH9 tab
3. Enter 1.0 in wrap amount field
4. Click "Wrap ETH to WETH9"
5. Confirm in MetaMask
6. Wait for confirmation

Unwrap All WETH10

1. Connect MetaMask
2. Go to WETH10 tab
3. Click "MAX" in unwrap section
4. Click "Unwrap WETH10 to ETH"
5. Confirm in MetaMask
6. Wait for confirmation

---

✅ Features Summary

Core Functionality

• ✅ Wrap ETH → WETH9
• ✅ Unwrap WETH9 → ETH
• ✅ Wrap ETH → WETH10
• ✅ Unwrap WETH10 → ETH

User Experience

• ✅ Real-time balance display
• ✅ MAX button for quick selection
• ✅ Transaction status feedback
• ✅ Automatic balance refresh
• ✅ Error handling and alerts

Integration

• ✅ MetaMask wallet integration
• ✅ Chain 138 network support
• ✅ Automatic network switching
• ✅ Account change detection

Interface

• ✅ Clean, modern design
• ✅ Intuitive tab navigation
• ✅ Information tab with instructions
• ✅ Responsive layout

---

🎯 Access

URL: https://explorer.d-bis.org/

Navigation: Click "WETH" in the navigation bar

Requirements:

• MetaMask browser extension installed
• Chain 138 network configured (auto-added if needed)
• ETH balance in wallet for wrapping
• WETH balance in wallet for unwrapping

---

📝 Notes

Why Wrap ETH?

• DeFi Compatibility: Many DeFi protocols require ERC-20 tokens
• Cross-Chain Bridging: WETH can be bridged to other chains
• Smart Contract Usage: ETH can't be directly used in many smart contracts

WETH9 vs WETH10

• WETH9: Standard wrapped ETH (compatible with most protocols)
• WETH10: Alternative wrapped ETH implementation
• Both can be used for cross-chain bridging via CCIP

Transaction Costs

• Wrap/unwrap transactions require gas fees
• Fees are paid in native ETH
• Transaction costs are minimal for wrap/unwrap operations

---

✅ Summary

WETH Utilities: ✅ FULLY OPERATIONAL

Features:

• ✅ Complete wrap/unwrap functionality
• ✅ MetaMask integration
• ✅ Real-time balance tracking
• ✅ User-friendly interface
• ✅ Automatic network detection
• ✅ Transaction status feedback

Access: https://explorer.d-bis.org/ → Click "WETH"

---

Last Updated: December 23, 2025
Status: ✅ WETH utilities fully operational