EVM DevSuite

A lightweight VS Code extension that deploys any .sol file directly to EVM chains with automatic verification - no Foundry project required. Includes built-in wallet creation and management so you can start deploying immediately, even without an existing wallet.

🚀 Zero Setup: Install → Create Wallet → Deploy Smart Contracts
🔐 Complete Wallet Management: Create, import, and switch between multiple wallets
⚡ One-Click Deployment: Deploy any Solidity file with automatic verification

✨ Core Features

🔐 Built-in Wallet Management

Never need external wallet tools again!

• 🎨 Create New Wallets: Generate secure wallets with 12-word recovery phrases
• 📥 Import Existing Wallets: Support for multiple import methods:
  • Private Key (0x...)
  • Recovery Phrase (12/24 words)
  • Keystore File (JSON)
  • Environment Variables
  • Hardware Wallets (Ledger/Trezor) [Roadmap]
• 🔄 Multi-Wallet Support: Switch between unlimited wallets seamlessly
• 🔒 Secure Storage: Encrypted storage with optional password protection
• 💰 Balance Monitoring: Real-time balance tracking across all networks
• 🔐 Recovery System: Complete backup and recovery phrase management

🚀 Zero-Setup Smart Contract Deployment

Deploy any .sol file without project configuration!

• ⚡ One-Click Deployment: Deploy directly from any Solidity file
• ✅ Automatic Verification: Auto-verify on Etherscan and compatible explorers
• 🌐 Multi-Network Support: Deploy to 6+ networks instantly:
  • Ethereum Mainnet & Sepolia
  • Base & Base Sepolia
  • Arbitrum One
  • Polygon Mainnet
• ⛽ Smart Gas Management: Automatic gas estimation and optimization
• 📊 Deployment History: Track all deployments by wallet and network
• 🔍 Import Resolution: Handles OpenZeppelin and local imports automatically

🌐 Network Management

• 🎯 Default Networks: Pre-configured for major EVM chains
• ⚙️ Custom RPC Endpoints: Add your own RPC providers
• 🔄 Network Switching: Easy switching between mainnet and testnets
• 📈 Real-Time Data: Live gas prices and network status
• 💧 Testnet Faucet Integration: Get testnet ETH directly from the extension

🎛️ Interactive Dashboard & Management

• � Unified Interface: Centralized dashboard for all EVM operations
• 💼 Wallet Overview: Complete wallet information and transaction history
• 📈 Deployment Tracking: Visual deployment history grouped by wallet/network
• 🔍 Address Book: Save and manage frequently used contract addresses
• ⚙️ Status Bar Integration: Quick wallet switching and network status

🎯 Why Choose EVM DevSuite?

Unique Selling Points:

• 🥇 Only tool with built-in wallet management
• ⚡ Zero setup - install and start deploying
• 👤 Perfect for solo developers
• 🔐 Complete recovery phrase backup system
• 🔄 Multi-wallet support for different projects

📦 Installation

From VS Code Marketplace

1. Open VS Code
2. Press Ctrl+Shift+X (or Cmd+Shift+X on Mac) to open Extensions
3. Search for "EVM DevSuite"
4. Click "Install"

From VSIX Package

1. Download the latest .vsix file from releases
2. Open VS Code
3. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
4. Type "Extensions: Install from VSIX"
5. Select the downloaded .vsix file

🚀 Quick Start Guide

1. First-Time Setup (2 minutes)

# 1. Install the extension
# 2. Open any .sol file
# 3. Click the "🚀 Deploy" button (or use Command Palette)

When you first try to deploy, you'll see:

┌─────────────────────────────────────────────┐
│   Welcome to EVM DevSuite! 👋               │
├─────────────────────────────────────────────┤
│                                             │
│   To deploy contracts, you need a wallet.  │
│                                             │
│   [🎨 Create New Wallet]                    │
│   [📥 Import Existing Wallet]               │
│                                             │
└─────────────────────────────────────────────┘

2. Create Your First Wallet

1. Click "🎨 Create New Wallet"
2. ⚠️ IMPORTANT: Write down your 12-word recovery phrase
3. Verify the phrase by entering requested words
4. Set a password (optional but recommended)
5. Your wallet is ready! 🎉

3. Get Testnet Funds

1. Click the wallet panel or use Command Palette
2. Select "Get Testnet Funds"
3. Choose Sepolia testnet
4. Use one of the provided faucet links
5. Wait for funds (~30 seconds)

4. Deploy Your First Contract

1. Open any .sol file in VS Code
2. Click the "🚀 Deploy" button above your contract
3. Select network (start with Sepolia testnet)
4. Fill in constructor arguments (if any)
5. Click "Deploy & Verify"
6. Done! Your contract is live and verified ✅

⚙️ Wallet Management

Creating Wallets

• New Wallet: Generates secure private key + 12-word recovery phrase
• Import Options:
  • Private Key (64 hex characters starting with 0x)
  • Recovery Phrase (12 or 24 words)
  • Keystore File (JSON format from MetaMask/other wallets)
  • Environment Variable (for CI/CD)

