Minimal CLI wallet for Spark.

yarn install

yarn run create

yarn run info

yarn run deposit

yarn run balance

yarn run send

yarn run withdraw

Launch the interactive menu-driven interface:

yarn start

View your transaction history:

yarn run history

Monitor incoming transfers in real-time:

yarn run monitor

Switch between MAINNET and REGTEST networks:

yarn run network

Thunder supports two networks:

• MAINNET (sp) - Production network
• REGTEST (sprt) - Local testing network

Network configuration is stored in .spark-config.json and can be changed using the network script or by setting the SPARK_NETWORK environment variable.

Thunder supports withdrawing Bitcoin from your Spark wallet to any Bitcoin address:

• Minimum Amount: 10,000 sats minimum withdrawal
• Exit Speed Options: Choose between SLOW, MEDIUM, or FAST confirmation speeds
• Network Validation: Ensures Bitcoin address matches current network (mainnet/regtest)
• Balance Checking: Verifies sufficient balance before withdrawal
• Fee Transparency: Clear warnings about withdrawal fees

• SLOW: Lower fees, 6-12 blocks confirmation time
• MEDIUM: Balanced fees, 3-6 blocks confirmation time
• FAST: Higher fees, 1-3 blocks confirmation time

yarn run withdraw

The withdrawal process will:

1. Check your current balance
2. Prompt for withdrawal amount (minimum 10,000 sats)
3. Request destination Bitcoin address
4. Validate address format and network compatibility
5. Allow selection of exit speed (fee tier)
6. Show confirmation summary with warnings
7. Process withdrawal and provide transaction ID

• Withdrawal fees are deducted from the withdrawal amount
• Withdrawals cannot be undone once confirmed
• Ensure the destination address is correct before confirming
• Network compatibility warnings should be heeded

Thunder includes comprehensive address validation:

Spark Address Validation:

• Validates bech32m address format
• Checks network compatibility (MAINNET vs REGTEST)
• Rejects unsupported network addresses (testnet, signet, liquid)
• Provides clear error messages for invalid addresses

Bitcoin Address Validation:

• Supports all standard Bitcoin address formats (P2PKH, P2SH, Bech32, Bech32m)
• Network-aware validation (mainnet vs regtest)
• Validates address format before withdrawal operations

• A wallet.json file is created. Delete it to reset.
• STORE THE SEED SAFELY AND NEVER SHARE IT.
• Network configuration is stored in .spark-config.json
• Transfer logs are stored in logs/thunder.log

• This is experimental software. Use at your own risk.
• Do not trust random code from the internet with real funds.
• Verify the code yourself before use. Keep your SATS safe.