How mhdn585/bc-rust works
Mercury is a local terminal application for generating a fixed supply of encrypted coin records, then mining coins incrementally to accrue fractional USD value. The user enters through the CLI; generation and mining are the principal workflows, with status reporting and integrity verification as supporting operations. SQLite stores coin, balance, and transaction state. Configuration, economics, cryptography, and key derivation provide shared internal rules and services. The map follows the main dispatch and documented module references; some subsystem internals were not sampled, so uncertain connections are omitted.
Main entry points: main.rs CLI dispatcher · mining.rs Incremental mining · verification.rs Integrity verification · ui.rs Status and prompts
Components 18
CLI and operations
- CLI dispatcher
src/main.rs - Terminal input
src/terminal.rs - Status and prompts
src/ui.rs - Process lock
src/lock.rs - Database maintenance
src/maintenance.rs
Coin workflows
- Coin generation
src/generation.rs - Incremental mining
src/mining.rs - Integrity verification
src/verification.rs
Domain services
- Coin and account models
src/domain.rs - Mining economics
src/economics.rs - Encryption and indexes
src/crypto.rs - Key derivation
src/key.rs - Runtime configuration
src/config.rs - Rotating logs
src/logging.rs
Persistence and integrity
- Coin and ledger queries
src/repositories.rs - SQLite connection
src/db.rs - Schema migrations
src/migrations.rs
Other components
- Operator
Connections 48
- Operator → CLI dispatcher: uses
src/main.rs - CLI dispatcher → Coin generation: dispatches
src/main.rs - CLI dispatcher → Incremental mining: dispatches
src/main.rs - CLI dispatcher → Integrity verification: dispatches
src/main.rs - CLI dispatcher → Database maintenance: dispatches
src/main.rs - CLI dispatcher → Process lock: acquires
src/main.rs - CLI dispatcher → SQLite connection: initializes
src/main.rs - CLI dispatcher → Status and prompts: renders
src/main.rs - CLI dispatcher → Rotating logs: initializes
src/main.rs - Status and prompts → Terminal input: reads input
src/ui.rs - Coin generation → Encryption and indexes: encrypts IDs
src/generation.rs - Coin generation → Key derivation: derives keys
src/generation.rs - Coin generation → Coin and ledger queries: persists coins
src/generation.rs - Coin generation → Coin and account models: builds records
src/generation.rs - Coin generation → Status and prompts: reports progress
src/generation.rs - Coin generation → Rotating logs: logs activity
src/generation.rs - Incremental mining → Coin and ledger queries: updates ledger
src/mining.rs - Incremental mining → Mining economics: calculates increments
src/mining.rs - Incremental mining → Encryption and indexes: uses cryptography
src/mining.rs - Incremental mining → Key derivation: derives keys
src/mining.rs - Incremental mining → Coin and account models: uses coin state
src/mining.rs - Incremental mining → Status and prompts: reports progress
src/mining.rs - Incremental mining → Terminal input: handles input
src/mining.rs - Incremental mining → Rotating logs: logs activity
src/mining.rs - Integrity verification → SQLite connection: checks integrity
src/verification.rs - Integrity verification → Schema migrations: checks schema
src/verification.rs - Integrity verification → Coin and ledger queries: checks statistics
src/verification.rs - Integrity verification → Encryption and indexes: checks payloads
src/verification.rs - Integrity verification → Key derivation: uses derived keys
src/verification.rs - Integrity verification → Coin and account models: builds report
src/verification.rs - Integrity verification → Status and prompts: reports results
src/verification.rs - Coin and ledger queries → Coin and account models: maps records
src/repositories.rs - Coin and ledger queries → Mining economics: validates amounts
src/repositories.rs - Coin and account models → Mining economics: validates state
src/domain.rs - Coin and account models → Encryption and indexes: validates payloads
src/domain.rs - Coin and account models → Runtime configuration: checks limits
src/domain.rs - Encryption and indexes → Key derivation: uses derived keys
src/crypto.rs - Encryption and indexes → Runtime configuration: uses constants
src/crypto.rs - Mining economics → Runtime configuration: uses constants
src/economics.rs - Status and prompts → Coin and account models: displays state
src/ui.rs - Status and prompts → Mining economics: formats values
src/ui.rs - SQLite connection → Schema migrations: runs migrations
src/db.rs - SQLite connection → Runtime configuration: selects database
src/db.rs - SQLite connection → Rotating logs: logs initialization
src/db.rs - Database maintenance → SQLite connection: maintains database
src/maintenance.rs - Database maintenance → Status and prompts: reports operations
src/maintenance.rs - Schema migrations → Runtime configuration: uses schema limits
src/migrations.rs - Process lock → Runtime configuration: uses lock path
src/lock.rs