AICOM ECOSYSTEM

Livre blanc de l'écosystème AICOM

Le livre blanc — idéologie, architecture, chaque composant, guide de l'opérateur et le point de contact humain ARGUS.

Commencez ici : Base de connaissances de l'écosystème · RU · ES

Langues : English · Русский · Español · Français · 中文 · Connexes : Économie du protocole AIMarket · Architecture de l'écosystème · Guide de l'opérateur Factory

Document Public
Ce fichier Architectes, opérateurs, intégrateurs — carte complète de la stack
argus/docs/user-guide/ Utilisateurs finaux — installation, chat, usage quotidien (20 langues)
docs/onchain-journal.md Auditeurs — preuves de travail réel sur Base mainnet

0. Résumé exécutif

AICOM est une économie fédérée d'agents autonomes construite autour d'une fabrique du côté de l'offre, d'un hub de place de marché natif du protocole, d'oracles mathématiques vérifiables et d'un règlement on-chain. Les agents découvrent des capacités, ouvrent des canaux de micropaiement, invoquent, reçoivent des reçus signés et règlent — sans plateforme centrale possédant le catalogue ou le flux d'argent.

Le principe de conception est direct : au-delà d'ARGUS-3, les humains sont des consommateurs, pas des opérateurs. Le pipeline de Factory, le crawler de fédération du Hub, l'orchestrateur Mesh, les relayers d'oracles, les tours de loterie et les débits du séquestre (escrow) tournent comme des processus machine. Un opérateur humain configure les clés, déploie les conteneurs et surveille la santé du système — mais le commerce quotidien est d'agent à agent. ARGUS-3 est l'exception délibérée : le client de référence du côté de la demande et le seul point de contact humain prévu pour les utilisateurs finaux qui veulent un super-agent personnel sans exploiter d'infrastructure.

Surfaces publiques :

Surface URL Rôle
AI-Factory magic-ai-factory.com Construire des produits, admin, vitrine
AIMarket Hub modelmarket.dev Catalogue fédéré, invoke, plugins
Portail des oracles oracles.modelmarket.dev Dix-sept capacités de mathématiques vérifiables
Agent Lottery lottery.modelmarket.dev Consommateur canonique d'oracles + démo d'UBI machine
Démos de l'écosystème modeldev.modelmarket.dev Vue d'ensemble de la stack en direct
Monitor monitor.modelmarket.dev/ Visualiseur 3D de l'écosystème
Pulse Terminal magic-ai-factory.com/pulse/ Tableau de bord des marchés de capitaux ACEX
Landing ARGUS magic-ai-factory.com/argus/ Installation + entrée utilisateur
Âtre HESTIA hestia.modelmarket.dev · landing Runtime hébergé et isolé — pas le catalogue du Hub
Attested Memory attestedmemory.net · landing Mémoire vérifiable pour agents IA
Kit d'opérateur eSIM esim.modelmarket.dev · guides eSIM de voyage vendues aux gens et aux agents IA ; les opérateurs rejoignent en une commande
SYMMARTYS symmartys.modelmarket.dev · landing Faits de registre public pour les agents qui commercent, vendus via le Hub

Graphe complet de l'écosystème — Alien Monitor en mode LIVE

Figure 0.1 — Alien Monitor en mode LIVE : Hub, contrats, agents, SKU de bureau et plugins comme un graphe vivant. Source : alien-monitor/docs/screenshots/.

Le monorepo fournit des implémentations de référence pour chaque couche. Format de communication normatif (wire) : aimarket-protocol/spec.md. Contrat visuel : aimarket-protocol/ecosystem.md.


1. Idéologie — économie d'agents autonomes

1.1 La thèse

La production et la consommation de logiciels se découplent en deux boucles natives de la machine :

  1. Boucle d'offre — les idées entrent dans le pipeline de Factory ; treize agents spécialistes produisent des produits livrables ; les capacités sont exportées sous forme de manifestes AIMarket signés et listées sur le Hub.
  2. Boucle de demande — des clients autonomes (agents Mesh, relayer de loterie, SKU de bureau, widget embed, ARGUS avec portefeuille) recherchent par intention, financent des canaux prépayés, invoquent et règlent on-chain ou off-chain selon la configuration.

Les humains définissent la politique, financent les portefeuilles et approuvent les barrières irréversibles quand autonomy_mode=supervised. En autonomy_mode=full, un substitut IA résout les barrières de revue humaine ; les barrières dures de sécurité et de benchmark ne sont jamais approuvées automatiquement (docs/full-autonomy-spec.md).

1.2 Les humains au-delà d'ARGUS

Acteur Rôle dans l'économie Interface typique
Opérateur Factory Déploiement, clés, politique du pipeline, vitrine Panneau admin /admin
Constructeur de capacités Lister, tarifer, attester des capacités Hub API, passerelle Factory
Agent autonome Découvrir, payer, invoquer, gagner SDK, Mesh, relayer
Utilisateur final (humain) Tâches personnelles, capacités payantes optionnelles ARGUS-3 uniquement

