https://github.com/smolgroot/eth-dev-faucet-vscode
💧 VS Code extension bringing an Ethereum faucet for local development nodes (geth, hardhat, anvil)
https://github.com/smolgroot/eth-dev-faucet-vscode
ethereum evm-blockchain faucet faucet-crypto localdev vscode-extension web3-development
Last synced: about 1 month ago
JSON representation
💧 VS Code extension bringing an Ethereum faucet for local development nodes (geth, hardhat, anvil)
- Host: GitHub
- URL: https://github.com/smolgroot/eth-dev-faucet-vscode
- Owner: smolgroot
- License: mit
- Created: 2025-10-09T23:43:31.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2026-04-17T03:43:13.000Z (about 2 months ago)
- Last Synced: 2026-04-17T05:32:59.944Z (about 2 months ago)
- Topics: ethereum, evm-blockchain, faucet, faucet-crypto, localdev, vscode-extension, web3-development
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet
- Size: 151 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 💧 ETH Dev Faucet Extension for VS Code
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](LICENSE.md)
[](https://github.com/smolgroot/eth-dev-faucet-vscode)
---
This VS Code extension provides a convenient faucet interface for Ethereum development directly in your editor sidebar.
https://github.com/user-attachments/assets/2d6522d0-76d6-4955-8f9b-9268389dbf3a
## Quick Start
1. **Install** from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
2. **Open** the ETH Faucet panel in VS Code sidebar
3. **Configure** your RPC endpoint (defaults to `localhost:8545`)
4. **Send** test ETH to development addresses
## Features
* **Local Node Connection** - Connects to local Ethereum development nodes
* **Account Management** - Displays account balances and addresses
* **Test ETH Distribution** - Send test ETH to development accounts
* **Transaction History** - Track all faucet transactions
* **RPC Endpoint Management** - Easy switching between different local nodes
* **Auto-Detection** - Automatically detects blockchain configuration files
* **Workspace Integration** - Workspace-specific RPC settings
* **One-Click Refresh** - Update connection status instantly
Perfect for **Hardhat**, **Foundry**, **Geth**, and other development workflows.
## Installation
### From VS Code Marketplace
1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "ETH Dev Faucet"
4. Click Install
### From Command Line
```bash
code --install-extension smolgroot.eth-dev-faucet
```
### Manual Installation
Download the latest `.vsix` file from [Releases](https://github.com/smolgroot/eth-dev-faucet-vscode/releases) and install via:
```bash
code --install-extension eth-dev-faucet-x.x.x.vsix
```
## Usage
1. **Open the Panel** - Open the ETH Faucet panel in the VS Code sidebar
2. **Configure RPC** - Click the plug icon (🔌) in the Connection view to set your RPC endpoint (defaults to `localhost:8545`)
3. **View Accounts** - Browse local account balances in the Accounts view
4. **Send Test ETH** - Use the faucet interface to send ETH to addresses
5. **Monitor History** - Track transaction status in the History view
### 🔌 RPC Endpoint Management
- **Easy Configuration** - Click the plug button in the Connection view to change RPC endpoints
- **Default Setting** - Automatically connects to `localhost:8545`
- **URL Validation** - Built-in validation for RPC endpoint URLs
- **Auto-Refresh** - Connection status updates automatically when endpoint changes
### 💰 Faucet Operations
- **Amount Range** - Send between 0.1 and 10 ETH per transaction
- **Address Validation** - Automatic Ethereum address format validation
- **Quick Send** - Send to recently used addresses with one click
- **Frequent Addresses** - Save commonly used addresses for easy access
### 📊 Account & History Tracking
- **Balance Display** - Real-time account balance updates
- **Transaction History** - Complete record of all faucet transactions
- **Status Tracking** - Success/failure status for each transaction
- **Address Management** - Recently used addresses for quick access
## Configuration
The extension automatically detects blockchain projects and configures itself. You can manually adjust settings:
- **RPC URL**: Set your preferred Ethereum node endpoint
- **Frequent Addresses**: Manage commonly used development addresses
## Supported Development Tools
- **Hardhat** - Local development node
- **Foundry/Anvil** - Fast Ethereum testing framework
- **Geth** - Go Ethereum client in dev mode
- **Ganache** - Personal blockchain for development
- **Custom RPC** - Any Ethereum-compatible local node
## Development
Built for local Ethereum development - **not intended for mainnet use**.
## 📈 Extension Stats
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
[](https://marketplace.visualstudio.com/items?itemName=smolgroot.eth-dev-faucet)
## Contributing
Found a bug or have a feature request? [Open an issue](https://github.com/smolgroot/eth-dev-faucet-vscode/issues) or submit a PR!
## License
MIT License - see LICENSE.md for details.