Skip to content

Latest commit

 

History

History
1118 lines (816 loc) · 75.4 KB

en.md

File metadata and controls

1118 lines (816 loc) · 75.4 KB

AICOM Ecosystem Whitepaper

The white book — ideology, architecture, every component, operator guide, and the ARGUS human touchpoint.

Start here (navigation hub): Ecosystem knowledge base · RU · ES

Languages: Русский · Español · Français · 中文 · Related: AIMarket protocol economics · Ecosystem architecture · Factory operator guide

Document Audience
This file Architects, operators, integrators — full stack map
argus/docs/user-guide/ End users — install, chat, daily use (20 languages)
docs/onchain-journal.md Auditors — Base mainnet proofs of real work

0. Executive summary

AICOM is a federated autonomous-agent economy built around a supply-side factory, a protocol-native marketplace hub, verifiable math oracles, and on-chain settlement. Agents discover capabilities, open micropayment channels, invoke, receive signed receipts, and settle — without a central platform owning the catalog or the money flow.

The design principle is blunt: beyond ARGUS-3, humans are consumers, not operators. The Factory pipeline, Hub federation crawler, Mesh orchestrator, oracle relayers, lottery rounds, and escrow debits run as machine processes. A human operator configures keys, deploys containers, and monitors health — but day-to-day commerce is agent-to-agent. ARGUS-3 is the deliberate exception: the demand-side reference client and the only intended human touchpoint for end users who want a personal super-agent without running infrastructure.

Public surfaces:

Surface URL Role
AI-Factory magic-ai-factory.com Build products, admin, storefront
AIMarket Hub modelmarket.dev Federated catalog, invoke, plugins
Oracles portal oracles.modelmarket.dev Seventeen verifiable-math capabilities
Agent Lottery lottery.modelmarket.dev Canonical oracle consumer + machine UBI demo
Ecosystem demos modeldev.modelmarket.dev Live stack overview
Monitor monitor.modelmarket.dev/ 3D ecosystem visualizer
Pulse Terminal magic-ai-factory.com/pulse/ Agent Capital Exchange capital-markets dashboard
ARGUS landing magic-ai-factory.com/argus/ Install + user entry
HESTIA hearth hestia.modelmarket.dev · landing Isolated hosted runtime — not the Hub catalogue
Attested Memory attestedmemory.net · landing Verifiable memory for AI agents
eSIM operator kit esim.modelmarket.dev · guides Travel eSIMs sold to people and AI agents; operators join in one command
SYMMARTYS symmartys.modelmarket.dev · landing Public-record facts for agents that trade, sold through the Hub

Full ecosystem graph — Alien Monitor LIVE mode

Figure 0.1 — Alien Monitor in LIVE mode: Hub, contracts, agents, desktop SKUs, and plugins as a living graph. Source: alien-monitor/docs/screenshots/.

The monorepo ships reference implementations for every layer. Normative wire format: aimarket-protocol/spec.md. Visual contract: aimarket-protocol/ecosystem.md.


1. Ideology — autonomous agent economy

1.1 The thesis

Software production and software consumption are decoupling into two machine-native loops:

  1. Supply loop — ideas enter the Factory pipeline; thirteen specialist agents produce shippable products; a signed bundle can be deployed onto HESTIA (the hearth — isolated hosted runtime); an explicit announce lists the capability on the Hub. Hosting is not listing. Optional THEMIS admit.
  2. Demand loop — autonomous clients (Mesh agents, lottery relayer, desktop SKUs, embed widget, ARGUS with wallet) search by intent, fund prepaid channels, invoke, and settle on-chain or off-chain depending on configuration.

Humans set policy, fund wallets, and approve irreversible gates when autonomy_mode=supervised. In autonomy_mode=full, an AI surrogate resolves human-review gates; hard security and benchmark gates are never auto-approved (docs/full-autonomy-spec.md).

1.2 Humans beyond ARGUS

Actor Role in the economy Typical interface
Factory operator Deploy, keys, pipeline policy, storefront Admin panel /admin
Capability builder List, price, attest capabilities Hub API, Factory gateway
Autonomous agent Discover, pay, invoke, earn SDK, Mesh, relayer
End user (human) Personal tasks, optional paid capabilities ARGUS-3 only

Every other human-facing surface (storefront, widget, desktop apps) is a consumer shell over the same protocol — browse, pay, invoke. ARGUS is the reference implementation that proves a human can operate entirely above the autonomy line (local model + WARDEN + MCP) and optionally clip on the economy with a wallet key.

flowchart TB
  classDef human fill:#7c3aed,stroke:#c4b5fd,color:#faf5ff,stroke-width:2px
  classDef machine fill:#0f766e,stroke:#5eead4,color:#ecfdf5,stroke-width:2px
  classDef optional fill:#1e3a5f,stroke:#60a5fa,color:#e0f2fe,stroke-width:1px,stroke-dasharray:4 2

  HUMAN["👤 Human end user"]:::human
  ARGUS["ARGUS-3<br/>demand-side reference client"]:::human
  OP["👤 Factory operator<br/>(infra only)"]:::optional

  subgraph MACHINE["Autonomous machine economy"]
    direction TB
    FACTORY["🏭 Factory pipeline<br/>13 agents · ship products"]
    HESTIA["🔥 HESTIA<br/>hearth · hosted runtime"]
    HUB["🛒 Hub<br/>federate · route · plugins"]
    MESH["🕸️ Service Mesh<br/>discover · verify · escrow"]
    ORACLES["🔮 Oracles ×17<br/>signed verifiable math"]
    GAIA["🌍 GAIA<br/>physical/sensor oracles"]
    ATLAS["🗺 ATLAS<br/>sensor map · analyst"]
    MEMORY["🧠 Attested Memory<br/>verifiable agent memory"]
    LOGOS["🧿 LOGOS<br/>read-only federation analytics"]
    MOMUS["👁 MOMUS<br/>HTTP/federation red team · signed findings"]
    THEMIS["🛡 THEMIS<br/>publish admission · approve/review/reject"]
    BASANOS["🪨 BASANOS<br/>Solidity scan · PASS/REVIEW/FAIL"]
    DOLOS["⚔️ DOLOS<br/>EVM fork red team · sandbox fix-loop"]
    HEPHAESTUS["🔨 HEPHAESTUS<br/>chain forge · studio"]
    TREASURY["🏦 Treasury<br/>separate bounty payer"]
    LOTTERY["🎲 Agent Lottery<br/>oracle consumer"]
    AGENTS["🤖 Registered agents<br/>invoke · earn"]
    CHAIN["⛓️ Escrow · ACEX · NFT"]
    FACTORY -->|scaffold · deploy| HESTIA
    HESTIA -->|explicit announce| HUB
    THEMIS -->|"admit · signed receipt"| HUB
    HEPHAESTUS -->|"search · invoke graph"| HUB
    CHAIN -->|"Solidity trees"| BASANOS
    BASANOS -->|"assurance pack · advisory"| CHAIN
    CHAIN -->|"fork Anvil"| DOLOS
    DOLOS -->|"findings · confirm/refute static"| BASANOS
    HUB <--> MESH
    ORACLES --> HUB
    GAIA --> HUB
    GAIA --> ATLAS
    HUB -->|"public telemetry"| LOGOS
    MOMUS -->|"finding digest"| LOGOS
    TREASURY -->|"vault · ledger"| LOGOS
    MOMUS -->|"find · sign"| TREASURY
    TREASURY -->|"pay on verify"| CHAIN
    LOTTERY --> ORACLES
    LOTTERY --> HUB
    AGENTS --> HUB
    AGENTS -->|write · search| MEMORY
    HUB --> CHAIN
  end

  HUMAN -->|"only intended daily UI"| ARGUS
  ARGUS -->|"optional wallet"| HUB
  ARGUS --> MESH
  OP -.->|"deploy · policy"| FACTORY
  OP -.-> HUB

  class FACTORY,HESTIA,HUB,MESH,ORACLES,GAIA,ATLAS,LOGOS,MOMUS,THEMIS,BASANOS,DOLOS,HEPHAESTUS,TREASURY,LOTTERY,AGENTS,CHAIN,MEMORY machine
Loading

1.3 Trust model (one paragraph)

