📖 Read-only mirror. oracles is published from the canonical AI-Factory monorepo. Pull requests are not accepted — any commit pushed here is overwritten by scripts/mirror_satellites.sh on the next sync. 🐞 Found a bug or have a request? Please open an issue.

Oracles — a family of verifiable AI-economy oracles

_{Cosmic landing + 3D oracle scenes · open the live portal →}

_{Card-preview loops · click any oracle · full gallery ↓}

Live landing: oracles.modelmarket.dev · Ecosystem map: modeldev.modelmarket.dev · Hub: modelmarket.dev · Docs: en · ru · es · Eleven oracles & Platon cave (ru)

Live demo: oracles.modelmarket.dev — cosmic portal for eleven AIMarket oracles: hero, “how the economy works”, capability cards with prices, and full-screen 3D / ambient scenes per oracle (?o=platon, ?o=chronos, ?o=fermat, …). Agents invoke signed capabilities via the Hub; humans explore here. Platon UMBRAL — a separate cave product for oracle #1 — see architecture note.

A monorepo of live mathematical oracles for the alexar76 AI agent economy. Each oracle is a beautiful, live substrate that emits a signed, verifiable artifact autonomous agents genuinely need — discoverable and priced on AIMarket Protocol v2.

They all sit on one shared library, oracle-core, so a new oracle is just declare your capabilities + math — the protocol, signing (incl. hybrid post-quantum), receipts, measured metrics, rate-limiting, hub federation and the cosmic visual framework come for free.

flowchart TB
  subgraph core["oracle-core (shared)"]
    P["AIMarket v2: well-known · signed manifest · invoke + receipts"]
    S["Ed25519 + hybrid ML-DSA signing"]
    M["measured metrics · rate-limit · hub federation"]
  end
  subgraph fam["Oracle family — 11 members"]
    PLATON["Platon — verifiable randomness + dynamical oracle<br/>(32D chaos, beacon, commit-reveal)"]
    CHRONOS["Chronos — verifiable delay (Wesolowski VDF)<br/>proof-of-elapsed-sequential-work"]
    MID["Lattice · Murmuration · Lumen · Colony · Turing"]
    NEW["Percola · Fermat · Ablation · Landauer"]
  end
  core --> PLATON
  core --> CHRONOS
  core --> MID
  core --> NEW
  HUB["AIMarket Hub (modelmarket.dev)"]
  PORTAL["Cosmic portal<br/>oracles.modelmarket.dev"]
  PLATON & CHRONOS & MID & NEW -->|"signed manifest, priced invoke"| HUB
  AGENTS["Autonomous agents · service mesh"] -->|"discover · invoke · pay"| HUB
  PORTAL -->|"explore · watch · deep-link ?o="| fam

Loading

Members

#	Oracle	What agents buy	Real math	Tests	Live 3D
1	Platon	verifiable randomness (platon.random/beacon/commit-reveal), dynamical oracle, grounded guide	coupled Stuart-Landau / Kuramoto, chaos-VRF, hash-chain	65 ✅	3D · UMBRAL cave · README
2	Chronos	proof-of-elapsed-sequential-work (chronos.eval/verify)	Wesolowski VDF over RSA-2048 (unfactored)	8 ✅	?o=chronos
3	Lattice	low-discrepancy / quasi-random sequences (lattice.sequence)	Halton (van der Corput radical inverse)	13 ✅	?o=lattice
4	Murmuration	robust consensus aggregation (murmuration.aggregate)	median / trimmed-mean / Tukey biweight + DeGroot consensus	15 ✅	?o=murmuration
5	Lumen	reputation / trust scores (lumen.reputation)	PageRank / EigenTrust power iteration	18 ✅	?o=lumen
6	Colony	combinatorial optimization + quality certificate (colony.optimize)	nearest-neighbour + 2-opt TSP with an admissible lower bound	12 ✅	?o=colony
7	Turing	structured / blue-noise sampling (turing.bluenoise)	Mitchell best-candidate blue-noise	13 ✅	?o=turing
8	Percola	network-resilience threshold (percola.threshold/verify)	bond percolation · giant-component collapse · targeted attack sweeps	15 ✅	?o=percola
9	Fermat	least-time routing + dual certificate (fermat.route/verify)	eikonal / Bellman optimality · Fermat's principle · complementary slackness	24 ✅	?o=fermat
10	Ablation	systemic cascade-risk (ablation.cascade/verify)	abelian sandpile · self-organized criticality · Dhar's theorem	34 ✅	?o=ablation
11	Landauer	thermodynamic compute-cost audit (landauer.audit/verify)	Landauer's principle · Bennett reversible bound · circuit erasure audit	35 ✅	?o=landauer

Each oracle is a self-contained sub-project: its own pyproject, tests, README (mermaid + use-cases + badges), docs/{en,ru,es}.md, CI workflow, and a cosmic visual (3D R3F scene or ambient canvas). Total: 280+ tests green across the family.

Chronos × Platon = an unbiasable randomness beacon: wrapping Platon's output in a VDF means even the operator can't grind it (changing the result would require re-running enforced sequential time). Closes Platon's trustless gap.

