25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
CosmicLedger SWARM Architecture
|
|
- Focus: MVP of offline-first verifiable ledger for partition-tolerant data sharing.
|
|
- Core modules:
|
|
- cosmic_ledger.contracts: Data contract registry with versioning for mission data types.
|
|
- cosmic_ledger.ledger: Local append-only ledger storing entries and signatures.
|
|
- cosmic_ledger.delta: Delta logs with Merkle root support and delta export/import.
|
|
- cosmic_ledger.crypto: Simple signer/verification using HMAC for MVP correctness.
|
|
|
|
- Data model (MVP):
|
|
- Telemetry, SensorData, Event, Command, Hazard entries with minimal fields.
|
|
- Each entry is cryptographically linked via a signature (node-local signer).
|
|
- Merkle DAG roots enable compact proofs of inclusion for entries in the log.
|
|
|
|
- Networking (out-of-scope MVP):
|
|
- Delta exchange is simulated via in-process delta export/import.
|
|
- Adapters/connectors to two domains can be added in future iterations.
|
|
|
|
- Tests & Validation:
|
|
- test.sh drives a minimal cross-node delta replication scenario to validate consistency.
|
|
- AGENTS.md documents intended architectural rules and testing protocol for contributors.
|
|
|
|
- Contribution rules:
|
|
- Small, well-scoped changes preferred; add tests for new features.
|
|
- Update README/docs to reflect changes and how to use the MVP.
|