Satoshi Sender

A TON blockchain mining bot that automatically mines Satoshi jettons by sending transactions to the Satoshi contract at random intervals.

Features

• 🤖 Automated TON blockchain mining
• ⏰ Random interval mining (configurable wait times)
• 🔐 Secure wallet integration with mnemonic phrase
• 📊 Real-time mining data monitoring
• 🐳 Docker support for easy deployment
• 📝 Comprehensive logging

Prerequisites

• Node.js 18+ (for local development)
• Docker (for containerized deployment)
• TON wallet with some TON for gas fees
• TonCenter API key

Environment Variables

Create a .env file in the root directory with the following variables:

# TON Center API Configuration
TONCENTER_API_KEY=your_toncenter_api_key_here

# Wallet Configuration (24-word mnemonic phrase)
MNEMONIC=word1 word2 word3 ... word24

# Mining Configuration
MIN_BLOCKS_TO_WAIT=6
MAX_BLOCKS_TO_WAIT=12

# Receiver Address (where mined tokens will be sent)
RECEIVER_ADDRESS=EQD...your_ton_address_here

Installation & Usage

Option 1: Using Docker (Recommended)

1. Clone the repository:

   git clone https://github.com/chiliec/satoshi-sender
   cd satoshi-sender

2. Create environment file:

   cp .env.example .env
   # Edit .env with your actual values

3. Build and run with Docker:

   # Build the Docker image
   docker build -t satoshi-sender .
   
   # Run the container
   docker run -d --name satoshi-sender

4. View logs:

   docker logs -f satoshi-sender

5. Stop the container:

   docker stop satoshi-sender
   docker rm satoshi-sender

Option 2: Local Development

1. Clone the repository:

   git clone <repository-url>
   cd satoshi-sender

2. Install dependencies:

   npm install

3. Create environment file:

   cp .env.example .env
   # Edit .env with your actual values

4. Run the application:

   npm start

Configuration

Environment Variables Explained

Variable	Description	Example
TONCENTER_API_KEY	Your TonCenter API key for TON blockchain access	a1b2c3d4-e5f6-7890-abcd-ef1234567890
MNEMONIC	24-word mnemonic phrase of your TON wallet	abandon abandon abandon ... art
MIN_BLOCKS_TO_WAIT	Minimum blocks to wait before mining (×10 minutes)	6 (60 minutes)
MAX_BLOCKS_TO_WAIT	Maximum blocks to wait before mining (×10 minutes)	12 (120 minutes)
RECEIVER_ADDRESS	TON address where mined tokens will be sent	EQD...

Mining Logic

• The bot waits for a random interval between MIN_BLOCKS_TO_WAIT * 10 and MAX_BLOCKS_TO_WAIT * 10 minutes
• It checks if enough time has passed since the last block was mined
• If conditions are met, it sends a mining transaction to the Satoshi contract
• Each mining transaction costs 0.06 TON in gas fees

Getting Started

1. Get a TonCenter API Key:

   • Visit TonCenter
   • Create an account and generate an API key

2. Set up your TON wallet:

   • Use a TON wallet (like TON Wallet, Tonkeeper, etc.)
   • Ensure you have some TON for gas fees (at least 1-2 TON)
   • Get your 24-word mnemonic phrase from your wallet

3. Configure the receiver address:

   • This is where your mined Satoshi tokens will be sent
   • Can be the same as your wallet address or a different address

4. Set mining intervals:

   • MIN_BLOCKS_TO_WAIT=6 means minimum 60 minutes between mining attempts
   • MAX_BLOCKS_TO_WAIT=12 means maximum 120 minutes between mining attempts
   • Adjust these values based on your preferences

Monitoring

The application provides detailed logging:

• Current mining status
• Time remaining until next mining attempt
• Transaction results
• Error messages

Security Notes

• ⚠️ Never share your mnemonic phrase or API keys
• 🔒 Keep your .env file secure and never commit it to version control
• 💰 Only use wallets with small amounts for automated mining
• 🔍 Regularly monitor your wallet for unexpected transactions

License

MIT License

Support & Contributing

For issues and questions, please create an issue in the repository.