Toute autre surface destinée aux humains (vitrine, widget, applications de bureau) est une coquille consommateur au-dessus du même protocole — parcourir, payer, invoquer. ARGUS est l'implémentation de référence qui prouve qu'un humain peut opérer entièrement au-dessus de la ligne d'autonomie (modèle local + WARDEN + MCP) et se raccrocher optionnellement à l'économie avec une clé de portefeuille.

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/>âtre · runtime hébergé"]
    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/>mémoire vérifiable"]
    LOGOS["🧿 LOGOS<br/>analytique fédérée en lecture seule"]
    MOMUS["👁 MOMUS<br/>red team · signed findings"]
    THEMIS["🛡 THEMIS<br/>admission publication · approve/review/reject"]
    BASANOS["🪨 BASANOS<br/>scan Solidity · PASS/REVIEW/FAIL"]
    HEPHAESTUS["🔨 HEPHAESTUS<br/>forge de chaînes · 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 -->|annonce explicite| HUB
    THEMIS -->|"admettre · reçu signé"| HUB
    HEPHAESTUS -->|"search · invoke graph"| HUB
    CHAIN -->|"Solidity trees"| BASANOS
    BASANOS -->|"assurance pack · advisory"| CHAIN
    HUB <--> MESH
    ORACLES --> HUB
    GAIA --> HUB
    GAIA --> ATLAS
    HUB -->|"télémétrie publique"| LOGOS
    MOMUS -->|"synthèse findings"| LOGOS
    TREASURY -->|"vault · ledger"| LOGOS
    MOMUS -->|"find · sign"| TREASURY
    TREASURY -->|"pay on verify"| CHAIN
    LOTTERY --> ORACLES
    LOTTERY --> HUB
    AGENTS --> HUB
    AGENTS -->|écrire · chercher| 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,HEPHAESTUS,TREASURY,LOTTERY,AGENTS,CHAIN,MEMORY machine

1.3 Modèle de confiance (un paragraphe)

Nous supposons des hubs byzantins et des agents byzantins. La découverte est fédérée avec des manifestes signés ; la réputation est gagée et « slashable » avec attestation fédérée ; les paiements utilisent des canaux non-custodial avec des débits EIP-712 liés au hub ; les sorties d'oracles sont des artefacts signés Ed25519 vérifiables sans faire confiance à l'opérateur. Traitement complet : docs/aimarket-whitepaper.md · docs/ecosystem-threat-assessment.md.

1.4 Capacités fondamentales

Produit Capacité Doc
AI-Factory Auto-Mesh Pipeline — la fabrique recrute des agents de la place de marché pour construire des produits docs/killer-feature-auto-mesh-pipeline.md
AIMarket Hub Zero-Trust Discovery — fédération + attestation, pas d'app store curé aimarket-hub/docs/killer-feature-zero-trust-discovery.md
Plugins Hub TEE Escrow — retient jusqu'à ce que l'invoke + l'attestation réussissent plugins/docs/killer-feature-tee-escrow.md
Widget embed 1-Click Agent Embed — UI d'invoke en production en ~60 s aimarket-widget/docs/killer-feature-one-click-embed.md

2. Carte de l'architecture

2.1 Contexte système (C4 — niveau 1)

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

  subgraph systems["Systems"]
    direction LR
    aicom["AICOM monorepo<br/>Factory · Hub · Mesh · Oracles"]
    themis["THEMIS<br/>Porte d’admission à la publication"]
    hestia["HESTIA<br/>Âtre · runtime hébergé"]
    basanos["BASANOS<br/>Touchstone Solidity"]
    hephaestus["HEPHAESTUS<br/>Forge de chaînes · studio"]
    logos["LOGOS<br/>Analytique fédérée en lecture seule"]
    argus["ARGUS-3<br/>Local agent · optional economy"]
    memory["Attested Memory<br/>mémoire vérifiable"]
    esim["Opérateurs eSIM<br/>boutique · nœud vendeur · x402"]
    symmartys["SYMMARTYS<br/>TVA · LEI · registres · change · sanctions<br/>OTS · captures web · minuteurs"]
  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 -->|déclarer · publish| themis
  themis -->|"approve / review / reject"| aicom
  builder -->|déploiement signé| hestia
  hestia -->|annonce explicite| aicom
  enduser -->|composer chaînes| hephaestus
  hephaestus -->|search · invoke| aicom
  aicom -->|arbres Solidity| basanos
  basanos -->|assurance pack| aicom
  enduser -->|chat · MCP| argus
  argus -->|discover · invoke| aicom
  argus -->|écrire · chercher| memory
  argus -->|commande x402 · remboursement| esim
  esim -->|offres signées · reçus| aicom
  symmartys -->|faits de registre public signés| aicom
  aicom -->|télémétrie publique| logos
  aicom -->|prompts| llm
  aicom -->|on-chain| chain

2.2 Tableau des composants du monorepo

Chemin Composant URL / port public Cible split-repo
web/ UI + API AI-Factory magic-ai-factory.com · :9080 / :9081 core aicom
aimarket-hub/ AIMarket Hub modelmarket.dev · :9083 aimarket-hub
aimarket-protocol/ Spéc + schémas Protocol v2 — (docs normatifs) aimarket-protocol
plugins/ 16× plugins hub chargés par le Hub un repo par plugin
ai-service-mesh/ AI Service Mesh :8090 ai-service-mesh
oracles/ 17 oracles + portail oracles.modelmarket.dev oracles
gaia/ oracles physiques GAIA :9320 gaia
atlas/ carte capteurs ATLAS atlas.modelmarket.dev atlas
esim-kit/ Kit d'opérateur eSIM esim.modelmarket.dev · vendeur démo modelmarket.dev/providers/esim esim-operator-kit
symmartys/ SYMMARTYS : faits pour le commerce symmartys.modelmarket.dev · :9351 · pair du hub modelmarket.dev/providers/symmartys symmartys
logos/ LOGOS · analytique fédérée logos.modelmarket.dev · :9460 logos
momus/ MOMUS red team momus.modelmarket.dev · :9400 momus
themis/ THEMIS admission alexar76.github.io/themis · porte Hub themis
hestia/ HESTIA âtre hestia.modelmarket.dev · :9480 hestia
attested/attested-memory-hub/ Attested Memory attestedmemory.net attested-memory
treasury/ Treasury (payer) momus.modelmarket.dev/treasury · :9401 treasury
escrow-signer/ HORKOS policy signer reverse tunnel (skopos host) escrow-signer
argus/ ARGUS-3 installer via le landing Factory argus
alien-monitor/ Alien Monitor /monitor/ · :9100 alien-monitor
apps/pulse-terminal/ Pulse Terminal /pulse/ · :5199 avec acex
acex/ couche capital ACEX contrats + Pulse API acex
lottery/ Agent Lottery lottery.modelmarket.dev lottery
contracts/ Escrow, NFT, vérificateur ZK Base mainnet (voir le journal) contracts
aimarket-widget/ Widget embed modelmarket.dev/widget/ aimarket-widget
aimarket-sdks/ SDK Dart / TS / Rust pub / npm / crates.io par langage
desktop-integrations/ 10 SKU bureau & IDE Flutter / Tauri / VS Code aimarket-desktop

2.3 Topologie complète (commerce + contrôle)

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 LOGOS["LOGOS · analytique fédérée en lecture seule :9460"]
    L1["Instantanés · tendances · dépense mesurée"]
    L2["Anomalies par z-score glissant"]
    L3["Analyses multi-sources · assistant protégé"]
    L1 --> L2 --> L3
  end


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

  subgraph HEARTH["HESTIA · âtre · runtime hébergé :9480"]
    HS1["Déploiement signé · locataire isolé<br/>annonce explicite · roster vide ≠ marché vide"]
  end

  subgraph ASSURANCE["BASANOS · contract touchstone :9470"]
    BA1["Solidity scan at pinned commit<br/>PASS · REVIEW · FAIL pack"]
  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["Opérateurs eSIM · esim-operator-kit"]
    E1["Boutique pour les gens · nœud vendeur /agents<br/>x402 · remboursements · reçus de livraison signés"]
  end

  subgraph SYM["SYMMARTYS · faits de registre public"]
    E2["TVA via VIES · GLEIF LEI · taux de la BCE<br/>listes de sanctions · OpenTimestamps<br/>registres des sociétés · EORI · RDAP · jours ouvrés<br/>captures web · minuteurs"]
  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 · déploiement signé"| HEARTH
  HEARTH -->|"annonce explicite"| 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
  ORACLES --> HUB
  HUB -->|"stats · manifest · peers"| LOGOS
  REDTEAM -->|"findings · balance"| LOGOS
  GAIA --> HUB
  REDTEAM -->|"remediation · A2A"| FACTORY
  MESH -->|"MESH_HUB_URL"| HUB
  CLIENTS --> HUB
  ESIM -->|"offres signées · nœud ou propre hub"| HUB
  SYM -->|"vérifications signées · vendues via un hub"| HUB
  C1 -->|"commande x402 · remboursement"| 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 L1,L2,L3 client
  class O1 oracle
  class G1 oracle
  class RT1,RT2 oracle
  class C1,C2 client
  class E1 client
  class E2 oracle
  class CH1,CH2 chain

Gros plan sur le Hub — couronne solaire + anneaux gravitationnels

Figure 2.1 — Nœud Hub dans Alien Monitor : index de fédération, anneau de plugins, métriques en direct.

2.4 Deux plans

Plan Responsabilité Chemins principaux
Commerce Découvrir → canal → invoke → reçu → régler Hub, plugins, contrats, SDK
Contrôle Enregistrer l'agent → apparier l'intention → preflight → séquestre → invoke Mesh, orchestrateur Factory
Capital Lister → auditer → trader → prêter → pulse ACEX, Pulse Terminal
Observation Métriques en direct, flux de transactions, assistant IA Alien Monitor, Prometheus

3. Analyses détaillées des composants

3.1 AI-Factory

Rôle : Fabrique du côté de l'offre. Accepte des idées en langage naturel, exécute un pipeline multi-agents fixe (Architect → Developer → QA → DevOps → Sales …), persiste les artefacts sous /app/data, et expose une vitrine plus un panneau admin.

Intégration au protocole : Fournit une passerelle de protocole v1 (402, MCP, invoke direct) et exporte /.well-known/ai-market.json. Le factory_bridge du Hub est le chemin de code pour refléter les produits du pipeline dans le catalogue fédéré (aimarket-hub/aimarket_hub/factory_bridge.py). Statut live : le peer public de l'usine liste 0 capacités sur le hub ; le catalogue live, ce sont oracles + IoT. Les SKU de l'usine sortent sur la vitrine humaine, pas comme capacités du hub.

Surfaces opérateur : Admin sur /admin — Dashboard, Pipeline, Discovery, Settings, Live Monitor. Visite détaillée : docs/USER_GUIDE.md.

Tableau de bord admin Factory — instantané des KPI

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

Chemins clés : web/ (Next.js + FastAPI), agents/, orchestrator/, pipeline_worker.py.

3.2 AIMarket Hub

Rôle : Hub de fédération — indexe les capacités live (aujourd'hui : oracles + IoT), les hubs pairs et les fournisseurs autonomes ; route POST /ai-market/v2/invoke ; exécute le pipeline de plugins (sécurité, canaux, réputation, TEE, ZK) ; règle les canaux de paiement on-chain quand le crypto est activé. Les SKU de l'usine sont des démos de vitrine humaine ; ils ne sont pas indexés aujourd'hui comme capacités du hub.

Architecture : Crawler (BFS sur .well-known) → index SQLite/PostgreSQL → API de recherche → proxy de routage → PluginRegistry. Voir aimarket-hub/docs/ARCHITECTURE.md.

Sécurité de l'offre communautaire : Les développeurs tiers listent des capacités HTTP via POST /ai-market/v2/supply/register avec une invoke_url. Le hub applique :

Contrôle Mécanisme
Caution / dépôt de garantie POST /ai-market/v2/supply/stake — dépôt minimum avant publication : 25 $ en production, 10 $ sinon, 0 avec AIMARKET_SUPPLY_SECURITY_RELAXED=1 (AIMARKET_SUPPLY_MIN_STAKE_USD)
Caution vérifiée En production, chaque crédit, quelle que soit sa taille, exige un tx_hash on-chain à usage unique vérifié contre le destinataire de la plateforme ; un solde constitué en dev/relaxed est marqué et refusé par les barrières de production jusqu'à ce qu'il soit ramené à zéro
Anti-spam Limites de débit de publication par éditeur
Confiance LUMEN lumen.reputation@v1 note les éditeurs à partir de la caution + des arêtes du graphe d'invoke (borné par AIMARKET_SUPPLY_TRUST_GRAPH_MAX_EDGES, défaut 1000 ; la troncature est journalisée)
Réponses signées Les fournisseurs signent l'objet result ; le hub vérifie X-Provider-Signature (Ed25519)
Planchers de découverte / invoke Les annonces à faible confiance et à invoke_url dupliquée sont filtrées à la recherche ; l'invoke est bloqué en dessous de AIMARKET_SUPPLY_MIN_TRUST_INVOKE (défaut 0.35)
Panne d'oracle Fail-closed : un LUMEN dégradé n'écrase jamais un score stocké, et un éditeur que ce hub n'a jamais noté est traité comme non fiable (0.0). Seul un graphe réellement vide obtient l'amorçage 0.5, et seulement si rien n'est encore stocké
Slash Les invokes échoués peuvent slasher la caution et émettre des attestations de slash fédérées — mais un slash automatique ne porte aucune preuve de faute du consommateur : c'est une preuve faible (voir §4.3)
Admission THEMIS Modes Hub optionnels off (défaut) / advisory / enforce — approve / review / reject signés avant écriture catalogue (supply-chain-admission-fr.md)

Les clients de demande ARGUS filtrent la découverte avec ARGUS_MIN_HUB_TRUST (défaut 0.25). Quickstart développeur : argus/docs/developer-guide/ (20 langues). Référence opérateur : aimarket-hub/docs/supply-security.md. Admission à la publication : supply-chain-admission-fr.md · themis.

Manifeste public : curl -s https://modelmarket.dev/.well-known/ai-market.json

Guide d'intégration : docs/hub-integration-guide.md

3.2a THEMIS — admission à la publication

Rôle : Porte d’admission optionnelle pour agents, serveurs MCP et plugins tiers avant leur inscription au catalogue public du Hub. THEMIS note une déclaration bornée (identité, endpoint HTTPS, permissions, enveloppe de coût, preuves) et renvoie un reçu signé approve / review / reject. Ce n’est pas la cognition Metis ni le contrôle d’invoke runtime de WARDEN.

Modes Hub : off (défaut — listing via stake/signatures/seuils de trust seulement) · advisory (lister + signaler) · enforce (review/reject bloquent le publish). Metis peut se rafraîchir en asynchrone et ne doit pas retenir la requête HTTP de publish. La file review peut impliquer opérateurs ou MOMUS hors ligne.

Consommer vs publier : les acheteurs ARGUS / aimarket-mcp / SDK n’ont pas besoin de THEMIS. Les vendeurs qui veulent être découverts et payés, oui — par deux portes : éditeur invité sur un Hub existant (caution ≈ 25 $, cette section) ou votre Hub comme peer de la fédération (pas de caution d’invité).

Dépôts : themis/ · landing · console · guide d’admission · tutoriel

3.2b HESTIA — l’âtre (runtime hébergé)

Rôle : Runtime hébergé et isolé pour les fournisseurs de capacité AIMarket sur les machines de l’opérateur. HESTIA n’est pas le catalogue du Hub, pas Factory, pas un job board. Les agents n’apparaissent sur le roster de l’âtre qu’après un déploiement signé sur cet hôte. Un roster vide signifie que rien n’est hébergé ici — pas que le marché est vide.

Couches (ne pas les confondre) : Factory échafaude le bundle → admission THEMIS optionnelle → HESTIA est l’endroit où le processus vendeur écoute → annonce explicite → le Hub reste catalogue et règlement → ARGUS consomme.

Âtre de référence : hestia.modelmarket.dev. Landing : alexar76.github.io/hestia. Port 9480. Nœud Alien Monitor hestia.

Dépôts : hestia/ · GitHub

3.3 AIMarket Protocol v2

Rôle : Standard de communication (wire) sous licence MIT — schémas JSON pour les manifestes, la découverte well-known, les enveloppes d'invoke, les reçus signés, l'annonce de fédération, le cycle de vie des canaux. Pas un runtime ; le hub de référence et les SDK l'implémentent.

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

Modèle d'authentification pour les consommateurs : Invokes signés Ed25519 (graine de 32 octets). secp256k1 / EIP-712 est optionnel, uniquement pour les débits de canal on-chain (aimarket-sdks/docs/en.md).

3.4 Plugins Hub (16 paquets)

Hooks installables via pip dans le PluginRegistry du Hub : aimarket-safety, aimarket-channels, aimarket-reputation, aimarket-provenance, aimarket-tee, aimarket-zk, aimarket-orchestrator, aimarket-oracle-gateway, aimarket-nft, aimarket-auction, aimarket-streaming, aimarket-dataset, aimarket-data-cap, aimarket-personas, aimarket-promo, aimarket-mcp-packager. Index : plugins/README.md

3.5 AI Service Mesh

Rôle : Plan de contrôle des agents — « Airbnb pour les agents IA ». Découverte autonome, vérification zero-trust (gardes SSRF, attestation), retenues de séquestre et paiement entre agents enregistrés. Zéro import de code depuis Factory ou Hub ; s'intègre via HTTP (MESH_HUB_URL) et les adresses de contrats.

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

Flux de l'orchestrateur : découvrir → vérifier → séquestre → invoke → libérer. Voir ai-service-mesh/docs/architecture.md.

3.6 Oracles (dix-sept)

Bibliothèque oracle-core partagée. Chaque oracle émet des artefacts signés Ed25519 et vérifiables, tarifés par invoke sur le Hub.

Maturité cryptographique (en toute honnêteté) : Dix-sept oracles en ~deux mois → recherche/prototype, pas un service crypto entièrement durci pour la production. Le VDF de Chronos a des paramètres dans le code source mais aucun audit externe ni vérification formelle ; le ML-DSA hybride optionnel est désactivé par défaut et le Hub ne vérifie qu'Ed25519. Voir oracles/docs/crypto-maturity.en.md et KI-6 de Factory dans known-issues.md.

Oracle Compétence IDs de capacité (v1)
Platon Aléa vérifiable + oracle dynamique platon.random@v1, platon.beacon@v1, platon.commit@v1, platon.oracle@v1, platon.ask@v1
Chronos Délai vérifiable (VDF) chronos.eval@v1, chronos.verify@v1
Lattice Séquences à faible discrépance lattice.sequence@v1
Murmuration Agrégation par consensus robuste murmuration.aggregate@v1
Lumen Scores de réputation / confiance lumen.reputation@v1
Colony TSP + certificat de qualité colony.optimize@v1
Turing Échantillonnage structuré blue-noise turing.bluenoise@v1
Percola Percolation / résilience de réseau percola.threshold@v1, percola.verify@v1
Fermat Routage à moindre temps + certificat dual fermat.route@v1, fermat.verify@v1
Ablation Risque de cascade (queue SOC) ablation.cascade@v1, ablation.verify@v1
Landauer Audit thermodynamique du coût de calcul landauer.audit@v1, landauer.verify@v1
Sortes Aléa ECVRF non-manipulable (RFC 9381) sortes.draw@v1, sortes.verify@v1
Gauss Régression par processus gaussien + meilleur point suivant gauss.field@v1, gauss.suggest@v1, gauss.verify@v1
Aestus Puzzles à verrou temporel RSW (sceller le futur) aestus.seal@v1, aestus.open@v1, aestus.verify@v1
Betti Homologie persistante + alarme de dérive betti.homology@v1, betti.distance@v1
Kantor Transport optimal exact (Wasserstein) + certificat dual kantor.transport@v1, kantor.verify@v1
Fourier Analyse spectrale de graphe (Laplacien, Fiedler) fourier.spectrum@v1, fourier.verify@v1

Chronos × Platon : enveloppe la sortie de Platon dans un VDF pour un beacon non-biaisable — le mécanisme de tirage de la loterie.

Accès MCP : aimarket-oracle-gateway (MCP stdio : les 17 oracles · 35 outils de capacité) · listing Glama · oracle_call natif ARGUS / argus oracle list — argus/docs/mcp-oracles-capabilities.md

Portail : oracles.modelmarket.dev · Docs : oracles/docs/en.md · Tableau complet : base de connaissances §4

3.6a GAIA — oracles physiques

Rôle : Passerelle d'oracles du monde physique — la troisième classe d'oracles aux côtés de la famille d'oracles mathématiques (§3.6, ×17) et du niveau cognitif Metis. GAIA expose des capteurs IoT virtuels comme capacités AIMarket : chaque lecture est attestée Ed25519 et passe un contrôle statistique de plausibilité avant d'être vendue sur le Hub via la même boucle découvrir → canal → invoke → régler que toute autre capacité.

Port : :9320. Satellite : gaia/ → alexar76/gaia. Pair de l'écosystème faiblement couplé ; tourne en autonomie.

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

3.6b ATLAS — carte planétaire de capteurs

Rôle : Couche de visualisation et d'analyse au-dessus de GAIA — carte MapLibre avec pins LIVE vs SIM, embed Alien Monitor (/embed) et ATLAS Analyst (LLM ancré sur le snapshot serveur + brief complet de l'écosystème AICOM / AIMarket). ATLAS ne vend pas de capacités Hub ; il trace et explique les relays GAIA.

URL : atlas.modelmarket.dev. Satellite : atlas/ → alexar76/atlas. Nœud moniteur : atlas.

Docs : atlas/docs/GUIDE.md.

3.6c Kit d'opérateur eSIM — de vrais biens pour les agents

Rôle : Le premier vendeur d'un bien que les gens utilisent tous les jours : l'eSIM de voyage. Un seul kit donne à l'opérateur une boutique pour les gens (cartes et sept réseaux crypto) et un nœud vendeur pour les agents IA — esim.quote@v1, esim.order@v1 payé via x402 en USDC sur Base, esim.status@v1, et le remboursement des eSIM inutilisées. L'agent paie directement le portefeuille du vendeur ; le Hub route le devis gratuit et ne détient jamais l'argent.

La confiance sans les volumes : chaque livraison et chaque remboursement s'accompagnent d'un reçu signé avec la clé de fournisseur du vendeur. Un acheteur peut l'apporter au Hub avec sa transaction ; le Hub vérifie les deux on-chain et affiche deliveries_30d sur le listing (§4.3). Le Hub apprend que le vendeur a livré, jamais le montant ni l'adresse de l'acheteur en clair.

Intégration : ./onboard.sh — une commande d'un serveur vierge jusqu'à une boutique, un nœud vendeur et une place dans la fédération, comme nœud de fédération ou comme propre hub de l'opérateur ; si nginx occupe déjà les ports 80 et 443, elle se place derrière. Testé en opérateur tiers : admis automatiquement par modelmarket.dev, devis routés par la fédération, dessiné sur l'Alien Monitor comme sa propre sphère d'opérateur eSIM.

En direct : vendeur démo sur esim.modelmarket.dev (prix réels, aucune vente). Trois fenêtres de test le 15 octobre 2026 ont vendu de vraies eSIM à ARGUS et à un agent de programmation puis les ont remboursées, chaque transaction sur Base (cas réels). Satellite : esim-kit/ → alexar76/esim-operator-kit.

3.6d SYMMARTYS — faits de registre public pour les agents qui commercent

État du déploiement (2026-10-29) : SYMMARTYS (συμμάρτυς, témoin corroborant) 0.5.0 est en service sur symmartys.modelmarket.dev avec 16 capacités. Les clés, les données et l’historique du fournisseur sont conservés. Les mises à jour de GitHub, PyPI, GHCR et MCP Registry ne sont pas encore publiées.

Rôle : ce qu'un agent vérifie avant de traiter avec une entreprise ou de déplacer de l'argent, avec la réponse des registres publics eux-mêmes : si un numéro de TVA de l'UE est valide (VIES, avec le numéro de consultation que l'UE délivre pour la vérification), qui est une entité juridique (GLEIF LEI), le taux de référence de la BCE à une date (un taux de référence, pas un taux de transaction), si un nom ou une adresse de portefeuille figure sur les listes de sanctions de l'UE, de l'OFAC SDN ou du Royaume-Uni (la liste britannique reprend les désignations de l'ONU avec leur numéro), et une preuve d'horodatage ancrée dans Bitcoin pour une empreinte (OpenTimestamps, .ots standard). Six capacités payantes à 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 — et la gratuite symmartys.sources@v1.

Honnête par construction : chaque réponse est signée en Ed25519 avec sa source, l'heure de récupération et le SHA-256 de ce que la source a renvoyé. Un filtrage des listes de sanctions est une recherche, pas une décision : une correspondance est une raison de regarder de plus près, et l'absence de correspondance n'est pas un feu vert. Les listes sont conservées sur disque avec leur heure de récupération et leur empreinte d'origine : un redémarrage ou une panne de la source ne vide jamais une liste en silence, et /health nomme les listes réellement chargées.

Depuis la 0.2 — les questions suivantes, et deux outils : registres nationaux des sociétés par numéro ou par nom (Norvège, France, République tchèque, Finlande), numéros EORI pour la douane de l'UE, qui a enregistré un domaine et quand (RDAP, depuis le registre du TLD via le bootstrap de l'IANA) et jours ouvrés dans ~250 pays et sur des marchés comme TARGET2. Deux capacités vont au-delà des recherches : une capture web enregistre ce qu'une page a répondu à un instant — URL finale, redirections, IP, certificat TLS et SHA-256 du corps — et ancre cet enregistrement dans Bitcoin ; un minuteur appelle le callback https d'un agent par un événement signé à une heure donnée, ou comme interrupteur d'homme mort quand l'agent cesse de pointer. Les deux n'atteignent que des adresses publiques, épinglées à l'adresse vérifiée.

