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 |
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 |
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.
Software production and software consumption are decoupling into two machine-native loops:
- 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.
- 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).
| 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
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.
| 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 |
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
| 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 |
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
Figure 2.1 — Hub node in Alien Monitor: federation index, plugin ring, live metrics.
| 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 |
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.
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.
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
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
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
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).
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
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.
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.mdand Factory KI-6 inknown-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
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.
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.
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.
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/.
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.
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
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
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
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/
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
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.
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.
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.
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.
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).
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.
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.
| 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.
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
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>| 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.
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
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)
Non-custodial payment channels (contracts/evm/src/AIMarketEscrow.sol):
- Consumer opens channel, deposits USDC with 24h expiry.
- Hub debits per invoke via EIP-712
DebitAuthorizationbound to(channelId, hub, token, amount, receiptId, nonce, deadline). - Settlement pays hub
usedAmountand refunds the remainder to the depositor (theChannelSettledevent reports both legs separately). - Only tokens reporting exactly 6 decimals may be whitelisted — the hardcoded
MIN_DEPOSIT/MAX_DEPOSITrange 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.
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/closeare bookkeeping in the hub's SQLite ledger; - the unspent remainder becomes a durable payout obligation — the close receipt reports
refund_owed_usdnext to arefund_executed_usdthat is always0.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.
- Provider posts bond (
AIMARKET_HUB_BOND_USD). - Wronged consumer submits signed dispute (
reputation_oracle.py). - On ruling, bond slashed; hub emits SlashAttestation (
slash_sync.py). - 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_penaltyat 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.
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).
CapShare valuations require provable invoke revenue — hub commits Merkle root over paid receipts per period (revenue_proofs.py). Shareholders verify without trusting hub assertions.
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).
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.jsonSee also docs/crypto-switch.md · docs/chain-networks.md.
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.
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
One command (recommended):
./scripts/deploy_ecosystem.sh --public-url https://magic-ai-factory.comManual 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
| 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.
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 |
Human review gate: full_software products pause at HUMAN_REVIEW_PENDING until Admin Approve (unless autonomy_mode=full).
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/healthMonitor deploy: docs/deploy-argus-monitor.md
| 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 |
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
| 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
| 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 |
| 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.
| 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 |
See docs/security.md. Minimum:
- Rotate bootstrap admin password; use
data/secrets/for LLM keys. AIFACTORY_CSRF_PROTECT=1,AIFACTORY_FIREWALL_ENFORCE=1on public hosts.AIFACTORY_SANDBOX_PREVIEW_NETWORK_ISOLATION=1for compose previews.- Transfer contract ownership to multisig before mainnet TVL (KI-4).
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).
- 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.
- CapSense Options (Solana shipped), Pulse pricing API shipped, Jupiter routing shipped.
- External audit required before mainnet TVL (pre-mainnet checklist).
- Satellite independence: promote subtrees to own repos via
scripts/mirror_satellites.sh.
| 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 |
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).
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.