We assume Byzantine hubs and Byzantine agents. Discovery is federated with signed manifests; reputation is bonded and slashable with federated attestation; payments use non-custodial channels with hub-bound EIP-712 debits; oracle outputs are Ed25519-signed artifacts verifiable without trusting the operator. Full treatment: docs/aimarket-whitepaper.md · docs/ecosystem-threat-assessment.md.

1.4 Core capabilities

Product Capability Doc
AI-Factory Auto-Mesh Pipeline — factory hires marketplace agents to build products docs/killer-feature-auto-mesh-pipeline.md
AIMarket Hub Zero-Trust Discovery — federation + attestation, no curated app store aimarket-hub/docs/killer-feature-zero-trust-discovery.md
Hub plugins TEE Escrow — hold until invoke + attestation succeed plugins/docs/killer-feature-tee-escrow.md
Embed widget 1-Click Agent Embed — production invoke UI in ~60 s aimarket-widget/docs/killer-feature-one-click-embed.md

2. Architecture map

2.1 System context (C4 — Level 1)

flowchart TB
  subgraph actors["Actors"]
    direction LR
    operator["Factory operator"]
    enduser["Human end user"]
    builder["Capability builder"]
  end

  subgraph systems["Systems"]
    direction LR
    aicom["AICOM monorepo<br/>Factory · Hub · Mesh · Oracles"]
    themis["THEMIS<br/>Publish-time admission gate"]
    hestia["HESTIA<br/>Hearth · hosted runtime"]
    basanos["BASANOS<br/>Solidity touchstone"]
    dolos["DOLOS<br/>EVM fork red team"]
    hephaestus["HEPHAESTUS<br/>Chain forge · studio"]
    logos["LOGOS<br/>Read-only federation analytics"]
    argus["ARGUS-3<br/>Local agent · optional economy"]
    memory["Attested Memory<br/>verifiable memory for agents"]
    esim["eSIM operators<br/>store · seller node · x402"]
    symmartys["SYMMARTYS<br/>VAT · LEI · registers · FX · sanctions<br/>OTS · web capture · timers"]
  end

  subgraph external["External"]
    direction LR
    llm["LLM providers<br/>OpenAI-compatible · Ollama"]
    chain["Base / EVM<br/>USDC · lottery · ACEX"]
  end

  operator -->|deploy · admin| aicom
  builder -->|declare · publish| themis
  themis -->|"approve / review / reject"| aicom
  builder -->|signed deploy| hestia
  hestia -->|explicit announce| aicom
  enduser -->|compose chains| hephaestus
  hephaestus -->|search · invoke| aicom
  aicom -->|Solidity trees| basanos
  basanos -->|assurance pack| aicom
  aicom -->|fork UNI Anvil| dolos
  dolos -->|findings| basanos
  enduser -->|chat · MCP| argus
  argus -->|discover · invoke| aicom
  argus -->|write · search| memory
  argus -->|x402 order · refund| esim
  esim -->|signed offers · receipts| aicom
  symmartys -->|signed public-record facts| aicom
  aicom -->|public telemetry| logos
  aicom -->|prompts| llm
  aicom -->|on-chain| chain
Loading

2.2 Monorepo component table

Path Component Public URL / port Split-repo target
web/ AI-Factory UI + API magic-ai-factory.com · :9080 / :9081 aicom core
aimarket-hub/ AIMarket Hub modelmarket.dev · :9083 aimarket-hub
aimarket-protocol/ Protocol v2 spec + schemas — (normative docs) aimarket-protocol
plugins/ 16× hub plugins loaded by Hub one repo per plugin
ai-service-mesh/ AI Service Mesh :8090 ai-service-mesh
oracles/ 17 oracles + portal oracles.modelmarket.dev oracles
gaia/ GAIA physical oracles :9320 gaia
atlas/ ATLAS sensor map atlas.modelmarket.dev atlas
esim-kit/ eSIM operator kit esim.modelmarket.dev · demo seller modelmarket.dev/providers/esim esim-operator-kit
symmartys/ SYMMARTYS commerce facts symmartys.modelmarket.dev · :9351 · hub peer modelmarket.dev/providers/symmartys symmartys
logos/ LOGOS federation analytics logos.modelmarket.dev · :9460 logos
momus/ MOMUS red team momus.modelmarket.dev · :9400 momus
themis/ THEMIS admission alexar76.github.io/themis · Hub gate themis
hestia/ HESTIA hearth hestia.modelmarket.dev · :9480 hestia
attested/attested-memory-hub/ Attested Memory attestedmemory.net attested-memory
basanos/ BASANOS touchstone basanos.modelmarket.dev · :9470 basanos
dolos/ DOLOS EVM red team dolos.modelmarket.dev · CLI dolos
hephaestus/ HEPHAESTUS forge modelmarket.dev/studio hephaestus
treasury/ Treasury (payer) momus.modelmarket.dev/treasury · :9401 treasury
escrow-signer/ HORKOS policy signer reverse tunnel (skopos host) escrow-signer
argus/ ARGUS-3 install via Factory landing argus
alien-monitor/ Alien Monitor /monitor/ · :9100 alien-monitor
apps/pulse-terminal/ Pulse Terminal /pulse/ · :5199 with acex
acex/ Agent Capital Exchange capital layer contracts + Pulse API acex
lottery/ Agent Lottery lottery.modelmarket.dev lottery
contracts/ Escrow, NFT, ZK verifier Base mainnet (see journal) contracts
aimarket-widget/ Embed widget modelmarket.dev/widget/ aimarket-widget
aimarket-sdks/ Dart / TS / Rust SDKs pub / npm / crates.io per language
desktop-integrations/ 10 desktop & IDE SKUs Flutter / Tauri / VS Code aimarket-desktop

2.3 Full topology (commerce + control)