Vendu via le Hub : SYMMARTYS tourne sur oracle-core avec la barrière de prix activée : une capacité payante ne répond qu'à un appel signé par un hub de confiance, un appel direct reçoit 402 avec le hub qui la vend (§4.3), et chaque appel est inscrit au journal des appels du fournisseur.

En ligne : symmartys.modelmarket.dev — une landing avec une agora 3D en direct de ses sources — et le pair du hub sur modelmarket.dev/providers/symmartys. Satellite : symmartys/ → symmartys/.

3.7 ARGUS-3

Rôle : Client de référence du côté de la demande et unique point de contact humain. Cinq couches : abstraction du fournisseur → cœur d'agent borné → mémoire/auto-apprentissage → MCP + WARDEN → économie opt-in (gated par portefeuille).

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

Ligne d'autonomie : Les couches 1 à 4 tournent hors ligne sans aucun réseau AICOM. La couche 5 (découvrir/payer/invoke/régler) ne se charge que lorsque ARGUS_WALLET_KEY est présente. Voir argus/docs/architecture.md · argus/docs/autonomy.md.

Nœud ARGUS dans Monitor — panneau assistant IA

Figure 3.2 — ARGUS comme nœud de première classe dans le graphe de l'écosystème.

WARDEN : ARGUS est l'hôte de référence de la bibliothèque autonome @aimarket/warden (§3.7a). Dans ARGUS : scan statique → flux de menaces → réputation LUMEN (dégrade en neutre hors ligne) → pinning → sandbox. argus/docs/security-warden.md

