TRONSend - TRON Wallet CLI Tool

A Node.js CLI tool for managing TRON wallets and automated TRX transfers with blockchain-based transaction checking.

Installation

# Install globally
npm install -g tronsend

# Or use with npx (recommended)
npx tronsend setup

Quick Start

1. Generate a new wallet:

   npx tronsend setup

2. Configure your .env file:

   TPK=your_private_key_here
   TIA=your_wallet_address_here
   TOA=recipient_address_here
   TSA=1.5
   PIS=3600

3. Send TRX:

   npx tronsend send

Environment Variables

| Variable | Description | Example | | -------- | ----------------------------------- | ------------------------------------------------------------------ | | TPK | TRON Private Key (auto-generated) | F8CAA6EDB1F401695D5DD4F42B2E46D6CE7863E3D0BF410148B0C904A6B62161 | | TIA | TRON Input Address (auto-generated) | TMwD7QEPbh4vdXkukhUQhjSxSx8QTow5pG | | TOA | TRON Output Address (recipient) | TECFRdhJibvFxvJncm8oHYcRFH7EWF4DtP | | TSA | TRON Send Amount (TRX) | 1.5 | | PIS | Period In Seconds (interval) | 3600 |

CLI Commands

# Generate new wallet
npx tronsend setup [--env <path>]

# Send TRX if period elapsed
npx tronsend send [--env <path>]

# Show help
npx tronsend

Options

• --env <path> - Path to .env file (default: .env)

Examples

# Use default .env file
npx tronsend setup
npx tronsend send

# Use custom .env file
npx tronsend setup --env ./config/production.env
npx tronsend send --env ./config/production.env

Features

• 🔐 Secure Wallet Generation - Generate new TRON wallets with private keys
• ⏰ Smart Timing - Only send if enough time has passed since last transaction
• 🔗 Blockchain Verification - Check actual blockchain state, not local files
• 📁 Multiple Configs - Support for multiple .env files
• 🛡️ Safe Setup - Interactive confirmation before overwriting existing wallets
• 🌐 TronGrid Integration - Uses official TronGrid API for transaction history

How It Works

1. Setup: Generates a new TRON wallet and saves credentials to .env
2. Send Check: Queries TronGrid API for the last outgoing transaction
3. Time Validation: Compares current time with last transaction timestamp
4. Transfer: Sends TRX only if the configured period has elapsed

Security Notes

• ⚠️ Never share your private key - Keep your .env file secure
• 🔒 Use separate wallets - Consider using dedicated wallets for automation
• 📝 Backup your .env - Store your configuration securely

Development

# Clone and install
git clone https://github.com/yourusername/tronsend.git
cd tronsend
npm install

# Run locally
npm run setup
npm run send

License

MIT License - see LICENSE file for details.