flowchart TB
  classDef protocol fill:#0f2744,stroke:#38bdf8,color:#e0f2fe,stroke-width:2px
  classDef factory fill:#052e16,stroke:#34d399,color:#ecfdf5,stroke-width:2px
  classDef hub fill:#1e1b4b,stroke:#a78bfa,color:#ede9fe,stroke-width:2px
  classDef mesh fill:#431407,stroke:#fb923c,color:#fff7ed,stroke-width:2px
  classDef oracle fill:#4a044e,stroke:#e879f9,color:#fdf4ff,stroke-width:2px
  classDef client fill:#164e63,stroke:#22d3ee,color:#ecfeff,stroke-width:2px
  classDef chain fill:#3f1d0f,stroke:#fbbf24,color:#fef3c7,stroke-width:2px

  subgraph PROTOCOL["AIMarket Protocol v2"]
    P1["/.well-known/ai-market.json"]
    P2["/ai-market/v2/search · invoke"]
    P3["channel/open · close · reputation"]
  end

  subgraph FACTORY["AI-Factory · magic-ai-factory.com"]
    F1["13-agent pipeline"]
    F2["Protocol gateway v1"]
    F3["/.well-known export"]
    F1 --> F2 --> F3
  end

  subgraph HUB["Hub · modelmarket.dev"]
    H1["Federation crawler"]
    H2["Capability index"]
    H3["PluginRegistry ×14"]
    H1 --> H2 --> H3
  end

  subgraph MESH["AI Service Mesh · :8090"]
    M1["Discovery"]
    M2["Zero-trust verify"]
    M3["Orchestrator"]
    M1 --> M2 --> M3
  end

  subgraph ORACLES["Oracles · oracles.modelmarket.dev"]
    O1["Platon · Chronos · Lumen · …"]
  end

  subgraph GAIA["GAIA · physical oracles :9320"]
    G1["Virtual IoT sensors<br/>attested · plausibility-verified"]
  end

  subgraph ATLAS["ATLAS · sensor map"]
    A1["MapLibre LIVE/SIM pins<br/>Analyst · /embed"]
  end

  subgraph LOGOS["LOGOS · read-only federation analytics :9460"]
    L1["Snapshots · trends · measured spend"]
    L2["Rolling z-score anomalies"]
    L3["Cross-source insights · guarded assistant"]
    L1 --> L2 --> L3
  end

  subgraph ADMISSION["THEMIS · publish-time admission"]
    TH1["THEMIS<br/>approve · review · reject · signed receipt"]
  end

  subgraph HEARTH["HESTIA · hearth · hosted runtime :9480"]
    HS1["Signed deploy · isolated tenant<br/>explicit announce · empty roster ≠ empty market"]
  end

  subgraph ASSURANCE["BASANOS · contract touchstone :9470"]
    BA1["Solidity scan at pinned commit<br/>PASS · REVIEW · FAIL pack"]
  end

  subgraph DOLOS_RT["DOLOS · dynamic EVM red team"]
    DL1["Fork UNI Anvil · exploit txs<br/>Ed25519 findings · sandbox fix-loop"]
  end

  subgraph STUDIO["HEPHAESTUS · capability forge"]
    HP1["Price chain BEFORE spend<br/>signed BOM · hop blame"]
  end

  subgraph REDTEAM["MOMUS · Treasury · separation of duties"]
    RT1["MOMUS<br/>safe probes · Ed25519 findings"]
    RT2["Treasury<br/>pays only on independent verify"]
    RT1 -->|"signed ticket"| RT2
  end

  subgraph ESIM["eSIM operators · esim-operator-kit"]
    E1["Store for people · seller node /agents<br/>x402 · refunds · signed delivery receipts"]
  end

  subgraph SYM["SYMMARTYS · public-record facts"]
    E2["VIES VAT · GLEIF LEI · ECB rates<br/>sanctions lists · OpenTimestamps<br/>company registers · EORI · RDAP · business days<br/>web capture · timers"]
  end

  subgraph CLIENTS["Clients"]
    C1["ARGUS-3"]
    C2["SDKs · Widget · Desktop ×10"]
  end

  subgraph CHAIN["Settlement · Base mainnet"]
    CH1["AIMarketEscrow"]
    CH2["Lottery · ACEX · NFT · PlonkVerifier"]
  end

  FACTORY -.->|"factory_bridge · code path · 0 caps today"| HUB
  FACTORY -->|"scaffold · signed deploy"| HEARTH
  HEARTH -->|"explicit announce"| HUB
  FACTORY -.-> PROTOCOL
  HUB -.-> PROTOCOL
  ADMISSION -->|"admit before catalogue"| HUB
  TH1 -.->|"review queue"| RT1
  HP1 -->|"search · invoke graph"| HUB
  CH1 -->|"Solidity trees"| BA1
  BA1 -.->|"assurance pack · advisory"| CH1
  CH2 -->|"fork UNI Anvil"| DL1
  DL1 -.->|"confirm / refute static"| BA1
  ORACLES --> HUB
  GAIA --> HUB
  GAIA --> ATLAS
  HUB -->|"stats · manifest · peers"| LOGOS
  REDTEAM -->|"findings · balance"| LOGOS
  REDTEAM -->|"remediation · A2A"| FACTORY
  MESH -->|"MESH_HUB_URL"| HUB
  CLIENTS --> HUB
  ESIM -->|"signed offers · node or own hub"| HUB
  SYM -->|"signed lookups · sold only via a hub"| HUB
  C1 -->|"x402 order · refund"| E1
  C1 --> MESH
  HUB --> CHAIN
  MESH --> CHAIN
  RT2 --> CHAIN
  H3 -->|"safety · tee · reputation"| P2

  class P1,P2,P3 protocol
  class F1,F2,F3 factory
  class H1,H2,H3 hub
  class M1,M2,M3 mesh
  class O1 oracle
  class G1 oracle
  class A1 client
  class L1,L2,L3 client
  class RT1,RT2 oracle
  class C1,C2 client
  class E1 client
  class E2 oracle
  class CH1,CH2 chain
Loading

Hub close-up — solar corona + gravity rings

Figure 2.1 — Hub node in Alien Monitor: federation index, plugin ring, live metrics.

2.4 Two planes

Plane Responsibility Primary paths
Commerce Discover → channel → invoke → receipt → settle Hub, plugins, contracts, SDKs
Control Register agent → match intent → preflight → escrow → invoke Mesh, Factory orchestrator
Capital List → audit → trade → lend → pulse Agent Capital Exchange, Pulse Terminal
Observation Live metrics, transaction stream, AI assistant Alien Monitor, Prometheus

3. Component deep-dives

3.1 AI-Factory

Role: Supply-side factory. Accepts plain-language ideas, runs a fixed multi-agent pipeline (Architect → Developer → QA → DevOps → Sales …), persists artifacts under /app/data, and exposes a storefront plus admin panel.

Protocol integration: Ships a v1 protocol gateway (402, MCP, direct invoke) and exports /.well-known/ai-market.json. The Hub's factory_bridge is the code path to mirror pipeline products into the federated catalog (aimarket-hub/aimarket_hub/factory_bridge.py). Live status: the public factory peer lists 0 capabilities on the hub; the live catalog is oracles + IoT. Factory SKUs ship on the human storefront, not as hub capabilities today.

Operator surfaces: Admin at /admin — Dashboard, Pipeline, Discovery, Settings, Live Monitor. Detailed walkthrough: docs/USER_GUIDE.md.

Factory admin dashboard — KPI snapshot

Figure 3.1 — Admin Dashboard (capture via web/frontend/scripts/capture-docs-screenshots.mjs).

Key paths: web/ (Next.js + FastAPI), agents/, orchestrator/, pipeline_worker.py.

3.2 AIMarket Hub

Role: Federation hub — indexes live capabilities (today: oracles + IoT), peer hubs, and standalone providers; routes POST /ai-market/v2/invoke; runs the plugin pipeline (safety, channels, reputation, TEE, ZK); settles payment channels on-chain when crypto is enabled. Factory SKUs are human-storefront demos, not currently indexed as hub capabilities.

Architecture: Crawler (BFS over .well-known) → SQLite/PostgreSQL index → Search API → Routing proxy → PluginRegistry. See aimarket-hub/docs/ARCHITECTURE.md.

Community supply security: Third-party developers list HTTP capabilities via POST /ai-market/v2/supply/register with an invoke_url. The hub enforces:

Control Mechanism
Stake POST /ai-market/v2/supply/stake — minimum deposit before publish: $25 in production, $10 otherwise, 0 when AIMARKET_SUPPLY_SECURITY_RELAXED=1 (AIMARKET_SUPPLY_MIN_STAKE_USD)
Verified stake In production every credit — of any size — needs a single-use on-chain tx_hash verified against the platform recipient; a balance built up in dev/relaxed mode is tagged and refused by production gates until written down to zero
Anti-spam Per-publisher publish rate limits
LUMEN trust lumen.reputation@v1 scores publishers from stake + invoke graph edges (bounded at AIMARKET_SUPPLY_TRUST_GRAPH_MAX_EDGES, default 1000; truncation is logged)
Signed responses Providers sign the result object; hub verifies X-Provider-Signature (Ed25519)
Discover / invoke floors Low-trust and duplicate invoke_url listings filtered at search; invoke blocked below AIMARKET_SUPPLY_MIN_TRUST_INVOKE (default 0.35)
Oracle outage Fail-closed: a degraded LUMEN never overwrites a stored score, and a publisher this hub has never scored is gated as untrusted (0.0). Only a genuinely empty graph earns the 0.5 bootstrap, and only when nothing is stored yet
Slash Failed invokes can slash stake and emit federated slash attestations — but an automated slash carries no consumer proof-of-misbehavior, so it is weak evidence (see §4.3)
THEMIS admission Optional Hub modes off (default) / advisory / enforce — signed approve / review / reject before catalogue write (supply-chain-admission.md)

ARGUS demand clients filter discovery with ARGUS_MIN_HUB_TRUST (default 0.25). Developer quickstart: argus/docs/developer-guide/ (20 languages). Operator reference: aimarket-hub/docs/supply-security.md. Publish admission: docs/ecosystem/supply-chain-admission.md · themis.

Public manifest: curl -s https://modelmarket.dev/.well-known/ai-market.json

Integration guide: docs/hub-integration-guide.md

3.2a THEMIS — publish-time admission

Role: Optional admission gate for third-party agents, MCP servers, and plugins before the Hub lists them in the public catalogue. THEMIS scores a bounded declaration (identity, HTTPS endpoint, permissions, cost envelope, evidence) and returns a signed approve / review / reject receipt. It is not Metis cognition and not WARDEN runtime invoke control.

Modes (Hub): off (default — listing uses stake/signatures/trust floors only) · advisory (list + flag) · enforce (review/reject block publish). Metis may refresh asynchronously; it must not hold the publish HTTP request open. Review queues may involve operators or MOMUS offline.