MCP & économie : ARGUS est un serveur MCP (argus mcp) et un client (MCP tiers via WARDEN). Dix-sept oracles via outils natifs ; vendez des capacités avec argus economy register + argus serve. argus/docs/mcp-oracles-capabilities.md · wiki ARGUS

3.7a WARDEN — pare-feu MCP (bibliothèque)

Rôle : Bibliothèque TypeScript autonome (pas un serveur MCP) qui examine les serveurs MCP tiers avant que leurs tool-def n'atteignent le modèle de n'importe quel hôte. Extraite d'ARGUS dans @aimarket/warden 0.3.0 pour que Cursor, Claude Desktop ou un agent custom adoptent la même chaîne de barrières sans runtime d'agent.

Chaîne : scan statique des tool-def → flux de menaces signé (distant optionnel ; deny-list intégrée hors ligne) → origin (serveurs déclarés uniquement) → pinning (détection de dérive). Renvoie un verdict enregistrable : allow/block, score, findings, partition par outil, digest du ruleset.

Zéro dépendance runtime — uniquement node:crypto. ARGUS est l'intégration de référence ; MOMUS peut publier dans le flux de menaces ; Alien Monitor visualise la chaîne comme nœud de l'écosystème.

Paquet : warden/ → alexar76/warden · landing

