cosmicledger-verifiable-offline-first-da/AGENTS.md

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.