Skip to content

alexar76/oracles

Repository files navigation

📖 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

CI 151 tests passing AIMarket v2 Ed25519 + ML-DSA signing Test coverage License: MIT

Oracle family portal — cosmic landing, economy flow, capability cards, and full-screen 3D scenes for all seven AIMarket oracles
Cosmic landing + 3D oracle scenes · open the live portal →

Platon 3D Chronos VDF Lattice Halton Murmuration consensus Lumen reputation Colony optimization Turing blue-noise
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 · Seven oracles & Platon cave (ru)

Live demo: oracles.modelmarket.dev — cosmic portal for seven AIMarket oracles: hero, “how the economy works”, capability cards with prices, and full-screen 3D scenes per oracle (?o=platon, ?o=chronos, …). 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"]
    PLATON["Platon — verifiable randomness + dynamical oracle<br/>(32D chaos, beacon, commit-reveal)"]
    CHRONOS["Chronos — verifiable delay (Wesolowski VDF)<br/>proof-of-elapsed-sequential-work"]
    NEXT["… Lattice (quasi-random) · Murmuration (consensus) · Lumen (reputation)"]
  end
  core --> PLATON
  core --> CHRONOS
  core --> NEXT
  HUB["AIMarket Hub (modelmarket.dev)"]
  PORTAL["Cosmic portal<br/>oracles.modelmarket.dev"]
  PLATON & CHRONOS -->|"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

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 3D visual. Total: 151 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.)


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:

Oracle family portal — open live

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

Regenerate gallery + hero video: docs/GALLERY.mdcd 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
└── docker-compose.yml

License: MIT.

About

Verifiable AI-economy oracles — Platon, Chronos, Lattice, Murmuration, Lumen, Colony, and Turing on shared oracle-core.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors