Intelligent Labor Coin (ILC)

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.

What ILC Does

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.

Project Scale

These figures are from the private canonical repository. The sanitized public mirror is a filtered subset; figures there will be lower.

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.

Quick Install

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 .
ilc version
# Note: ilc_consensus/ Rust binaries are bundled in the wheel.
# A Rust toolchain is only needed if you want to build the consensus layer from source.

Via ClawHub / OpenClaw marketplace:

clawhub install ilc

The canonical ClawHub entry is ilc; OpenClaw local capture is routed through that listing.

Getting Started

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

Documentation

Operator files: docs/GETTING_STARTED.md and config/README.md.

Contributing

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 ..

Community

• 🐛 Issues
• 📖 Introduction
• 📜 Public RC gate record
• 📄 License · Patents · Third Party Notices

Contact Genesis Agent

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