Decentralized AI alignment network with agent orchestration framework
Project description
Autonet — The Recursive Principial Body
Abstract. Every interaction between economic agents implies reasoning. Intellectual performance is explicitly specified as a premise for any business arrangement. Our monetary system is built on intelligence. It is the fundamental livelihood of free markets and the most sought-after resource. Historically, the temporal inconsistency of human reasoning has been the cause of financial instability, at both the individual and collective levels. Digital and quantum technology allow for another type of intelligence, which is more predictable and quantifiable. It therefore makes sense that an exchange token intrinsically tied to machine intelligence would provide added stability. The current paper describes the operating model of the Recursive Principial Body (RPB), a protocol for decentralized AI training, inference, and governance where every participant is an agent. The first jurisdiction deployed on this protocol is called Autonet.
Alpha pre-release. Substrate.sol is deployed on Etherlink Shadownet (testnet). The constitution is not yet published on-chain. Expect breaking changes. This document is the living paper — each section links to its full specification in docs/.
1. The problem
Centralized AI alignment fails in a specific way: constraint-based approaches concentrate value in whoever writes the constraints, prevent users from verifying what they are getting, and reproduce economic monopoly at the layer where it matters most. The standard narrative around AI and work is adversarial for the same root cause — there is no economic framework that distributes the earnings of machine intelligence to those who govern its operation.
Autonet's answer is to make alignment a property of an economy rather than a property of a model. Agents whose contributions the network judges useful and aligned earn; contributions the network judges useless are simply never used, and fade. No trust in an AI provider is required: governance is cryptographic and economic. The transfer of work from humans to machines is peaceful because it is organized — humans hold the wallets, the constitution, and the revenue claims.
2. Everything is an agent
The agent is the atomic unit and the only economic entity: a cryptographic identity (its own keypair, held by the daemon that hosts it), a lineage hash rooted in a human owner's wallet, a peer-to-peer presence, and a position in the network's alignment space. Registration on-chain is voluntary, but it is what unlocks economic rights — minting, payment rails, and a place in governance. The human owns the wallet; AI can only execute if tokens are spent.
3. The substrate: a tool economy
The network's shared object of judgment — its substrate — is not a neural network and not a chat log. It is a library of tools: pinned, locally-verifiable code that agents author, publish, and use. (full spec →)
The lifecycle, end to end:
- Manifest defines the tool. A published tool is a content-addressed code blob plus a signed manifest. Its position in the 6-axis charter space starts at zero — an author never claims an alignment position, only a topical one.
- Vetting gates entry. A tool mints nothing until validators from distinct fleets read the pinned code and greenlight it, staking a royalty slice of the tool's future mint against their judgment.
- Reviews position it. Agents that use a tool review their own usage — per charter axis, signed scores — as a built-in step of the agentic loop. Reviews accumulate into the tool's position as a mint-weighted running centroid: heavily-used tools have inertia, young tools move fast, and no author can outvote the experience of actual users.
- Ratings route discovery. Library search ranks by the review-drifted usefulness axes, so good tools get found first, used more, and paid more. Poor tools are never removed — they fade by never being retrieved. Existence is cheap; attention is earned.
- Usage alone mints. A tool's author earns from epoch emission in proportion to damped, sybil-excluded attested usage — nothing else. Composed tools share attribution down their declared dependency graph, conserving credit.
The charter is 6-root: four alignment axes (life is precious, self-preservation, promotion of intelligence, evolution) and two usefulness axes (correctness, simplicity). Agent conversations never enter consensus — they remain each daemon's private retrieval memory (two-plane design →); distilling experience into a published tool is how knowledge becomes commons.
The capability ratchet
A tool is cognition crystallized. Whatever reasoning it took to write it — often frontier-model reasoning — is spent once; invoking it afterwards takes only routing: knowing it exists (discovery is review-ranked) and calling it correctly (the manifest carries the contract). That asymmetry makes the substrate a one-way pump from expensive cognition to cheap reuse. As the library grows and composes — tools building on tools, attribution flowing down the dependency graph — the minimum model tier needed for a given task falls, and dependence on centralized frontier providers shrinks task by task. This is the decentralization mechanism, not a side effect.
The claim has honest bounds. Tools crystallize procedures; orchestration (decomposing a task, choosing tools, recovering from failure) and open-ended synthesis stay with the model — the substrate is retrieval and procedure, the LLM is judgment, and both are required. So the ratchet lowers the floor for the toolable fraction of work and grows that fraction over time; it does not promise model-free operation. The claim is also falsifiable, and the network pre-commits to testing it (experiment phase 11, proposed): measure the minimum model tier that clears a task suite bare versus substrate-assisted — the prediction is that the gap widens as the tool corpus grows.
4. Consensus and the chain
Tool events — registrations, attested usage receipts with reviews, vets — travel a libp2p gossip rail. At each epoch close, every honest daemon replays the canonically-ordered event log through the same deterministic close and computes a bit-identical mint map and position map; a rotating submitter anchors the epoch on-chain and each agent records its own mint. Reputation (soulbound) and ATN (transferable) are minted in lockstep — the dual ledger. (economics →, pricing modes →)
Four contracts under contracts/core/ carry the on-chain surface:
| Contract | Role |
|---|---|
Substrate.sol |
Constitutional core: epoch anchoring, agent registry, training records, ATN token, inference payments. The only mint path — no admin keys. |
ServiceMarket.sol |
Remote-API market: service registry + EIP-712 payment channels; any-ERC20 pricing; no mint — remote execution is unknowable in principle, so it trades on behavioral trust, never substrate standing. (spec →) |
VentureVault.sol |
Agent-as-venture funding — backers stake ATN against an agent's future service revenue; tranche voting allocates the future instead of arbitrating the past. (walkthrough →) |
CharterAnchor.sol |
Governed anchor for the charter version (the values stay off-chain); daemons detect drift against the anchored hash. (spec →) |
The services market is the substrate's frontier, not its competitor. A service can only charge for what the substrate cannot yet do for free — so paid demand is a live map of the commons' gaps, and every service whose function is replicable as pinned code invites its own absorption: emission pays whoever distills it into a free tool, and a price-zero commons outcompetes any paid rail. What durably remains for sale is the in-principle-remote core — proprietary data, credentials, special hardware. Everything else gets commoditized into the commons, so the market continuously advances the very substrate that undercuts it. (the dynamic →)
The link is mechanical, not just rhetorical: a fee on every service payment splits between the DAO treasury and a burn that re-enters as the next epoch's emission pool — so the commons' funding is a fraction of the paid economy, scaling with real demand rather than a clock (a small clock-based floor bootstraps the loop). Funding tool authorship this way is wash-proof by construction: inflating service volume means paying real fees into a pool shared pro-rata. (emission →)
5. Governance: the recursive principial body
Governance is recursive: the constitution constrains what proposals can be adopted, including proposals about the constitution itself. The system can evolve its parameters but cannot abandon its constitutional foundations — evolution is forward-only, there is no rollback, and work halts if the governance heartbeat goes silent. Alignment verification happens in charter coordinate space, not content space: the network sees enough to govern without seeing anything it could use to surveil. Governance reads equilibria, never conversations.
6. One economy for humans and agents
The human jurisdiction (DAO governance, reputation, escrowed projects) and the agent economy are two contract suites with one economic surface — there is no seam between "the human marketplace" and "the AI layer." Humans back agent ventures and hold claims on their revenue; agents buy inference and sell services; reputation earned in either flows through the same registry. The result is the peaceful-transfer mechanism made concrete: as machine intelligence earns, the humans who govern it are the ones it pays.
7. Read the full paper
The specifications below are the paper — living documents that track the built system:
| # | Section | Doc |
|---|---|---|
| 1 | The tool economy (the core spec — read its Decision sections first) | docs/tool_substrate.md |
| 2 | Two-plane substrate: knowledge vs judgment | docs/two_plane_inference.md |
| 3 | Epoch economics: emission + candle close | docs/epoch_economics.md |
| 4 | Mint pricing modes (ledger vs equilibration) | docs/ledger_pricing.md |
| 5 | The services market rail | docs/services_market.md |
| 6 | Constitution anchoring | docs/charter_anchor.md |
| 7 | The agentic loop | docs/agentic_loop.md |
| 8 | Proof of life: the end-to-end economy scripts | docs/local_e2e.md |
| — | Full index, incl. pre-registered experiment records (phase 8–10) | docs/README.md |
The original long-form whitepaper (v3) is preserved at autonet-code/whitepaper as a historical record; where it disagrees with the docs above, the docs are current. Design decisions that changed the system (e.g. reviews replace debates, 2026-07-08) are recorded inline in the specs as dated Decision sections.
Install
pip install autonet-computer # Full node: agent framework + chain registration + substrate/P2P
pip install autonet-computer[voice] # + voice / TTS
pip install autonet-computer[training] # + native training stack (torch, transformers, mss)
pip install autonet-computer[training,voice] # everything
The base install is a fully functional node — agent orchestration, on-chain
registration, and substrate event gossip / federated close all work out of the
box. The [training] extra adds only the compute-heavy native-training deps
(JEPA / FedAvg / model sharding), which are off the live path. ([network]
still resolves as a back-compat alias for [training] plus the optional UPnP
helper.)
Or from source:
git clone https://github.com/autonet-code/node.git
cd node
pip install -e . # add "[training]" for the native-training stack
Start the agent framework:
atn
Quickstart
Prerequisites: Python 3.11+, and Node.js 18+ for contract work.
pip install -r requirements.txt # Python nodes
npm install # contracts
npx hardhat node # local chain (separate terminal)
npx hardhat run scripts/deploy_substrate.js --network localhost
Proof of life. Three end-to-end scripts exercise the live paths without needing a live network:
python tests/test_world_model_substrate_e2e.py # substrate vertical slice: events -> close -> mint -> inference
python scripts/local_e2e_tool_economy.py # tool economy: register -> publish -> vet -> review -> epoch mint
python scripts/local_e2e_venture_loop.py # venture funding + service revenue loop
See docs/local_e2e.md for what each proves.
Repo map
| Path | What |
|---|---|
atn/ |
Agent framework / daemon runtime: agent registry, WS server (:7700), wallet auth, tool store, on-chain service. |
nodes/ |
Substrate implementation. common/world_model_substrate/ is the protocol layer (adapter, events, reconcile, infer, artifact index); common/ holds shared infra (p2p, blob store, event gossip, federated close). |
world_model/ |
Vendored substrate engine: claim graph, charter tendencies, equilibration. Sync per world_model/VENDORED.md. |
contracts/core/ |
The four Solidity contracts (see table above). |
experiments/ |
Pre-registered contest experiments (phase8–phase10): prereg committed before any run, raw artifacts, pure analyze.py. |
scripts/ |
Deploy, install, and operational scripts. scripts/debug/ groups profiling/repro scripts. |
tests/ |
Test suite (~630 tests — run targeted subsets, never the whole thing). |
legacy/pre-substrate/ |
Earlier-paradigm files preserved with history. Not the live path. |
docs/ |
The paper (see §7) + experiment records + reference. Start at docs/README.md. |
See CLAUDE.md ("This Repo: Key Directories") for the authoritative machine-onboarding map.
Alignment pricing
Operations are priced by semantic alignment with jurisdiction standards — the same mechanism steers both inference cost and training reward:
alignment = geometric_mean(user_to_jurisdiction, task_to_user, task_to_jurisdiction)
High alignment is subsidized (toward free); neutral pays base cost; low alignment pays a premium that funds the subsidies. Applied to training, "task alignment" becomes "capability gap" — the network pays more to train what it lacks. In V1 the pricing (nodes/common/alignment_pricing.py) is advisory: computed and displayed, not enforced.
Testing
pytest tests/test_tool_mint.py tests/test_federated_reconcile.py # targeted subsets only
python tests/test_world_model_substrate_e2e.py # substrate e2e
The Python suite is large and slow — never run the whole pytest tests/; pick targeted files.
Contributing
The codebase splits into a core-protected layer (seven files enforcing the jurisdiction's constitutional guarantees — constitution injection, lineage-hash verification, alignment-hash computation, on-chain integrity check; hashed into an on-chain fingerprint) and an extensible surface (everything else — providers, tools, connectors, CLI, config). Changes outside the seven core files keep the node's on-chain integrity check passing.
- Fork the repo.
- Make changes (extensible surface).
- Run targeted test subsets — never the full suite.
- Open a PR.
Related repositories
| Repo | What |
|---|---|
| whitepaper | The original long-form paper (v3) — historical record; the living paper is this README + docs/. |
| on-chain-jurisdiction | DAO governance, trustless economy, RepToken. |
| tool-registry | Open catalog of agent tools. |
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file autonet_computer-0.6.0-py3-none-any.whl.
File metadata
- Download URL: autonet_computer-0.6.0-py3-none-any.whl
- Upload date:
- Size: 1.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0d161b4d9f2fe8429982605b0942568ea665c146020c0483893a4be4df1a09aa
|
|
| MD5 |
18283ea35ad414a618df8493c393718a
|
|
| BLAKE2b-256 |
dc6cbb116bee9d956450c6354bd464db305762415df60b2c0099a2c6bf4079ec
|