• ✨ Features
• 🚀 Installation
• 🏗️ Architecture
• 🔧 Development
• 📱 Usage
• 🌍 Multi-language Support
• 🤝 Contributing
• 📄 License

Why Choose Universal Web3 Wallet? Built for the next generation of DeFi users who demand security, flexibility, and seamless multi-chain experiences.

• 🛡️ EIP-1193 Provider: Full compliance with Ethereum provider standard - works with ALL DApps
• 🔑 Mnemonic Support: BIP39 12-word mnemonic phrase generation and import with entropy validation
• 👥 Multi-Account: HD wallet with hierarchical deterministic account generation (unlimited accounts)
• 📥 Account Import: Import accounts via private keys with security warnings
• 🔒 Secure Storage: Military-grade AES encryption for keys and mnemonics - never leaves your device

• 🌍 15+ Networks: Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Fantom + more
• ⚙️ Custom Networks: Add any EVM-compatible network with custom RPC endpoints
• ⚡ Instant Switching: Seamless network switching with automatic balance updates
• 🦊 MetaMask Compatible: Drop-in replacement - works with existing DApp integrations
• 🔄 Auto-Detection: Automatically detects and suggests network additions from DApps

• ERC-20 Tokens: Add, remove, and manage custom tokens
• Balance Tracking: Real-time balance updates every 6 seconds
• Auto-refresh: Balance updates on account/network changes
• Token Filtering: Hide/show zero-balance tokens

• Transaction Signing: Secure transaction signing with user confirmation
• Message Signing: Support for personal_sign message signing
• Typed Data: Full eth_signTypedData_v4 support
• Confirmation UI: User-friendly transaction confirmation popups

• Modern UI: Built with Ant Design for sleek interface
• Multi-language: Support for English, Chinese, Korean, and Japanese
• Lock/Unlock: Secure wallet state management
• Address Book: Easy address management and copying

• Node.js 16+ and npm
• Chrome/Chromium browser
• Git

1. Clone the repository

   git clone https://github.com/yourusername/UniversalWeb3Wallet.git
   cd UniversalWeb3Wallet

2. Install dependencies

   npm install

3. Build the extension

   npm run build

4. Load in Chrome

   • Open Chrome and navigate to chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked extension"
   • Select the dist folder from the project

# Start development server with hot reload
npm run dev

src/
├── 📂 provider/
│ └── EthereumProvider.ts # EIP-1193 provider implementation
├── 📂 wallet/
│ ├── WalletManager.ts # Core wallet functionality
│ ├── NetworkManager.ts # Network management
│ └── TokenManager.ts # ERC-20 token management
├── 📂 pages/
│ ├── Popup.tsx # Main wallet interface
│ ├── TokenList.tsx # Token management UI
│ └── Settings.tsx # Settings and preferences
├── 📂 content/
│ └── inject.ts # DApp injection script
├── 📂 hooks/
│ └── useI18n.ts # Internationalization hook
├── background.ts # Service worker
├── content.ts # Content script
└── manifest.json # Extension configuration

• Frontend: React 18 + TypeScript + Ant Design
• Blockchain: ethers.js v6 + EIP-1193
• Crypto: bip39, crypto-js, @metamask/eth-sig-util
• Build: Vite + vite-plugin-web-extension
• Browser: WebExtension Polyfill

# Install dependencies
npm install
# Development with hot reload
npm run dev
# Production build
npm run build
# Type checking
npm run type-check

1. Infura Setup: Configure your Infura API key in WalletManager.ts
2. Networks: Add custom networks in NetworkManager.ts
3. Tokens: Configure popular tokens in TokenManager.ts

1. Create New Wallet

   • Click extension icon → "Create Wallet"
   • Set secure password
   • ⚠️ Important: Save your mnemonic phrase securely!

2. Import Existing Wallet

   • Choose "Import Wallet" tab
   • Enter your 12-word mnemonic phrase
   • Set password

// DApp integration example
if (window.ethereum) {
 console.log('Universal Wallet detected!')
 // Request account access
 const accounts = await window.ethereum.request({
 method: 'eth_requestAccounts'
 })
 // Send transaction
 const txHash = await window.ethereum.request({
 method: 'eth_sendTransaction',
 params: [{
 from: accounts[0],
 to: '0x...',
 value: '0x...'
 }]
 })
}

• Add Token: Click "+" button → Enter contract address
• Auto-detection: Popular tokens load automatically
• Balance Updates: Refreshes every 6 seconds
• Hide Zero: Toggle to hide tokens with zero balance

Available in 4 languages:

• 🇺🇸 English (Setup Guide)
• 🇨🇳 中文 (设置指南)
• 🇰🇷 한국어 (설정 가이드)
• 🇯🇵 日本語 (セットアップガイド)

• 🔐 Local Encryption: AES encryption for all sensitive data
• 🔒 Password Protection: Required for all wallet operations
• ✅ User Confirmation: Manual approval for all transactions
• 🏠 Isolated Storage: Chrome extension secure storage
• 🔑 No Key Logging: Private keys never leave your device

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

This is experimental software. Use at your own risk. Always:

• Test on testnets first
• Keep backups of your mnemonic phrases
• Never share private keys
• Conduct security audits before production use

• 📁 Documentation
• 🐛 Report Issues
• 💬 Discussions
• 🔒 Security Policy