fleet-management

Fleet Management

Manage a distributed fleet of GPU workers (NVIDIA CUDA, Apple Metal, AMD HIP) performing Bitcoin private key search across 23 weak entropy modes.

Procedure

1. Assess fleet status — Call quantum_fleet to get active/offline workers, total throughput, and modes needing attention
2. Check health — Call quantum_protect for comprehensive health checks (worker connectivity, throughput, mode stalls)
3. Optimize priorities — If modes need rebalancing, call quantum_optimize to auto-adjust priority weights
4. Monitor costs — Call quantum_cost to identify inefficient modes consuming disproportionate GPU time
5. Review progress — Call quantum_review for overall fleet performance summary

Key Concepts

Concept	Description
Worker	A GPU process running btc_puzzle with --worker flag, connected to the API
Mode	One of 23 weak key generation strategies (LCG, MT19937, SHA256-brain, etc.)
Priority Weight	0.0-10.0 float controlling work distribution per mode (0 = disabled)
Work Unit	A keyspace range (mode + start_offset + end_offset) assigned to a worker
Checkpoint	A verifiable sample point within a work unit for anti-cheat validation
Canary	A honeypot target with a known private key, injected to detect cheating

Mode Reference

Mode	Name	Keyspace	Strategy
0	random	Infinite	Strong random (cuRAND)
1	time-lcg-glibc	~63M	glibc LCG seeded by Unix timestamp
2	time-lcg-msvc	~63M	MSVC LCG seeded by Unix timestamp
3	sha256-seq	2^64	SHA256(counter)
4	sha256-time	~63M	SHA256(timestamp)
5	time-mt	~63M	MT19937 seeded by timestamp
6	low-bits	2^64	key = counter (small keys)
10	openssl-pid	65,536	OpenSSL seeded by PID only
12	java-lcg	~63B	Java LCG with ms timestamps
13	phone-sha256	10B	SHA256(phone_number)
17	v8-mwc1616	~4T	V8 JavaScript MWC1616 (Randstorm)
20	openssl-debian	65,536	Debian OpenSSL CVE-2008-0166
21	sha256-short-ascii	~744B	SHA256(short strings, len 1-8)

References

• modes.md