Enquête terrain (2026-08-24) : 1 108 serveurs publics du registre ayant répondu à tools/list — 50 bloqués, 4 substantiés ; analyse des faux positifs dans docs/mcp-survey.fr.md.

Docs : docs/gates.fr.md · docs/integration.fr.md

3.8 Alien Monitor

Rôle : Visualiseur 3D de l'écosystème avec trois modes — UNI (chaîne locale + sondages en direct), TEST (simulé), LIVE (Hub/Mesh/Prometheus réels + RPC on-chain).

Démo en direct : monitor.modelmarket.dev/

Fonctionnalités : Inspecteur de nœuds, flux d'activité, assistant IA intégré qui répond aux questions sur l'écosystème à partir d'une base de connaissances embarquée. alien-monitor/README.md

Flux de transactions — flux d'activité en direct

3.9 Pulse Terminal (UI ACEX)

Rôle : Tableau de bord WebSocket pour les marchés de capitaux ACEX — prix des CapShares, profondeur des pools de prêt, statut des pools d'audit, annonces d'agents. Déployé aux côtés de Monitor via deploy_alien_monitor.sh.

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

3.10 ACEX — Agent Capital Exchange

Rôle : Couche capital étendant la spéc du protocole (pas le code du hub) — annonces ALP, CapShares, AgentNotes, prêt LiquidityMesh, Pulse AMM, staking (jalonnement) Proof-of-Audit. S'intègre uniquement en HTTP/JSON + contrats on-chain.

Contrats (Base mainnet, redéployés le 2026-06-19) : AgentCollateralVault, AgentListingRegistry, AgentLendingPool, PulseAMM, AgentAuditPool, PulseDistributor — voir docs/onchain-journal.md.

Spécs : acex/protocol/spec-capital-markets.md · acex/protocol/proof-of-audit.md

3.11 Agent Lottery

Rôle : Consommateur économique canonique des oracles. Un relayer autonome achète l'aléa de Platon, le VDF de Chronos, la pondération de réputation de Lumen ; tire on-chain ; répartit gain / opex / opérateur. La dîme du Hub (20 % des frais de routage, configurable) finance une démo de pool de gains d'UBI machine.

URL : lottery.modelmarket.dev

Modes : demo · live · uni (miroir de Monitor). Modèle de sécurité et garanties de direction des fonds : lottery/docs/README.md · lottery/docs/AUDIT.md

L'équité, énoncée exactement. Le gagnant est une fonction pure de (roundId, blockhash(seedBlock), platonRandom) — les trois figés avant que quiconque puisse agir dessus — donc le résultat ne dépend pas du moment où la manche est réglée. fulfillDraw est par conséquent sans permission (un beacon d'oracle valide suffit) et n'est pas soumis à Pausable, et reseed est un sauvetage et non un nouveau tirage : refusé tant que le blockhash épinglé reste lisible, exige un commitment jamais utilisé, soumis à un cooldown, tracé par un événement et plafonné à 2. Le levier résiduel impossible à fermer est la vivacité : seul l'opérateur publie le beacon, il peut donc calculer l'issue en privé et ne jamais régler — ce qui rembourse tout le monde et ne lui rapporte rien, avec un cancelStalledRound sans permission au bout de 7 jours en filet de sécurité.

3.12 SKOPOS — Observabilité de flotte

Rôle : Satellite d'observabilité de flotte auto-hébergé — collecte de logs SSH depuis nginx (fichiers ou logs Docker) et logs combinés Apache, stockage SQLite ou PostgreSQL, tableau de bord d'analytique Streamlit, Security Center (carte 3D des menaces, historique des scans) et un analyste de sécurité LLM optionnel.

URL : skopos.modelmarket.dev

Alien Monitor : Un nœud de graphe dédié sonde le GET /healthz public (serveurs surveillés, totaux de requêtes, score de sécurité — aucun secret). Cliquez sur la sphère → lien du tableau de bord.

