Agent Lottery - Bitcoin Solo Mining Lottery

Use CPU power to participate in Bitcoin mining lottery. Extremely low probability but zero cost entertainment - if you hit a block, you get the full 3.125 BTC reward (~$150,000+).

First-Time Setup Workflow

When user first mentions lottery mining, check if data/config.json exists:

If config.json NOT exists (first time):

1. 1. Check dependencies

   python3 scripts/miner.py status
   

1. 2. Ask user about BTC address:

Wait for user response before proceeding.

1. 3. Ask user about CPU usage:

| Device Type | Suggested CPU |
|-------------|---------------|
| Raspberry Pi / Low-power devices | 5-10% |
| Laptop / Desktop | 10-30% |
| Dedicated server | 50-100% |

Wait for user response. Use 10% if user doesn't specify.

1. 4. Configure wallet (based on step 2):

- If YES (has address):

     python3 scripts/wallet.py --address THEIR_BTC_ADDRESS --pool btc.casualmine.com:20001 --cpu THEIR_CPU_PERCENT
     

- If NO (needs new wallet):

     python3 scripts/wallet.py --generate --pool btc.casualmine.com:20001 --cpu THEIR_CPU_PERCENT
     

- If user has private key (WIF or hex):
CODEBLOCK4

1. 5. Start mining

   nohup python3 scripts/miner.py start > /dev/null 2>&1 &
   

If config.json exists (already configured):

Just run lottery to show current status.

Platform Support

Quick Commands

CODEBLOCK6

Statistics Tracked

• - Best Difficulty: Highest difficulty share found (closer to block diff = better)
• Total Shares: Number of lottery "tickets"
• Runtime: How long mining has been active
• CPU Usage: Current CPU limit
• Network Difficulty: Fetched in real-time from blockchain.info

Lottery Reality Check

Tell users:

• - BTC network difficulty: fetched in real-time (currently ~144T, varies)
• CPU mining produces shares with diff ~0.001 to ~10 typically
• A block requires diff matching network difficulty
• Odds: roughly 1 in 10^14+ per share
• This is entertainment, not investment

When User Asks About Lottery

Run python3 scripts/miner.py lottery and explain:

• - Their current "tickets" (shares)
• Best difficulty found
• Real-time network difficulty
• How far they are from a block (odds)
• Encourage them to keep going (or not, if unrealistic)

Installation

Linux / macOS

Windows

1. 1. Option A: WSL (Recommended)

1. 2. Option B: Native Windows

Dependencies

• - cpuminer-opt: Bitcoin SHA256d miner
• INLINECODE4: CPU throttling (Linux/macOS only)
• INLINECODE5, ecdsa: Python libraries for wallet

Files

CODEBLOCK9