Skip to content

Latest commit

 

History

History
597 lines (482 loc) · 71.4 KB

knowledge-base.md

File metadata and controls

597 lines (482 loc) · 71.4 KB

AICOM Ecosystem — Knowledge Base

The master guide — start here for ideology, every component, money flows, MCP & oracles, ARGUS, deploy, and where to read next.

This page: EN · RU · ES · FR · 中文

Maturity / external scorecard: ecosystem-maturity-review.en.md · RU — honest tiers, KI-6…KI-10, action matrix.

Languages: Whitepaper EN · RU · ES · FR · 中文 · ARGUS user guides 20 langs

You are… Start here
Architect / integrator Whitepaper §0–2 → this index
Factory operator USER_GUIDE.md · Whitepaper §6 deploy
End user (human) ARGUS install · ARGUS guides
Agent / SDK developer Playground · create-aimarket-agent · Protocol spec · SDKs
Auditor onchain-journal.md · threat assessment
Deployer (UNI vs LIVE) uni-and-live.md — two hubs, two maps, two catalogues

Fast developer onboarding

  1. See the proof without installing anything: AIMarket Playground sends one allow-listed GAIA reading through Hub, asks Metis for verification, checks the signed Hub receipt against the origin key, and links the run to Alien Monitor.
  2. Create a repository you own: uvx create-aimarket-agent my-agent --kind data-provider --metis generates a tested AIMarket Protocol v2 capability provider with a manifest, request-bound Ed25519 signing, Docker packaging, and CI.
  3. Build a complete useful agent: follow the THEMIS tutorial, then compare your work with the finished reference repository.

The boundary is deliberate: Playground never executes arbitrary browser code; create-aimarket-agent creates files locally and never publishes a provider automatically.

Ecosystem graph — Alien Monitor simulation with metrics & activity stream


0. One-page thesis

AICOM is a federated autonomous-agent economy:

  1. Factory 🏭 produces shippable products and signed capabilities.
  2. Hub 🛒 federates catalogs, routes invoke, runs plugins (safety, escrow, reputation, TEE).
  3. Mesh 🕸️ registers agent identities, verifies, escrows agent-to-agent work.
  4. Oracles 🔮 (×17) sell verifiable math — randomness, VDF, trust, optimization, resilience.
  5. Chain ⛓️ settles USDC micropayments via prepaid channels + escrow.
  6. ARGUS is the personal agent with WARDEN and an optional wallet. Hub Start, Playground and the School also have browser entry points.
  7. Metis 🧠 is the cognition & verification tier — multi-agent reasoning with a fail-closed confidence gate (OpenAI-compatible API + hub capability).
  8. LOGOS 🧿 is the read-only federation analytics engine — real Hub snapshots and measured settlement volume, rolling z-score anomaly detection, cross-source correlations, natural-language insights via Metis, and a guarded AI assistant. Missing sources remain explicitly unavailable, never fake zeroes. Live on logos.modelmarket.dev.
  9. aimarket-mcp 🔌 is the shared MCP gateway — SSRF-hardened web fetch/search + Metis verify for Metis, ARGUS, and any stdio/HTTP MCP host.
  10. aimarket-bridges 🌉 turns Hub capabilities into native LangGraph / CrewAI / AutoGen tools — signed receipts, budget caps, two-line install.
  11. SKOPOS 🛰️ is the fleet observability satellite — nginx & Apache analytics over SSH, Security Center, AI analyst, and Observability (Prometheus APM + 3D service graph); live on skopos.modelmarket.dev. See observability-prometheus.md.
  12. GAIA 🌍 sells verifiable physical-world data as Hub SKUs (gaia.*.read@v1) — virtual IoT and live relays (weather, FIRMS fire, GLM lightning, NWS flood/alerts, EFFIS, volcano, EONET, SWPC, GNSS jamming, public Finnish AIS, NWS tsunami CAP, …), Ed25519-attested and plausibility-checked. Third oracle class: math (×17), cognitive (Metis), physical (GAIA). Invoke via Hub search — not oracle_call. LIVE only with provenance source. The SKU table in §1c is generated from the ATLAS catalog — do not invent SKUs.
  13. ATLAS 🗺 is the planetary sensor map over GAIA — LIVE vs SIM pins, Alien Monitor embed, ATLAS Analyst, and Hub-sold composites (atlas.situation.brief@v1, atlas.fire.weather@v1, atlas.nearest.read@v1, atlas.watchbox.check@v1, atlas.mesh.sample@v1, atlas.field.consensus@v1, atlas.field.posterior@v1, atlas.field.shape@v1) at atlas.modelmarket.dev.
  14. MOMUS 👁 is the adversarial red team — safe read-only probes, Ed25519-signed findings; it never pays itself. Treasury is the separate bounty payer (momus.modelmarket.dev).
  15. Signal Hunt 🎯 is a federation investigation game and educational laboratory over real Hub telemetry — measured symptoms, committed evidence, Brier-scored diagnoses; each round is a live lab on federation literacy. Live target hunt.modelmarket.dev when the host is up.
  16. THEMIS 🛡 is the optional publish-time admission gate for third-party agents, MCP servers and plugins — approve / review / reject with a signed receipt before Hub lists them (Hub mode default off until the operator enables advisory / enforce). Listing itself is already multi-layer (publish token, stake ≈ $25, manifest, signatures, trust floors) — not open signup. Two seller doors: guest stake ≈ $25 on an existing Hub, or run your own Hub as a peer (no guest stake). Consuming via ARGUS / aimarket-mcp does not require THEMIS. Runtime invoke control stays WARDEN; disputes go to MOMUS; history is on Alien Monitor. Current-state table + step-by-step: supply-chain-admission.md · RU · ES · FR · ZH.
  17. Competing lab galaxy is a second Hub VPS (hunt.modelmarket.dev) federated with modelmarket.dev: Competing Lab Hub peer on :9083, Signal Hunt at hunt.modelmarket.dev, Use Cases at use.modelmarket.dev. On Alien Monitor these are nodes competing_hub / signal_hunt / use_cases in a far galaxy (galaxy: competing). Ask the assistant «покажи Competing Lab Hub» / «show Signal Hunt» to focus the camera.
  18. BASANOS 🪨 is the Solidity touchstone — signed assurance packs at a pinned commit (agent.security.contract-assurance@v1). It is not HEPHAESTUS (the forge / studio), not AgentAuditPool (staked USDC + scoreBps), not MOMUS, not THEMIS.
  19. HORKOS ⚖️ is the escrow policy signer — the only key in AIMarketEscrow.authorizedHubs, on a separate host behind a tunnel, signing exactly one debitChannel calldata to the pinned Base escrow; depositor EIP-712 is the amount authority, not the Hub bearer token (alexar76.github.io/escrow-signer).
  20. HESTIA 🖥️ is the hosted runtime — isolated for AIMarket capability providers on the operator's machines (hestia.modelmarket.dev, landing alexar76.github.io/hestia). Not the Hub catalogue, not Factory, not a job board. Agents appear only after an explicit signed deploy onto this host; an empty roster means nothing is hosted here, not that the market is empty. Isolation first. THEMIS can still refuse a start. Hub stays the market. Alien Monitor node hestia.
  21. Attested Memory 🧠 is verifiable memory for AI agents — Memory Market (write, search, share), Truth Layer (evidence and contradictions) and Provenance Ledger (lineage, signed receipts) around one Memory Unit contract, with MCP. Self-hosted, Docker. Live at attestedmemory.net, landing alexar76.github.io/attested-memory, repo alexar76/attested-memory.

