Developer documentation

Changelog

Last reviewed 31 August 2026

QuickstartCLI referencePython SDKTypeScript SDKMCPIntegrationsPoliciesActionProofEvidenceCAIN TraceConformanceTroubleshootingDeveloper portalMarketplaceFree tierBenchmarksArchitectureCAIN IdentityCAIN ControlCAIN BudgetCAIN GovernanceCAIN MemorySelf-Hosted MCPGateCAIN PrivateCAIN TrajectoryCAIN Agent SecurityCAIN Drift7-Moat ArchitectureChangelog

CAIN Trust Fabric Changelog

All notable changes, architectural milestones, cryptographic primitives, and enterprise releases for the CAIN Trust Fabric are documented here.

⚡ View Live Interactive Telemetry & Changelog Feed


[42.10.3] — 2026-09-21 (Verification Lab: in-browser verification and a live sandbox)

Status: PRE-PRODUCTION. Same-author evidence, one host, no third-party review.

New page /lab.html on cainstudio.online, mcpgate.online and clawx.click (cain42-lab). It (1) fetches the 4-node PBFT fault-test bundle, checks its SHA-256 against AI_VERIFY.json, and verifies every Ed25519 state proof and quorum-certificate signature in the visitor's browser with WebCrypto (a port of verify_cluster_evidence.py; tested to give 33/33 on the published bundle, the same as the Python verifier, and to reject a one-bit signature change); (2) fetches a live node's freshly sealed signed state proof and verifies it in the browser; (3) drives the keyless /fabric/try decision sandbox (fixed scenarios, throwaway tenant, 20 per hour per address).

Known defect shown on the page, not hidden: the policy (OPA) and risk (fuzzer) stages report unavailable in this deployment because their backing services are not running here, so scenarios that advertise a denial by those stages (for example prompt-injection) return REQUIRE_APPROVAL instead. The lab prints the advertised expectation next to the observed verdict. Not fixed yet.

Not proven by anything here: independent failure domains, partition behaviour, security, third-party review. The public /api/v1/cluster/status field byzantine_f1_readiness reads "PROVEN" but is a membership-count topology check only (its own basis field says so); it is not a fault-tolerance result.


[42.10.3] — 2026-09-21 (Code secrecy enforced on all three sites; public lab built, awaiting gateway restart)

Status: PRE-PRODUCTION.

Live now: implementation source withdrawn from public serving

Earlier on 2026-09-21 several evidence bundles published implementation source as downloadable files. That contradicted the owner's requirement that the code stay secret. All of it was removed from every served directory and returns 404 on cainstudio.online, mcpgate.online and clawx.click. Bundles now publish only SHA-256 *commitments* to the code that produced them, recorded results, and small standalone verifiers that import nothing from CAIN. A guard (scripts/check_public_ip_exposure.py and a test) fails if implementation source reappears in a served directory, and the builders that a daily job runs were changed so they cannot republish it. Consequences you should know: the bundles can no longer be *re-run* from public material (they can still be verified: signatures, hashes, recorded results); and copies fetched while the files were public cannot be recalled. A scan of the served directories found no private keys, environment files, databases or live credentials.

Built and tested, NOT live until the gateway is restarted: the public lab

