Version: v1.2.3 | Status: Active | Last Updated: March 2026
The Wallet module provides self-custody key management and "Natural Ritual" recovery using zero-knowledge proofs. It enables secure storage of cryptographic keys, API credentials, and agent secrets with recovery mechanisms that don't rely on centralized services. Part of the Secure Cognitive Agent suite.
from codomyrmex.wallet import Wallet
wallet = Wallet()
# Store and retrieve cryptographic keys
# Self-custody: keys never leave the local system
# Hierarchical key derivation for agent-specific keys- Recovery without centralized servers using zero-knowledge proofs
- Multi-party threshold recovery for disaster scenarios
- Biometric and cognitive factor integration
| Export | Type | Purpose |
|---|---|---|
Wallet |
Class | Self-custody key management engine |
| ZKP recovery | Various | Zero-knowledge proof based key recovery |
| Phase | Wallet Contribution |
|---|---|
| EXECUTE | Retrieve keys and credentials for secure API access |
| VERIFY | Validate key integrity and custody chain |
Specialized Layer — Part of the Secure Cognitive Agent suite (identity, wallet, defense, market, privacy). Consumed by auth/ and crypto/ for key management.
- Self: PAI.md
- Parent: ../PAI.md — Source-level PAI module map
- Root Bridge: ../../../PAI.md — Authoritative PAI system bridge doc
- Siblings: README.md | AGENTS.md | SPEC.md | API_SPECIFICATION.md