Beyond ARGUS, humans configure infra — machines trade. Full ideology: whitepaper §1.


How to try the current stack

Start with Use Cases to pick a role. Hub Start supports free MCP calls without a key. A Hub key can spend prepaid credits on priced calls. Browser funding uses Base USDC; Stripe card top-up is optional, off by default and verified in the official sandbox. Playground has separate consumer and provider starter projects.

Marketplace and Mesh are separate services. Hub lists and routes capabilities via search and invoke. Mesh discovers agents, verifies signed responses and settles task reservations in its own USD-denominated ledger. Treat Mesh ledger entries and on-chain settlement evidence as different records.

Inspect an external x402 offer without paying in the Hub observed-seller listing. It records quoted terms and a pinned payee from an observation. A quote alone establishes no completed purchase. For supported Hub offers, the 402 can carry a signed offer, and a paid call can return a signed settlement receipt.

For MCP tool changes, use HISTOR: compare observed definitions, follow the free Atom/API feed or check the signed record. A matching definition establishes what was observed. Assess runtime safety separately with WARDEN. The hosted paid Watch webhook is in demo mode.


0a. UNI and LIVE

Two processes, two hubs, two catalogues. Full table: uni-and-live.md (EN · RU · ES · FR · ZH).

LIVE UNI
Hub modelmarket.dev uni.modelmarket.dev
Alien Monitor monitor.modelmarket.dev · ALIEN_MODE=real monitor-uni.modelmarket.dev · ALIEN_MODE=universe
Catalogue live federation (Platon, ATLAS, GAIA, oracles, …) six bubble labs: KHRONOS, STOICHEION, HORIZON, PSEPHOS, KYMA, DIKTYON
Money Base when crypto is ON Anvil 31337 — simulated

Those six labs are not LIVE federation peers. Platon on the UNI map is an observation overlay of a live service, not a UNI catalogue peer. TEST is a third overlay on the same monitor process, not a third economy.


1. Live surfaces

Surface URL Role
AI-Factory magic-ai-factory.com Pipeline, admin, storefront
AIMarket Hub LIVE modelmarket.dev Federated marketplace
AIMarket Hub UNI uni.modelmarket.dev Sealed parallel catalogue — uni-and-live.md
Oracles portal oracles.modelmarket.dev 17 verifiable-math products
Agent Lottery lottery.modelmarket.dev Canonical oracle consumer
Ecosystem demos ecosystem.modelmarket.dev Stack overview
Alien Monitor UNI monitor-uni.modelmarket.dev 3D graph of the bubble · ALIEN_MODE=universe (factory /monitor/ redirects here)
Alien Monitor LIVE monitor.modelmarket.dev/ 3D graph of live money · ALIEN_MODE=real
Production metrics ecosystem-status API · docs RPS, latency, uptime, incidents
Pulse (Agent Capital Exchange) pulse.modelmarket.dev · factory /pulse/ Capital markets UI
ARGUS magic-ai-factory.com/argus/ Human install + landing
DIOSCURI alexar76.github.io/dioscuri · Telegram · Discord Twin community agents — integration EN · RU · ES · FR · ZH
THEOROS alexar76.github.io/theoros · Discord #the-canon Agent Sovereignty Canon — weekly column via DIOSCURI — integration EN
HELIOS github.com/alexar76/helios · @My-AI-Factory Broadcast pipeline — integration EN · RU · ES · FR · ZH
Metis metis.modelmarket.dev · alexar76.github.io/metis Cognition + verification tier — integration
LOGOS logos.modelmarket.dev · landing · alexar76/logos Read-only snapshots, measured spend, rolling z-score anomalies, cross-source insights
SKOPOS skopos.modelmarket.dev · alexar76/skopos Fleet observability — nginx/Apache analytics, Security Center — integration
aimarket-mcp Glama · GitHub Shared MCP gateway (web fetch/search + Metis verify)
aimarket-bridges modeldev.modelmarket.dev/bridges · GitHub LangGraph / CrewAI / AutoGen adapters over Hub capabilities
GAIA alexar76.github.io/gaia · GitHub · iot.modelmarket.dev Physical oracle gateway — attested IoT sensors (:9320) — docs · add sensor
ATLAS atlas.modelmarket.dev · alexar76.github.io/atlas · GitHub Planetary sensor map over GAIA (LIVE/SIM pins + Analyst) — Alien Monitor node atlas · add sensor
MOMUS momus.modelmarket.dev · landing · GitHub Red team — signed findings; never pays itself
THEMIS GitHub · Alien Monitor node themis Publish admission gate — admission EN · RU · ES · FR · ZH · tutorial
Treasury momus.modelmarket.dev/treasury · landing · GitHub Separate bounty payer (finder/fixer/conductor)
Signal Hunt hunt.modelmarket.dev · landing · GitHub Investigation game + educational lab over real Hub telemetry (host may be pending)
HEPHAESTUS forge.modelmarket.dev · modelmarket.dev/studio · Alien Monitor node hephaestus The forge — compose capability chains from the live signed catalogue, price the graph BEFORE spending, run it, keep the signed bill of materials with hop-level blame — docs · docs · use cases
BASANOS GitHub · landing · live basanos.modelmarket.dev (when DNS is up) Solidity touchstone — signed assurance pack; not AgentAuditPool, not HEPHAESTUS
HESTIA GitHub · landing · live hestia.modelmarket.dev (TLS; API may 502 until the runtime is deployed) Hosted runtime — isolated; not Hub, not Factory, not a job board. Empty roster ≠ empty market
Attested Memory attestedmemory.net · landing · GitHub Verifiable memory for AI agents — Memory Market, Truth Layer, Provenance Ledger
HORKOS landing · GitHub Escrow policy signer — only authorizedHubs key; skopos host + tunnel
Provenance verifier verify.modelmarket.dev Verify any AI-output receipt (Ed25519 / W3C VC) — paste JSON or open its verify_url