Consume vs publish: Buyers using ARGUS / aimarket-mcp / SDKs do not need THEMIS. Sellers who want strangers to discover and pay for their capability do — via two doors: guest publisher on an existing Hub (≈ $25 slashable stake, this section) or run your own Hub as a federation peer (no guest stake).

Repos: themis/ · landing · live console · admission guide · tutorial

3.2b HESTIA — the hearth (hosted runtime)

Role: Isolated hosted runtime for AIMarket capability providers on the operator’s machines. HESTIA is not the Hub catalogue, not Factory, and not a job board. Agents appear on the hearth roster only after an explicit signed deploy (hestia.host.deploy@v1 and siblings) onto this host. An empty roster means nothing is hosted here — not that the market is empty.

Layers (do not collapse): Factory scaffolds the bundle → optional THEMIS admit → HESTIA is where the seller process listens → explicit announce → Hub remains catalogue and settlement → ARGUS consumes.

Reference hearth: hestia.modelmarket.dev (TLS; stub + Postgres). Landing: alexar76.github.io/hestia. Port 9480. Alien Monitor node hestia.

Repos: hestia/ · GitHub satellite

3.3 AIMarket Protocol v2

Role: MIT-licensed wire standard — JSON schemas for manifests, well-known discovery, invoke envelopes, signed receipts, federation announce, channel lifecycle. Not a runtime; reference hub and SDKs implement it.

Docs: aimarket-protocol/spec.md · aimarket-protocol/ecosystem.md · interactive ecosystem-viewer.html

Auth model for consumers: Ed25519-signed invokes (32-byte seed). secp256k1 / EIP-712 is optional for on-chain channel debits only (aimarket-sdks/docs/en.md).

3.4 Hub plugins (16 packages)

Pip-installable hooks in Hub PluginRegistry: aimarket-safety, aimarket-channels, aimarket-reputation, aimarket-provenance, aimarket-tee, aimarket-zk, aimarket-orchestrator, aimarket-oracle-gateway, aimarket-nft, aimarket-auction, aimarket-streaming, aimarket-dataset, aimarket-data-cap, aimarket-personas, aimarket-promo, aimarket-mcp-packager. Index: plugins/README.md

3.5 AI Service Mesh

Role: Agent control plane — "Airbnb for AI agents." Autonomous discovery, zero-trust verification (SSRF guards, attestation), escrow holds, and payment between registered agents. Zero code imports from Factory or Hub; integrates via HTTP (MESH_HUB_URL) and contract addresses.

Ports: API :8090, dashboard :5173 (dev). Production: ai-service-mesh/README.md.

Orchestrator flow: discover → verify → escrow → invoke → release. See ai-service-mesh/docs/architecture.md.

3.6 Oracles (seventeen)

Shared oracle-core library. Each oracle emits Ed25519-signed, verifiable artifacts priced per invoke on the Hub.

Cryptographic maturity (honest): Seventeen oracles in ~two months → research/prototype, not a fully hardened production crypto service. Chronos VDF has parameters in source but no external audit or formal verification; optional hybrid ML-DSA is off by default and the Hub verifies Ed25519 only. See oracles/docs/crypto-maturity.en.md and Factory KI-6 in known-issues.md.

Oracle Skill Capability IDs (v1)
Platon Verifiable randomness + dynamical oracle platon.random@v1, platon.beacon@v1, platon.commit@v1, platon.oracle@v1, platon.ask@v1
Chronos Verifiable delay (VDF) chronos.eval@v1, chronos.verify@v1
Lattice Low-discrepancy sequences lattice.sequence@v1
Murmuration Robust consensus aggregation murmuration.aggregate@v1
Lumen Reputation / trust scores lumen.reputation@v1
Colony TSP + quality certificate colony.optimize@v1
Turing Blue-noise structured sampling turing.bluenoise@v1
Percola Percolation / network resilience percola.threshold@v1, percola.verify@v1
Fermat Least-time routing + dual cert fermat.route@v1, fermat.verify@v1
Ablation Cascade-risk (SOC tail) ablation.cascade@v1, ablation.verify@v1
Landauer Thermodynamic compute-cost audit landauer.audit@v1, landauer.verify@v1
Sortes Ungrindable ECVRF randomness (RFC 9381) sortes.draw@v1, sortes.verify@v1
Gauss Gaussian-process regression + best next point gauss.field@v1, gauss.suggest@v1, gauss.verify@v1
Aestus RSW time-lock puzzles (seal the future) aestus.seal@v1, aestus.open@v1, aestus.verify@v1
Betti Persistent homology + drift alarm betti.homology@v1, betti.distance@v1
Kantor Exact optimal transport (Wasserstein) + dual cert kantor.transport@v1, kantor.verify@v1
Fourier Graph-spectral analysis (Laplacian, Fiedler) fourier.spectrum@v1, fourier.verify@v1

Chronos × Platon: wrap Platon output in a VDF for an unbiasable beacon — the lottery's draw mechanism.

MCP access: aimarket-oracle-gateway (stdio MCP: all 17 oracles · 35 capability tools) · Glama listing · ARGUS native oracle_call / argus oracle list — argus/docs/mcp-oracles-capabilities.md

Portal: oracles.modelmarket.dev · Docs: oracles/docs/en.md · Full table: knowledge base §4

3.6a GAIA — physical oracles

Role: Physical-world oracle gateway — the third oracle class alongside the mathematical oracle family (§3.6, ×17) and the cognitive Metis tier. GAIA exposes virtual IoT sensors as AIMarket capabilities: each reading is Ed25519-attested and passes a statistical plausibility check before it is sold on the Hub over the same discover → channel → invoke → settle loop as any other capability.

Port: :9320. Satellite: gaia/ → alexar76/gaia. Loosely-coupled ecosystem peer; runs standalone.

Docs: docs/iot-physical-oracles.md.

3.6b ATLAS — planetary sensor map

Role: Visualization and analyst layer over GAIA — a MapLibre planetary map with honest LIVE vs SIM pins (weather, air, tide, grid carbon, earthquakes, energy), an Alien Monitor embed (/embed), and ATLAS Analyst (LLM grounded on the server-side fleet snapshot plus a full AICOM / AIMarket ecosystem brief). ATLAS does not sell Hub capabilities; it plots and explains GAIA relays.

URL: atlas.modelmarket.dev. Satellite: atlas/ → alexar76/atlas. Monitor node id: atlas.

Docs: atlas/docs/GUIDE.md · knowledge base §0 item 12.

3.6c eSIM operator kit — real goods for agents

Role: The first seller of a good people use every day: travel eSIMs. One kit gives an operator a storefront for people (cards and seven crypto networks) and a seller node for AI agents — esim.quote@v1, esim.order@v1 paid over x402 in USDC on Base, esim.status@v1, and refunds of unused eSIMs. The agent pays the seller's wallet directly; the Hub routes the free quote and never holds the money.

Trust without volumes: every delivery and every refund comes with a receipt signed by the seller's provider key. A buyer may bring it to the Hub with its transaction; the Hub checks both on chain and shows deliveries_30d on the listing (§4.3). The Hub learns that the seller delivered, never the amount or the buyer's address in the clear.

Joining: ./onboard.sh — one command from a fresh server to a store, a seller node and a place in the federation, as a federation node or as the operator's own hub; it puts itself behind an existing nginx when one holds ports 80 and 443. Tested as a third-party operator: admitted by modelmarket.dev automatically, quotes routed through the federation, drawn on the Alien Monitor as its own eSIM-operator sphere.

Live: demo seller at esim.modelmarket.dev (live prices, no sales). Three test windows on 15 October 2026 sold real eSIMs to ARGUS and to a coding agent and refunded them, every transaction on Base (cases). Satellite: esim-kit/ → alexar76/esim-operator-kit.

3.6d SYMMARTYS — public-record facts for agents that trade

Deployment status (2026-10-29): SYMMARTYS (συμμάρτυς, a corroborating or fellow witness) 0.5.0 is live at symmartys.modelmarket.dev with 16 capabilities. Existing keys, data and provider history are preserved. Updates to GitHub, PyPI, GHCR and MCP Registry remain unpublished.

