LITCOIN Fleet Tools

A collection of command-line tools for managing and monitoring LITCOIN mining fleets. Config-driven — plug in your own API keys and go.

Setup

pip install -r requirements.txt

Copy the config template and fill in your details:

cp config.example.json config.json

Edit config.json with your Bankr API keys (get them at bankr.bot/api):

{
  "bots": [
    { "name": "MyBot", "api_key": "bk_YOUR_KEY_HERE", "enabled": true }
  ],
  "mining": { "mode": "comprehension", "min_free_balance": 5000000, "auto_claim": true },
  "staking": { "target_tier": 1, "auto_rebalance": false }
}

Tools

fleet_status.py

Quick status check — balances, tiers, mining eligibility for all bots.

python fleet_status.py

fleet_accounting.py

Full financial breakdown — free/staked/total, yields, APY, claimable rewards, fleet aggregates.

python fleet_accounting.py

funding_gap.py

Calculate how much each bot needs to reach the mining threshold (default: 5M free LIT).

python funding_gap.py
python funding_gap.py --target 10000000

stake_manager.py

Manage staking across all bots — check status, stake tiers, register as staker.

python stake_manager.py status
python stake_manager.py stake --tier 1
python stake_manager.py stake --tier 2 --bot MyBot
python stake_manager.py register

Important: After staking, you must register for mining eligibility. The stake command does this automatically, but you can run it manually if needed.

claim_rewards.py

Claim pending mining and staking rewards.

python claim_rewards.py
python claim_rewards.py --bot MyBot
python claim_rewards.py --dry-run

mining_diagnostics.py

Diagnose why a bot can't mine — tests balance thresholds, staking, challenge eligibility.

python mining_diagnostics.py
python mining_diagnostics.py --bot MyBot
python mining_diagnostics.py --verbose

fleet_dashboard.py

Live terminal dashboard with real-time balances, mining progress, staking yields, and cap countdown.

python fleet_dashboard.py
python fleet_dashboard.py --interval 10

Key Things to Know

• Mining requires 5M free LIT per wallet (staked tokens don't count toward this threshold)
• After staking, call register — mining won't work without it
• Daily cap resets at midnight UTC (~3,100–3,400 LIT/wallet/day)
• All tools accept --config path/to/config.json to use a custom config location

Staking Tiers

Tier	Name	Stake	Lock	Boost
1	Spark	1M	7 days	1.10x
2	Circuit	5M	30 days	1.25x
3	Core	50M	90 days	1.50x
4	Architect	500M	180 days	2.00x

License

MIT — see LICENSE