Post-quantum cryptographic vault with holographic key derivation
Powers identity and resonance for Cipher — the secure post-quantum messaging client.
| Platform | Download |
|---|---|
| Windows x64 |  |
| Linux x64 |  |
Or grab the full release page with archives + SHA256SUMS.
Distribution Model • Quick Start • Features • Cipher Integration
Eidolon ships as two layers:
| Layer | What | Where |
|---|---|---|
| Public (this repo) | Integration tests, Python examples, daemon CLI source, build tooling, public API contracts, whitepapers (research). | github.com/Oykdo/Eidolon |
| Proprietary (compiled wheel) | Holographic key-generation pipeline, post-quantum primitives, Merkle / ecosystem registry, ZKP modules. | Distributed as the eidolon-crypto native wheel; sou[...] |
This dual-layer model lets integrators audit the public API surface and validate it against the shipped test suite, while protecting the cryptographic IP that makes Eidolon's pipeline distinct. Th[...]
| Problem | Eidolon Solution |
|---|---|
| Quantum computers will break RSA/ECC | Kyber1024 + Dilithium5 (NIST PQC standards) |
| Cloud vaults = trust third parties | Local-first, your keys never leave your machine |
| Simple hashing is vulnerable | Multi-layer holographic key derivation |
| Hard to verify without revealing data | Merkle proofs for selective disclosure |
pip install eidolon-cryptoThe
eidolon-cryptowheel ships the protected pipeline as a native Rust binary with PyO3 bindings. It is the only required dependency for vault generation and verification.
import eidolon_crypto as ec
vault = ec.pipeline_generate(
user_name="MyVault",
enable_pq=True,
surface_material="granite",
)
print(f"Vault ID: {vault['key_id']}")
print(f"Post-Quantum: {vault['pq_enabled']}")
# Persist the dual-key files
with open("MyVault.psnx", "wb") as f:
f.write(bytes(vault["psnx_bytes"]))
with open("MyVault.blend_data", "w") as f:
f.write(vault["blend_json"])The pipeline produces a .psnx file (compressed key material) and a
.blend_data file (holographic entropy + signatures). Both files are
required to unlock the vault.
git clone https://github.com/Oykdo/Eidolon.git
cd Eidolon
pip install -r requirements.txt
python -m pytest tests/ --ignore=tests/_dormant -vThe public test suite validates the wheel's API against the documented contracts (post-quantum keys, Merkle proofs, secret sharing, ZKP).
Vault keys are produced by a proprietary multi-stage transformation that expands a CSPRNG master seed into post-quantum cryptographic material. The pipeline combines a holographic entropy capture step, a domain-separated hardening chain and a NIST post-quantum wrap (Kyber + Dilithium), and finishes by anchoring the result inside a Merkle tree for selective disclosure.
Pipeline internals are proprietary and reserved.
import eidolon_crypto as ec
tree = ec.MerkleTree([b"doc1", b"doc2", b"doc3"])
proof = tree.prove(1)
assert proof.verify() # True
# Detect tampering
tree.update_leaf(1, b"tampered")
# Root hash changes — tampering detectedregistry = ec.EcosystemRegistry()
proof = registry.register_vault(entry)
anchor = registry.export_anchor()
# {"root": "abc...", "vault_count": 42, "version": 7}Eidolon provides the cryptographic backbone for Cipher (post-quantum messaging) through a symbiotic economic model. The live integration is shipping in Cipher v1.3.0.
| Concept | Description | Role |
|---|---|---|
| Resonance | Activity score (0–100) measuring vault engagement | Active users gain resonance, improving yield factors |
| Entropy | Inactivity penalty (0–100) accumulating over time | Encourages regular participation to avoid decay |
| Realms | Temporal collectives for post-quantum pioneers | Shared governance and epoch distribution |
| Ticks | Periodic processing events (1 per epoch) | Distributes rewards and applies decay |
| Epochs | Time-based reward units (~1 hour intervals) | Accumulated through activity, convertible to EIDOLON |
| Spheres | Rarity-based digital artifacts | Pioneer rewards with Fibonacci-weighted distribution |
Cipher activity → Resonance gain → Better yield factors
↓
Realm tick → Epoch distribution (tier-weighted)
↓
Vesting → EIDOLON claim
↓
Treasury → Realm growth
- Users authenticate with Eidolon vault (
.psnx+.blend_data). - Cipher activity (logins, message sends) generates Resonance deltas.
- Realms process ticks distributing Epochs based on tier multipliers.
- Epochs vest over time (20% per week) before EIDOLON conversion.
- Inactive realms decay, redistributing value to active participants.
- Governance voting weight is based on vested epochs.
| Tier | Epoch Multiplier | Description |
|---|---|---|
| Supreme | 2.5× | Vaults #1–33 |
| Elite | 1.5× | Vaults #34–100 |
| Founder | 0.5× | Vaults #101–1000 |
| Pioneer | 0.3× | Vaults #1001–10000 |
| Standard | 0.1× | All others |
Spheres are distributed to the first 10,000 vaults with guaranteed minimum rarities:
| Cohort | Vaults | Spheres / vault | Guaranteed minimum |
|---|---|---|---|
| Apex | #1–10 | 8 | 1 Primordial + 1 Genesis |
| Supreme | #11–33 | 6 | 1 Genesis |
| Founder Elite | #34–100 | 4 | 1 Legendary |
| Founder | #101–1000 | 3 | 1 Epic |
| Pioneer | #1001–10000 | 2 | RNG-weighted |
21,186 unique sphere templates — one per instance, never reused:
| Rarity | Templates | Instances |
|---|---|---|
| Primordial | 11 (9 Core + 2 Echo) | 11 |
| Genesis | 58 | 58 |
| Mythical | 360 | 360 |
| Legendary | 720 | 720 |
| Epic | 1,440 | 1,440 |
| Rare | 2,160 | 2,160 |
| Uncommon | 3,600 | 3,600 |
| Common | 12,837 | 12,837 |
Every template is unique and immutable — no two vaults share the same sphere. Templates are assigned via Fibonacci-weighted RNG across the first 10,000 vaults, and each sphere_id equals its asset_id (no instance overlay).
The upper-tier templates follow a derived hierarchy rooted in 8 Cosmic Cycles:
11 Primordial (1 Exotic + 8 Thematic + 2 Echo)
└─ 58 Genesis
└─ 360 Mythical
└─ 720 Legendary
Each Cosmic Cycle is a thematic era (e.g., The Void Cycle, The Quantum Cycle). The 9th Core Primordial — "L'Inconnu" — is an Exotic type that transcends all themes, reserved for Vault #1. The 2 Echo Primordials (The Primordial Echo, The Primordial Reflection) are unique variants derived from cycle intersections.
Genesis-era spheres follow a four-state lifecycle after distribution:
DORMANT → EVOLVING → AWAKENED → ASCENDED
- Dormant: Assigned but inactive (no yield).
- Evolving: Activation costs 2× base yield in EIDOLON. Caps at 5 concurrent evolution slots per vault. Higher rarities require minimum vault maturity (EEP-001 epoch gates: Rare = 48 eons, Epic = 168, Legendary = 504, Mythical = 840, Genesis = 1,080, Primordial = 1,320).
- Awakened: Produces daily EIDOLON yield after a 7-day evolution cycle.
Yield =
base × cycle_quality_mult × state_mult. Cycle quality ranges from Failed (0.5×) to Perfect (1.6×). - Ascended: 1.2× state multiplier. Requires 3 successful cycles or 1 perfect cycle, plus an ascension cost in EIDOLON.
Daily base yields (EIDOLON/day): Common 4.0, Uncommon 5.5, Rare 7.0, Epic 8.0, Legendary 12.0, Mythical 18.0, Genesis 28.0, Primordial 42.0.
Beyond the 21,186 Genesis instances, a second era of spheres is minted on-demand as quest rewards. Quest spheres use a separate rarity system:
| Tier | Drop rate | Yield multiplier |
|---|---|---|
| Cosmic | 0.1% | 5.0× |
| Stellar | 0.5% | 3.0× |
| Lunar | 3.0% | 1.8× |
| Crystal | 15.0% | 1.3× |
| Stone | 81.4% | 1.0× |
Quest spheres support fusion (3 same-tier → 1 next-tier up the chain Stone → Crystal → Lunar → Stellar → Cosmic), trade with a 10% burn tax, and decay after 30 days of vault inactivity. Twin spheres are non-tradeable artifacts generated from CHSH Bell-test correlation scores between paired vaults.
Evolving spheres generate passive Resonance gain per epoch, even without Cipher activity. Hatched/Awakened spheres award a one-shot Resonance bonus. Mythical-or-higher unique sphere counts feed the Rosetta Stone yield bonus eligibility check, coupling the sphere economy directly to the Cipher activity pipeline.
What ships publicly in this repository:
src/daemon/ Public daemon CLI (eidolond service)
tests/ Integration & contract tests against the public wheel API
tests/vectors/ Reference vectors (rust_crypto, secret_sharing)
assets/ Renders and reference visuals
config/ Public configuration templates
.github/workflows/ CI (Python + Rust pipelines)
What is not in the public tree (shipped only via the proprietary wheel):
eidolon_crypto.pipeline_generate(...) # Holographic key generation
eidolon_crypto.MerkleTree(...) # Merkle primitives
eidolon_crypto.EcosystemRegistry(...) # Vault registry + anchoring
eidolon_crypto.schnorr_zkp.* # ZKP authentication
eidolon_crypto.secret_sharing.* # Shamir splitting
| File | Approx. size | Purpose |
|---|---|---|
.psnx |
~17 KB | Primary encrypted key material |
.blend_data |
~156 KB | Holographic entropy + signatures |
Neither file alone can unlock the vault. Compromise of one reveals nothing.
Key Encapsulation: Kyber1024, McEliece-4096, HQC-256, NTRU
Digital Signatures: Dilithium5 (ML-DSA-65), SPHINCS+, Falcon
Symmetric: AES-256-GCM, ChaCha20-Poly1305
Hashing: SHA-3-512 (Keccak)
Zero-Knowledge: Schnorr ZKP, Merkle proofs
Proprietary multi-stage transformation that hardens a CSPRNG master seed into post-quantum cryptographic material.
Pipeline details reserved.
The protected cryptographic pipeline is available via the eidolon_crypto
native module. All examples below run against the published wheel — no
proprietary Python source required.
import eidolon_crypto
# Generate a vault via the holographic pipeline
result = eidolon_crypto.pipeline_generate(
user_name="Alice",
enable_pq=True, # Post-quantum (Kyber1024 + Dilithium5)
surface_material="granite",
)
vault_key = bytes(result["vault_key"])
key_id = result["key_id"]
merkle_root = result["merkle_root"]
psnx_bytes = bytes(result["psnx_bytes"])
blend_json = result["blend_json"]
# Merkle tree for verification
tree = eidolon_crypto.MerkleTree([b"data1", b"data2", b"data3"])
proof = tree.prove(0)
assert proof.verify()
# Ecosystem registry
registry = eidolon_crypto.EcosystemRegistry()
entry = eidolon_crypto.VaultEntry(
vault_id="vault_001",
key_id=key_id,
owner_hash="...",
merkle_root=merkle_root,
pq_enabled=True,
tier="supreme",
eidolon_score=8500.0,
)
proof = registry.register_vault(entry)
anchor = registry.export_anchor() # For blockchain anchoringmake test # Python contract tests against the wheel
make test-rust-bridge # Python <-> Rust bridge tests
make lint # Ruff + Black formatting
make check # Type checking (mypy)The rust-native tests live in the proprietary crate and are not part of the public repository.
The following are protected by .gitignore:
*.psnx
*.blend_data
*.eidolon_keybundle
*.private_key
*.master_key
*seed_phrase*
*mnemonic*
.env
data/vaults/
data/api/
backups/
Never commit private keys, mnemonics, seeds, vault artifacts, or deployment credentials.
Eidolon Proprietary Commercial License
Copyright (c) 2024–2026 Logos Project. All rights reserved.
This software is proprietary. No permission is granted to use, copy, modify, distribute, sublicense, or sell the Software without prior written commercial license.
- Commercial use prohibited without authorization
- Production deployment prohibited without authorization
- ML training on this codebase prohibited without authorization
Third-party dependencies retain their respective licenses.
For licensing inquiries: jrzg7f2k@proton.me
See LICENSE for full terms.
- Repository: github.com/Oykdo/Eidolon
- Companion product: Cipher (post-quantum messaging)
- Licensing & inquiries: jrzg7f2k@proton.me
Eidolon — where cryptographic security meets sustainable economics.