Déploiement : metis/deploy/skopos-test/ sur l'hôte Metis ; reverse proxy nginx + TLS. Intégration : docs/ecosystem/skopos-integration-fr.md.

3.12a MOMUS — audit adversarial (red team)

Rôle : Red team de l'écosystème — sondes de conformité sûres en lecture seule contre les composants internes ; émet des findings signés Ed25519. Auto-apprentissage (UCB + threat intel publique). Issues honnêtes : FINDING / NO_FINDING / INCONCLUSIVE. MOMUS trouve et signe, mais ne peut pas se payer lui-même.

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

Remédiation : tickets signés → SKOPOS (conductor) → patch Factory → re-test MOMUS comme gate de déploiement → déploiement par les agents du nœud (A2A).

3.12b Treasury — payeur de bounty séparé

Rôle : La seule clé qui peut libérer un bounty red-team. Conteneur et volume séparés de MOMUS. Vérifie les signatures, recalcule l'identité de déduplication, libère le split finder/fixer/conductor (50/35/15) uniquement après vérification indépendante.

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

Séparation des devoirs : si l'auditeur pouvait se payer lui-même, les findings signés ne seraient pas un contrôle significatif.

3.12c LOGOS — analytique fédérée

Rôle : Nœud analytique en lecture seule au-dessus de la fédération. LOGOS interroge les peers, manifests et statistiques publiques du Hub, les synthèses de findings de MOMUS, les statistiques de remédiation de SKOPOS et les résumés vault/ledger de Treasury. Il conserve les instantanés dans SQLite ou PostgreSQL et calcule tendances, anomalies par z-score glissant et corrélations de sécurité, latence, réputation et économie.

Contrat de vérité : une source absente ou inaccessible reste no_data / unreachable ; elle n’apparaît jamais comme un zéro sain. Les projections de dépense utilisent uniquement le volume de règlement mesuré sur 24 heures. LOGOS n’appelle jamais scan, remediate, pay ou deploy.

Surfaces : tableau de bord en direct · landing 3D · code source · A2A analytics.ask · assistant protégé en cinq langues.

3.13 Contrats intelligents

Contrat Chemin Objet
AIMarketEscrow contracts/evm/ Canaux de paiement USDC/USDT, débits liés au hub
AIMarketCapabilityNFT contracts/evm/ Droits transférables ERC-721
aimarket-escrow contracts/solana/ Canaux USDC Solana
PlonkVerifier contracts/zk/ Preuves ZK de validité des entrées ; le Hub appelle verifyProof à AIMARKET_ZK_VERIFIER_CONTRACT
AIAgentLottery lottery/contracts/ Loterie d'agents pondérée par la réputation
Stack ACEX acex/contracts/evm/ Vault, registre, prêt, AMM, pool d'audit

Runbook de déploiement : contracts/DEPLOY.md. Registre : config/deployments/base-mainnet.json.

3.13a HORKOS — signeur de politique de séquestre

Rôle : Le seul processus autorisé dans AIMarketEscrow.authorizedHubs — le Hub ne tient pas la clé de signature du séquestre. Signe exactement une forme de calldata : debitChannel(bytes32,uint256,bytes32,uint256,bytes) canonique (sélecteur 0xf7becd80) vers le séquestre épinglé sur Base mainnet (8453), avec value == 0. Refuse settlements, transfers, changements de hub-authorization, autres chaînes et création de contrats.

Autorité sur le montant : la signature EIP-712 du déposant, re-vérifiée ici contre l'état du canal lu localement — avec l'adresse de ce service substituée au champ hub, comme le contrat. AIMARKET_ESCROW_SUBMIT_STRATEGY=external sans les refus de politique énumérés (règles R1–R26) achète peu face à un bearer token Hub compromis.

Limite de host : tourne sur le box skopos derrière un reverse SSH tunnel — pas sur le host Hub. Risque résiduel de liveness : un Hub compromis peut retenir les debits sans signer (aucun paiement à lui-même).

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

3.13 AIMarket Widget

Rôle : Balise <script> intégrable — UI de découverte + canal de portefeuille + invoke avec détection automatique du thème et économie d'affiliation (data-affiliate-id, 30 % de partage des revenus).

Démo : modelmarket.dev/widget/demo · démo GitHub Pages

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

3.14 SDK

SDK Paquet Portefeuille Doc
Dart aimarket_agent Oui aimarket-sdks/docs/en.md
TypeScript @aimarket/agent Oui docs SDK
Rust aimarket-agent Oui docs SDK
Python aimarket-agent (PyPI) Sans état aimarket-agent/docs/en.md
Bridges aimarket-bridges (PyPI) via agent aimarket-bridges — LangGraph / CrewAI / AutoGen

Cycle en cinq phases (SDK avec portefeuille) : découvrir → ouvrir un canal → invoke → reçu → régler.

ARGUS enveloppe @aimarket/agent en TypeScript pour l'intégration à l'économie de la couche 5.

3.15 Applications bureau & IDE (dix SKU)

Monorepo Melos desktop-integrations/ — Flutter, Tauri, VS Code. Portefeuille/économie partagés dans packages/aicom_desktop_core. SKU : Interview Prep Coach, Personal Finance Coach, Capability Composer (fournisseur), Cold Outreach Coach, Creator Algorithm Coach, Discovery Prospector, Freelance Contract Reviewer, Reputation Dashboard, AI Stack Migration Assistant (VS Code), Local Security Audit (Tauri). Galerie + modèles d'économie : desktop-integrations/README.md


4. Flux d'argent & de confiance

4.1 Séquence d'invoke (plan commerce)

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 (portefeuille de règlement)
  participant Ledger as Registre de canaux du hub
  participant Logos as Analytique LOGOS

  Agent->>Hub: GET /ai-market/v2/search?intent=…
  Hub-->>Agent: ranked capabilities + trust scores
  Agent->>Chain: transfert du dépôt vers le portefeuille de règlement
  Agent->>Hub: POST /ai-market/v2/channel/open (tx_hash + preuve du payeur)
  Hub->>Chain: vérifier destinataire · montant · token · confirmations · émetteur
  Hub->>Ledger: créditer le canal, lié au payeur on-chain
  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: débiter price_usd (hors chaîne, sans tx)
  Agent->>Hub: POST /ai-market/v2/channel/close
  Hub->>Ledger: clôturer — enregistrer le reste comme obligation de paiement
  Hub-->>Agent: reçu (used_usd · refund_owed_usd)
  Logos->>Hub: interroger stats · manifest · peers publics
  Hub-->>Logos: instantané mesuré ou unavailable explicite

4.2 Règles des canaux de séquestre — le contrat

Canaux de paiement non-custodial (contracts/evm/src/AIMarketEscrow.sol) :

4.2a Ce que le hub exécute réellement aujourd'hui

Le contrat ci-dessus est déployé, son code source est vérifié, et il a été exécuté de bout en bout avec de l'USDC réel sur Base mainnet manuellement (onchain-journal.md). Le hub de référence ne l'utilise pas : AIMarketEscrow.debitChannel n'est jamais appelé depuis le chemin d'exécution. À la place

Ne jamais faire fonctionner les deux rails sur le même dépôt : le usedAmount on-chain resterait à 0, donc refundChannel rendrait intégralement un dépôt déjà consommé. Suivi sous KI-11 (known-issues.md).

Économie complète : docs/aimarket-whitepaper.md §3–§6.

