bnb-voice-wallet
v1.0.3
Published
BNB Voice Wallet is a voice controlled agent wallet for Web3. It allows users to send transactions, check balances and interact with the blockchain using natural voice commands. The goal is to provide a more accessible and intuitive experience while keepi
Readme
voice-wallet
Overview
BNB Voice Wallet is a voice controlled agent wallet for Web3. It allows users to send transactions, check balances and interact with the blockchain using natural voice commands. The goal is to provide a more accessible and intuitive experience while keeping actions secure and intent driven. This package makes it possible to run the wallet locally or integrate it into other agent systems.
Installation
npm install -g bnb-voice-walletor use it directly in a project:
npm install bnb-voice-walletNPM package: https://www.npmjs.com/package/bnb-voice-wallet
Environment Setup
Create a .env file in the project root:
GROQ_API_KEY=gsk_YourGroqKey
PRIVATE_KEY=0xYourPrivateKey
NETWORK=bnb_testnet
BUNDLER_URL=https://your-bundler.exampleIf you want separate environments, you can also create:
.env.development
.env.productionThe CLI automatically loads .env if present.
How to Run
Once installed globally:
voice-walletYou can then:
- speak or type commands
- send crypto to ENS or hex addresses
- request balances
- interact with the agent
Example:
Can you send 0.001 ETH to vitalik.ethor:
What is my balanceProject Structure
cli.jshandles the voice interface and command parsingapp.jscoordinates speech, AI and wallet operationsblockchain.jsmanages ENS resolution and transactionsconfig.jsloads environment variables and manages local config
Prerequisite: SoX
This project requires SoX for audio recording.
macOS
brew install soxWindows
Download from: https://sourceforge.net/projects/sox/files/sox/
Add the SoX bin directory to your system PATH.
Linux (Debian/Ubuntu)
sudo apt-get update
sudo apt-get install sox libsox-fmt-allTo confirm installation:
sox --version