https://github.com/sharafdin/ethereumCLI
ethereumCLI - Your Gateway to the Ethereum Blockchain Universe, Right from Your CLI! 🚀🌐
https://github.com/sharafdin/ethereumCLI
cli-wallet ethereum wallet
Last synced: 11 days ago
JSON representation
ethereumCLI - Your Gateway to the Ethereum Blockchain Universe, Right from Your CLI! 🚀🌐
- Host: GitHub
- URL: https://github.com/sharafdin/ethereumCLI
- Owner: sharafdin
- License: mit
- Created: 2023-07-20T16:23:17.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-09T13:26:05.000Z (5 months ago)
- Last Synced: 2025-04-14T07:18:09.170Z (13 days ago)
- Topics: cli-wallet, ethereum, wallet
- Language: Rust
- Homepage:
- Size: 12.7 KB
- Stars: 16
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ethereumCLI
ethereumCLI is a professional and secure command-line Ethereum wallet built for developers and enthusiasts. It allows users to interact with the Ethereum blockchain for sending ETH, checking balances, generating wallets, and exploring transactions – all with transparency and security in mind.
---
## 🚀 Features
- **Generate a Wallet**: Create a new Ethereum wallet with a private key and wallet address.
- **Send Ethereum**: Transfer ETH securely to any address on the Ethereum blockchain.
- **Check Balance**: Instantly check the ETH balance of your wallet.
- **Transaction History**: View the latest transactions for your wallet.
- **Retrieve Address**: Extract your wallet address from a private key if needed.
- **Developer-Friendly**: Built for developers who want a transparent and auditable CLI Ethereum wallet.
---
## 🔍 Why ethereumCLI?
The principle of cryptocurrency is **"Don't trust, verify"**. With ethereumCLI, you get complete transparency:
- The code is open-source, allowing you to inspect every function.
- **ethereumCLI does not store or share your private key** – you are in complete control.
💡 **Tip**: Always verify the code and the tool you’re using. Never blindly trust anyone in the crypto space, including me.
---
## ⚙️ Getting Started
### 1. Requirements
- Rust (for building the CLI wallet)
- Cargo (Rust package manager)
- Ethereum private key
- Infura API Key (or equivalent provider API)
---
## 📄 Configuration
To run **ethereumCLI**, you need to configure some environment variables. A sample `.env-example` file is provided to help you get started.
### Steps to Configure:
1. Locate the `.env-example` file in the project directory.
2. Copy it to create a new `.env` file:
```bash
cp .env-example .env
```
3. Open the `.env` file and replace the placeholder values with your actual credentials:
- `PRIVATE_KEY`: Your Ethereum private key (keep this secret and secure).
- `INFURA_API_KEY`: Your Infura project API key for interacting with the Ethereum blockchain.
### Example `.env` File:
```plaintext
# Your Ethereum private key (KEEP THIS SECRET AND NEVER SHARE IT)
PRIVATE_KEY=your_private_key_here
# Infura API key for accessing Ethereum blockchain data
INFURA_API_KEY=your_infura_api_key_here
```
> ⚠️ **Note**: Never share your `.env` file or its contents with anyone. Your private key is critical for accessing your Ethereum wallet and must remain secure.
---
## 🔧 Usage
### 1. Build the CLI
To compile the ethereumCLI wallet:
```bash
cargo build --release
```
### 2. Run the CLI
To start ethereumCLI:
```bash
cargo run
```
---
## 💻 Actions
When you run ethereumCLI, you’ll see the following menu options:
1. **💰 Generate a New Crypto Wallet**
Create a new wallet and securely store your private key and wallet address.
2. **📤 Send Ethereum (ETH) to Someone**
Enter the recipient’s address and amount to securely transfer ETH.
3. **💳 Check Your Wallet Balance**
Instantly fetch your current ETH balance.
4. **🔍 Explore Recent Blockchain Transactions**
View up to 10 recent transactions for your wallet.
5. **🔑 Retrieve Wallet Address Using Private Key**
Get your wallet address by providing a valid private key.
6. **🚪 Exit ethereumCLI**
Safely exit the program.
---
## 📚 Useful Resources
- [Ethereum Official Documentation](https://ethereum.org/en/developers/)
- [Infura](https://infura.io/) – Ethereum API provider
- [Etherscan](https://etherscan.io/) – Ethereum block explorer
---
## 💡 Tips for Security
- Never share your private key or `.env` file with anyone.
- Always verify the code before running it.
- Use a secure and encrypted location to store your `.env` file.
---
## 🛠️ Contributing
Feel free to fork this repository and contribute improvements. Submit pull requests, and they will be reviewed promptly.
---
## 📜 License
This project is licensed under the [MIT License](LICENSE).