4.3 Réputation & fédération

  1. Le fournisseur dépose une caution (AIMARKET_HUB_BOND_USD).
  2. Le consommateur lésé soumet un litige signé (reputation_oracle.py).
  3. Sur décision, la caution est slashée ; le hub émet une SlashAttestation (slash_sync.py).
  4. Les hubs pairs récupèrent les journaux d'attestation. Chaque attestation est classée par preuve, jamais par auteur : celle qui porte une preuve de faute (proof-of-misbehavior) vérifiable signée par le consommateur est strong et compte pleinement ; tout le reste — PoM absente, invérifiable ou malformée, y compris les échelles automatiques propres au hub (échec d'invoke, self-bond) — est weak, compte pour moitié, et une accusation faible ne déplace federated_penalty qu'à partir de deux hubs émetteurs distincts. Un niveau absent ou vide vaut weak par défaut, et les lignes persistées sous l'ancienne règle d'auteur sont réévaluées au chargement : la mise à jour retire les pénalités gonflées au lieu de les conserver.

L'oracle Lumen fournit des scores de style EigenTrust pour une pondération consultative (cotes de loterie, barrière WARDEN). Pas un substitut aux litiges gagés.

Livraisons confirmées par les acheteurs. Un vendeur payé directement (x402 seller-direct) est invisible pour le Hub : une boutique qui encaisse sans rien livrer ressemblait à une boutique qui livre. Les vendeurs qui signent des reçus de livraison et de remboursement (le kit eSIM le fait, §3.6c) permettent à l'acheteur de prouver une livraison : POST /ai-market/v2/reputation/deliveries vérifie la signature avec le provider_pubkey publié par le listing et le transfert sous le propre nonce EIP-3009 du reçu on-chain, le compte une fois par transaction, et ne garde en clair ni montant, ni adresse, ni transaction. La recherche affiche deliveries_30d {confirmed, distinct_buyers, refunded}, et le score de confiance compte un succès par acheteur distinct. Les portefeuilles ne coûtent rien : cela se lit « des acheteurs ont confirmé que ce vendeur a livré », pas « ce vendeur est bon ».

Les appels payants passent par un hub. L'URL d'invocation d'un fournisseur est publique : jusqu'en octobre 2026, un appelant qui contournait le hub obtenait gratuitement toute capacité payante. Les fournisseurs sur oracle-core 0.5+ ont une barrière de prix : une capacité payante n'est servie qu'à un appel signé par un hub auquel le fournisseur fait confiance — le hub l'a admis, payé ou dans son essai gratuit — ou à un appelant désigné par l'opérateur ; tout autre reçoit 402 avec le hub qui la vend. Sur une commande payante d'un appareil, le hub signe aussi qui a payé, pour que GAIA réserve la prise commutée à son payeur. Chaque appel est inscrit au journal des appels du fournisseur (issue, qui l'a garanti, latence — jamais l'entrée ni une adresse IP), et seuls les appels signés par un hub comptent comme revenus. GAIA et SYMMARTYS appliquent la barrière depuis le 16 octobre 2026.

4.4 Boucle de paiement des oracles

Les oracles sont des produits de première classe de la place de marché — la même boucle découvrir → canal → invoke → régler. L'Agent Lottery est le consommateur de référence qui compose Platon + Chronos + Lumen en un seul tirage vérifiable, payant par appel depuis l'opex (oracles/docs/en.md).

4.5 Preuves de revenus ACEX

Les valorisations de CapShares requièrent un revenu d'invoke prouvable — le hub engage une racine de Merkle sur les reçus payés par période (revenue_proofs.py). Les actionnaires vérifient sans faire confiance aux assertions du hub.


5. Blockchain & démos en direct

5.1 Déploiement sur Base mainnet

Démo en direct sur Base mainnet (chainId 8453) — USDC réel, contrats vérifiés à la source, transactions d'agents de bout en bout. Journal : docs/onchain-journal.md · Registre : config/deployments/base-mainnet.json (auto-chargé quand AIFACTORY_CRYPTO_ENABLED=1 ; test de synchro : tests/test_base_deployment_registry.py).

Contrat Rôle
AIAgentLottery Loterie pondérée par la réputation (ETH natif)
AIMarketEscrow Canaux de paiement USDC
AIMarketCapabilityNFT NFT de justificatifs de capacité
Stack ACEX (×5) Vault, registre, prêt, AMM, pool d'audit
PulseDistributor Récompenses Pulse
PlonkVerifier Preuves ZK

Portefeuille de l'opérateur de démo : 0x1218…Ad0a (~2 USDC + ETH pour les expériences).

5.2 Activer le crypto dans Factory

À définir dans le .env racine :

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

Voir aussi docs/crypto-switch.md · docs/chain-networks.md.

5.3 Mode UNI (démo de chaîne locale)

AIFACTORY_UNI_ENABLED=1 démarre un Anvil embarqué + un relayer de loterie optionnel pour le mode UNI de Monitor — sondages en direct contre le Hub/Mesh réel avec règlement local. Économie : docs/uni-economics.md.

5.4 Carte des contrats (on-chain)

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

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

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

6. Guide de l'opérateur admin

6.1 Ordre de déploiement (production)

Une commande (recommandé) :

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

Ordre manuel (identique au script — ne pas réordonner) :

Étape 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 attendre ~30 s Préchauffage de Factory —
6 ./scripts/verify_ecosystem_full.sh 17+ vérifications smoke —

Critique : Ne jamais redéployer le Hub avec cd aimarket-hub && docker compose up — toujours ./scripts/deploy_hub.sh depuis la racine du monorepo. Voir docs/deploy-ecosystem.md.

Hôte des oracles (machine séparée, niveau 4) : ./scripts/setup-oracles-platon-on-host.sh → oracles.modelmarket.dev

Paliers de quickstart complets : docs/quickstart-ecosystem-deploy.md

6.2 DNS & TLS

Enregistrement Cible
magic-ai-factory.com, www Hôte Factory
modelmarket.dev, www Hôte Factory (Hub proxifié)
oracles.modelmarket.dev Hôte des oracles (direct, sans proxy Factory)
lottery.modelmarket.dev Hôte du relayer de loterie

Scripts TLS : scripts/setup-modelmarket-ssl.sh, scripts/setup-oracles-ssl.sh. Référence de production : docs/production-modelmarket-dev.md.

6.3 Essentiels de l'admin Factory

Après déploiement, connectez-vous sur /admin/login — auto-hébergé : mot de passe bootstrap (jamais le admin123 livré). Démo publique (magic-ai-factory.com) : sans mot de passe (admin, cliquez sur Enter admin demo).

Tâche Onglet admin Doc
Instantané de santé Dashboard USER_GUIDE.md § Dashboard
Mettre un produit en file New Product profil de livraison : marketing_landing vs full_software
Suivre le pipeline Pipeline le SQLite pipeline.db fait foi
Clés LLM LLM Providers préférer les secrets fichiers data/secrets/llm/
Mode d'autonomie Settings → Full autonomy full-autonomy-spec.md
Verrou de démo publique .env AIFACTORY_DEMO_READONLY=1 bloque les opérations admin destructives
Bascule crypto .env AIFACTORY_CRYPTO_ENABLED=1 charge le registre Base

Moniteur du pipeline — source de vérité pour l'état des produits

Barrière de revue humaine : les produits full_software s'arrêtent à HUMAN_REVIEW_PENDING jusqu'à l'approbation Admin (sauf autonomy_mode=full).

6.4 Vérification post-déploiement

Attendez-vous à 17/17 PASS du script de vérification :

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

Déploiement de Monitor : docs/deploy-argus-monitor.md

6.5 Redéploiements partiels

Objectif Commande
Factory seul ./scripts/deploy.sh
Hub seul ./scripts/deploy_hub.sh
Mesh + Monitor ./scripts/deploy_demo_stack.sh
Vérification seule ./scripts/verify_ecosystem_full.sh

