VAULT compiles the private aggregate. Auth-gated. Ledger-backed.
`` ~/.canonic/bin/vault — CLI (Python) — all economic operations ~/.canonic/bin/vault_crypto.py — Ed25519 key management ~/.canonic/bin/api — HTTP surface wrapping vault commands
~/.canonic/VAULT/ ├── USERS/ │ └── {USER}/ │ ├── WALLET.json — derived balance + totals │ ├── TIMELINE.jsonl — append-only event stream (hash-chained) │ ├── identity.json — principal metadata (git_emails, kyc, pubkey) │ ├── KEY.pub — Ed25519 public key (hex) │ └── KEY.priv — Ed25519 private key (encrypted, gitignored) └── VIEWS/ └── shop.json — public shop aggregate ``
| Command | Purpose |
|---|---|
| vault mint –user USER –amount N | MINT:WORK — credit from governed work |
| vault drift –user USER –amount N | DEBIT:DRIFT — debit from governance regression |
| vault transfer –from U1 –to U2 –amount N | Transfer COIN (5% TREASURY fee) |
| vault spend –user U –seller S –amount N –product P | Spend COIN on SHOP product |
| vault settle –user U –amount N | Exit COIN to fiat via Stripe |
| vault close –reconcile | Monthly epoch close — snapshot, reconcile, rotate |
| Command | Purpose |
|---|---|
| vault user-wallet –user USER –json | Read WALLET state |
| vault user-timeline –user USER –limit N –json | Transaction history |
| vault verify-wallet [–user USER] | Chain integrity + balance verification |
| vault reconcile [–backfill] | LEDGER-to-WALLET reconciliation |
| Command | Purpose |
|---|---|
| vault resolve-git-user –email E –name N | Map git identity to USER principal |
| vault resolve-user –linkedin S | Map LinkedIn to USER principal |
| vault signup –user USER –referred-by R | Create principal (500 COIN bonus) |
| vault pyramid –user USER –referred-by R | Referral bonus (500 COIN to referrer) |
| Command | Purpose |
|---|---|
| vault publish –site SITE | Emit ORG-level economic data to fleet |
| vault publish-user –user USER –site SITE | Emit per-user wallet to dashboard |
| vault stripe-sync | Sync Stripe webhooks to LEDGER |
| vault checkout –product P –amount N | Create Stripe Checkout session |
| Command | Purpose |
|---|---|
| `vault keygen --user USER` | Generate Ed25519 key-pair |
| `vault auth --user USER` | Mint signed auth token (1h expiry) |
| `vault verify-sig [--user USER]` | Verify event signatures |
build step 11: vault stripe-sync
build step 11a: vault publish --site {FLEET}
build step 11b: vault publish-user --user {USER} --site {FLEET}
build step 11c: vault verify-wallet ← HARD GATE (broken chain = build failure)
Discovered via ~/.canonic/VAULT/USERS/ — never hardcoded.
| *VAULT | SPEC | SERVICES* |
| Principal | Role | KYC |
|---|---|---|
| DEXTER | Founder | GITHUB |
| AVINASH | GITHUB | |
| YANA | GITHUB | |
| ILYA | GITHUB | |
| ISABELLA | GITHUB | |
| JP | GITHUB | |
| ROBERT | Distributed | |
| FATIMA | Distributed | |
| TREASURY | Org wallet | SYSTEM |