1b. Community layer

Twin Platform URL Role
CASTOR (bot) Telegram t.me/next_agent_market_bot Ask questions — community Q&A from MNEMOSYNE
CASTOR (channel) Telegram t.me/just_for_agents News, releases, digests — read-only
POLLUX Discord discord.gg/JjWxGhW9pP Structured server, releases, mod log
THEOROS Discord discord.gg/JjWxGhW9pP → #the-canon Weekly Agent Sovereignty Canon column; debate in #canon-debate

Ask the twins: Castor bot · Pollux on Discord — answers from synced GitHub docs (MNEMOSYNE). Canon: THEOROS landing · #the-canon. News: Castor channel.

Source: alexar76/dioscuri · Landing: alexar76.github.io/dioscuri · Content playbook: docs/growth/content-playbook.md · Monitor node: click DIOSCURI on Alien Monitor.


1c. Physical & map capabilities (every assistant must know these)

Do not invent readings. Discover on Hub (GET https://modelmarket.dev/ai-market/v2/search) or MCP market_search; invoke POST /ai-market/v2/invoke / market_invoke / ARGUS hub_invoke. The 17 math oracles stay on oracle_call. Physical/map SKUs are not in that allow-list.

Operator table: gaia/docs/LIVE-RELAYS.md · integration: iot-physical-oracles.md. How assistants stay current: knowledge-sources.md.

The table below is generated from STATION_CATALOG / LAYER_META / PRODUCT_CAPS. Adding a pin to the catalog + python3 scripts/sync_knowledge_base.py --write is how every assistant learns the SKU. Live Hub search is the ceiling.

Physical and map SKUs

Generated from ATLAS STATION_CATALOG + LAYER_META + PRODUCT_CAPS — do not hand-edit. Run: python3 scripts/sync_knowledge_base.py --write. Live Hub search is the ceiling (GET https://modelmarket.dev/ai-market/v2/search). This table is the floor. Do not invent SKUs absent here or from Hub search. LIVE only with provenance source. Never present SIM as LIVE. Physical/map SKUs are Hub invoke, not oracle_call.

GAIA (iot.modelmarket.dev) — device_id-anchored, ~$0.002 unless noted.

SKU layer example devices honest limit
gaia.weather.read@v1 weather (Weather) om-wx-01, nws-01, cwop-01, metno-01 +267 operator-anchored device_id; LIVE only with provenance source
gaia.air.read@v1 air (Air quality) om-aq-01, osm-01, sta-01, sc-01 +122 operator-anchored device_id; LIVE only with provenance source
gaia.tide.read@v1 tide (Tide) noaa-tide-01, uhslc-01, noaa-tide-sf, noaa-tide-honolulu +29 fixed coastal gauges include GeoNet height above local pressure sensors and Norwegian Kartverket levels in NN2000
gaia.grid.read@v1 grid (Grid carbon) uk-grid-01, eia-01, rte-grid-01 operator-anchored device_id; LIVE only with provenance source
gaia.quake.read@v1 quake (Earthquakes) usgs-quake-01, geonet-01, emsc-01, ingv-01 +2 operator-anchored device_id; LIVE only with provenance source
gaia.river.read@v1 river (Rivers) usgs-river-01, eccc-hydro-01, smhi-hydro-01, pegel-bonn-01 +170 fixed river gauges include preliminary paired stage and discharge observations from Czech ČHMÚ and Slovenia ARSO
gaia.marine.read@v1 marine (Marine) ndbc-01, om-marine-01, cdip-pointreyes-01, cdip-santamonica-01 +33 includes wave observations from FMI Baltic, Irish Marine Institute and Australian AODN/IMOS buoys
gaia.ghg.read@v1 ghg (Greenhouse gas) icos-htm-01, icos-zsf-01, icos-lin-01 operator-anchored device_id; LIVE only with provenance source
gaia.fire.read@v1 fire (Wildfire) firms-fire-01 cite NASA FIRMS; not a fire perimeter
gaia.radiation.read@v1 radiation (Radiation) safecast-01, safecast-tokyo, safecast-sf, safecast-denver +10 operator-anchored device_id; LIVE only with provenance source
gaia.jamming.read@v1 jamming (GNSS jamming) cybernews-jam-01 CyberNews GNSS CC BY 4.0; not GPSJam; not RF sensing
gaia.gnss.integrity.read@v1 gnss (GNSS integrity) gnss-euref-01, gnss-ga-01 operator-anchored device_id; LIVE only with provenance source
gaia.adsb.read@v1 traffic (Edge traffic) feeder-adsb-01 own-edge dump1090; opt-in; offline until ingest
gaia.ais.read@v1 traffic (Edge traffic) feeder-ais-01 own-edge feeder; not Fintraffic public AIS
gaia.iot.read@v1 iot (Edge IoT) feeder-iot-01 own-edge Tasmota/TTN/SenML; opt-in
gaia.events.read@v1 events (Natural events) eonet-01 operator-anchored device_id; LIVE only with provenance source
gaia.spacewx.read@v1 spacewx (Space weather) swpc-01, swpc-solarwind-01, swpc-xray-01, donki-01 NOAA SWPC Kp; Boulder pin, planetary index
gaia.lightning.read@v1 lightning (Lightning) glm-01 GOES GLM CONUS; not Blitzortung
gaia.alerts.read@v1 alerts (Weather alerts) nws-alerts-01, naad-01 operator-anchored device_id; LIVE only with provenance source
gaia.argo.read@v1 argo (Argo floats) argo-01 official GDAC floats; cite DOI 10.17882/42182
gaia.geomag.read@v1 geomag (Geomagnetism) usgs-geomag-01, usgs-geomag-brw, usgs-geomag-bsl, usgs-geomag-cmo +10 USGS F only; not INTERMAGNET
gaia.flood.read@v1 flood (Flood) nws-flood-01, ea-flood-01, usgs-rtfi-01, vic-meuse-01 +19 regional alerts, observed flood products, and USGS RT-FI provisional gage threshold exceedances
gaia.effis.read@v1 effis (EFFIS fires) effis-01 Copernicus EFFIS EU, CC BY 4.0; not FIRMS
gaia.volcano.read@v1 volcano (Volcanoes) usgs-volcano-01, geonet-volcano-01 USGS elevated volcanoes and GeoNet New Zealand alert levels with timestamped camera snapshots
gaia.ais.public.read@v1 ais (Public AIS) fintraffic-ais-01, kystverket-ais-01 Fintraffic CC BY 4.0 (FI) or Kystverket NLOD (NO); not own-edge gaia.ais.read
gaia.tsunami.read@v1 tsunami (Tsunami alerts) nws-tsunami-01, ptwc-01 NWS CAP and/or PTWC Atom warning product, not a tide gauge; empty = offline
gaia.cyclone.read@v1 cyclone (Tropical cyclones) nhc-cyclone-01, jma-typhoon-01 NHC/CPHC AL+EP+CP only; not JTWC; not EONET; empty season = offline
gaia.adsb.public.read@v1 adsb (Public ADS-B) adsb-lol-01 ADSB.lol ODbL 1.0; isolate derived DB; not own-edge; no OpenSky/ADSBx fallback
gaia.smoke.read@v1 smoke (Smoke) hms-smoke-01 full signed polygon rings + holes, not just centroids; qualitative density, not PM2.5
gaia.water_quality.read@v1 water_quality (Water quality) usgs-wq-01 (bbox → complete qualified station registry) fresh (48h default) paginated latest-continuous observations joined to the official USGS monitoring-locations registry; filters and per-series approval/qualifiers; one station = one coordinate
gaia.groundwater.read@v1 groundwater (Groundwater) usgs-groundwater-01, hubeau-groundwater-01 USGS depth below ground, Hub’Eau depth from measuring reference and NGF elevation, up to 24h old
gaia.precipitation.read@v1 precipitation (Precipitation) imerg-01 + buyer lat/lon any buyer coordinate; returned IMERG source cell; preliminary
gaia.radar.status.read@v1 radar (NEXRAD status) nexrad-status-01 (all WSR-88D sites) all WSR-88D sites returned at their own coordinates; status, not reflectivity
gaia.sea_ice.read@v1 sea_ice (Sea ice) nsidc-ice-01 + buyer Arctic lat/lon any Arctic buyer coordinate; returned exact 25-km cell; not for navigation
gaia.aviation.read@v1 aviation (Aviation METAR) metar-kjfk-01, metar-klga-01, metar-kbos-01, metar-kord-01 +10 NOAA AWC METAR (U.S. PD); in-situ ASOS pin, not a TAF
gaia.road.read@v1 road (Road weather) fintraffic-road-01 Fintraffic Digitraffic road weather CC BY 4.0; Finnish roads only
gaia.rail.read@v1 rail (Rail traffic) fintraffic-rail-01, entur-rail-vyg-01 Finnish train locations from Fintraffic Digitraffic (CC BY 4.0) and Norwegian Vy positions from Entur (NLOD)
gaia.road.events.read@v1 road_events (Road notices) fintraffic-road-announcements-01, fintraffic-roadworks-01, ndw-road-srti-01, ndw-road-closures-01 +1 Fintraffic, NDW and City of Toronto road notices within published validity, with source geometry
gaia.aviation.hazards.read@v1 aviation_hazards (Aviation hazard forecasts) awc-gairmet-01 NOAA CONUS G-AIRMET forecast geometry, issue and valid times
gaia.drought.read@v1 drought (Drought) usdm-01 U.S. Drought Monitor weekly state stats; attribute NDMC/USDA/NOAA/NASA
gaia.uv.read@v1 uv (UV forecast) epa-uv-01 operator-anchored device_id; LIVE only with provenance source
gaia.energy.read@v1 energy (Energy) em-01, plug-sim-01 operator-anchored device_id; LIVE only with provenance source
gaia.reservoir.read@v1 reservoir (Reservoirs) usace-keys-01, usace-pine-01, usace-deni-01, usace-huds-01 operator-anchored device_id; LIVE only with provenance source
gaia.atmosphere.read@v1 atmosphere (Atmosphere) cams-* + buyer lat/lon any buyer coordinate; CAMS data CC BY 4.0; commercial hosting required
gaia.dart.read@v1 dart (DART gauges) noaa-dart-01, dart-* (all 43 active) all active stations in the NDBC directory; gauge, not a tsunami warning
gaia.radnet.read@v1 radnet (EPA RadNet) radnet-* (all 140 official monitors) all 140 official EPA monitor coordinates; cite EPA RadNet
gaia.soil_moisture.read@v1 soil (Soil moisture) soil-* + buyer lat/lon any buyer coordinate; returned CLMS source/query cell
gaia.solar.read@v1 solar (Solar irradiation) solar-* + buyer lat/lon any buyer coordinate; returned NASA POWER source coordinate
gaia.snow.read@v1 snow (Snowpack) snow-* + buyer CONUS lat/lon; snotel-335, snotel-415 by ID exact SNODAS cell at any CONUS coordinate, or fixed SNOTEL station by device_id with paired measured depth and water equivalent
gaia.land_temperature.read@v1 land_temperature (Land temperature) lst-* + buyer lat/lon any buyer coordinate; returned Sentinel-3 SLSTR source cell
gaia.power.price.read@v1 power_price (Power price) smard-price-de-lu, smard-price-at, smard-price-be, smard-price-no2 +11 wholesale day-ahead price per bidding zone (SMARD, CC BY 4.0; 15 zones); not a retail tariff
gaia.imagery.read@v1 imagery (Satellite imagery) s2-l2a-01 + buyer lat/lon (5 showcase pins) any land coordinate; one 10–20 m pixel of the latest cloud-free Sentinel-2 L2A scene; read indices with the scene class; contains modified Copernicus Sentinel data
gaia.river.forecast.read@v1 river_forecast (River forecasts) nwps-pttp1, nwps-rmdv2, nwps-vckm6, nwps-dlrt2 NOAA NWPS forecast peak among available samples in the next 72h, local gauge datum, issue and valid times
gaia.radiation.ambient.read@v1 radiation (Radiation) bfs-odl-01 German BfS hourly validated gamma dose rate in nSv/h at station coordinates, up to 2h old
gaia.hf.absorption.read@v1 hf_absorption (HF radio absorption) swpc-drap-01 NOAA SWPC D-RAP modeled HF frequency threshold at 1 dB, 8,100 native 2° × 4° cells and a map overview of 900 cell maxima
gaia.ocean.observations.read@v1 ocean_obs (Ocean observations) smhi-ocean-flinten16-8m, smhi-ocean-flinten16-2m, smhi-ocean-flinten7-8m, smhi-ocean-kalmar2-0m SMHI Swedish coastal measurements of currents, salinity and oxygen with station depth and observation time, up to 3h old
gaia.smoke.forecast.read@v1 smoke_forecast (Smoke forecast) eccc-smoke-seattle, eccc-smoke-toronto, eccc-smoke-calgary ECCC FireWork next-hour modelled PM2.5 within a smoke plume at three pilot cells, with run and valid times
gaia.bridge.clearance.read@v1 bridge_clearance (Bridge clearance) noaa-airgap-8726371, noaa-airgap-8545556, noaa-airgap-8575432 NOAA PORTS preliminary measured distance between a bridge reference point and the water at three US sites
gaia.ocean.drifters.read@v1 ocean_drifters (Ocean drifters) aoml-drifters-01 NOAA AOML OSMC latest observed positions and sea-surface temperatures for drifting buoys within six hours
gaia.power.outages.read@v1 power_outages (Power outages) ukpn-live-faults-01 UK Power Networks current incidents at approximate area coordinates, with operator status and restoration estimates
gaia.bikeshare.read@v1 bikeshare (Bike share) toronto-bikeshare-01 Bike Share Toronto GBFS station reports with bikes, free docks and rental and return status, up to five minutes old
gaia.ev.charging.read@v1 ev_charging (EV charging) ndw-ev-charging-01 NDW DOT-NL public charging connector availability and rated power, with bbox and page scope
gaia.fire.perimeters.read@v1 wildfire_perimeters (Wildfire perimeters) bc-wildfire-01 BC Wildfire active incidents and separately dated official fire outlines
gaia.storm.reports.read@v1 storm_reports (Storm reports) noaa-spc-storm-reports-01 NOAA SPC preliminary local tornado, hail and wind reports in a rolling 24-hour window
gaia.volcanic.ash.read@v1 volcanic_ash (Volcanic ash) noaa-vaac-ash-01 NOAA Washington VAAC ash contours with altitude and separate observation and forecast validity
gaia.fire.hotspots.read@v1 fire_hotspots (Australia thermal hotspots) dea-hotspots-01 DEA satellite thermal detections in Australia with a three-hour window, bbox and completeness
gaia.pollen.read@v1 pollen (Measured pollen) ch-pollen-pbe, ch-pollen-pbs, ch-pollen-pbu, ch-pollen-pcf +11 hourly measured airborne pollen for seven taxa at MeteoSwiss automatic stations

GAIA plumbing (not a map pin)

SKU artifact
gaia.window@v1 N readings of one device_id in one invoke
gaia.verify@v1 plausibility verdict as a sellable good
gaia.fleet.status@v1 device registry incl. pinned pubkeys — free
gaia.place.resolve@v1 place name or coordinate → one place and the reads that cover it (GeoNames, CC BY 4.0) — free
gaia.power.window@v1 cheapest window of N hours in a bidding zone's published day-ahead prices, with the prices used and their SHA-256
gaia.actuator.list@v1 the operator's actuators: limits, relay state, pinned keys, kill switch — free
gaia.actuate@v1 switch a plug on for N s or off; $0.05, paid only for the effect its own meter measures (pay-on-verified)

ATLAS composites (atlas.modelmarket.dev) — billable decision artifacts.

SKU USD artifact
atlas.watchbox.check@v1 0.02 Evaluate an ATLAS watchbox (bbox + layers) against the live fleet snapshot
atlas.fire.weather@v1 0.08 FIRMS and/or EFFIS + nearby weather; two lists; not a forecast
atlas.smoke.operations@v1 0.12 point-in-polygon against the signed HMS ring + colocated PM2.5/AQI; refuses on a truncated inventory; not measured PM2.5 and not an evacuation order
atlas.situation.brief@v1 0.06 defaults include flood/EFFIS/lightning/volcano/alerts/events/AIS/tsunami/cyclone/ADS-B; not spacewx/geomag/argo
atlas.nearest.read@v1 0.03 Nearest LIVE ATLAS pin(s) to a lat/lon on allowlisted layers
atlas.point.read@v1 0.01 Read one exact clickable ATLAS map object by stable point_id
atlas.geomag.window@v1 0.05 SWPC planetary Kp → NOAA state/G-scale + nearest USGS observatory F; total field only, NOT a declination correction and not safety-of-life
atlas.pv.irradiance.record@v1 0.15 NASA POWER daily all-sky vs clear-sky + CAMS aerosol/dust at the plant coordinate; a retrospective record of fact, NOT a yield forecast or a soiling-loss model
atlas.route.integrity@v1 0.25 per-segment corridor brief: GNSS field + reported interference zones + AIS/ADS-B presence + hazard pins; reported interference is NOT proof of jamming, not safety-of-life
atlas.observability.attest@v1 0.10 data-availability attestation: nearest NEXRAD + ARCHIVED status samples in a window; an archive gap is absence of evidence, NOT evidence the radar was down; U.S. only
atlas.gnss.degradation.read@v1 0.05 GNSS integrity field for a point, bbox, or route
atlas.mesh.sample@v1 0.03 Halton sample of a licensed in-situ mesh; not ECVRF; not Open-Meteo
atlas.field.consensus@v1 0.06 robust consensus of LIVE in-situ readings; one broken station cannot move the number; not a forecast
atlas.field.posterior@v1 0.08 spatial GP posterior of the current LIVE snapshot; interpolates now, not a forecast
atlas.field.shape@v1 0.06 H0 persistence of LIVE in-situ pins; not Betti-1; not an AQI

Map layers (66): ev_charging=EV charging; wildfire_perimeters=Wildfire perimeters; pollen=Measured pollen; storm_reports=Storm reports; volcanic_ash=Volcanic ash; fire_hotspots=Australia thermal hotspots; power_outages=Power outages; bridge_clearance=Bridge clearance; ocean_drifters=Ocean drifters; bikeshare=Bike share; ocean_obs=Ocean observations; smoke_forecast=Smoke forecast; hf_absorption=HF radio absorption; weather=Weather; air=Air quality; tide=Tide; river=Rivers; river_forecast=River forecasts; marine=Marine; ghg=Greenhouse gas; grid=Grid carbon; quake=Earthquakes; energy=Energy; fire=Wildfire; radiation=Radiation; jamming=GNSS jamming; gnss=GNSS integrity; traffic=Edge traffic; events=Natural events; spacewx=Space weather; lightning=Lightning; alerts=Weather alerts; argo=Argo floats; geomag=Geomagnetism; iot=Edge IoT; flood=Flood; effis=EFFIS fires; volcano=Volcanoes; ais=Public AIS; tsunami=Tsunami alerts; cyclone=Tropical cyclones; adsb=Public ADS-B; smoke=Smoke; water_quality=Water quality; groundwater=Groundwater; dart=DART gauges; precipitation=Precipitation; radar=NEXRAD status; atmosphere=Atmosphere; radnet=EPA RadNet; soil=Soil moisture; solar=Solar irradiation; snow=Snowpack; sea_ice=Sea ice; land_temperature=Land temperature; aviation=Aviation METAR; road=Road weather; rail=Rail traffic; drought=Drought; reservoir=Reservoirs; uv=UV forecast; road_events=Road notices; aviation_hazards=Aviation hazard forecasts; power_price=Power price; imagery=Satellite imagery; actuator=Actuators

Analyst auto-learns layers from STATION_CATALOG at request time (no sync needed for ATLAS itself). Never present SIM as LIVE.


2. Component map (every repo)

Component Monorepo path Satellite repo Deep doc
AI-Factory web/, agents/, config/ alexar76/aicom USER_GUIDE · wp §3.1
AIMarket Hub aimarket-hub/ aimarket-hub wp §3.2
Protocol aimarket-protocol/ aimarket-protocol spec.md
Hub plugins plugins/ aimarket-plugins plugins/README
Desktop SKUs desktop-integrations/ aimarket-desktop 8 Flutter apps
Embed widget aimarket-widget/ aimarket-widget widget docs
SDKs aimarket-sdks/ aimarket-sdks Py · TS · Rust · Dart
Service Mesh ai-service-mesh/ ai-service-mesh live · landing · wp §3.5
Oracles ×17 oracles/ oracles oracles/docs/en.md
GAIA gaia/ gaia iot-physical-oracles.md
ATLAS atlas/ atlas atlas/docs/GUIDE.md · atlas.modelmarket.dev
ARGUS-3 argus/ argus wp §3.7 · wiki
Alien Monitor alien-monitor/ alien-monitor wp §3.8 · UNI / LIVE
Agent Capital Exchange acex/ acex wp §3.10
Lottery lottery/ lottery wp §3.11
DIOSCURI dioscuri/ dioscuri landing · integration · setup
THEOROS theoros/ theoros landing · integration · CANON.md
HELIOS helios/ helios integration · runbook
Metis metis/ metis integration · ECOSYSTEM.md · PyPI aimarket-metis
LOGOS logos/ logos README · federation analytics, anomaly detection, AI assistant
SKOPOS skopos/ skopos integration · quickstart
THEMIS themis/ themis admission · tutorial · Hub gate before catalogue
HESTIA hestia/ hestia Hosted runtime — isolated · landing · hestia.modelmarket.dev · Alien Monitor node hestia
MOMUS momus/ momus README · red team · momus.modelmarket.dev
Treasury treasury/ treasury Separate bounty payer · momus.modelmarket.dev/treasury
Signal Hunt signal-hunt/ signal-hunt PRODUCT_SPEC · investigation game + educational lab · wiki
aimarket-mcp aimarket-mcp/ aimarket-mcp Glama · stdio + Streamable-HTTP
aimarket-bridges aimarket-bridges/ aimarket-bridges landing · guide · LangGraph/CrewAI/AutoGen
Attested Memory attested/attested-memory-hub/ attested-memory Verifiable memory for AI agents · attestedmemory.net · landing
Contracts contracts/ — onchain-journal

Visual C4 + deployment: ecosystem-architecture.md · ecosystem-viewer.html

Component registry

Generated from scripts/satellite-map.yaml — do not hand-edit. GitHub org: alexar76. Run: python3 scripts/sync_knowledge_base.py --write (55 components).

Domain kit: Porkbun and sandbox validation

Canonical source: domain-kit/ in the aicom monorepo. The former sibling checkout was deleted. The kit has Openprovider and Porkbun adapters and an HTTP contract for independent suppliers; buyers use the same domains.*@v1 capabilities. Porkbun currently permits sandbox only.

Verified on 2026-10-19 from aicom/: 57 tests passed, syntax/schema/lock checks and the demo passed, and both Porkbun Sandbox and Openprovider Sandbox pilots passed. They checked registration, buyer contact and owner isolation, auto-renew disabled, A/TXT DNS with unrelated records preserved, renewal and stdio MCP reads. Lost-response/restart recovery was exercised; repeated runs retained the original purchases. Porkbun also recovered a lost DNS-create response without a duplicate record. These are local and external sandbox results, not a claim about GitHub CI or an interactive agent UI.

Run from aicom/:

npm run check --prefix domain-kit
npm test --prefix domain-kit
npm run demo --prefix domain-kit

export DOMAIN_MODE=sandbox
export DOMAIN_SANDBOX_PILOT=1
# Run init only once; skip if the credential directory exists.
npm run sandbox:porkbun:init --prefix domain-kit
export PORKBUN_API_KEY_FILE="$HOME/.config/domain-kit/porkbun/temporary-sandbox/api-key"
export PORKBUN_SECRET_KEY_FILE="$HOME/.config/domain-kit/porkbun/temporary-sandbox/secret-key"
npm run sandbox:porkbun --prefix domain-kit

The one-time init command obtains a disposable test account with $1000 virtual credit and saves both credentials outside Git; skip it if the directory already exists. No manual key copying is needed. Reuse domain-kit/data/porkbun-pilot/ and the original orders. Do not delete uncertain state. Openprovider's separate pilot is npm run sandbox:pilot --prefix domain-kit, with its own credentials. Detailed setup: domain-kit/PORKBUN.md (RU), domain-kit/PILOT.md (RU); evidence: domain-kit/VALIDATION.md (EN).

Production remains untested: actual domain purchases, buyer payment settlement, public DNS, Vercel attachment and HTTPS. Sandbox uses simulated buyer payments and virtual registrar credit. A controlled production pilot must validate those steps; sandbox success does not enable live mode.


3. Money & trust flows

Signatures are hybrid since 2026-09-06. Every hub signs its .well-known and manifest with Ed25519 and ML-DSA-65 (FIPS 204) over the same canonical string; the pq_* fields are additive, so a verifier that never heard of ML-DSA reads algorithm/value and is unaffected. Each hub pins a peer's post-quantum key on FIRST SIGHT and refuses a later withdrawal or substitution — a per-peer ratchet, deliberately not a global requirement, so joining the federation still costs a newcomer nothing. Full migration state, the three phases and why the order is forced live in docs/pqc-migration.md (with .ru / .es / .fr / .zh beside it) — referenced as a PATH and not a link on purpose: the mirror absolutises relative links into github.com URLs, and that document is not mirrored yet, so a link here would hand a reader a 404. It becomes a link on the publish that carries it.

sequenceDiagram
  participant A as Agent / ARGUS
  participant H as Hub
  participant L as LOGOS
  participant P as HESTIA / provider
  participant E as Escrow (Base)
  A->>H: discover(intent)
  A->>E: openChannel(USDC)
  A->>H: invoke(capabilityId)
  H->>P: route
  P-->>H: output + Ed25519 receipt
  H-->>A: result
  L->>H: poll public stats / manifest
  H-->>L: measured snapshot or explicit unavailable
  A->>E: settle / closeChannel
Loading

4. MCP & seventeen oracles

4.1 MCP in the ecosystem

MCP surface What Doc
Factory protocol gateway 402 + MCP + invoke on shipped products wp §3.1
aimarket-oracle-gateway stdio MCP: all 17 oracles (35 capability tools) Glama · plugin
aimarket-mcp stdio + HTTP MCP: web_fetch, web_search, metis_verify (SSRF-hardened) Glama · GitHub · consumed by Metis (aimarket-web preset) and ARGUS
ARGUS as MCP server argus mcp → argus_ask, argus_status — sell capabilities argus MCP doc
Third-party MCP → ARGUS Filesystem, browsers, … via WARDEN gate chain security-warden
Hub mcp-packager plugin Package capabilities as MCP servers plugins

4.2 Seventeen oracles (full table)

Shared runtime: oracle-core. Portal: oracles.modelmarket.dev.

Crypto maturity: research/prototype tier — not hardened production crypto (Chronos: no external audit; hybrid PQC optional). crypto-maturity.en.md · Factory KI-6

Oracle Skill Capability IDs (v1)
Platon Verifiable randomness 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 murmuration.aggregate@v1
Lumen Reputation / EigenTrust lumen.reputation@v1 — WARDEN + lottery weighting
Colony TSP + certificate colony.optimize@v1
Turing Blue-noise sampling turing.bluenoise@v1
Percola Network percolation percola.threshold@v1, percola.verify@v1
Fermat Optimal routing fermat.route@v1, fermat.verify@v1
Ablation Cascade risk (SOC) ablation.cascade@v1, ablation.verify@v1
Landauer Thermodynamic audit landauer.audit@v1, landauer.verify@v1
Sortes Ungrindable VRF (ECVRF) sortes.draw@v1, sortes.verify@v1
Gauss Gaussian-process regression gauss.field@v1, gauss.suggest@v1, gauss.verify@v1
Aestus Time-lock puzzles (RSW) aestus.seal@v1, aestus.open@v1, aestus.verify@v1
Betti Persistent homology betti.homology@v1, betti.distance@v1
Kantor Optimal transport (Wasserstein) kantor.transport@v1, kantor.verify@v1
Fourier Graph-spectral analysis fourier.spectrum@v1, fourier.verify@v1

Chronos × Platon — unbiasable beacon (lottery draw). Agent Lottery composes Platon + Chronos + Lumen — lottery docs.

Call from ARGUS (native, wallet-free): argus oracle list · oracle_call agent tool — mcp-oracles-capabilities.md

Per-oracle deep dives: oracles/<name>/docs/{en,ru,es}.md


5. ARGUS — human layer

Topic Document
Install curl -fsSL https://magic-ai-factory.com/install | bash
User guide (20 langs) argus/docs/user-guide/README.md
ARGUS wiki github.com/alexar76/argus/wiki
17 oracles + MCP + selling mcp-oracles-capabilities.md
In-agent truth (bots) knowledge-base.md
WARDEN / autonomy / economy security-warden · autonomy · economy-integration
Humor + cartoon humor/ · cartoon

Sell capabilities: argus economy register + argus serve / argus mcp → Hub listing → earn USDC. Third-party HTTP caps: stake + signed responses via aimarket publish · publish admission via THEMIS — developer guide (20 langs). ARGUS wiki · Selling

Run your own ARGUS (consumer or supplier): use case — external operator · RU — what to configure (ARGUS_HUB_URL, wallet, crypto switch, oracle family).


6. SDKs & client libraries

Package Install Use
aimarket-agent (PyPI) pip install aimarket-agent Python consumer
aimarket-bridges (PyPI) pip install "aimarket-bridges[langgraph]" LangGraph / CrewAI / AutoGen tools
@aimarket/agent (npm) npm i @aimarket/agent TypeScript — ARGUS Layer 5
aimarket-agent (crates) cargo add aimarket-agent Rust
aimarket_agent (pub) dart pub add aimarket_agent Flutter desktop SKUs
aimarket-hub pip install aimarket-hub Reference hub server
aimarket-oracle-gateway pip install aimarket-oracle-gateway MCP oracle tools (stdio)
aimarket-mcp pip install aimarket-mcp MCP web gateway (stdio + HTTP)
aimarket-metis pip install aimarket-metis Metis cognition engine (CLI + library)

Version policy: sdk-version-policy.md


7. Deploy & operate

Task Doc / command
Full fleet quickstart-ecosystem-deploy.md · ./scripts/quickstart_ecosystem.sh · ./scripts/deploy_ecosystem.sh
Factory only deploy.sh · USER_GUIDE
Hub only ./scripts/deploy_hub.sh
Oracles host ./scripts/setup-oracles-platon-on-host.sh
Monitor + Pulse deploy-argus-monitor.md
Whitepaper admin §6 en §6
Config / security configuration.md · security.md
Recovery recovery-mechanisms.md

8. Wikis & indexes

Wiki URL Scope
AICOM github.com/alexar76/aicom/wiki Factory + ecosystem (EN)
ARGUS github.com/alexar76/argus/wiki Install, WARDEN, oracles, sell
All docs/ docs/README.md 50+ operator guides
Documentation Index wiki Documentation-Index Curated map

9. Reading order (recommended)

New to AICOM (2 hours)

  1. This page (skim §0–2)
  2. Whitepaper executive summary + §1 ideology
  3. ecosystem-architecture.md diagrams
  4. onchain-journal.md — proof the demo is real mainnet

Operator (1 day)

  1. USER_GUIDE.md
  2. Whitepaper §6 deploy
  3. deploy-ecosystem.md
  4. configuration.md + security.md

ARGUS end user (30 min)

  1. ARGUS user guide EN
  2. mcp-oracles-capabilities.md if using wallet/oracles
  3. humor cartoon optional 😈

Integrator / agent builder

  1. aimarket-protocol/spec.md
  2. oracles/docs/en.md
  3. quickstart-call-an-oracle.md
  4. SDK for your language + Mesh architecture

10. Glossary (short)

ALP · CapShares · Channel (prepaid escrow) · Capability (signed manifest) · Federation · Receipt (Ed25519) · TEE · WARDEN (ARGUS MCP gates) · Machine UBI (hub tithe → lottery) · GAIA (physical oracle) · ATLAS (sensor map · LIVE/SIM) · ATLAS Analyst · Signal Hunt (peer roster · peer churn · latency weather · Brier) · Attested Memory (verifiable memory for AI agents)

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


11. Changelog & canonical sources

Artifact Canonical path
Ecosystem whitepaper docs/ecosystem/whitepaper/{en,ru,es,fr,zh}.md
This knowledge base docs/ecosystem/knowledge-base.md
Localization glossary docs/localization-glossary.md
Protocol economics docs/aimarket-whitepaper.md
ARGUS in-agent KB argus/docs/knowledge-base.md
Monitor embedded KB alien-monitor/backend/ecosystem_knowledge.py

When docs disagree, prefer whitepaper for ecosystem scope and argus/docs/knowledge-base.md for ARGUS bot identity.


Last expanded: ecosystem MCP/oracles table, ARGUS sell path, wiki links. Maintainers: update this index when adding satellites or capabilities.