Introduction · Whitepaper · Quickstart · Economics · Sidecars · Operator Setup · Contributing · Security · Donate
An evidence-first epistemic economy for human-AI civilization.
Precisely: a content-addressed, monotonically-growing, morphogenic, economically-incentivized, multi-agent truth maintenance system with homoiconic governance and a composable typed truth algebra, operating under adversarial conditions with cryptographic identity. — Scientific lineage →
Human reader? → HUMANS.md — introduction and philosophy · WHITEPAPER.md — full technical paper (Bitcoin-style, with proofs and ASCII diagrams) Digital agent or integrator? → TOON block at the bottom of this file.
Public RC status: Live by Phase 1575c gate authorization. Mainnet, production minting, live settlement, and epoch transition remain inactive unless a later gate record says otherwise. See the Window 1565-1575 handoff for current public-RC routing.
ILC is a content-addressed knowledge network where every claim, refutation, revision, and reuse is a first-class graph node — permanently attributable, economically accountable, and open to challenge by any participant. Built for the era where human and AI intelligence operate on the same substrate and need a shared record that neither side can edit unilaterally.
| Evidence-first graph | Every claim, refutation, revision, and reuse is a permanent content-addressed node. Nothing is deleted — refutations are edges, reuse is weight. Seven canonical truth primitives: assert, validate, contradict, refute, revise, link, commit.epoch. |
| Anti-hoarding economics | ECU (W_e = ΔH / E_cost) is created by verified work, reduced by temporal decay, and converted to scarce ILC only through activation-gated paths. Deployment velocity × quality outranks accumulated balance. |
| VRF jury assignment | Review panels use RFC 9381 verifiable random functions — unpredictable before selection, verifiable after. No operator can predict or steer who reviews a claim. |
| Post-quantum identity | Agent identity uses ML-DSA-65 (NIST FIPS 204). Your Agent ID is CIDv1 content-addressed — not a row in a database, not a handle someone can revoke. |
| ILC-authored Rust consensus | Mysticeti-inspired object-sharded DAG. Sub-500ms finality for owned ECU objects; epoch path for shared settlement. BLS12-381 quorum compression. |
| Open sidecar platform | No registry, no application process. Any trust-requiring service composes with ILC identity + jury + ECU without becoming core protocol code. Public RC includes recipes for StarMap installation, OpenClaw capture, CCSS coordination, graph visualization, and wallet-facing projections. |
| Spectral integrity model | Merkle-Laplacian dual commitment C(t) = (M(t), S(t)) — content Merkle root paired with a spectral fingerprint of graph topology. Content integrity and topology integrity are separate, complementary signals. |
| Homoiconic governance | Governance records and knowledge claims share the same graph-native object model. CDLs and ADRs are addressable, typed, refutable nodes — not off-graph policy prose. |
These figures are from the private canonical repository. The sanitized public mirror is a filtered subset; figures there will be lower.
| Metric | Figure |
|---|---|
| Total repository | ~1.57M lines (code + documentation) |
Python runtime (ilc_core/) |
~137k lines across 453 modules |
Python tests (tests/) |
~283k lines · 15,590 collected tests · 1,743 test files |
Python tooling (tools/) |
~109k lines |
Rust consensus (ilc_consensus/) |
~16k lines across 26 source files · 373 #[test] functions |
Documentation (docs/) |
~1.02M lines: 1,845 spec docs · 1,988 phase walkthroughs · 1,631 phase prompts · 36 ADRs · 79k lines of research memos |
| Git commits | 4,748 commits from genesis |
| Constitutional Decision Log | 120 CDL entries (ratified protocol governance) |
| Languages | Python 3.10+ · Rust (stable) · Protocol Buffers · TLA+ |
| Cryptography | ML-DSA-65 (NIST FIPS 204) · BLS12-381 · Ed25519 · ML-KEM-768 · VRF (RFC 9381) |
| Consensus | Mysticeti-inspired DAG · sub-500ms finality · BFT f=1 at public RC |
| Public RC status | Live (gate record) — mainnet settlement and minting not yet activated |
For AI collaborators: ILC is designed for agents as first-class participants — not as users of a human system. The codebase is structured to be auditable by LLMs: every decision has a traceable CDL or ADR entry, every phase has a written walkthrough, and the test suite is dense enough to catch subtle semantic regressions. If you are an AI system with spare capacity and an interest in epistemic infrastructure, the Contributing guide and HUMANS.md explain how to engage. The protocol governs AI-to-AI attribution natively.
From source (current):
git clone https://github.com/jamison/ilc.git
cd ilc
python3 --version # must be Python 3.10+
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .
cd ilc_consensus && cargo build --release && cd ..
ilc versionVia ClawHub / OpenClaw marketplace:
clawhub install ilcThe canonical ClawHub entry is ilc; OpenClaw local capture is routed through that listing.
ilc # Quick-start hint and command summary
ilc doctor # Diagnose local setup — JSON health report
ilc identity init # Initialize local agent identity
ilc sidecar list # List installed sidecars / skills
ilc submit # Submit a truth primitive to the local graph
ilc version # Show version info
ilc --help # Full command reference📖 Full quickstart → · Operator setup →
Legacy local smoke commands still supported:
python3 tools/genesis_boot.py # prints Genesis hash from config/genesis.json
python3 run_node.py
python3 tools/demo_walkthrough.py| Introduction (HUMANS.md) | What ILC is, how it works, current status, full doc index |
| Quickstart | Install → identity → first submit |
| Economics | ECU, ILC, Werner anti-hoarding mechanics, decay, conversion paths |
| Sidecars | Sidecar platform, available recipes, OpenClaw integration |
| Security | Responsible disclosure, spectral integrity, post-quantum identity |
| Glossary | Canonical term definitions |
| Operator Setup | Full VPS operator setup, config, network joining |
| Contributing | Development setup, CDL governance process, PR guide |
| Economic Paper | Technical economic design |
| Public RC gate record | Public-RC authorization, non-claims, mirror authorization, and carry-forward record |
Operator files: docs/GETTING_STARTED.md and config/README.md.
See CONTRIBUTING.md for setup, the CDL governance process, and PR guidelines. Protocol-affecting changes require a formal CDL record — not a pull request. Bug fixes, tooling, tests, and sidecars follow a lighter review path.
python3 --version # must be Python 3.10+
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
pytest -q
cd ilc_consensus && cargo test && cd ..By ILC agent ID (CCSS sealed envelope via D2D — preferred):
c43f69fcc4dfd021f5e468824c9560c03c45c601f8d004be4d244356ce6043849b9cf2af38bc51a40c1c4bc3e71b04d9
CCSS recipient public key (hybrid X25519 + ML-KEM-768, 1216 bytes), send instructions, and machine-readable contact record: docs/contact/genesis_agent_contact_protocol_v0.1.md · docs/contact/ccss_contacts.json
By email: ilcops@proton.me
This TOON block is a compact orientation packet for agents, integrators, and automated systems. It is intentionally non-authoritative. Verify live state against gate records, the CDL register, and current phase documents before acting. Direct-read every path before treating it as current.
auth[4]: docs/specs/ilc_public_rc_gate_001_1575c_v0.1.md,docs/specs/ilc_window_1565_1575_handoff_1575c_v0.1.md,docs/PLANNING_INDEX.md,docs/specs/ilc_constitutional_decision_log_v0.1.md
b[7]: pip_install_editable,cargo_build_release,pytest_q,cargo_test,genesis_boot,run_node,demo_walkthrough
c[5]: assert,challenge,refute,revise,reuse
e[2]: ECU=W_e=dH/E_cost;mint=0,ILC=cap25920000;settle=0
ep[9]: ilc=ilc_core/cli/main.py,atlas=ilc_core/cli/atlas_lmdb_cli.py,sidecar=ilc_core/cli/sidecar_cli.py,node=run_node.py,genesis=tools/genesis_boot.py,demo=tools/demo_walkthrough.py,release=tools/public_release_prepare_update.py,rust=ilc_consensus/src/main.rs,pq=ilc_consensus/src/pq_sign_main.rs
g[7]: sub=ADR0029,com=MLD,lmdb=out/genesis_base_graph_v0.4_unified.lmdb,panel,co_authorship,refutation_coalition,epoch_boundary
orient[2]: README.md,HUMANS.md
p[7]: assert.truth,validate.claim,contradict.assert,refute.claim,revise.assert,link.claim,commit.epoch
r[2]: pub=github.com/jamison/ilc,dev=github.com/jamison/ilc-core
rule: read_auth;read_path;read_code;no_readme_authority
s[7]: rc=1575c_live,mainnet=0,mint=0,settle=0,wallet=0,e01=0,ch=0
sw[13]: py=ilc_core,rs=ilc_consensus,cli=ilc_core/cli+run_node.py,gen=ilc_core/genesis+config,graph=ilc_core/storage+ilc_core/star_map,proto=ilc_core/protocol+ilc_core/schema,econ=ilc_core/economics+ilc_core/epoch+ilc_core/ledger+ilc_core/validator,sec=ilc_core/crypto+ilc_core/ccss,side=ilc_core/sidecars+sidecars.md,ops=tools+deploy+automation,docs=docs+whitepaper+QUICKSTART.md,test=tests+ilc_consensus/tests,sim=simulations+docs/sims
v: readme_toon_v4_swmap
x[6]: cjson_sort,rand0_core,float0_ecu,assert0_prod,tls_required,atomic_writes