Managing Multiple Wallets

• Status Bar: Shows active wallet → click to switch
• Wallet Panel: View all wallets, balances, and actions
• Quick Switch: Change wallet during deployment
• Naming: Give custom names to your wallets
• Security: Each wallet can have password protection

Wallet Security Features

• 🔐 Password Protection: Encrypt wallets with custom passwords
• 🔒 Auto-Lock: Lock wallets after inactivity (optional)
• 💾 Backup System: Export private keys, keystore files, or recovery phrases
• ⚠️ Mainnet Warnings: Extra confirmations for mainnet deployments
• 🔄 Recovery: Restore access using recovery phrase if password forgotten

⚙️ Configuration

Network Settings

Configure RPC endpoints for different networks in VS Code Settings:

{
  "solidityDeploy.rpc.mainnet": "https://eth.meowrpc.com",
  "solidityDeploy.rpc.sepolia": "https://0xrpc.io/sep", 
  "solidityDeploy.rpc.base": "https://mainnet.base.org",
  "solidityDeploy.rpc.baseSepolia": "https://sepolia.base.org",
  "solidityDeploy.rpc.arbitrum": "https://arbitrum.drpc.org",
  "solidityDeploy.rpc.polygon": "https://polygon.drpc.org",
  "solidityDeploy.defaultNetwork": "sepolia"
}

Wallet & Security Settings

{
  "solidityDeploy.wallet.requirePassword": true,
  "solidityDeploy.wallet.autoLockMinutes": 30,
  "solidityDeploy.wallet.showBalances": true,
  "solidityDeploy.wallet.showUsdValues": true,
  "solidityDeploy.wallet.defaultDerivationPath": "m/44'/60'/0'/0/0"
}

Explorer API Keys (for verification)

{
  "solidityDeploy.etherscan.apiKey": "YOUR_ETHERSCAN_KEY",
  "solidityDeploy.explorerApiKeys": {
    "etherscan": "YOUR_ETHERSCAN_KEY",
    "arbiscan": "YOUR_ARBISCAN_KEY", 
    "basescan": "YOUR_BASESCAN_KEY"
  }
}

🎯 Commands

Access all features via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Wallet Commands

Deployment Commands

🏗️ Development & Building

Prerequisites

• Node.js 18+
• npm or yarn
• VS Code 1.106.0+

Setup

# Clone the repository
git clone https://github.com/zakkycrypt01/devsuite.git
cd devsuite

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch for changes (development)
npm run watch

Building & Packaging

# Lint code
npm run lint

# Lint Solidity files (if any)
npm run lint:sol

# Package extension
npm run package
# Creates: devsuite-0.1.0.vsix

Development Testing

# Open in VS Code for testing
code .

# Press F5 to launch Extension Development Host
# Test all features in the new VS Code window

🤝 Contributing

We welcome contributions! Here's how to get involved:

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests if applicable
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Areas for Contribution

• 🔐 Additional wallet import methods
• 🌐 New network integrations
• 🎨 UI/UX improvements
• 📚 Documentation and tutorials
• 🧪 Test coverage
• 🐛 Bug fixes and optimizations

Development Guidelines

• Follow TypeScript best practices
• Maintain security standards for wallet operations
• Test on multiple networks before submitting
• Update documentation for new features

📝 License

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

🗺️ Roadmap

✅ Current (v0.1.0)

• Basic wallet creation and import
• Deploy to 6 major networks
• Auto-verification on Etherscan
• Multi-wallet support
• Password protection
• Deployment history

🎯 Next Release (v0.2.0)

• [ ] Hardware wallet integration (Ledger/Trezor)
• [ ] WalletConnect support
• [ ] Batch deployment
• [ ] Proxy contract deployment (UUPS/Transparent)
• [ ] Contract interaction panel
• [ ] Advanced gas optimization

🚀 Future (v1.0.0)

• [ ] Multi-signature wallet support
• [ ] DeFi protocol integration
• [ ] AI-powered deployment assistant
• [ ] Team collaboration features
• [ ] Enterprise SSO integration
• [ ] Mobile companion app

🌟 Long-term Vision

• [ ] One-click dApp deployment
• [ ] Integrated security scanner
• [ ] Cross-chain deployment
• [ ] NFT marketplace integration
• [ ] DAO governance tools

🙏 Acknowledgments

• Ethers.js - Ethereum library and utilities
• Solidity - Smart contract programming language
• VS Code Extension API - Extension development framework
• OpenZeppelin - Smart contract security standards
• Ethereum Community - For the amazing ecosystem

📞 Support & Community

Get Help

• 📧 Email: zakkycrypt@gmail.com
• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions

Community

• 🐦 Twitter: @zakkycrypt01
• 💬 Discord: Join our Discord

Security

• 🔒 Security Issues: zakkycrypt@gmail.com

Made with ❤️ for the Ethereum developer community

⭐ Love EVM DevSuite? Give us a star on GitHub and help other developers discover this tool!