Documentation index
Documentation
ConceptsEXPERIMENTAL

MAGIC

Use authenticated, provider-aware entropy for mantras, integrity research, and quantum-category skills.

SYSTEM DIAGRAMEntropy waterfall
Quantinuum H2
Qiskit RNG
OS CSPRNG
Provenance
Mantras
Ledger salts

A secure fallback remains available when quantum providers are not

Mixed Authenticated Quantum Intelligence Core

MAGIC records where entropy came from and preserves a secure operating-system CSPRNG fallback when a quantum provider is unavailable. It is a research subsystem, not a claim of post-quantum cryptography.

Provider waterfall

  • Quantinuum H2 through pytket when authenticated and available
  • Qiskit-based sampling for quantum experiments
  • Operating-system CSPRNG as the dependable fallback

Entropy provenance

Samples carry provider and health information so callers can distinguish quantum-origin material from simulation or the operating-system fallback. Configuration can require a provider or accept the secure fallback according to the experiment.

Mantra system

The mantra tree organizes 18 categories used to select and combine prompt context. Entries can be created, updated, simulated, and reviewed through the API without treating generated text as cryptographic proof.

Integrity research

MAGIC can contribute entropy to memory and Elixir checksums, ledger salts, and integrity verification. The shipped boundary remains BLAKE3, Ed25519, and AES-256-GCM; post-quantum migration is documented as future work.

Configuration

  • CARNELIAN_MAGIC_ENABLED is the subsystem master switch
  • CARNELIAN_QUANTUM_ORIGIN_API_KEY supplies Quantum Origin credentials
  • Provider health and provenance remain visible when the OS CSPRNG fallback is selected

MAGIC API

GET/v1/magic/entropy/health

Inspect entropy-provider health

POST/v1/magic/entropy/sample

Request a provenance-bearing sample

GET/v1/magic/mantras

List mantra categories and entries

POST/v1/magic/mantras/simulate

Simulate mantra selection

POST/v1/magic/integrity/verify

Verify MAGIC-backed integrity records

Inspect MAGIC

COMMAND
carnelian magic auth
carnelian magic status
carnelian magic sample
carnelian magic providers