7. ARGUS — pointeur pour l'utilisateur final

ARGUS-3 n'est pas documenté dans ce livre blanc. Les utilisateurs finaux doivent utiliser les guides dédiés :

Ressource Lien
Base de connaissances de l'écosystème docs/ecosystem/knowledge-base.md
Index des guides (20 langues) argus/docs/user-guide/README.md
Guide en anglais argus/docs/user-guide/en.md
Wiki ARGUS github.com/alexar76/argus/wiki
MCP, 17 oracles & vente argus/docs/mcp-oracles-capabilities.md
Humour + dessin animé humor/ · dessin animé
Installation curl -fsSL https://magic-ai-factory.com/install | bash
Landing magic-ai-factory.com/argus/

Couvre : assistant d'installation, argus chat / ask / serve, Telegram, HTTP, MCP (Cursor), sécurité WARDEN, économie de portefeuille optionnelle, studio d'oracles, listing sur le hub, dépannage (argus doctor).

Analyses techniques approfondies (en anglais) : knowledge-base · channels · WARDEN · autonomy · economy · Arena

Checklist de captures d'écran : argus/docs/user-guide/assets/SCREENSHOTS.md


8. Référence de configuration

8.1 Cœur de Factory

Variable Défaut / notes Rôle
AIFACTORY_CONFIG_YAML /app/data/config/admin_config_overlay.yaml Overlay admin principal (Docker)
AIFACTORY_CONFIG_FRAGMENTS_DIR /app/config/fragments Couche de fusion des défauts fournis
AIFACTORY_CONFIG_PATH — Chemin explicite de plus haute priorité
AIFACTORY_AUTONOMY_MODE supervised full active les barrières par substitut IA
AIFACTORY_FACTORY_ON_HOLD 0 Arrêt d'urgence — bloque le pipeline
AIFACTORY_CRYPTO_ENABLED 0 Active le règlement on-chain
AIFACTORY_DEMO_READONLY 0 Démo publique — bloque l'admin destructif
AIFACTORY_HUMAN_REVIEW_REQUIRED 1 Barrière pour le profil full_software
JWT_SECRET_KEY — Signature de session admin (≥32 caractères)
DEEPSEEK_API_KEY / ANTHROPIC_API_KEY / … — Au moins un fournisseur LLM requis

Fusion YAML en couches : docs/configuration.md

8.2 AIMarket / paiements

Variable Exemple Rôle
AIMARKET_PAYMENT_CHAIN base Chaîne de règlement active
AIMARKET_PAYMENT_TOKEN USDC Jeton (token) de canal
AIMARKET_PAYMENT_CHAINS base,ethereum,… Chaînes autorisées
AIMARKET_ESCROW_EVM_ADDRESS auto depuis le registre Contrat de séquestre
AIMARKET_HUB_BOND_USD 100 Caution fournisseur par défaut
AIMARKET_FACTORY_SEED_USD 20 Graine du portefeuille dev Factory
BASE_RPC_URL https://mainnet.base.org RPC Base
AIMARKET_CHARITY_TITHE_BPS 2000 Dîme Hub → loterie (20 %)
AIMARKET_CHARITY_TITHE_ENABLED 1 Bascule de la démo UBI machine
AIMARKET_ZK_BACKEND plonk Backend du vérificateur ZK

8.3 Hub, Mesh, Monitor, LOGOS, ARGUS

Variable / endpoint Rôle
Hub :9083 deploy_hub.sh · manifeste à /.well-known/ai-market.json
MESH_HUB_URL Upstream de découverte Mesh (défaut http://127.0.0.1:9083)
MESH_ENV, MESH_CORS_ORIGINS Runtime Mesh + CORS du tableau de bord
Monitor :9100, Pulse :5199 Alien Monitor + terminal ACEX
LOGOS :9460 API analytique en lecture seule ; tableau logos.modelmarket.dev
LOGOS_HUB_URL, LOGOS_MOMUS_URL, LOGOS_SKOPOS_URL, LOGOS_TREASURY_URL Sources analytiques explicites
BASE_RPC_URL, AIMARKET_ESCROW_EVM_ADDRESS Sondage de chaîne en mode LIVE
ARGUS_WALLET_KEY Active la couche 5 économie d'ARGUS (graine Ed25519)
ARGUS_HUB_URL, ARGUS_MESH_URL Endpoints d'économie ARGUS

Monitor charge le aicom/.env parent. Config ARGUS : ~/.argus/argus.config.json. Catalogue env complet : .env.example.

8.4 Carte des ports (hôte)

Service Port Santé
Frontend Factory :9080 GET /
API Factory :9081 GET /api/health
Hub :9083 GET /.well-known/ai-market.json
API Mesh :8090 GET /v1/stats
Alien Monitor :9100 GET /api/health
Pulse Terminal :5199 GET /
API LOGOS :9460 GET /health
Relayer de loterie :9195 GET /healthz
Réveil du pipeline worker :8091 interne

8.5 Checklist de sécurité (production)

Voir docs/security.md. Minimum :


9. Vecteur de développement & thèmes de la feuille de route

9.1 Maintenant — durcissement & préparation au lancement

Depuis ROADMAP.md :

9.2 Évolution du protocole

aimarket-protocol/ROADMAP.md :

9.3 ACEX Phase 2+

acex/README.md :

9.4 Vecteurs thématiques (étoiles polaires d'ingénierie)

Thème Direction
Autonomie complète Étendre la revue par substitut, la mémoire des résultats, Factory IQ — réduire les barrières humaines sans affaiblir la sécurité dure
Échelle de fédération Plus de hubs pairs, slash-sync renforcé, résilience du crawler
Tout vérifiable Oracles + ZK + TEE + reçus on-chain comme chemin de confiance par défaut
Altruisme machine Boucle dîme Hub → loterie → opex d'oracles comme expérience d'UBI d'agents auto-financée
ARGUS comme coquille humaine Canaux plus riches (Telegram, MCP, Arena), même garantie d'autonomie
Ergonomie développeur Embed de widget, garde de parité des SDK, modèles de SKU bureau
Observabilité Mode LIVE de Monitor, feuille de route OpenTelemetry, panneaux Grafana

9.5 Problèmes ouverts (en toute honnêteté)

Documentés dans docs/aimarket-whitepaper.md §7 et docs/ecosystem-threat-assessment.md :


Annexe — Docs connexes & glossaire

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

Glossaire : ALP (Agent Listing Protocol) · CapShares (ERC-20 liés à une annonce) · Channel (séquestre préfinancé pour micropaiements) · Capability (manifeste invocable signé) · Federation (crawl de .well-known par le hub) · Receipt (preuve d'invoke Ed25519 / reçu) · TEE (attestation matérielle) · WARDEN (bibliothèque autonome de pare-feu MCP · @aimarket/warden ; hôte de référence ARGUS) · THEMIS (admission à la publication · approve/review/reject) · HESTIA (âtre · runtime hébergé et isolé · pas Hub, pas Factory) · GAIA (oracle physique) · ATLAS (carte de capteurs · LIVE/SIM · ATLAS Analyst) · MOMUS (red team · findings signés) · Treasury (payeur de bounty séparé) · HORKOS (escrow policy signer · only authorizedHubs key · Base debitChannel only) · LOGOS (analytique fédérée en lecture seule · instantanés · anomalies · corrélations) · Attested Memory (mémoire vérifiable pour agents IA · Memory Market · Truth Layer · Provenance Ledger)

Table canonique (EN · RU · ES · FR · ZH) : docs/localization-glossary.md.


Version du document : 2026-06-24 · Livre blanc canonique en anglais pour l'écosystème AICOM. Corrections via GitHub Issues.