ZeroEcho/README.md

ZeroEcho

No Signal Is Ever Truly Silent: A Modular Toolkit for Covert, Resilient, and Future-Proof Communication

ZeroEcho is a modular cryptographic toolkit designed to support secure, scriptable, and resilient data workflows — even in low-connectivity, offline, or constrained environments. Built with flexibility in mind, it enables developers, researchers, and advanced users to construct encryption pipelines using modern cryptographic algorithms and robust deployment models.

Whether you're working on secure file storage, encrypted communication, or privacy-focused data exchange, ZeroEcho offers a toolkit to build reliable, modern cryptographic workflows — with a focus on portability, future-proofing, and offline survivability.

Key Features

• Post-Quantum Cryptography (PQC)

  • Supports NIST-standardized algorithms like ML-KEM (Kyber)
  • Includes signature schemes such as SPHINCS+ for long-term integrity protection
  • Modular structure allows easy integration of additional post-quantum providers
  • Designed to protect against future quantum-based attacks

• Classic Cryptography

  • Full support for proven algorithms such as RSA, ECDSA, and Ed25519
  • Works seamlessly alongside PQC for hybrid deployments
  • Flexible signing and verification APIs for modern workflows

• Multi-Recipient Encryption and KEM

  • Encrypt a single payload for multiple recipients, each with their own key
  • No shared secrets or central authority required
  • Optional decoy data streams to enhance confidentiality and recipient privacy

• Offline and Indirect Deployment Workflows

  • Generate encrypted payloads entirely offline, suitable for air-gapped environments
  • Transfer via physical media (USB, SD card, etc.) with no online exposure
  • Optional script generation to automate upload or staging to public endpoints
    (cloud drives, pastebins, file hosts, etc.)
  • Enables asynchronous or indirect delivery models where sender and receiver never need to be online at the same time

• Steganographic Embedding (Incubator)

  • Optionally embed ciphertext into common media formats: images, audio, video
  • Enables discreet transport of encrypted data over everyday channels
  • Currently in transition: may evolve into a standalone pluggable project

• CLI Tools & Keystore Management

PKI administration CLI

The application distribution provides one synchronous PKI administration entry point. Direct commands and JSON plans use the same typed backend operation executor and one lifecycle-owned PkiSession:

zeroecho pki --help
zeroecho pki configuration.validate --config pki-config.json
zeroecho pki run administration-plan.json --config pki-config.json --output json

The administration surface covers every administratively meaningful capability implemented by the current backend: configuration validation; persisted profile validation/import/inspection/activation; CA creation, inspection, listing, and lifecycle transitions; strict CSR import and proof verification; credential issuance and inspection; revocation inspection and bounded history/snapshot presentation; signed status/CRL generation and inspection; and explicit publication registration, processing, retry, reconciliation, inspection, and listing. Presentation limits bound terminal output only; backend revocation and publication cursors remain streaming and do not acquire an aggregate population limit.

Plans are versioned JSON documents with ordered, uniquely named operations. References use exact whole values from earlier successful steps. Plans support only FAIL_FAST and CONTINUE_INDEPENDENT; they have no scripts, expressions, loops, implicit retries, or rollback across already committed operations. Binary artifacts and secrets are never emitted in terminal JSON.

Version-two session configuration enables capabilities explicitly. A signing section selects one signature-workflow provider, one X.509 framework, a durable signing-bus location, an algorithm, a finite signing deadline, and the name of an environment variable supplying the process-local keyring unlock capability. Publisher entries select configured destinations independently, so publication can be administered without enabling signing. Values of unlock variables, private keys, and publisher credentials are never operation arguments or output. Read-only version-one configurations remain valid and allocate neither signing nor publisher capabilities.

The CLI and a future server share the same transport-neutral PkiSession and typed operations; batch execution opens that service graph once. Backup and import/export commands remain unavailable because the current backend has no production service implementation for them. Final backend release readiness is intentionally deferred until the planned extensible X.509 algorithm/OID binding work and its CLI integration are complete; this CLI does not anticipate or add placeholders for that future work.

Development Status

ZeroEcho is stable and actively maintained.
Some subcomponents (such as steganography and script export) are provided with basic functionality while being moved out of the incubator stage. It is under evaluation whether they will remain integrated in the core library or become separate pluggable projects.

The core cryptographic engine, context model, and CLI tools are production-ready, with a strong focus on security, robustness, and maintainability.

Documentation

• API is documented via Javadoc and complemented by CLI usage examples.
• Some Javadoc sections are still being updated after recent structural changes.
  If you encounter discrepancies in examples or descriptions, we welcome feedback and contributions to ensure clarity and correctness.

Ideal Use Cases

• Building secure backup and archive workflows
• Sending encrypted messages across public platforms
• Creating educational or research-grade cryptographic tools
• Learning applied cryptography and encryption systems design
• Exploring secure data transport in offline or limited-access environments

No deep programming experience is required to get started. Most features are available through intuitive CLI utilities and well-documented examples.

---

🧭 Responsible Use Notice: ZeroEcho is intended for lawful and ethical use only. It is designed to support privacy, secure communication, academic research, and freedom of expression. The author does not condone or support the use of this software for any illegal or malicious activities, including but not limited to data theft, unauthorized surveillance evasion, or digital espionage.

Users are responsible for complying with all applicable laws and regulations in their jurisdiction. This is a tool for empowerment, not exploitation.