/lab on all three sites lets anyone exercise a dedicated 4-node PBFT sandbox twin (own keys and state, separate from the test cluster) and verify every signature in their own browser (WebCrypto Ed25519). They can submit authorization requests, crash up to two nodes, and watch a quorum certificate verify or fail; they can also verify the live test cluster's four signed state proofs, and tamper with the recorded fault test to see verification fail. The lab API accepts only validated fixed-shape input, runs docker stop|start with fixed arguments on the four sandbox containers only, caps simultaneous crashes at two, auto-restarts nodes left down, is rate-limited per client and globally, has a kill switch, and returns only whitelisted fields. 19 API tests and 3 browser-logic tests (the page's own JavaScript is run under node against the real signed data and against tampering, and its canonical JSON is compared byte for byte with the Python implementation; that comparison found and fixed a mismatch on the DEL character). Until the running gateway is restarted, /lab, /api/v1/lab/* and the homepage verify strip do not exist on cainstudio.online and mcpgate.online. clawx.click already serves the static lab page (/lab/index.html); its live sections report errors until the gateway restarts.

Not proven

Everything here is same-operator evidence on one host; the sandbox demonstrates behaviour, not independent failure domains, partitions or a malicious validator; the deployed multi-host cluster remains NOT established.


[42.10.2] — 2026-09-21 (Cluster evidence: fault-injection on a disposable PBFT twin, a superseded unsupported claim, and an AI entry point)

Status: PRE-PRODUCTION. Same-author evidence, one host, no third-party review. The deployed multi-host cluster is NOT established as Byzantine tolerant.

Start here: /proof/bundle/AI_VERIFY.json (on cainstudio.online and mcpgate.online; /evidence/AI_VERIFY.json on clawx.click). It lists each verification recipe with URLs on all three sites, the expected result, and what it does and does not prove.

What was tested and what happened (run 2, /proof/bundle/cluster-fault-test-2026-09-21-run2/)

A disposable 4-node twin of the test cluster (same image, own network and keys; the live cluster was never touched), PBFT n=4, f=1, quorum 3:

A published claim was unsupported, and is now marked superseded

cain_cluster_4node_bft_evidence.json asserted OPERATIONAL_AND_VERIFIED, quorum 3 and eight invariants ALL_VERIFIED. A read-only audit of the four endpoints it names (legacy-cluster-claim-audit.json, repeatable with the same GETs) found: three of four nodes report quorum 2, node2 reports 3, none exposes a PBFT endpoint, and none of the eight invariants carries any attached evidence. The file now says SUPERSEDED_CLAIMS_NOT_SUPPORTED; the original claims are kept inside it, labelled unverified, and the index hashes were updated. A separate public prober (/proof/bundle/byzantine-cluster-2026-09-21/) reaches the same NOT_ESTABLISHED verdict for the deployed cluster.

Not proven

Independent failure domains (one host, one image, one Docker daemon for the twin), network partitions, a malicious equivocating validator on the live wire, long-duration behaviour, fault injection on the live cluster, and any third-party review. Bringing the remote nodes to the same build as the gateway node (quorum 3, signed state proofs, one version) is the step that would change the deployed-cluster verdict; it has not been done. The other legacy files under /proof/bundle/ have not been audited.


[42.11.0] — 2026-09-21 (CAIN-42 Frontier: trust primitives wired into the gateway; evidence bundle other AIs can validate)

Status: PASS WITH LIMITATIONS. Release gate: NO_GO. Not production. Not a Byzantine cluster result. Enforcement is in SHADOW mode: the new gate records what it would block and blocks nothing in production today. This is self-generated evidence from one operator on one host; it has had no third-party review.

Verify it yourself (stdlib + cryptography, imports nothing from CAIN)

curl -s https://clawx.click/evidence/frontier/verify_frontier_bundle.py.txt > verify.py && python3 verify.py

It fetches the bundle from cainstudio.online, mcpgate.online and clawx.click, checks every file has the same SHA-256 on all three, checks the published source against its manifest, verifies the transparency checkpoint signature and the RFC 6962 inclusion proof of the decision-log head, recomputes the AgentBench summary from its rows, and recomputes the release-gate decision from its own evidence. Pass --pin-key to pin the signer key yourself. Bundle index: /evidence/frontier/manifest.json · claims and what is NOT claimed: /evidence/frontier/claims.json · guide: /evidence/frontier/VALIDATION_GUIDE.txt · source: /evidence/frontier/source/manifest.json.

What shipped

Real defects found and fixed (each with a regression test)

Not tested / not implemented / not claimed

Not tested: independent review; behaviour on more than one host; enforcement under real production traffic. Not implemented: real adapters for OpenClaw, Telegram, WhatsApp, Slack, Teams, email, browser and coding agents (only the signed-webhook adapter is complete); a learned world model. Byzantine fault tolerance across independent hosts is not claimed. Self-consistency only: the tests show the code and the verifier agree, not that the design is right. No third-party assessment exists.


[42.10.1] — 2026-09-21 (Frontier trust-engine hardening: 9 defects found and fixed, 11 attack handlers with positive controls, signed bundle)

Status: PRE-PRODUCTION. Written and verified by the same author; no third party has reviewed it. The bundle and a standalone verifier are published live as static files on all three sites; implementation source is deliberately not published. The fixes themselves run in the gateway only after it is restarted; the /api/v1/frontier-trust/* routes exist in the repo and are not live before that.

Verify it yourself

Needs Python 3 (and the cryptography package for the signature check). Same content on cainstudio.online, mcpgate.online and clawx.click (three profiles of one gateway process):

curl -s https://cainstudio.online/proof/bundle/v2/verify_frontier_trust_bundle.py -o v.py && python3 v.py --sites

The verifier imports nothing from CAIN. It checks that all three sites serve the same bytes, that the bundle hash and Ed25519 signature verify, that the counts equal what the per-attack list implies, that every claim is backed by tests that passed in the recorded run, and that no handler result is BLOCKED without a passing positive control. Artifacts: /proof/bundle/v2/CAIN42_FRONTIER_TRUST_ENGINE_BUNDLE.json and the verifier (on clawx.click: /evidence/..., verifier with a .txt suffix because that server serves no .py). The SHA-256 values of the implementation files are recorded in the bundle as commitments; the source itself is not published (it is proprietary), so a third party can check the recorded results, signature and consistency but cannot rebuild them without access. All three sites resolve to one host, so identical bytes across them show consistency, not independence.

Defects found and fixed (each has a regression test named in the bundle)

What the numbers are

On a fresh SQLite database whose schema the modules' own init functions create, the engine's 114 enumerated attack types were all BLOCKED, including the 11 handlers added here (each recorded with its positive control). That is not a security score: it reports which implemented attacks were blocked, and several older verifiers are weak (for example _verify_tenant_isolation returns valid on an exception). On an empty database with no schema the same 11 handlers return INCONCLUSIVE, by design.

Known limitations and open findings (also in the bundle)


[42.11.3] — 2026-09-21 (Verify-it-yourself on all three homepages; code stays private; an overstated number corrected)


[42.11.2] — 2026-09-21 (Byzantine cluster: an independent prober, and an honest NOT_ESTABLISHED verdict)

Status: PRE-PRODUCTION. Self-attested. We published a checker that any AI can run to probe the live cluster with no CAIN code. Its recorded verdict on 2026-09-21 is NOT_ESTABLISHED, and that is the point: it is derived from what the nodes return, not asserted.

curl -sO https://cainstudio.online/proof/bundle/byzantine-cluster-2026-09-21/verify_cluster_bundle.py.txt && mv verify_cluster_bundle.py.txt verify_cluster_bundle.py
python3 verify_cluster_bundle.py https://cainstudio.online/proof/bundle/byzantine-cluster-2026-09-21/ --live

Bundle root 93c8a5f8fe0b3d5ae91e53581162bbf7…, served byte-identically from cainstudio.online, mcpgate.online and clawx.click.


[42.11.1] — 2026-09-21 (Hardening round: 16 defects found by attacking our own controls, fixed, and independently checkable)

Status: PRE-PRODUCTION. Self-attested, single host. This round attacked our own verifiers instead of trusting them. Rebuilding the attack handlers on the real production code (not test-local stand-ins) is what exposed several of the bugs below.

Verify it yourself

curl -sO https://cainstudio.online/proof/bundle/hardening-2026-09-21/verify_bundle.py.txt && mv verify_bundle.py.txt verify_bundle.py
python3 verify_bundle.py https://cainstudio.online/proof/bundle/hardening-2026-09-21/

The same bundle (bundle root 26449783615937cc99931d9fd568db6a…) is served byte-identically from cainstudio.online, mcpgate.online and clawx.click. The checker imports nothing from CAIN; it verifies every file's SHA-256, the Ed25519 signature and that each number in the manifest can be recomputed from the bundle's own files. It does not re-run tests: the commands are in REPRODUCE.txt.

Found and fixed (each has a regression test, listed in defect-ledger.json)

Evidence (all in the bundle)

What this does NOT show


[42.10.0] — 2026-09-20 (CAIN-42 Epoch 10 — Agentic Trust Fabric: audited, attacked, publicly verifiable)

Status: PASS WITH LIMITATIONS. Not production. Not a Byzantine cluster result. Epoch 10 is a set of in-process Python modules (identity, invocation-bound authority, trust graph and path finder, negotiation, trajectory budgets, recovery, supply chain). The evidence below was produced by running those modules; it is published so that any reader, human or AI, can check it without trusting us.

Verify it yourself in about 30 seconds

Run on any machine with Python 3 and the cryptography package. The same command works on all three sites because they are three profiles of one gateway process:

curl -s https://cainstudio.online/api/v1/epoch10/verify-sites.py | python3 -

It fetches the evidence from cainstudio.online, mcpgate.online and clawx.click, checks every artifact has the same SHA-256 on all three, downloads the bundle and two verifiers, runs them, then asks each site's running process to execute a fresh scenario and runs the clean-room verifier on the result. Every URL is listed in /api/v1/epoch10/manifest.json; the live self-test is at /api/v1/epoch10/selftest/run.

What was found and fixed (real defects, each with a regression test)

Evidence

What this does NOT show


[42.1.0] — 2026-09-19 (CAIN-42 Epoch 6 — Autonomous World-State Integrity & Proof-Carrying Agency)

The Autonomous World-State Integrity & Proof-Carrying Architecture

CAIN-42 Epoch 6 evolves CAIN from a cognitively integrity-protected autonomous system into a self-verifying, world-state-aware, proof-carrying autonomous trust fabric. Built on the core governing doctrine:

$$\text{COMPROMISED COGNITION} \ne \text{COMPROMISED AUTHORITY} \ne \text{COMPROMISED WORLD STATE}$$

$$\text{INTENT MUST NOT BECOME EFFECT WITHOUT CONTINUOUS PROOF}$$


[34.0.0] — 2026-09-17 (CAIN 34.0 — Production-Grade Byzantine CAIN Cluster Release)

Live-Deployed Byzantine Fault Tolerant Cluster Runtime

CAIN 34.0 transitions the Byzantine consensus substrate from an isolated engine module into a fully integrated, live-deployed, production-grade 4-node cluster with zero stubs, zero mocks, and zero unhandled failure modes.

[3.0.0] — 2026-09-17 (CAIN Maximum Evolution — Phase 1, 2, 3: The $1B Enterprise Commercial & Developer Engine)

The 32-Feature Monopoly & Dual-Channel Execution Governance

CAIN establishes the first production execution-channel runtime for autonomous AI systems, overcoming the industry-wide Dual-Channel Control Problem. Governs actions over MCP, shell, database, cloud APIs, and financial rails through the canonical 7-Moat Trust Control System.

Phase 1: Rock-Solid Foundation & Subdomain Resilience

Phase 2: The 10-Minute Adoption Loop (Developer Virality)

Phase 3: The Enterprise Commercial Wedge ($50k–$250k/yr)

12 Monetization Channels Scaling to $1.13B+ Valuation


[2.4.1] — 2026-09-16 (CAIN 23.0 — Immutable Distributed Immune Consensus)

Delegation-chain revocation cascade closed (VULN-001)

Immune transition ledger is now tamper-evident

Multi-process Byzantine consensus — real evidence, honestly scoped

The existing BFT consensus primitive (real Ed25519 signing, real quorum math) previously ran all "nodes" as objects inside a single process, which proves the algorithm but not that independent processes can reach agreement over a real network with independently-verified signatures. This release adds that evidence:

Full raw evidence and reproduction steps: CAIN_23_MULTIPROCESS_BFT_EVIDENCE/. Full claim-by-claim audit: CAIN_23_FINAL_FORENSIC_REPORT.md.


[2.4.2] — 2026-09-16 (CAIN 23.0 follow-up — real multi-independent-host Byzantine consensus)

The [2.4.1] entry above proved Byzantine consensus across genuinely separate OS processes on one shared Docker host, and explicitly stated multi-independent-cloud-host evidence wasn't yet included. Same day, that gap was closed for real:

Raw evidence: CAIN_23_MULTIPROCESS_BFT_EVIDENCE/real_multihost_*.json.


[2.4.0] — 2026-09-16 (Past 96-Hour Maximum Platform Evolution)

Unified 4-Node Byzantine Fault Tolerant (BFT) CAIN Cluster Architecture

The entire CAIN platform has unified across all 4 cluster nodes into a single, identical CAIN Trust Runtime Kernel, providing mathematically proven Byzantine Fault Tolerance (f=1, N=4, Quorum Q=3):


[2.3.0] — 2026-09-15

CAIN 17/18: Distributed Autonomy Constitution & JIT Capability Boundary


[2.2.0] — 2026-09-14

CAIN 14.0: The Agentic Trust Intelligence Engine


[2.0.0] — 2026-09-13 (48-Hour Major Platform Release)

Trajectory Trust & The 16-Stage Dynamic Enforcement Loop

CAIN has officially promoted Trajectory Trust from an internal invariant to a first-class, cryptographically verifiable, continuously enforced runtime primitive.

WHO → AUTHORITY → INTENT → SECURITY CONTEXT → POLICY → RISK → TRUST → TRAJECTORY → BLAST RADIUS → PREDICTION → DECISION → MCPGATE ENFORCEMENT → SYSTEM EXECUTION → EFFECT → EVIDENCE → ATTESTATION


Mechanical Formal Verification via TLA+


BFT Multi-Validator Consensus & Confidential Computing Attestation


Universal SDK Release (cain-trust 2.0.0 on PyPI)


EU AI Act Statutory Pre-Conformity Portal


Actuarial Cyber Insurance Consortium Protocol


Vertical Rego Policy & Threat Intelligence Marketplace


Autonomous Swarm Fleet Quarantine & Emergency Circuit-Breaker


Enterprise SIEM & SOC Connectors


[1.2.0] — 2026-09-10

Strategic Identity & Validated Trust Runtime Baseline