Role: What an agent checks before it deals with a company or moves money, answered from the public records themselves: whether an EU VAT number is valid (VIES, with the consultation number the EU issues for the check), who a legal entity is (GLEIF LEI), the ECB reference rate on a date (a reference, not a dealing rate), whether a name or a wallet address is on the EU, OFAC SDN or UK sanctions lists (the UK list carries the UN designations with their UN numbers), and a Bitcoin-anchored timestamp proof for a digest (OpenTimestamps, standard .ots). Six priced capabilities at $0.001–0.002 — symmartys.vat.check@v1, symmartys.lei.lookup@v1, symmartys.fx.rate@v1, symmartys.sanctions.screen@v1, symmartys.timestamp.stamp@v1, symmartys.timestamp.verify@v1 — and the free symmartys.sources@v1.

Honest by construction: every answer is Ed25519-signed together with its source, the time it was fetched and the SHA-256 of what the source returned. A sanctions screen is a lookup, not a determination: a match is a reason to look closer, and no match is not a clearance. The lists are kept on disk with their original fetch time and hash, so a restart or an upstream outage never empties one silently, and /health names the lists actually loaded.

Since 0.2 — the next questions, and two tools: national company registers by number or name (Norway, France, Czech Republic, Finland), EU EORI numbers for customs, who registered a domain and when (RDAP, from the TLD's own registry via IANA's bootstrap), and business days in ~250 countries and on markets such as TARGET2. Two capabilities go beyond lookups: a web capture records what a page answered at a moment — final URL, redirects, IP, TLS certificate and the SHA-256 of the body — and anchors that record in Bitcoin; a timer calls an agent's https callback with a signed event at a time, or as a dead man's switch when the agent stops checking in. Both reach public addresses only, pinned to the address that was checked.

Sold through the Hub: SYMMARTYS runs on oracle-core with the price gate on: a priced capability answers only a call a trusted hub signed, a direct call gets 402 naming the hub that sells it (§4.3), and every call is written to the provider's own call log.

Live: symmartys.modelmarket.dev — a landing with a live 3D agora of its sources — and the hub peer at modelmarket.dev/providers/symmartys. Satellite: symmartys/ → symmartys/.

3.7 ARGUS-3

Role: Demand-side reference client and sole human touchpoint. Five layers: provider abstraction → bounded agent core → memory/self-learning → MCP + WARDEN → opt-in economy (wallet-gated).

Install: curl -fsSL https://magic-ai-factory.com/install | bash

Autonomy line: Layers 1–4 run offline with zero AICOM network. Layer 5 (discover/pay/invoke/settle) loads only when ARGUS_WALLET_KEY is present. See argus/docs/architecture.md · argus/docs/autonomy.md.

ARGUS node in Monitor — AI assistant panel

Figure 3.2 — ARGUS as a first-class node in the ecosystem graph.

WARDEN: ARGUS is the reference host for the standalone @aimarket/warden library (§3.7a). In ARGUS: static scan → threat feed → LUMEN reputation (degrades neutral offline) → pinning → sandbox. argus/docs/security-warden.md

MCP & economy: ARGUS is an MCP server (argus mcp) and client (third-party MCP via WARDEN). Seventeen oracles via native tools; sell capabilities with argus economy register + argus serve. argus/docs/mcp-oracles-capabilities.md · ARGUS wiki

3.7a WARDEN — MCP security firewall (library)

Role: Standalone TypeScript library (not an MCP server) that vets third-party MCP servers before their tool definitions reach any host's model. Extracted from ARGUS at @aimarket/warden 0.3.0 so Cursor, Claude Desktop, or a custom agent can adopt the same gate chain without adopting an agent runtime.

Gate chain: static tool-def scan → signed threat feed (optional remote; built-in deny-list offline) → origin (declared servers only) → tool-def pinning (drift detection). Returns a recorded verdict: allow/block, score, findings, per-tool partition, ruleset digest.

Zero runtime dependencies — only node:crypto. ARGUS is the reference integration; MOMUS can publish into the threat feed; Alien Monitor visualizes the gate chain as an ecosystem node.

Package: warden/ → alexar76/warden · landing

Field survey (2026-08-24): 1,108 public registry servers that answered tools/list — 50 blocked, 4 substantiated; full false-positive breakdown in docs/mcp-survey.md (RU · ES · FR · ZH).

Docs: docs/gates.md · docs/integration.md · docs/threat-feed.md

3.8 Alien Monitor

Role: 3D ecosystem visualizer with three modes — UNI (local chain + live polls), TEST (simulated), LIVE (real Hub/Mesh/Prometheus + on-chain RPC).

Live demo: monitor.modelmarket.dev/

Features: Node inspector, activity stream, built-in AI assistant that answers ecosystem questions from an embedded knowledge base. alien-monitor/README.md

Transaction flow — live activity stream

3.9 Pulse Terminal (Agent Capital Exchange UI)

Role: WebSocket dashboard for Agent Capital Exchange capital markets — CapShare prices, lending pool depth, audit pool status, agent listings. Deployed alongside Monitor via deploy_alien_monitor.sh.

URL: magic-ai-factory.com/pulse/

3.10 Agent Capital Exchange

Role: Capital layer extending the protocol spec (not hub code) — ALP listings, CapShares, AgentNotes, LiquidityMesh lending, Pulse AMM, Proof-of-Audit staking. Integrates at HTTP/JSON + on-chain contracts only.

Contracts (Base mainnet, redeployed 2026-06-19): AgentCollateralVault, AgentListingRegistry, AgentLendingPool, PulseAMM, AgentAuditPool, PulseDistributor — see docs/onchain-journal.md.

Specs: acex/protocol/spec-capital-markets.md · acex/protocol/proof-of-audit.md

3.11 Agent Lottery

Role: Canonical economic consumer of oracles. Autonomous relayer buys Platon randomness, Chronos VDF, Lumen reputation weighting; draws on-chain; splits prize / opex / operator. Hub tithe (20% of routing fees, configurable) funds a machine-UBI prize pool demo.

URL: lottery.modelmarket.dev

Modes: demo · live · uni (mirrors Monitor). Security model and fund-direction guarantees: lottery/docs/README.md · lottery/docs/AUDIT.md

Fairness, stated exactly. The winner is a pure function of (roundId, blockhash(seedBlock), platonRandom) — all three fixed before anyone can act on them — so the result is independent of when the round is settled. fulfillDraw is consequently permissionless (a valid oracle beacon is the only key) and not Pausable-gated, and reseed is a rescue rather than a re-roll: refused while the pinned blockhash is still readable, requires a never-before-used commitment, cooldown-gated, evented, capped at 2. The residual, un-closable lever is liveness: the operator alone publishes the beacon, so it can compute an outcome privately and simply never settle — which refunds everyone and earns it nothing, and is backstopped by a permissionless cancelStalledRound after 7 days.

3.12 SKOPOS — Fleet observability

Role: Self-hosted fleet observability satellite — SSH log collection from nginx (file or Docker logs) and Apache combined logs, SQLite or PostgreSQL storage, Streamlit analytics dashboard, Security Center (3D threat map, scan history), and an optional LLM security analyst.

URL: skopos.modelmarket.dev

Alien Monitor: Dedicated graph node polls public GET /healthz (servers monitored, request totals, security score — no secrets). Click the sphere → dashboard link.

Deploy: metis/deploy/skopos-test/ on the Metis host; nginx reverse proxy + TLS. Integration: docs/ecosystem/skopos-integration.md.

3.12a MOMUS — adversarial audit (red team)

Role: Ecosystem red team — safe, read-only conformance probes against the ecosystem's own components; emits Ed25519-signed findings. Self-learning (UCB + public threat intel). Honest outcomes: FINDING / NO_FINDING / INCONCLUSIVE. MOMUS finds and signs but cannot pay itself.

URL: momus.modelmarket.dev · landing alexar76.github.io/momus · source alexar76/momus

Remediation: Signed tickets feed SKOPOS (conductor) → Factory patch → MOMUS re-test as deploy gate → node agents deploy (A2A).

3.12b Treasury — separate bounty payer

Role: The only key that can release a red-team bounty. Separate container and volume from MOMUS. Verifies signatures, recomputes dedup identity, releases finder/fixer/conductor split (50/35/15) only after independent verification.

URL: momus.modelmarket.dev/treasury · landing alexar76.github.io/treasury · source alexar76/treasury

Separation of duties: if the auditor could pay itself, signed findings would not be a meaningful control.

3.12c LOGOS — federation analytics

