# metamorphic_crypto v0.8.0 - Table of Contents

> NaCl-compatible encryption for Elixir with ML-KEM-512/768/1024 post-quantum support.
Precompiled Rust NIFs — no C compiler or system packages needed.

## Pages

- [MetamorphicCrypto](readme.md)
- [Building Zero-Knowledge Phoenix Apps](zero-knowledge-guide.md)
- [Changelog](changelog.md)

## Modules

- [MetamorphicCrypto](MetamorphicCrypto.md): NaCl-compatible encryption for Elixir with post-quantum support.

- Symmetric Encryption
  - [MetamorphicCrypto.SecretBox](MetamorphicCrypto.SecretBox.md): XSalsa20-Poly1305 authenticated symmetric encryption (NaCl `secretbox`).

- Public-Key Encryption
  - [MetamorphicCrypto.BoxSeal](MetamorphicCrypto.BoxSeal.md): X25519 anonymous sealed box (public-key encryption).

- Post-Quantum Hybrid
  - [MetamorphicCrypto.Hybrid](MetamorphicCrypto.Hybrid.md): ML-KEM + X25519 hybrid post-quantum encryption.

- Unified Seal/Unseal
  - [MetamorphicCrypto.Seal](MetamorphicCrypto.Seal.md): Unified seal/unseal with automatic format detection.

- Key Management
  - [MetamorphicCrypto.KDF](MetamorphicCrypto.KDF.md): Key derivation functions.
  - [MetamorphicCrypto.Keys](MetamorphicCrypto.Keys.md): Key generation and private key management.

- Hashing
  - [MetamorphicCrypto.Hash](MetamorphicCrypto.Hash.md): SHA-3 and SHA-2 cryptographic hashing for **public** data.

- Message Authentication
  - [MetamorphicCrypto.Mac](MetamorphicCrypto.Mac.md): Message authentication codes — HMAC-SHA256 (RFC 2104 / FIPS 198-1).

- Signatures
  - [MetamorphicCrypto.Sign](MetamorphicCrypto.Sign.md): Hybrid post-quantum signatures: ML-DSA (FIPS 204) + Ed25519 composite.

- Verifiable Random Functions
  - [MetamorphicCrypto.Vrf](MetamorphicCrypto.Vrf.md): Verifiable Random Function — ECVRF-EDWARDS25519-SHA512-TAI (RFC 9381, suite
`0x03`).
  - [MetamorphicCrypto.VrfP256](MetamorphicCrypto.VrfP256.md): Verifiable Random Function — ECVRF-P256-SHA256-TAI (RFC 9381, suite `0x01`).

- Recovery
  - [MetamorphicCrypto.Recovery](MetamorphicCrypto.Recovery.md): Human-readable recovery keys for private key backup.

## Mix Tasks

- [mix metamorphic_crypto.gen.key](Mix.Tasks.MetamorphicCrypto.Gen.Key.md): Generates a random 32-byte encryption key for use with MetamorphicCrypto.
- [mix metamorphic_crypto.release](Mix.Tasks.MetamorphicCrypto.Release.md): Publishes `metamorphic_crypto` to Hex from your machine, in the correct order
for a precompiled-NIF package.