Rootstock Wallet CLI

A secure, feature-rich Rust-based CLI wallet for the Rootstock blockchain

🚀 Features

Wallet Management

• Create new wallets with custom names
• Import existing wallets using private keys
• Switch between multiple wallets
• Backup and restore wallet data
• List all available wallets
• Rename or delete wallets

Asset Management

• Check RBTC balance for any address
• View token balances (supports all ERC-20 tokens)
• Add custom tokens to your wallet
• Remove unwanted tokens from your token list

Transactions

• Send RBTC to any address
• Transfer ERC-20 tokens
• View transaction history with filtering options
• Check transaction status
• Bulk transfer functionality

Contact Management

• Save frequently used addresses as contacts
• Add notes and tags to contacts
• Search through your contacts
• Update or remove existing contacts
• Import/export contact lists

Network & Configuration

• Switch between Mainnet and Testnet
• Configure custom RPC endpoints
• Manage API keys for services
• View network status and connection details

🛠️ Installation

Prerequisites

• Rust (latest stable version)
• Git
• Cargo (comes with Rust)

Building from Source

1. Clone the repository:

   git clone https://github.com/cosmasken/rootstock-wallet.git
   cd rootstock-wallet

2. Build the project:

   cargo build --release

3. Run the application:

   # For development
   cargo run
   
   # For production
   ./target/release/rootstock-wallet

⚙️ Configuration

The wallet automatically handles configuration through an interactive setup wizard when you first run it. You can also manage your configuration at any time using the interactive menu:

🎮 Usage

Interactive Mode

The wallet features an intuitive interactive interface. Simply run:

cargo run

Demo

First Time Setup

Importing Existing Wallet

Wallet Creation

List Wallets & Switch Wallets

Delete Wallet & Rename Wallet

Check Balance of RBTC and ERC-20 Tokens

Check your RBTC and ERC-20 token balances (e.g., RIF).

View example transaction on explorer

Send Funds

Transfer RBTC from one wallet to another (e.g., from personal to lock wallet).

Set API Key

Configure your API key for accessing transaction history and status checking.

Transaction History

Check Transaction Status

You can also view it at View Transaction

Bulk Transfer

Send multiple transactions at once.

View Transaction 1 , View Transaction 2

Token Management

Add, list, and delete tokens from your wallet.

Contact

Add, list, and delete contacts from your address book.

🔍 Troubleshooting

Common Issues

Transaction Failures

• Ensure you have enough RBTC for gas fees
• Verify recipient address format (0x...)
• Check network compatibility (mainnet/testnet)

Connection Issues

• Verify your internet connection

Wallet Issues

• Confirm wallet file exists at ~/.local/share/rootstock-wallet/
• Check file permissions if access is denied
• Ensure you're using the correct network (mainnet/testnet)

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

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

Please read our Contributing Guidelines for more details on our development process and code of conduct.

📄 License

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

🙏 Acknowledgments

• Built as part of the Rootstock Hacktivator program
• Special thanks to the Rootstock team for their support
• Inspired by the vibrant Rootstock community

📚 Resources

• Rootstock Documentation
• RSK Smart Contracts
• RSK Developer Portal
• GitHub Repository
• Issue Tracker

Made with ❤️ for the Rootstock ecosystem