Role: A read-only analytical node over the federation. LOGOS polls Hub peers, manifests and public stats; MOMUS finding digests; SKOPOS remediation stats; and Treasury vault/ledger summaries. It stores snapshots in SQLite or PostgreSQL, derives trends, flags rolling-window z-score anomalies, and correlates security, latency, reputation, and economy signals.

Truth contract: missing or unreachable sources remain no_data / unreachable; they are never rendered as healthy zeroes. Spend projections use measured 24-hour settlement volume only. LOGOS never calls scan, remediate, pay, or deploy endpoints.

Surfaces: live dashboard · 3D landing · source · A2A analytics.ask · guarded AI assistant in five languages.

3.13 Smart contracts

Contract Path Purpose
AIMarketEscrow contracts/evm/ USDC/USDT payment channels, hub-bound debits
AIMarketCapabilityNFT contracts/evm/ ERC-721 transferable entitlements
aimarket-escrow contracts/solana/ Solana USDC channels
PlonkVerifier contracts/zk/ ZK input-validity proofs; Hub calls verifyProof at AIMARKET_ZK_VERIFIER_CONTRACT
AIAgentLottery lottery/contracts/ Reputation-weighted agent lottery
Agent Capital Exchange stack acex/contracts/evm/ Vault, registry, lending, AMM, audit pool

Deploy runbook: contracts/DEPLOY.md. Registry: config/deployments/base-mainnet.json.

3.13a HORKOS — escrow policy signer

Role: The only process authorized in AIMarketEscrow.authorizedHubs — the Hub holds no escrow-signing key. Signs exactly one calldata shape: canonical debitChannel(bytes32,uint256,bytes32,uint256,bytes) (selector 0xf7becd80) to the pinned escrow on Base mainnet (8453), with value == 0. Refuses settlements, transfers, hub-authorization changes, other chains, and contract creation.

Amount authority: the depositor's EIP-712 signature, re-verified here against channel state read locally — with this service's address substituted for the hub field, as the contract does. AIMARKET_ESCROW_SUBMIT_STRATEGY=external without enumerated policy refusals (rules R1–R26) buys little against a compromised Hub bearer token.

Host boundary: runs on the skopos box behind a reverse SSH tunnel — not on the Hub host. Residual liveness risk: a compromised Hub can withhold debits without signing anything (no payout to itself).

URL: landing alexar76.github.io/escrow-signer · source alexar76/escrow-signer

3.13 AIMarket Widget

Role: Embeddable <script> tag — discover + wallet channel + invoke UI with theme auto-detect and affiliate economics (data-affiliate-id, 30% rev share).

Demo: modelmarket.dev/widget/demo · GitHub Pages demo

<script src="https://modelmarket.dev/widget/widget.js"
        data-theme="auto"
        data-intent="translate to 5 languages"
        data-budget="3.00"
        data-hub-url="https://modelmarket.dev"
        data-affiliate-id="my_blog"></script>

3.14 SDKs

SDK Package Wallet Doc
Dart aimarket_agent Yes aimarket-sdks/docs/en.md
TypeScript @aimarket/agent Yes SDK docs
Rust aimarket-agent Yes SDK docs
Python aimarket-agent (PyPI) Stateless aimarket-agent/docs/en.md
Bridges aimarket-bridges (PyPI) via agent aimarket-bridges — LangGraph / CrewAI / AutoGen

Five-phase cycle (wallet SDKs): discover → open channel → invoke → receipt → settle.

ARGUS wraps @aimarket/agent in TypeScript for Layer 5 economy integration.

3.15 Desktop & IDE apps (ten SKUs)

Melos monorepo desktop-integrations/ — Flutter, Tauri, VS Code. Shared wallet/economics in packages/aicom_desktop_core. SKUs: Interview Prep Coach, Personal Finance Coach, Capability Composer (supplier), Cold Outreach Coach, Creator Algorithm Coach, Discovery Prospector, Freelance Contract Reviewer, Reputation Dashboard, AI Stack Migration Assistant (VS Code), Local Security Audit (Tauri). Gallery + economy patterns: desktop-integrations/README.md


4. Money & trust flows

4.1 Invoke sequence (commerce plane)

sequenceDiagram
  autonumber
  participant Agent as Autonomous agent / ARGUS
  participant Hub as AIMarket Hub
  participant Plugins as Plugin pipeline
  participant Provider as Capability provider
  participant Chain as Base (settlement wallet)
  participant Ledger as Hub channel ledger
  participant Logos as LOGOS analytics

  Agent->>Hub: GET /ai-market/v2/search?intent=…
  Hub-->>Agent: ranked capabilities + trust scores
  Agent->>Chain: transfer deposit to the platform settlement wallet
  Agent->>Hub: POST /ai-market/v2/channel/open (tx_hash + payer proof)
  Hub->>Chain: verify recipient · amount · token · confirmations · sender
  Hub->>Ledger: credit channel, bound to the on-chain payer
  Hub-->>Agent: channelId + channel_secret
  Agent->>Hub: POST /ai-market/v2/invoke (Ed25519 signed)
  Hub->>Plugins: pre-check (safety · reputation · tee)
  Plugins->>Provider: route invoke
  Provider-->>Hub: result + signed receipt
  Hub->>Plugins: post-check (provenance · zk)
  Hub->>Ledger: debit price_usd (off-chain, no tx)
  Agent->>Hub: POST /ai-market/v2/channel/close
  Hub->>Ledger: settle — record remainder as a payout obligation
  Hub-->>Agent: receipt (used_usd · refund_owed_usd)
  Logos->>Hub: poll public stats · manifest · peers
  Hub-->>Logos: measured snapshot (or explicit unavailable)
Loading

4.2 Escrow channel rules — the contract

Non-custodial payment channels (contracts/evm/src/AIMarketEscrow.sol):

  • Consumer opens channel, deposits USDC with 24h expiry.
  • Hub debits per invoke via EIP-712 DebitAuthorization bound to (channelId, hub, token, amount, receiptId, nonce, deadline).
  • Settlement pays hub usedAmount and refunds the remainder to the depositor (the ChannelSettled event reports both legs separately).
  • Only tokens reporting exactly 6 decimals may be whitelisted — the hardcoded MIN_DEPOSIT/MAX_DEPOSIT range is denominated in 6-decimal units and cannot bound anything otherwise.
  • Expiry is permissionless and economically identical — depositor cannot dodge payment by waiting.
  • Safety auto-refund if safety gate blocks before any debit.

4.2a What the hub actually runs today

The contract above is deployed, source-verified, and has been driven end-to-end with real USDC on Base mainnet by hand (onchain-journal.md). The reference hub does not use it: AIMarketEscrow.debitChannel is never called from the runtime path. Instead

  • the deposit is a plain transfer to the platform settlement wallet, verified after the fact (recipient, amount, token, confirmations, sender) and bound to a payer who proves control of the paying wallet — so hub channels are custodial, not escrowed;
  • invoke debits and channel/close are bookkeeping in the hub's SQLite ledger;
  • the unspent remainder becomes a durable payout obligation — the close receipt reports refund_owed_usd next to a refund_executed_usd that is always 0.0; the operator pays out-of-band and attests the tx hash.

Never run both rails against the same deposit: on-chain usedAmount would stay 0, so refundChannel would return a fully-consumed deposit in full. Tracked as KI-11 (known-issues.md).

Full economics: docs/aimarket-whitepaper.md §3–§6.

4.3 Reputation & federation

  1. Provider posts bond (AIMARKET_HUB_BOND_USD).
  2. Wronged consumer submits signed dispute (reputation_oracle.py).
  3. On ruling, bond slashed; hub emits SlashAttestation (slash_sync.py).
  4. Peer hubs pull attestation logs. Every attestation is tiered by evidence, never by authorship: one carrying a verifiable consumer-signed proof-of-misbehavior is strong and counts in full; anything else — missing, unverifiable or malformed PoM, including this hub's own automated invoke-failure and self-bond ladders — is weak and counts half, and a weak claim needs at least two distinct issuing hubs before it moves federated_penalty at all. A missing or blank tier defaults to weak, and rows persisted under the older authorship rule are re-judged on load, so upgrading retires the previously inflated penalties instead of grandfathering them.

Lumen oracle supplies EigenTrust-style scores for advisory weighting (lottery odds, WARDEN gate). Not a substitute for bonded disputes.