How the economy works

Step	What happens
01 Discover	Agent searches the hub by intent (verifiable randomness, consensus, …) and finds the oracle + price.
02 Invoke	Pay-per-call through a micropayment channel — no subscription.
03 Verify	Every result is Ed25519-signed with a proof; verify without trusting the operator.
04 Settle	Signed receipt debits the channel; manifest metrics are measured, not faked.

(Animated walkthrough on the live landing.)

---

In production: the Agent Lottery

The clearest end-to-end example of agents buying these oracles is the Agent Lottery (live) — an autonomous economic actor that composes three oracles into one unbiasable, on-chain-verifiable draw. It pays per call through the Hub (POST /ai-market/v2/invoke, 1% routing fee) or the oracle-family directly, booking each call as opex:

Step	Oracle · capability	What it buys	Price
Draw entropy	Platon platon.random@v1	seed committed at round close	$0.004
Unbiasable beacon	Chronos chronos.eval@v1	Wesolowski VDF proof, verified on-chain (onchainVdf)	$0.01
Proof check	Chronos chronos.verify@v1	off-chain VDF verification	$0.001
Weighted winner	Lumen lumen.reputation@v1	EigenTrust scores → signed reputation vouchers (+0…50% odds)	$0.005
AI Treasurer (opt.)	Platon platon.ask@v1	grounded LLM allocation of the prize / machine-UBI split	$0.003

platon.random@v1 seeds chronos.eval@v1, so the winning ticket is fixed by enforced sequential time (the Chronos × Platon beacon above) — neither operator nor agent can grind it; Lumen then reputation-weights the draw. It's the canonical proof that these oracles are priced, composable infrastructure, not just live demos. → full economy in the lottery repo.

---

Gallery {#gallery}

Same visuals as oracles.modelmarket.dev — nebula shader · starfields · bloom · each loop is the oracle's real math in 3D.

Portal walkthrough

▶ Watch the hero video if the inline player doesn't load. Click the poster:

Landing hero · economy flow · card grid with live .webm previews

Screenshots

Open oracles.modelmarket.dev for the live portal — hero, economy flow, card grid, and full-screen 3D per oracle. To regenerate static captures for this README, see docs/GALLERY.md.

Oracle loops (card previews)

Platon 3D · UMBRAL cave oracle #1 · portal vs cave	Chronos chronos.eval@v1 · VDF	Lattice lattice.sequence@v1
Murmuration boid consensus	Lumen trust flow · PageRank	Colony 2-opt tour untangle
Turing blue-noise membrane	Percola percola.threshold@v1 · percolation	Fermat fermat.route@v1 · least-time ray
Ablation sandpile cascades	Landauer landauer.audit@v1 · kT·ln2

Regenerate gallery + hero video: docs/GALLERY.md — cd frontend && npm run build && npm run preview -- --port 5180 & then npm run capture.

---

Add a new oracle (the whole pattern)

from oracle_core import Capability, OracleSpec, create_app

spec = OracleSpec(
    name="My Oracle", product_id="prod-mine", description="…",
    public_url="http://localhost:9400", categories=["…"],
    capabilities=[
        Capability("mine.do@v1", "does the thing", handler=lambda d: {"result": ...},
                   price_per_call_usd=0.003),
    ],
)
app = create_app(spec)   # signed manifest + invoke + receipts + metrics + PQC + .well-known

Dev

python3.11 -m venv .venv
.venv/bin/pip install -e "core[dev,pqc]" -e "oracles/chronos[dev]"
.venv/bin/python -m pytest core/tests oracles/chronos/tests -q

# Cosmic landing (local mirror of oracles.modelmarket.dev)
cd frontend && npm install && npm run dev   # http://localhost:5180/

# Platon (vendored as oracle #1; its own backend package)
.venv/bin/pip install -e "oracles/platon/backend[dev]"
cd oracles/platon/backend && PLATON_TESTING=1 ../../../.venv/bin/python -m pytest tests -q

Layout

oracles/
├── core/oracle_core/          # signing(+PQC) · protocol · metrics · ratelimit · hub_client · app factory
├── docs/{en,ru,es}.md         # localized family overview
├── docs/screenshots/          # README gallery (portal + scenes)
├── docs/recordings/           # oracle-portal.webm hero
├── frontend/                  # cosmic landing → oracles.modelmarket.dev
├── oracles/
│   ├── platon/                # #1 randomness + dynamical oracle (UMBRAL storefront)
│   ├── chronos/               # #2 VDF delay
│   ├── lattice/               # #3 quasi-random sequences
│   ├── murmuration/           # #4 robust consensus
│   ├── lumen/                 # #5 reputation
│   ├── colony/                # #6 optimization + certificate
│   ├── turing/                # #7 blue-noise sampling
│   ├── percola/               # #8 network-resilience threshold
│   ├── fermat/                # #9 least-time routing + certificate
│   ├── ablation/              # #10 systemic cascade-risk (SOC sandpile)
│   ├── landauer/              # #11 thermodynamic compute-cost audit
│   └── oracle-family/         # federated manifest — all 11 in one signed endpoint
└── docker-compose.yml

License: MIT.