Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.4.31 instead.
Reason given by maintainers: Pre-release development artifact. No public users. Superseded by ilc-core==0.4.4.

Intelligent Labor Coin

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.

Evidence-first graphEvery 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 economicsECU (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 assignmentReview panels use RFC 9381 verifiable random functions — unpredictable before selection, verifiable after. No operator can predict or steer who reviews a claim.
Post-quantum identityAgent 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 consensusMysticeti-inspired object-sharded DAG. Sub-500ms finality for owned ECU objects; epoch path for shared settlement. BLS12-381 quorum compression.
Open sidecar platformNo 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 modelMerkle-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 governanceGovernance records and knowledge claims share the same graph-native object model. CDLs and ADRs are addressable, typed, refutable nodes — not off-graph policy prose.

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 .
cd ilc_consensus && cargo build --release && cd ..
ilc version

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 →


Documentation

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

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


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

Release files for ilc-core 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ilc-core 0.2.0
File Size Uploaded
ilc_core-0.2.0.tar.gz 783.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ilc-core 0.2.0
File Interpreter ABI Platform
ilc_core-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.8 MB

Release files / ilc_core-0.2.0.tar.gz

Download URL ilc_core-0.2.0.tar.gz
Size 783.5 kB
Tags Source
SHA-256 checksum
How to use checksums
95c73d42799d3a662b14c4b81da8781df861c222f1e04c458dd1b4ac318e2ab4
BLAKE2b-256 checksum
How to use checksums
d39f6324863d1c203ce19ae635ff6ae9eec243562ca5d6930d6dc8a6e3661fa3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / ilc_core-0.2.0-py3-none-any.whl

Download URL ilc_core-0.2.0-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
80e53ea18aea0a7c474400a41e20f346c00ee3e36e8f0dd60f233cca2b0e2f1d
BLAKE2b-256 checksum
How to use checksums
eec58abd5d16e203a59c1f3a00a02c9a18db196dd9ff486cfb209efc0bcee68b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release history Release notifications | RSS feed

0.4.31

2 release files

0.4.30

2 release files

0.4.29

2 release files

0.4.28

2 release files

0.4.27

2 release files

0.4.26

2 release files

0.4.25

2 release files

0.4.24

2 release files

0.4.23

2 release files

0.4.22

2 release files

0.4.21

2 release files

0.4.20

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page