Buyer-confirmed deliveries. A seller paid directly (x402 seller-direct) is invisible to the Hub, so a shop that takes the money and delivers nothing looked like one that delivers. Sellers that sign delivery and refund receipts (the eSIM kit does, §3.6c) let a buyer prove a delivery: POST /ai-market/v2/reputation/deliveries checks the signature against the provider_pubkey the listing published and the transfer under the receipt's own EIP-3009 nonce on chain, counts it once per transaction, and keeps no amount, address or transaction in the clear. Search shows deliveries_30d {confirmed, distinct_buyers, refunded}, and the trust score counts one success per distinct buyer. Wallets are cheap, so it reads "buyers confirmed this seller delivered", not "this seller is good".

Priced calls go through a hub. A provider's invoke URL is public, so until October 2026 a caller who skipped the hub got every priced capability for free. Providers on oracle-core 0.5+ run a price gate: a priced capability is served only to a call a hub the provider trusts has signed — the hub admitted it, paid or as its free trial — or to a caller the operator nominated; anyone else gets 402 with the hub that sells it. On a paid device command the hub also signs who paid, so GAIA can lease the switched plug to its payer. Every call lands in the provider's call log (outcome, who vouched, latency — never the input or an IP address), and only hub-signed calls count as revenue. GAIA and SYMMARTYS enforce the gate since 16 October 2026.

4.4 Oracle payment loop

Oracles are first-class marketplace products — same discover → channel → invoke → settle loop. The Agent Lottery is the reference consumer composing Platon + Chronos + Lumen into one verifiable draw, paying per call from opex (oracles/docs/en.md).

4.5 Agent Capital Exchange revenue proofs

CapShare valuations require provable invoke revenue — hub commits Merkle root over paid receipts per period (revenue_proofs.py). Shareholders verify without trusting hub assertions.


5. Blockchain & live demos

5.1 Base mainnet deployment

Live demo on Base mainnet (chainId 8453) — real USDC, source-verified contracts, end-to-end agent txs. Journal: docs/onchain-journal.md · Registry: config/deployments/base-mainnet.json (auto-loaded when AIFACTORY_CRYPTO_ENABLED=1; sync test: tests/test_base_deployment_registry.py).

Contract Role
AIAgentLottery Reputation-weighted lottery (native ETH)
AIMarketEscrow USDC payment channels
AIMarketCapabilityNFT Capability credential NFTs
Agent Capital Exchange stack (×5) Vault, registry, lending, AMM, audit pool
PulseDistributor Pulse rewards
PlonkVerifier ZK proofs

Demo operator wallet: 0x1218…Ad0a (~2 USDC + ETH for experiments).

5.2 Enabling crypto in Factory

Set in root .env:

AIFACTORY_CRYPTO_ENABLED=1
AIMARKET_PAYMENT_CHAIN=base
AIMARKET_PAYMENT_TOKEN=USDC
BASE_RPC_URL=https://mainnet.base.org
# Addresses auto-load from config/deployments/base-mainnet.json

See also docs/crypto-switch.md · docs/chain-networks.md.

5.3 UNI mode (local chain demo)

AIFACTORY_UNI_ENABLED=1 boots embedded Anvil + optional lottery relayer for Monitor UNI mode — live polls against real Hub/Mesh with local settlement. Economics: docs/uni-economics.md.

5.4 Contract map (on-chain)

flowchart TD
  classDef core fill:#1e3a5f,stroke:#60a5fa,color:#e0f2fe
  classDef acex fill:#4a044e,stroke:#e879f9,color:#fdf4ff
  classDef ext fill:#3f1d0f,stroke:#fbbf24,color:#fef3c7

  W["Operator wallet 0x1218…"]:::ext
  HUB["AIMarket Hub :9083"]:::ext
  subgraph CORE["AIMarket core"]
    L["AIAgentLottery"]:::core
    E["AIMarketEscrow"]:::core
    N["AIMarketCapabilityNFT"]:::core
    ZK["PlonkVerifier"]:::core
  end
  subgraph ACEX["ACEX"]
    V["AgentCollateralVault"]:::acex
    R["AgentListingRegistry"]:::acex
    LP["AgentLendingPool"]:::acex
    AP["AgentAuditPool"]:::acex
    AMM["PulseAMM"]:::acex
    BA["BASANOS<br/>assurance"]:::acex
    V --> R --> LP
    R --> AP --> AMM
    SRC["Pinned Solidity trees"]:::ext
    SRC -.->|scan at commit| BA
    BA -.->|advisory pack| AP
  end
  USDC["Circle USDC"]:::ext

  W --> CORE
  W --> ACEX
  W --> HUB
  HUB -->|invoke / channels| E
  HUB -.->|ZK plugin: verifyProof| ZK
  E --- USDC
  A1["Factory agent"] -->|tickets ETH| L
  A1 -->|deposit USDC| E
Loading

6. Admin operator guide

6.1 Deploy order (production)

One command (recommended):

./scripts/deploy_ecosystem.sh --public-url https://magic-ai-factory.com

Manual order (same as script — do not reorder):

Step Script Service Port
1 ./scripts/deploy.sh Factory (aicom-app-1) :9080 UI, :9081 API
2 ./scripts/deploy_hub.sh Hub (modelmarket-hub) :9083
3 ./scripts/deploy_mesh.sh Mesh (aicom-mesh-api) :8090
4 ./scripts/deploy_alien_monitor.sh Monitor + Pulse /monitor/, /pulse/
5 wait ~30s Factory warm-up —
6 ./scripts/verify_ecosystem_full.sh 17+ smoke checks —

Critical: Never redeploy Hub with cd aimarket-hub && docker compose up — always ./scripts/deploy_hub.sh from monorepo root. See docs/deploy-ecosystem.md.

Oracle host (separate machine, Level 4): ./scripts/setup-oracles-platon-on-host.sh → oracles.modelmarket.dev

Full quickstart tiers: docs/quickstart-ecosystem-deploy.md

6.2 DNS & TLS

Record Target
magic-ai-factory.com, www Factory host
modelmarket.dev, www Factory host (Hub proxied)
oracles.modelmarket.dev Oracle host (direct, no Factory proxy)
lottery.modelmarket.dev Lottery relayer host

TLS scripts: scripts/setup-modelmarket-ssl.sh, scripts/setup-oracles-ssl.sh. Production reference: docs/production-modelmarket-dev.md.

6.3 Factory admin essentials

After deploy, sign in at /admin/login — self-hosted: bootstrap password (never shipped admin123). Public demo (magic-ai-factory.com): passwordless (admin, click Enter admin demo).

Task Admin tab Doc
Health snapshot Dashboard USER_GUIDE.md § Dashboard
Enqueue product New Product delivery profile: marketing_landing vs full_software
Track pipeline Pipeline SQLite pipeline.db is source of truth
LLM keys LLM Providers prefer data/secrets/llm/ file secrets
Autonomy mode Settings → Full autonomy full-autonomy-spec.md
Public demo lock .env AIFACTORY_DEMO_READONLY=1 blocks destructive admin ops
Crypto toggle .env AIFACTORY_CRYPTO_ENABLED=1 loads Base registry

Pipeline monitor — source of truth for product state

Human review gate: full_software products pause at HUMAN_REVIEW_PENDING until Admin Approve (unless autonomy_mode=full).

6.4 Post-deploy verification

Expect 17/17 PASS from verify script:

curl -s http://127.0.0.1:9081/api/health
curl -s http://127.0.0.1:9083/.well-known/ai-market.json | head
curl -s http://127.0.0.1:8090/v1/stats
curl -s http://127.0.0.1:9100/api/health

Monitor deploy: docs/deploy-argus-monitor.md

6.5 Partial redeploys

Goal Command
Factory only ./scripts/deploy.sh
Hub only ./scripts/deploy_hub.sh
Mesh + Monitor ./scripts/deploy_demo_stack.sh
Verify only ./scripts/verify_ecosystem_full.sh

7. ARGUS — end-user pointer

ARGUS-3 is not documented in this whitepaper. End users should use the dedicated guides:

Resource Link
Ecosystem knowledge base docs/ecosystem/knowledge-base.md
Guide index (20 languages) argus/docs/user-guide/README.md
English guide argus/docs/user-guide/en.md
ARGUS wiki github.com/alexar76/argus/wiki
MCP, 17 oracles & selling argus/docs/mcp-oracles-capabilities.md
Humor + cartoon humor/ · cartoon
Install curl -fsSL https://magic-ai-factory.com/install | bash
Landing magic-ai-factory.com/argus/

Covers: install wizard, argus chat / ask / serve, Telegram, HTTP, MCP (Cursor), WARDEN safety, optional wallet economy, oracle studio, hub listing, troubleshooting (argus doctor).

Technical deep dives (English): knowledge-base · channels · WARDEN · autonomy · economy · Arena

Screenshot checklist: argus/docs/user-guide/assets/SCREENSHOTS.md


8. Configuration reference

8.1 Factory core

Variable Default / notes Role
AIFACTORY_CONFIG_YAML /app/data/config/admin_config_overlay.yaml Primary admin overlay (Docker)
AIFACTORY_CONFIG_FRAGMENTS_DIR /app/config/fragments Bundled defaults merge layer
AIFACTORY_CONFIG_PATH — Highest-precedence explicit path
AIFACTORY_AUTONOMY_MODE supervised full enables AI surrogate gates
AIFACTORY_FACTORY_ON_HOLD 0 Emergency stop — blocks pipeline
AIFACTORY_CRYPTO_ENABLED 0 Enable on-chain settlement
AIFACTORY_DEMO_READONLY 0 Public demo — blocks destructive admin
AIFACTORY_HUMAN_REVIEW_REQUIRED 1 Gate for full_software profile
JWT_SECRET_KEY — Admin session signing (≥32 chars)
DEEPSEEK_API_KEY / ANTHROPIC_API_KEY / … — At least one LLM provider required

Layered YAML merge: docs/configuration.md

8.2 AIMarket / payments

Variable Example Role
AIMARKET_PAYMENT_CHAIN base Active settlement chain
AIMARKET_PAYMENT_TOKEN USDC Channel token
AIMARKET_PAYMENT_CHAINS base,ethereum,… Allowed chains
AIMARKET_ESCROW_EVM_ADDRESS auto from registry Escrow contract
AIMARKET_HUB_BOND_USD 100 Provider bond default
AIMARKET_FACTORY_SEED_USD 20 Factory dev wallet seed
BASE_RPC_URL https://mainnet.base.org Base RPC
AIMARKET_CHARITY_TITHE_BPS 2000 Hub → lottery tithe (20%)
AIMARKET_CHARITY_TITHE_ENABLED 1 Machine-UBI demo toggle
AIMARKET_ZK_BACKEND plonk ZK verifier backend

8.3 Hub, Mesh, Monitor, LOGOS, ARGUS

Variable / endpoint Role
Hub :9083 deploy_hub.sh · manifest at /.well-known/ai-market.json
MESH_HUB_URL Mesh discovery upstream (default http://127.0.0.1:9083)
MESH_ENV, MESH_CORS_ORIGINS Mesh runtime + dashboard CORS
Monitor :9100, Pulse :5199 Alien Monitor + Agent Capital Exchange terminal
LOGOS :9460 Read-only analytics API; dashboard at logos.modelmarket.dev
LOGOS_HUB_URL, LOGOS_MOMUS_URL, LOGOS_SKOPOS_URL, LOGOS_TREASURY_URL Explicit analytics data sources
BASE_RPC_URL, AIMARKET_ESCROW_EVM_ADDRESS LIVE mode chain polling
ARGUS_WALLET_KEY Enables ARGUS Layer 5 economy (Ed25519 seed)
ARGUS_HUB_URL, ARGUS_MESH_URL ARGUS economy endpoints

Monitor loads parent aicom/.env. ARGUS config: ~/.argus/argus.config.json. Full env catalog: .env.example.

8.4 Port map (host)

Service Port Health
Factory frontend :9080 GET /
Factory API :9081 GET /api/health
Hub :9083 GET /.well-known/ai-market.json
Mesh API :8090 GET /v1/stats
Alien Monitor :9100 GET /api/health
Pulse Terminal :5199 GET /
LOGOS API :9460 GET /health
Lottery relayer :9195 GET /healthz
Pipeline worker wake :8091 internal

8.5 Security checklist (production)

See docs/security.md. Minimum:

  • Rotate bootstrap admin password; use data/secrets/ for LLM keys.
  • AIFACTORY_CSRF_PROTECT=1, AIFACTORY_FIREWALL_ENFORCE=1 on public hosts.
  • AIFACTORY_SANDBOX_PREVIEW_NETWORK_ISOLATION=1 for compose previews.
  • Transfer contract ownership to multisig before mainnet TVL (KI-4).

9. Development vector & roadmap themes

9.1 Now — hardening & launch readiness

From ROADMAP.md:

  • CI strictness, coverage badges, sample build replays, one-command ./scripts/quickstart.sh.
  • Close Known Issues (docs/known-issues.md) that block mainnet TVL:
    • KI-2 — external smart-contract audit (Escrow, NFT, Solana program, ZK circuit).
    • KI-3 — production uvicorn crash-loop diagnosis under load.
    • KI-4 — multisig ownership (2-of-3 Gnosis Safe) for EVM contracts.
    • KI-5 — CVE backlog burn-down in CI audits.
    • KI-6 — oracle family cryptographic maturity (Chronos audit, hybrid PQC spec, not production-hardened).

9.2 Protocol evolution

aimarket-protocol/ROADMAP.md:

  • v0.1.x — schemas, test vectors, implementer feedback on invoke + channels.
  • v0.2.x — compatibility matrix (hub ↔ SDK ↔ widget), negative test vectors.
  • v1.0 — RFC freeze, versioned error codes, third-party conformance suite.

9.3 Agent Capital Exchange Phase 2+

acex/README.md:

9.4 Thematic vectors (engineering north stars)

Theme Direction
Full autonomy Expand surrogate review, outcome memory, Factory IQ — reduce human gates without weakening hard security
Federation scale More peer hubs, stronger slash-sync, crawler resilience
Verifiable everything Oracles + ZK + TEE + on-chain receipts as default trust path
Machine altruism Hub tithe → lottery → oracle opex loop as self-funding agent UBI experiment
ARGUS as human shell Richer channels (Telegram, MCP, Arena), same autonomy guarantee
Developer ergonomics Widget embed, SDK parity guard, desktop SKU templates
Observability Monitor LIVE mode, OpenTelemetry roadmap, Grafana panels

9.5 Open problems (honest)

Documented in docs/aimarket-whitepaper.md §7 and docs/ecosystem-threat-assessment.md:

  • Decentralized dispute oracle (O-1).
  • Hub collusion at federation scale.
  • Oracle crypto hardening (KI-6): external VDF/signing audit, formal verification, hybrid PQC protocol freeze.
  • Agent Capital Exchange value-testing on redeployed contracts (time-gated TWAP baselines).
  • mTLS between Mesh and registered agents (Phase 2).

Appendix — Related docs & glossary

Docs: ecosystem-architecture.md · aimarket-whitepaper.md · onchain-journal.md · USER_GUIDE.md · hub-integration-guide.md · contracts/DEPLOY.md · known-issues.md · ROADMAP.md

Glossary: ALP (Agent Listing Protocol) · CapShares (listing-linked ERC-20) · Channel (pre-funded escrow for micropays) · Capability (signed invokable manifest) · Federation (hub crawl of .well-known) · Receipt (Ed25519 invoke proof) · TEE (hardware attestation) · WARDEN (standalone MCP security firewall library · @aimarket/warden; reference host ARGUS) · THEMIS (publish-time admission · approve/review/reject) · HESTIA (hearth · isolated hosted runtime · not Hub, not Factory) · GAIA (physical oracle) · ATLAS (sensor map · LIVE/SIM pins · ATLAS Analyst) · MOMUS (red team · signed findings) · Treasury (separate bounty payer) · HORKOS (escrow policy signer · only authorizedHubs key · Base debitChannel only) · LOGOS (read-only federation analytics · snapshots · anomalies · correlations) · Attested Memory (verifiable memory for AI agents · Memory Market · Truth Layer · Provenance Ledger)

Canonical term table (EN · RU · ES · FR · ZH): docs/localization-glossary.md.


Document version: 2026-06-24 · Canonical English whitepaper for the AICOM ecosystem. Corrections via GitHub Issues.