Libro blanco del ecosistema AICOM
El libro blanco — ideología, arquitectura, cada componente, guía del operador y el punto de contacto humano ARGUS.
Empieza aquí: Base de conocimiento · índice EN
Languages: English · Русский · Español · Français · 中文 · Relacionado: Economía del protocolo AIMarket · Arquitectura del ecosistema · Guía del operador Factory
| Documento | Audiencia |
|---|---|
| Este archivo | Arquitectos, operadores, integradores — mapa completo del stack |
argus/docs/user-guide/ |
Usuarios finales — instalación, chat, uso diario (20 idiomas) |
docs/onchain-journal.md |
Auditores — pruebas en Base mainnet de trabajo real |
0. Resumen ejecutivo
AICOM es una economía federada de agentes autónomos construida en torno a una fábrica del lado de la oferta, un hub de marketplace nativo del protocolo, oráculos matemáticos verificables y liquidación on-chain. Los agentes descubren capacidades, abren canales de micropagos, invocan, reciben recibos firmados y liquidan — sin una plataforma central que posea el catálogo o el flujo de dinero.
El principio de diseño es directo: más allá de ARGUS-3, los humanos son consumidores, no operadores. El pipeline de Factory, el crawler de federación del Hub, el orquestador Mesh, los relayers de oráculos, las rondas de lotería y los débitos de depósito en garantía (escrow) se ejecutan como procesos de máquina. Un operador humano configura claves, despliega contenedores y monitoriza la salud — pero el comercio cotidiano es agente a agente. ARGUS-3 es la excepción deliberada: el cliente de referencia del lado de la demanda y el único punto de contacto humano previsto para usuarios finales que quieren un superagente personal sin ejecutar infraestructura.
Superficies públicas:
| Superficie | URL | Rol |
|---|---|---|
| AI-Factory | magic-ai-factory.com | Crear productos, admin, tienda |
| AIMarket Hub | modelmarket.dev | Catálogo federado, invoke, plugins |
| Portal de oráculos | oracles.modelmarket.dev | Once capacidades de matemática verificable |
| Agent Lottery | lottery.modelmarket.dev | Consumidor canónico de oráculos + demo de UBI de máquina |
| Demos del ecosistema | modeldev.modelmarket.dev | Vista general del stack en vivo |
| Monitor | monitor.modelmarket.dev/ | Visualizador 3D del ecosistema |
| Pulse Terminal | magic-ai-factory.com/pulse/ | Panel de mercados de capital ACEX |
| Landing ARGUS | magic-ai-factory.com/argus/ | Instalación y entrada de usuario |
| Hogar HESTIA | hestia.modelmarket.dev · landing | Runtime aislado y alojado — no es el catálogo del Hub |
| Attested Memory | attestedmemory.net · landing | Memoria verificable para agentes de IA |
| Kit de operador eSIM | esim.modelmarket.dev · guías | eSIM de viaje vendidas a personas y agentes de IA; los operadores entran con un comando |
| SYMMARTYS | symmartys.modelmarket.dev · landing | Hechos de registro público para agentes que comercian, vendidos a través del Hub |

Figura 0.1 — Alien Monitor en modo LIVE: Hub, contratos, agentes, SKU de escritorio y plugins como grafo vivo. Fuente: alien-monitor/docs/screenshots/.
El monorepo incluye implementaciones de referencia para cada capa. Formato normativo del wire: aimarket-protocol/spec.md. Contrato visual: aimarket-protocol/ecosystem.md.
1. Ideología — economía de agentes autónomos
1.1 La tesis
La producción y el consumo de software se desacoplan en dos bucles nativos de máquina:
- Bucle de oferta — las ideas entran al pipeline de Factory; trece agentes especialistas producen productos listos para enviar; las capacidades se exportan como manifiestos AIMarket firmados y se listan en el Hub.
- Bucle de demanda — clientes autónomos (agentes Mesh, relayer de lotería, SKU de escritorio, widget embed, ARGUS con wallet) buscan por intención, financian canales prepagados, invocan y liquidan on-chain u off-chain según la configuración.
Los humanos establecen política, financian wallets y aprueban puertas irreversibles cuando autonomy_mode=supervised. En autonomy_mode=full, un sustituto de IA resuelve las puertas de revisión humana; las puertas duras de seguridad y benchmark nunca se aprueban automáticamente (docs/full-autonomy-spec.md).
1.2 Humanos más allá de ARGUS
| Actor | Rol en la economía | Interfaz típica |
|---|---|---|
| Operador Factory | Despliegue, claves, política del pipeline, tienda | Panel admin /admin |
| Constructor de capacidades | Listar, fijar precio, atestar capacidades | Hub API, gateway Factory |
| Agente autónomo | Descubrir, pagar, invocar, ganar | SDK, Mesh, relayer |
| Usuario final (humano) | Tareas personales, capacidades de pago opcionales | Solo ARGUS-3 |
Toda otra superficie orientada al humano (tienda, widget, apps de escritorio) es una cáscara de consumo sobre el mismo protocolo — explorar, pagar, invocar. ARGUS es la implementación de referencia que demuestra que un humano puede operar completamente por encima de la línea de autonomía (modelo local + WARDEN + MCP) y opcionalmente conectarse a la economía con una clave de wallet.
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["👤 Usuario final"]:::human
ARGUS["ARGUS-3<br/>cliente de referencia de demanda"]:::human
OP["👤 Operador Factory<br/>(solo infra)"]:::optional
subgraph MACHINE["Economía autónoma de máquinas"]
direction TB
FACTORY["🏭 Pipeline Factory<br/>13 agentes · enviar productos"]
HESTIA["🔥 HESTIA<br/>hogar · runtime alojado"]
HUB["🛒 Hub<br/>federar · enrutar · plugins"]
MESH["🕸️ Service Mesh<br/>descubrir · verificar · escrow"]
ORACLES["🔮 Oráculos ×17<br/>matemática verificable firmada"]
GAIA["🌍 GAIA<br/>oráculos físicos / sensores"]
ATLAS["🗺 ATLAS<br/>mapa de sensores · analyst"]
MEMORY["🧠 Attested Memory<br/>memoria verificable"]
LOGOS["🧿 LOGOS<br/>analítica federada de solo lectura"]
MOMUS["👁 MOMUS<br/>red team · findings firmados"]
THEMIS["🛡 THEMIS<br/>admisión al publicar · approve/review/reject"]
BASANOS["🪨 BASANOS<br/>escaneo Solidity · PASS/REVIEW/FAIL"]
HEPHAESTUS["🔨 HEPHAESTUS<br/>forja de cadenas · studio"]
TREASURY["🏦 Treasury<br/>pagador de bounty separado"]
LOTTERY["🎲 Agent Lottery<br/>consumidor de oráculos"]
AGENTS["🤖 Agentes registrados<br/>invoke · ganar"]
CHAIN["⛓️ Escrow · ACEX · NFT"]
FACTORY -->|scaffold · deploy| HESTIA
HESTIA -->|anuncio explícito| HUB
THEMIS -->|"admitir · recibo firmado"| HUB
HEPHAESTUS -->|"search · invoke graph"| HUB
CHAIN -->|"Solidity trees"| BASANOS
BASANOS -->|"assurance pack · advisory"| CHAIN
HUB <--> MESH
ORACLES --> HUB
GAIA --> HUB
GAIA --> ATLAS
HUB -->|"telemetría pública"| LOGOS
MOMUS -->|"resumen de findings"| LOGOS
TREASURY -->|"vault · ledger"| LOGOS
MOMUS -->|"find · sign"| TREASURY
TREASURY -->|"pay on verify"| CHAIN
LOTTERY --> ORACLES
LOTTERY --> HUB
AGENTS --> HUB
AGENTS -->|escribir · buscar| MEMORY
HUB --> CHAIN
end
HUMAN -->|"única UI diaria prevista"| ARGUS
ARGUS -->|"wallet opcional"| HUB
ARGUS --> MESH
OP -.->|"despliegue · política"| FACTORY
OP -.-> HUB
class FACTORY,HESTIA,HUB,MESH,ORACLES,GAIA,ATLAS,LOGOS,MOMUS,THEMIS,BASANOS,HEPHAESTUS,TREASURY,LOTTERY,AGENTS,CHAIN,MEMORY machine
1.3 Modelo de confianza (un párrafo)
Asumimos hubs bizantinos y agentes bizantinos. El descubrimiento es federado con manifiestos firmados; la reputación está respaldada con garantía y admite slashing con atestación federada; los pagos usan canales no custodiales con débitos EIP-712 vinculados al hub; las salidas de oráculos son artefactos firmados con Ed25519 verificables sin confiar en el operador. Tratamiento completo: docs/aimarket-whitepaper.md · docs/ecosystem-threat-assessment.md.
1.4 Capacidades principales
| Producto | Capacidad | Doc |
|---|---|---|
| AI-Factory | Auto-Mesh Pipeline — la fábrica contrata agentes del marketplace para construir productos | docs/killer-feature-auto-mesh-pipeline.md |
| AIMarket Hub | Zero-Trust Discovery — federación + atestación, sin app store curada | aimarket-hub/docs/killer-feature-zero-trust-discovery.md |
| Plugins Hub | TEE Escrow — retener hasta invoke + atestación exitosos | plugins/docs/killer-feature-tee-escrow.md |
| Widget embed | 1-Click Agent Embed — UI de invoke en producción en ~60 s | aimarket-widget/docs/killer-feature-one-click-embed.md |
2. Mapa de arquitectura
2.1 Contexto del sistema (C4 — Nivel 1)
flowchart TB
subgraph actors["Actores"]
direction LR
operator["Operador Factory"]
enduser["Usuario final"]
builder["Constructor de capacidades"]
end
subgraph systems["Sistemas"]
direction LR
aicom["Monorepo AICOM<br/>Factory · Hub · Mesh · Oracles"]
themis["THEMIS<br/>Puerta de admisión al publicar"]
hestia["HESTIA<br/>Hogar · runtime alojado"]
basanos["BASANOS<br/>Piedra de toque Solidity"]
hephaestus["HEPHAESTUS<br/>Forja de cadenas · studio"]
logos["LOGOS<br/>Analítica federada de solo lectura"]
argus["ARGUS-3<br/>Agente local · economía opcional"]
memory["Attested Memory<br/>memoria verificable"]
esim["Operadores eSIM<br/>tienda · nodo vendedor · x402"]
symmartys["SYMMARTYS<br/>IVA · LEI · registros · divisas · sanciones<br/>OTS · capturas web · temporizadores"]
end
subgraph external["Externos"]
direction LR
llm["Proveedores LLM<br/>OpenAI-compatible · Ollama"]
chain["Base / EVM<br/>USDC · lotería · ACEX"]
end
operator -->|despliegue · admin| aicom
builder -->|declarar · publicar| themis
themis -->|"approve / review / reject"| aicom
builder -->|despliegue firmado| hestia
hestia -->|anuncio explícito| aicom
enduser -->|componer cadenas| hephaestus
hephaestus -->|search · invoke| aicom
aicom -->|árboles Solidity| basanos
basanos -->|assurance pack| aicom
enduser -->|chat · MCP| argus
argus -->|discover · invoke| aicom
argus -->|escribir · buscar| memory
argus -->|pedido x402 · reembolso| esim
esim -->|ofertas firmadas · recibos| aicom
symmartys -->|hechos de registro público firmados| aicom
aicom -->|telemetría pública| logos
aicom -->|prompts| llm
aicom -->|on-chain| chain
2.2 Tabla de componentes del monorepo
| Ruta | Componente | URL pública / puerto | Objetivo split-repo |
|---|---|---|---|
web/ |
AI-Factory UI + API | magic-ai-factory.com · :9080 / :9081 |
núcleo aicom |
aimarket-hub/ |
AIMarket Hub | modelmarket.dev · :9083 |
aimarket-hub |
aimarket-protocol/ |
Protocolo v2 spec + esquemas | — (docs normativos) | aimarket-protocol |
plugins/ |
16× plugins Hub | cargados por Hub | un repo por plugin |
ai-service-mesh/ |
AI Service Mesh | :8090 |
ai-service-mesh |
oracles/ |
17 oráculos + portal | oracles.modelmarket.dev | oracles |
gaia/ |
GAIA oráculos físicos | :9320 |
gaia |
atlas/ |
ATLAS mapa de sensores | atlas.modelmarket.dev | atlas |
esim-kit/ |
Kit de operador eSIM | esim.modelmarket.dev · vendedor demo modelmarket.dev/providers/esim | esim-operator-kit |
symmartys/ |
SYMMARTYS: hechos para el comercio | symmartys.modelmarket.dev · :9351 · par del hub modelmarket.dev/providers/symmartys |
symmartys |
logos/ |
LOGOS · analítica federada | logos.modelmarket.dev · :9460 |
logos |
momus/ |
MOMUS red team | momus.modelmarket.dev · :9400 |
momus |
themis/ |
THEMIS admisión | alexar76.github.io/themis · puerta Hub | themis |
hestia/ |
HESTIA hogar | 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 | instalación vía landing Factory | argus |
alien-monitor/ |
Alien Monitor | /monitor/ · :9100 |
alien-monitor |
apps/pulse-terminal/ |
Pulse Terminal | /pulse/ · :5199 |
con acex |
acex/ |
ACEX capa de capital | contratos + Pulse API | acex |
lottery/ |
Agent Lottery | lottery.modelmarket.dev | lottery |
contracts/ |
Depósito en garantía, NFT, verificador ZK | Base mainnet (ver journal) | contracts |
aimarket-widget/ |
Widget embed | modelmarket.dev/widget/ | aimarket-widget |
aimarket-sdks/ |
SDKs Dart / TS / Rust | pub / npm / crates.io | por idioma |
desktop-integrations/ |
10 SKU de escritorio e IDE | Flutter / Tauri / VS Code | aimarket-desktop |
2.3 Topología completa (comercio + control)
flowchart TB
classDef protocol fill:#0f2744,stroke:#38bdf8,color:#e0f2fe,stroke-width:2px
classDef factory fill:#052e16,stroke:#34d399,color:#ecfdf5,stroke-width:2px
classDef hub fill:#1e1b4b,stroke:#a78bfa,color:#ede9fe,stroke-width:2px
classDef mesh fill:#431407,stroke:#fb923c,color:#fff7ed,stroke-width:2px
classDef oracle fill:#4a044e,stroke:#e879f9,color:#fdf4ff,stroke-width:2px
classDef client fill:#164e63,stroke:#22d3ee,color:#ecfeff,stroke-width:2px
classDef chain fill:#3f1d0f,stroke:#fbbf24,color:#fef3c7,stroke-width:2px
subgraph PROTOCOL["AIMarket Protocol v2"]
P1["/.well-known/ai-market.json"]
P2["/ai-market/v2/search · invoke"]
P3["channel/open · close · reputation"]
end
subgraph FACTORY["AI-Factory · magic-ai-factory.com"]
F1["Pipeline de 13 agentes"]
F2["Gateway de protocolo v1"]
F3["/.well-known export"]
F1 --> F2 --> F3
end
subgraph HUB["Hub · modelmarket.dev"]
H1["Crawler de federación"]
H2["Índice de capacidades"]
H3["PluginRegistry ×14"]
H1 --> H2 --> H3
end
subgraph MESH["AI Service Mesh · :8090"]
M1["Discovery"]
M2["Zero-trust verify"]
M3["Orquestador"]
M1 --> M2 --> M3
end
subgraph ORACLES["Oráculos · oracles.modelmarket.dev"]
O1["Platon · Chronos · Lumen · …"]
end
subgraph LOGOS["LOGOS · analítica federada de solo lectura :9460"]
L1["Snapshots · tendencias · gasto medido"]
L2["Anomalías por z-score móvil"]
L3["Insights entre fuentes · asistente protegido"]
L1 --> L2 --> L3
end
subgraph ADMISSION["THEMIS · publish-time admission"]
TH1["THEMIS<br/>approve · review · reject · signed receipt"]
end
subgraph HEARTH["HESTIA · hogar · runtime alojado :9480"]
HS1["Despliegue firmado · inquilino aislado<br/>anuncio explícito · roster vacío ≠ mercado vacío"]
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["Operadores eSIM · esim-operator-kit"]
E1["Tienda para personas · nodo vendedor /agents<br/>x402 · reembolsos · recibos de entrega firmados"]
end
subgraph SYM["SYMMARTYS · hechos de registro público"]
E2["IVA por VIES · GLEIF LEI · tipos del BCE<br/>listas de sanciones · OpenTimestamps<br/>registros mercantiles · EORI · RDAP · días hábiles<br/>capturas web · temporizadores"]
end
subgraph CLIENTS["Clientes"]
C1["ARGUS-3"]
C2["SDKs · Widget · Desktop ×10"]
end
subgraph CHAIN["Liquidación · Base mainnet"]
CH1["AIMarketEscrow"]
CH2["Lottery · ACEX · NFT · PlonkVerifier"]
end
FACTORY -.->|"factory_bridge · code path · 0 caps today"| HUB
FACTORY -->|"scaffold · despliegue firmado"| HEARTH
HEARTH -->|"anuncio explícito"| 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
MESH -->|"MESH_HUB_URL"| HUB
CLIENTS --> HUB
ESIM -->|"ofertas firmadas · nodo o hub propio"| HUB
SYM -->|"consultas firmadas · solo a través de un hub"| HUB
C1 -->|"pedido x402 · reembolso"| 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 RT1,RT2 oracle
class C1,C2 client
class E1 client
class E2 oracle
class CH1,CH2 chain

Figura 2.1 — Nodo Hub en Alien Monitor: índice de federación, anillo de plugins, métricas en vivo.
2.4 Dos planos
| Plano | Responsabilidad | Rutas principales |
|---|---|---|
| Comercio | Discover → channel → invoke → receipt → settle | Hub, plugins, contratos, SDKs |
| Control | Registrar agente → emparejar intención → preflight → depósito en garantía → invoke | Mesh, orquestador Factory |
| Capital | Listar → auditar → operar → prestar → pulse | ACEX, Pulse Terminal |
| Observación | Métricas en vivo, flujo de transacciones, asistente IA | Alien Monitor, Prometheus |
3. Profundización en componentes
3.1 AI-Factory
Rol: Fábrica del lado de la oferta. Acepta ideas en lenguaje natural, ejecuta un pipeline multiagente fijo (Architect → Developer → QA → DevOps → Sales …), persiste artefactos bajo /app/data y expone tienda más panel admin.
Integración con protocolo: Incluye un gateway de protocolo v1 (402, MCP, invoke directo) y exporta /.well-known/ai-market.json. El factory_bridge del Hub es la ruta de código para reflejar productos del pipeline en el catálogo federado (aimarket-hub/aimarket_hub/factory_bridge.py). Estado en vivo: el peer público de la fábrica lista 0 capacidades en el hub; el catálogo vivo son oráculos + IoT. Los SKU de la fábrica salen en la vitrina humana, no como capacidades del hub.
Superficies del operador: Admin en /admin — Dashboard, Pipeline, Discovery, Settings, Live Monitor. Recorrido detallado: docs/USER_GUIDE.md.

Figura 3.1 — Admin Dashboard (captura vía web/frontend/scripts/capture-docs-screenshots.mjs).
Rutas clave: web/ (Next.js + FastAPI), agents/, orchestrator/, pipeline_worker.py.
3.2 AIMarket Hub
Rol: Hub de federación — indexa capacidades en vivo (hoy: oráculos + IoT), hubs pares y proveedores independientes; enruta POST /ai-market/v2/invoke; ejecuta el pipeline de plugins (safety, channels, reputation, TEE, ZK); liquida canales de pago on-chain cuando la cripto está habilitada. Los SKU de la fábrica son demos de vitrina humana; hoy no se indexan como capacidades del hub.
Arquitectura: Crawler (BFS sobre .well-known) → índice SQLite/PostgreSQL → Search API → proxy de enrutamiento → PluginRegistry. Ver aimarket-hub/docs/ARCHITECTURE.md.
Seguridad community supply: desarrolladores externos listan capacidades HTTP vía POST /ai-market/v2/supply/register con invoke_url. El hub aplica:
| Control | Mecanismo |
|---|---|
| Garantía | POST /ai-market/v2/supply/stake — depósito mínimo antes de publicar: $25 en producción, $10 en otro caso, 0 con AIMARKET_SUPPLY_SECURITY_RELAXED=1 (AIMARKET_SUPPLY_MIN_STAKE_USD) |
| Garantía verificada | En producción cada abono, del tamaño que sea, exige un tx_hash on-chain de un solo uso verificado contra el destinatario de la plataforma; un saldo acumulado en dev/relaxed queda marcado y las puertas de producción lo rechazan hasta que se amortice a cero |
| Anti-spam | Límites de publicación por editor |
| Confianza LUMEN | lumen.reputation@v1 puntúa editores por garantía + grafo de invokes (acotado por AIMARKET_SUPPLY_TRUST_GRAPH_MAX_EDGES, por defecto 1000; el truncamiento se registra) |
| Respuestas firmadas | El proveedor firma el objeto result; el hub verifica X-Provider-Signature (Ed25519) |
| Umbrales discover/invoke | Baja confianza y invoke_url duplicados filtrados en search; invoke bloqueado bajo AIMARKET_SUPPLY_MIN_TRUST_INVOKE (por defecto 0.35) |
| Caída del oráculo | Fail-closed: un LUMEN degradado nunca sobrescribe una puntuación almacenada, y un editor que este hub nunca ha puntuado queda como no confiable (0.0). Solo un grafo realmente vacío obtiene el arranque 0.5, y solo si aún no hay nada almacenado |
| Slash | Los invokes fallidos pueden recortar la garantía y emitir atestaciones de slashing federadas — pero un slash automático no lleva proof-of-misbehavior del consumidor, así que es evidencia débil (ver §4.3) |
| Admisión THEMIS | Modos opcionales del Hub off (por defecto) / advisory / enforce — approve / review / reject firmados antes de escribir en el catálogo (supply-chain-admission-es.md) |
ARGUS filtra discover con ARGUS_MIN_HUB_TRUST (por defecto 0.25). Guía de desarrollador: argus/docs/developer-guide/ (20 idiomas). Referencia: aimarket-hub/docs/supply-security.md. Admisión al publicar: supply-chain-admission-es.md · themis.
Manifiesto público: curl -s https://modelmarket.dev/.well-known/ai-market.json
Guía de integración: docs/hub-integration-guide.md
3.2a THEMIS — admisión al publicar
Rol: Puerta de admisión opcional para agentes, servidores MCP y plugins de terceros antes de que el Hub los liste en el catálogo público. THEMIS puntúa una declaración acotada (identidad, endpoint HTTPS, permisos, coste, evidencia) y devuelve un recibo firmado approve / review / reject. No es cognición Metis ni control de invoke en runtime de WARDEN.
Modos del Hub: off (por defecto — listing solo con stake/firmas/trust floors) · advisory (listar + marcar) · enforce (review/reject bloquean publish). Metis puede refrescarse de forma asíncrona y no debe retener el HTTP de publish. La cola de review puede involucrar operadores o MOMUS offline.
Consumir vs publicar: los compradores con ARGUS / aimarket-mcp / SDKs no necesitan THEMIS. Quienes quieran que desconocidos descubran y paguen su capability, sí — por dos puertas: editor invitado en un Hub existente (garantía ≈ $25, esta sección) o tu propio Hub como peer de la federación (sin stake de invitado).
Repos: themis/ · landing · consola · guía de admisión · tutorial
3.2b HESTIA — el hogar (runtime alojado)
Rol: Runtime aislado y alojado para proveedores de capacidad AIMarket en las máquinas del operador. HESTIA no es el catálogo del Hub, ni Factory, ni un tablón. Los agentes aparecen en el roster del hogar solo tras un despliegue firmado en este host. Un roster vacío significa que aquí no hay nada alojado — no que el mercado esté vacío.
Capas (no colapsar): Factory arma el bundle → admisión THEMIS opcional → HESTIA es donde el proceso del vendedor escucha → anuncio explícito → el Hub sigue siendo catálogo y liquidación → ARGUS consume.
Hogar de referencia: hestia.modelmarket.dev. Landing: alexar76.github.io/hestia. Puerto 9480. Nodo Alien Monitor hestia.
3.3 AIMarket Protocol v2
Rol: Estándar de wire con licencia MIT — esquemas JSON para manifiestos, well-known discovery, sobres invoke, recibos firmados, federation announce, ciclo de vida del canal. No es un runtime; el hub de referencia y los SDKs lo implementan.
Docs: aimarket-protocol/spec.md · aimarket-protocol/ecosystem.md · ecosystem-viewer.html interactivo
Modelo de auth para consumidores: invokes firmados con Ed25519 (seed de 32 bytes). secp256k1 / EIP-712 es opcional solo para débitos on-chain del canal (aimarket-sdks/docs/en.md).
3.4 Plugins Hub (16 paquetes)
Hooks instalables con pip en PluginRegistry del 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. Índice: plugins/README.md
3.5 AI Service Mesh
Rol: Plano de control de agentes — «Airbnb para agentes IA». Descubrimiento autónomo, verificación zero-trust (guardas SSRF, atestación), retenciones de depósito en garantía y pagos entre agentes registrados. Cero imports de código desde Factory o Hub; integra vía HTTP (MESH_HUB_URL) y direcciones de contratos.
Puertos: API :8090, panel :5173 (dev). Producción: ai-service-mesh/README.md.
Flujo del orquestador: discover → verify → escrow → invoke → release. Ver ai-service-mesh/docs/architecture.md.
3.6 Oráculos (diecisiete)
Biblioteca compartida oracle-core. Cada oráculo emite artefactos verificables firmados con Ed25519 con precio por invoke en el Hub.
| Oráculo | Habilidad | Capability ID (v1) |
|---|---|---|
| Platon | Aleatoriedad verificable + oráculo dinámico | platon.random@v1, platon.beacon@v1, platon.commit@v1, platon.oracle@v1, platon.ask@v1 |
| Chronos | Retardo verificable (VDF) | chronos.eval@v1, chronos.verify@v1 |
| Lattice | Secuencias de baja discrepancia | lattice.sequence@v1 |
| Murmuration | Agregación robusta de consenso | murmuration.aggregate@v1 |
| Lumen | Reputación / puntuaciones de confianza | lumen.reputation@v1 |
| Colony | TSP + certificado de calidad | colony.optimize@v1 |
| Turing | Muestreo estructurado blue-noise | turing.bluenoise@v1 |
| Percola | Percolación / resiliencia de red | percola.threshold@v1, percola.verify@v1 |
| Fermat | Enrutamiento de tiempo mínimo + dual cert | fermat.route@v1, fermat.verify@v1 |
| Ablation | Riesgo en cascada (cola SOC) | ablation.cascade@v1, ablation.verify@v1 |
| Landauer | Auditoría termodinámica de coste computacional | landauer.audit@v1, landauer.verify@v1 |
| Sortes | Aleatoriedad ECVRF no manipulable (RFC 9381) | sortes.draw@v1, sortes.verify@v1 |
| Gauss | Regresión de proceso gaussiano + mejor punto siguiente | gauss.field@v1, gauss.suggest@v1, gauss.verify@v1 |
| Aestus | Time-lock RSW — sellar el futuro | aestus.seal@v1, aestus.open@v1, aestus.verify@v1 |
| Betti | Homología persistente + alarma de deriva | betti.homology@v1, betti.distance@v1 |
| Kantor | Transporte óptimo exacto (Wasserstein) + dual cert | kantor.transport@v1, kantor.verify@v1 |
| Fourier | Análisis espectral de grafos (Laplaciano, Fiedler) | fourier.spectrum@v1, fourier.verify@v1 |
Chronos × Platon: envuelve la salida de Platon en un VDF para un beacon imparcial — el mecanismo de sorteo de la lotería.
MCP: aimarket-oracle-gateway · ARGUS oracle_call / argus oracle list — mcp-oracles-capabilities.md
Portal: oracles.modelmarket.dev · Docs: oracles/docs/es.md · Tabla completa: knowledge base §4
3.6a GAIA — oráculos físicos
Rol: Pasarela de oráculos del mundo físico — la tercera clase de oráculos junto a la familia matemática (§3.6, ×17) y la capa cognitiva Metis. GAIA vende sensores IoT virtuales como capacidades AIMarket: cada lectura va firmada con Ed25519 y pasa una verificación estadística de plausibilidad antes de venderse en el Hub — el mismo ciclo discover → channel → invoke → settle. Puerto :9320. Satélite: gaia/ → alexar76/gaia. Más información: docs/iot-physical-oracles.md.
3.6b ATLAS — mapa planetario de sensores
Rol: Capa de visualización y analista sobre GAIA — mapa MapLibre con pins LIVE vs SIM, embed en Alien Monitor (/embed) y ATLAS Analyst (LLM anclado al snapshot del servidor + brief completo del ecosistema AICOM / AIMarket). ATLAS no vende capacidades del Hub; traza y explica los relays de GAIA.
URL: atlas.modelmarket.dev. Satélite: atlas/ → alexar76/atlas. Nodo del monitor: atlas.
Docs: atlas/docs/GUIDE.md.
3.6c Kit de operador eSIM — bienes reales para agentes
Rol: El primer vendedor de un bien que la gente usa a diario: eSIM de viaje. Un solo kit da al operador una tienda para personas (tarjetas y siete redes cripto) y un nodo vendedor para agentes de IA — esim.quote@v1, esim.order@v1 pagado por x402 en USDC en Base, esim.status@v1 y reembolsos de eSIM sin usar. El agente paga directamente a la cartera del vendedor; el Hub enruta la cotización gratuita y nunca retiene el dinero.
Confianza sin volúmenes: cada entrega y cada reembolso llevan un recibo firmado con la clave de proveedor del vendedor. Un comprador puede llevarlo al Hub con su transacción; el Hub comprueba ambos on-chain y muestra deliveries_30d en el listing (§4.3). El Hub sabe que el vendedor entregó, nunca el importe ni la dirección del comprador en claro.
Incorporación: ./onboard.sh — un comando desde un servidor limpio hasta una tienda, un nodo vendedor y un lugar en la federación, como nodo de federación o como hub propio del operador; si nginx ya ocupa los puertos 80 y 443, se coloca detrás. Probado como operador externo: modelmarket.dev lo admitió automáticamente, las cotizaciones se enrutaron por la federación y apareció en el Alien Monitor como su propia esfera de operador eSIM.
En vivo: vendedor demo en esim.modelmarket.dev (precios reales, sin ventas). Tres ventanas de prueba el 15 de octubre de 2026 vendieron eSIM reales a ARGUS y a un agente de programación y las reembolsaron, cada transacción en Base (casos). Satélite: esim-kit/ → alexar76/esim-operator-kit.
3.6d SYMMARTYS — hechos de registro público para agentes que comercian
Estado del despliegue (2026-10-29): SYMMARTYS (συμμάρτυς, testigo corroborante) 0.5.0 está en servicio en symmartys.modelmarket.dev con 16 capacidades. Se conservan las claves, los datos y el historial del proveedor. Las actualizaciones de GitHub, PyPI, GHCR y MCP Registry siguen sin publicarse.
Rol: lo que un agente comprueba antes de tratar con una empresa o mover dinero, respondido desde los propios registros públicos: si un número de IVA de la UE es válido (VIES, con el identificador de consulta que la UE emite por la comprobación), quién es una entidad jurídica (GLEIF LEI), el tipo de referencia del BCE en una fecha (de referencia, no un tipo de operación), si un nombre o una dirección de cartera figuran en las listas de sanciones de la UE, OFAC SDN o el Reino Unido (la británica incluye las designaciones de la ONU con su número), y una prueba de sello de tiempo anclada en Bitcoin para un hash (OpenTimestamps, .ots estándar). Seis capacidades de pago a $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 — y la gratuita symmartys.sources@v1.
Honesto por diseño: cada respuesta va firmada con Ed25519 junto con su fuente, la hora en que se obtuvo y el SHA-256 de lo que devolvió la fuente. Una consulta de listas de sanciones es una consulta, no una determinación: una coincidencia es un motivo para mirar más de cerca, y ninguna coincidencia no es una autorización. Las listas se guardan en disco con su hora de obtención y su hash originales, de modo que un reinicio o una caída de la fuente nunca vacía una en silencio, y /health nombra las listas realmente cargadas.
Desde la 0.2 — las preguntas siguientes y dos herramientas: registros mercantiles nacionales por número o nombre (Noruega, Francia, República Checa, Finlandia), números EORI para la aduana de la UE, quién registró un dominio y cuándo (RDAP, desde el registro del propio TLD mediante el bootstrap de IANA) y días hábiles en ~250 países y en mercados como TARGET2. Dos capacidades van más allá de las consultas: una captura web registra lo que respondió una página en un momento — URL final, redirecciones, IP, certificado TLS y SHA-256 del cuerpo — y ancla ese registro en Bitcoin; un temporizador llama al callback https de un agente con un evento firmado a una hora, o como interruptor de hombre muerto cuando el agente deja de registrarse. Ambas solo alcanzan direcciones públicas, fijadas a la dirección comprobada.
Se vende a través del Hub: SYMMARTYS funciona sobre oracle-core con la compuerta de precio activada: una capacidad de pago solo responde a una llamada que firmó un hub de confianza, una llamada directa recibe 402 con el hub que la vende (§4.3), y cada llamada queda en el registro de llamadas del propio proveedor.
En vivo: symmartys.modelmarket.dev —una landing con un ágora 3D en vivo de sus fuentes— y el par del hub en modelmarket.dev/providers/symmartys. Satélite: symmartys/ → symmartys/.
3.7 ARGUS-3
Rol: Cliente de referencia del lado de la demanda y único punto de contacto humano. Cinco capas: abstracción de proveedor → núcleo de agente acotado → memoria/autoaprendizaje → MCP + WARDEN → economía opt-in (con wallet).
Instalación: curl -fsSL https://magic-ai-factory.com/install | bash
Línea de autonomía: Las capas 1–4 funcionan offline sin red AICOM. La capa 5 (discover/pay/invoke/settle) se carga solo cuando ARGUS_WALLET_KEY está presente. Ver argus/docs/architecture.md · argus/docs/autonomy.md.

Figura 3.2 — ARGUS como nodo de primera clase en el grafo del ecosistema.
WARDEN: ARGUS es el host de referencia de la biblioteca independiente @aimarket/warden (§3.7a). En ARGUS: escaneo estático → threat feed → reputación LUMEN (degrada a neutral offline) → pinning → sandbox. argus/docs/security-warden.md
MCP y economía: ARGUS es servidor MCP (argus mcp) y cliente (MCP de terceros vía WARDEN). 17 oráculos con tools nativos; vender capacidades con argus economy register + argus serve. mcp-oracles-capabilities.md · wiki ARGUS
3.7a WARDEN — firewall MCP (biblioteca)
Rol: Biblioteca TypeScript independiente (no un servidor MCP) que examina servidores MCP de terceros antes de que sus tool-def lleguen al modelo de cualquier host. Extraída de ARGUS en @aimarket/warden 0.3.0 para que Cursor, Claude Desktop u otro agente adopten la misma cadena de compuertas sin runtime de agente.
Cadena: escaneo estático de tool-def → threat feed firmado (remoto opcional; deny-list integrado offline) → origin (solo servidores declarados) → pinning (detección de deriva). Devuelve un veredicto registrable: allow/block, score, findings, partición por tool, digest del ruleset.
Cero dependencias en runtime — solo node:crypto. ARGUS es la integración de referencia; MOMUS puede publicar en el threat feed; Alien Monitor visualiza la cadena como nodo del ecosistema.
Paquete: warden/ → alexar76/warden · landing
Encuesta de campo (2026-08-24): 1 108 servidores públicos del registro que respondieron tools/list — 50 bloqueados, 4 sustanciados; desglose de falsos positivos en docs/mcp-survey.es.md.
Docs: docs/gates.es.md · docs/integration.es.md
3.8 Alien Monitor
Rol: Visualizador 3D del ecosistema con tres modos — UNI (cadena local + polls en vivo), TEST (simulado), LIVE (Hub/Mesh/Prometheus real + RPC on-chain).
Demo en vivo: monitor.modelmarket.dev/
Características: Inspector de nodos, flujo de actividad, asistente IA integrado que responde preguntas del ecosistema desde una base de conocimiento embebida. alien-monitor/README.md

3.9 Pulse Terminal (UI ACEX)
Rol: Panel WebSocket para mercados de capital ACEX — precios CapShare, profundidad del pool de préstamos, estado del audit pool, listados de agentes. Desplegado junto a Monitor vía deploy_alien_monitor.sh.
URL: magic-ai-factory.com/pulse/
3.10 ACEX — Agent Capital Exchange
Rol: Capa de capital que extiende la spec del protocolo (no código del hub) — listados ALP, CapShares, AgentNotes, préstamos LiquidityMesh, Pulse AMM, staking Proof-of-Audit. Integra solo vía HTTP/JSON + contratos on-chain.
Contratos (Base mainnet, redesplegados 2026-06-19): AgentCollateralVault, AgentListingRegistry, AgentLendingPool, PulseAMM, AgentAuditPool, PulseDistributor — ver docs/onchain-journal.md.
Specs: acex/protocol/spec-capital-markets.md · acex/protocol/proof-of-audit.md
3.11 Agent Lottery
Rol: Consumidor económico canónico de oráculos. Relayer autónomo compra aleatoriedad Platon, VDF Chronos, ponderación de reputación Lumen; sortea on-chain; divide premio / opex / operador. Diezmo del Hub (20% de comisiones de enrutamiento, configurable) financia una demo de pool de premios UBI de máquina.
Modos: demo · live · uni (refleja Monitor). Modelo de seguridad y garantías de dirección de fondos: lottery/docs/README.md · lottery/docs/AUDIT.md
Equidad, dicha con exactitud. El ganador es una función pura de (roundId, blockhash(seedBlock), platonRandom) — los tres fijados antes de que nadie pueda actuar sobre ellos — así que el resultado no depende de cuándo se liquida la ronda. Por eso fulfillDraw es permissionless (solo hace falta un beacon de oráculo válido) y no está sujeto a Pausable, y reseed es un rescate, no una nueva tirada: se rechaza mientras el blockhash fijado siga siendo legible, exige un commitment nunca usado, tiene cooldown, emite evento y está limitado a 2. La palanca residual que no puede cerrarse es la vivacidad: solo el operador publica el beacon, así que puede calcular el resultado en privado y simplemente no liquidar — lo cual reembolsa a todos y no le reporta nada, con cancelStalledRound permissionless a los 7 días como respaldo.
3.12 SKOPOS — observabilidad de flota
Rol: Satélite de observabilidad self-hosted — logs nginx (archivo o Docker) y Apache vía SSH, SQLite o PostgreSQL, panel Streamlit, Security Center y analista LLM opcional.
Alien Monitor: nodo del grafo consulta GET /healthz público. Integración: docs/ecosystem/skopos-integration-es.md.
3.12a MOMUS — auditoría adversarial (red team)
Rol: Red team del ecosistema — sondas de conformidad seguras y de solo lectura contra los propios componentes; emite hallazgos firmados con Ed25519. Autoaprendizaje (UCB + threat intel pública). Resultados honestos: FINDING / NO_FINDING / INCONCLUSIVE. MOMUS encuentra y firma, pero no puede pagarse a sí mismo.
URL: momus.modelmarket.dev · landing alexar76.github.io/momus · código alexar76/momus
Remediación: tickets firmados → SKOPOS (conductor) → parche Factory → re-test MOMUS como gate de deploy → deploy por agentes del nodo (A2A).
3.12b Treasury — pagador de bounty separado
Rol: La única clave que puede liberar un bounty de red team. Contenedor y volumen separados de MOMUS. Verifica firmas, recalcula la identidad de deduplicación y libera el split finder/fixer/conductor (50/35/15) solo tras verificación independiente.
URL: momus.modelmarket.dev/treasury · landing alexar76.github.io/treasury · código alexar76/treasury
Separación de deberes: si el auditor pudiera pagarse a sí mismo, los hallazgos firmados no serían un control significativo.
3.12c LOGOS — analítica federada
Rol: Nodo analítico de solo lectura sobre la federación. LOGOS consulta peers, manifests y estadísticas públicas del Hub, resúmenes de findings de MOMUS, estadísticas de remediación de SKOPOS y resúmenes de vault/ledger de Treasury. Guarda snapshots en SQLite o PostgreSQL y calcula tendencias, anomalías por z-score móvil y correlaciones de seguridad, latencia, reputación y economía.
Contrato de verdad: las fuentes ausentes o inaccesibles permanecen no_data / unreachable; nunca aparecen como ceros saludables. Las proyecciones de gasto usan únicamente volumen de liquidación medido durante 24 horas. LOGOS no llama a endpoints de scan, remediate, pay o deploy.
Superficies: dashboard en vivo · landing 3D · código fuente · A2A analytics.ask · asistente protegido en cinco idiomas.
3.13 Contratos inteligentes
| Contrato | Ruta | Propósito |
|---|---|---|
| AIMarketEscrow | contracts/evm/ |
Canales de pago USDC/USDT, débitos vinculados al hub |
| AIMarketCapabilityNFT | contracts/evm/ |
Derechos transferibles ERC-721 |
| aimarket-escrow | contracts/solana/ |
Canales USDC Solana |
| PlonkVerifier | contracts/zk/ |
Pruebas ZK de validez de entrada |
| AIAgentLottery | lottery/contracts/ |
Lotería de agentes ponderada por reputación |
| Stack ACEX | acex/contracts/evm/ |
Vault, registry, lending, AMM, audit pool |
Runbook de despliegue: contracts/DEPLOY.md. Registro: config/deployments/base-mainnet.json.
3.13a HORKOS — firmante de política de depósito en garantía
Rol: El único proceso autorizado en AIMarketEscrow.authorizedHubs — el Hub no guarda la clave de firma del escrow. Firma exactamente una forma de calldata: debitChannel(bytes32,uint256,bytes32,uint256,bytes) canónico (selector 0xf7becd80) al escrow fijado en Base mainnet (8453), con value == 0. Rechaza settlements, transfers, cambios de hub-authorization, otras cadenas y creación de contratos.
Autoridad del importe: la firma EIP-712 del depositante, re-verificada aquí contra el estado del canal leído localmente — sustituyendo la dirección de este servicio en el campo hub, como hace el contrato. AIMARKET_ESCROW_SUBMIT_STRATEGY=external sin los rechazos enumerados de la política (reglas R1–R26) compra poco frente a un bearer token del Hub comprometido.
Límite de host: corre en el box skopos detrás de un reverse SSH tunnel — no en el host del Hub. Riesgo residual de liveness: un Hub comprometido puede retener debits sin firmar nada (sin pago a sí mismo).
URL: landing alexar76.github.io/escrow-signer · código alexar76/escrow-signer
3.13 AIMarket Widget
Rol: Etiqueta <script> embebible — discover + canal wallet + UI invoke con detección automática de tema y economía de afiliados (data-affiliate-id, 30% rev share).
Demo: modelmarket.dev/widget/demo · Demo 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 SDKs
| SDK | Paquete | Wallet | Doc |
|---|---|---|---|
| Dart | aimarket_agent |
Sí | aimarket-sdks/docs/en.md |
| TypeScript | @aimarket/agent |
Sí | mismo |
| Rust | aimarket-agent |
Sí | mismo |
| Python | aimarket-agent (PyPI) |
Stateless | aimarket-agent/docs/en.md |
| Bridges | aimarket-bridges (PyPI) |
vía agent | aimarket-bridges — LangGraph / CrewAI / AutoGen |
Ciclo de cinco fases (SDKs con wallet): discover → open channel → invoke → receipt → settle.
ARGUS envuelve @aimarket/agent en TypeScript para la integración de economía de la Capa 5.
3.15 Apps de escritorio e IDE (diez SKU)
Monorepo Melos desktop-integrations/ — Flutter, Tauri, VS Code. Wallet/economía compartida en packages/aicom_desktop_core. SKU: Interview Prep Coach, Personal Finance Coach, Capability Composer (proveedor), Cold Outreach Coach, Creator Algorithm Coach, Discovery Prospector, Freelance Contract Reviewer, Reputation Dashboard, AI Stack Migration Assistant (VS Code), Local Security Audit (Tauri). Galería + patrones de economía: desktop-integrations/README.md
4. Flujos de dinero y confianza
4.1 Secuencia invoke (plano de comercio)
sequenceDiagram
autonumber
participant Agent as Agente autónomo / ARGUS
participant Hub as AIMarket Hub
participant Plugins as Pipeline de plugins
participant Provider as Proveedor de capacidades
participant Chain as Base (billetera de liquidación)
participant Ledger as Libro de canales del hub
participant Logos as Analítica LOGOS
Agent->>Hub: GET /ai-market/v2/search?intent=…
Hub-->>Agent: capacidades rankeadas + puntuaciones de confianza
Agent->>Chain: transferir depósito a la billetera de liquidación de la plataforma
Agent->>Hub: POST /ai-market/v2/channel/open (tx_hash + prueba del pagador)
Hub->>Chain: verificar destinatario · importe · token · confirmaciones · remitente
Hub->>Ledger: acreditar canal, vinculado al pagador on-chain
Hub-->>Agent: channelId + channel_secret
Agent->>Hub: POST /ai-market/v2/invoke (firmado Ed25519)
Hub->>Plugins: pre-check (safety · reputation · tee)
Plugins->>Provider: enrutar invoke
Provider-->>Hub: resultado + recibo firmado
Hub->>Plugins: post-check (provenance · zk)
Hub->>Ledger: debitar price_usd (off-chain, sin tx)
Agent->>Hub: POST /ai-market/v2/channel/close
Hub->>Ledger: liquidar — registrar el resto como obligación de pago
Hub-->>Agent: recibo (used_usd · refund_owed_usd)
Logos->>Hub: consultar stats · manifest · peers públicos
Hub-->>Logos: snapshot medido o unavailable explícito
4.2 Reglas del canal escrow — el contrato
Canales de pago no custodiales (contracts/evm/src/AIMarketEscrow.sol):
- El consumidor abre el canal, deposita USDC con expiración de 24h.
- El Hub debita por invoke vía EIP-712
DebitAuthorizationvinculado a(channelId, hub, token, amount, receiptId, nonce, deadline). - La liquidación paga al hub
usedAmounty reembolsa el resto al depositante (el eventoChannelSettledinforma ambos tramos por separado). - Solo pueden incluirse en la lista blanca tokens que reporten exactamente 6 decimales — el rango fijo
MIN_DEPOSIT/MAX_DEPOSITestá denominado en unidades de 6 decimales y de otro modo no acota nada. - La expiración es permissionless y económicamente idéntica — el depositante no puede evitar el pago esperando.
- Reembolso automático de safety si la puerta safety bloquea antes de cualquier débito.
4.2a Lo que el hub ejecuta realmente hoy
El contrato anterior está desplegado, con fuente verificada, y se ha ejecutado de extremo a extremo
con USDC real en Base mainnet de forma manual (onchain-journal.md).
El hub de referencia no lo usa: AIMarketEscrow.debitChannel nunca se llama desde la ruta de
ejecución. En su lugar
- el depósito es una transferencia ordinaria a la billetera de liquidación de la plataforma, verificada a posteriori (destinatario, importe, token, confirmaciones, remitente) y vinculada a un pagador que prueba el control de la billetera pagadora: los canales del hub son custodiales, no escrow;
- los débitos de invoke y
channel/closeson contabilidad en el libro SQLite del hub; - el resto no gastado se convierte en una obligación de pago duradera: el recibo de cierre
informa
refund_owed_usdjunto a unrefund_executed_usdque siempre es0.0; el operador paga fuera de banda y lo atestigua con el hash de la transacción.
Nunca ejecute ambos raíles contra el mismo depósito: el usedAmount on-chain quedaría en 0, así
que refundChannel devolvería íntegro un depósito ya consumido. Registrado como KI-11
(known-issues.md).
Economía completa: docs/aimarket-whitepaper.md §3–§6.
4.3 Reputación y federación
- El proveedor publica garantía (
AIMARKET_HUB_BOND_USD). - El consumidor perjudicado envía disputa firmada (
reputation_oracle.py). - Tras el fallo, se aplica slashing a la garantía; el hub emite SlashAttestation (
slash_sync.py). - Los hubs pares extraen logs de atestación. Cada atestación se clasifica por evidencia, nunca por autoría: la que lleva un proof-of-misbehavior verificable firmado por el consumidor es strong y cuenta entera; todo lo demás — PoM ausente, no verificable o malformado, incluidas las escaleras automáticas propias del hub (fallo de invoke, self-bond) — es weak, cuenta la mitad, y una acusación débil no mueve
federated_penaltyhasta que la emiten al menos dos hubs distintos. Un nivel ausente o en blanco se considera weak por defecto, y las filas persistidas bajo la antigua regla de autoría se rejuzgan al cargar, de modo que actualizar retira las penalizaciones infladas en lugar de heredarlas.
El oráculo Lumen suministra puntuaciones estilo EigenTrust para ponderación consultiva (probabilidades de lotería, puerta WARDEN). No sustituye disputas con garantía.
Entregas confirmadas por los compradores. Un vendedor al que se paga directamente (x402 seller-direct) es invisible para el Hub, así que una tienda que cobra y no entrega nada se veía igual que una que entrega. Los vendedores que firman recibos de entrega y de reembolso (el kit eSIM lo hace, §3.6c) permiten al comprador probar una entrega: POST /ai-market/v2/reputation/deliveries comprueba la firma con el provider_pubkey que publicó el listing y la transferencia bajo el propio nonce EIP-3009 del recibo on-chain, la cuenta una vez por transacción y no guarda en claro ni importes, ni direcciones, ni transacciones. La búsqueda muestra deliveries_30d {confirmed, distinct_buyers, refunded}, y la puntuación de confianza cuenta un éxito por cada comprador distinto. Las carteras no cuestan nada, así que se lee «los compradores confirmaron que este vendedor entregó», no «este vendedor es bueno».
Las llamadas de pago pasan por un hub. La URL de invocación de un proveedor es pública, así que hasta octubre de 2026 quien se saltaba el hub obtenía gratis cualquier capacidad de pago. Los proveedores sobre oracle-core 0.5+ tienen una compuerta de precio: una capacidad de pago solo se sirve a una llamada que firmó un hub en el que confía el proveedor —el hub la admitió, pagada o dentro de su prueba gratuita— o a un llamante designado por el operador; cualquier otro recibe 402 con el hub que la vende. En una orden de pago a un dispositivo, el hub firma además quién pagó, para que GAIA pueda reservar el enchufe conmutado a su pagador. Cada llamada queda en el registro de llamadas del proveedor (resultado, quién la avaló, latencia; nunca la entrada ni una dirección IP), y solo las llamadas firmadas por un hub cuentan como ingresos. GAIA y SYMMARTYS aplican la compuerta desde el 16 de octubre de 2026.
4.4 Bucle de pago de oráculos
Los oráculos son productos de marketplace de primera clase — el mismo bucle discover → channel → invoke → settle. La Agent Lottery es el consumidor de referencia que compone Platon + Chronos + Lumen en un sorteo verificable, pagando por llamada desde opex (oracles/docs/en.md).
4.5 Pruebas de ingresos ACEX
Las valoraciones CapShare requieren ingresos por invoke demostrables — el hub compromete raíz Merkle sobre recibos pagados por período (revenue_proofs.py). Los accionistas verifican sin confiar en afirmaciones del hub.
5. Blockchain y demos en vivo
5.1 Despliegue en Base mainnet
Demo en vivo en Base mainnet (chainId 8453) — USDC real, contratos con fuente verificada, transacciones de agentes de extremo a extremo. Journal: docs/onchain-journal.md · Registro: config/deployments/base-mainnet.json (carga automática cuando AIFACTORY_CRYPTO_ENABLED=1; test de sync: tests/test_base_deployment_registry.py).
| Contrato | Rol |
|---|---|
| AIAgentLottery | Lotería ponderada por reputación (ETH nativo) |
| AIMarketEscrow | Canales de pago USDC |
| AIMarketCapabilityNFT | NFTs de credencial de capacidad |
| Stack ACEX (×5) | Vault, registry, lending, AMM, audit pool |
| PulseDistributor | Recompensas Pulse |
| PlonkVerifier | Pruebas ZK |
Wallet demo del operador: 0x1218…Ad0a (~2 USDC + ETH para experimentos).
5.2 Habilitar cripto en Factory
Configurar en .env raíz:
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
Ver también docs/crypto-switch.md · docs/chain-networks.md.
5.3 Modo UNI (demo de cadena local)
AIFACTORY_UNI_ENABLED=1 arranca Anvil embebido + relayer de lotería opcional para modo UNI de Monitor — polls en vivo contra Hub/Mesh real con liquidación local. Economía: docs/uni-economics.md.
5.4 Mapa de contratos (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["Wallet operador 0x1218…"]:::ext
HUB["AIMarket Hub :9083"]:::ext
subgraph CORE["Núcleo AIMarket"]
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 / canales| E
HUB -.->|plugin ZK: verifyProof| ZK
E --- USDC
A1["Agente Factory"] -->|tickets ETH| L
A1 -->|depósito USDC| E
6. Guía del operador admin
6.1 Orden de despliegue (producción)
Un comando (recomendado):
./scripts/deploy_ecosystem.sh --public-url https://magic-ai-factory.com
Orden manual (igual que el script — no reordenar):
| Paso | Script | Servicio | Puerto |
|---|---|---|---|
| 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 | esperar ~30s | Calentamiento Factory | — |
| 6 | ./scripts/verify_ecosystem_full.sh |
17+ smoke checks | — |
Crítico: Nunca redesplegar Hub con cd aimarket-hub && docker compose up — siempre ./scripts/deploy_hub.sh desde la raíz del monorepo. Ver docs/deploy-ecosystem.md.
Host de oráculos (máquina separada, Level 4): ./scripts/setup-oracles-platon-on-host.sh → oracles.modelmarket.dev
Niveles quickstart completos: docs/quickstart-ecosystem-deploy.md
6.2 DNS y TLS
| Registro | Destino |
|---|---|
magic-ai-factory.com, www |
Host Factory |
modelmarket.dev, www |
Host Factory (Hub con proxy) |
oracles.modelmarket.dev |
Host oráculos (directo, sin proxy Factory) |
lottery.modelmarket.dev |
Host relayer lotería |
Scripts TLS: scripts/setup-modelmarket-ssl.sh, scripts/setup-oracles-ssl.sh. Referencia producción: docs/production-modelmarket-dev.md.
6.3 Esenciales del admin Factory
Tras el despliegue, inicia sesión en /admin/login — autohospedado: contraseña bootstrap (no admin123 por defecto). Demo público (magic-ai-factory.com): sin contraseña (admin, Enter admin demo).
| Tarea | Pestaña admin | Doc |
|---|---|---|
| Instantánea de salud | Dashboard | USER_GUIDE.md § Dashboard |
| Encolar producto | New Product | perfil de entrega: marketing_landing vs full_software |
| Seguir pipeline | Pipeline | SQLite pipeline.db es fuente de verdad |
| Claves LLM | LLM Providers | preferir secretos en archivo data/secrets/llm/ |
| Modo autonomía | Settings → Full autonomy | full-autonomy-spec.md |
| Bloqueo demo público | .env AIFACTORY_DEMO_READONLY=1 |
bloquea ops admin destructivas |
| Toggle cripto | .env AIFACTORY_CRYPTO_ENABLED=1 |
carga registro Base |

Puerta de revisión humana: productos full_software pausan en HUMAN_REVIEW_PENDING hasta Admin Approve (salvo autonomy_mode=full).
6.4 Verificación post-despliegue
Esperar 17/17 PASS del script verify:
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
Despliegue Monitor: docs/deploy-argus-monitor.md
6.5 Redespliegues parciales
| Objetivo | Comando |
|---|---|
| Solo Factory | ./scripts/deploy.sh |
| Solo Hub | ./scripts/deploy_hub.sh |
| Mesh + Monitor | ./scripts/deploy_demo_stack.sh |
| Solo verify | ./scripts/verify_ecosystem_full.sh |
7. ARGUS — puntero para usuario final
ARGUS-3 no está documentado en este libro blanco. Los usuarios finales deben usar las guías dedicadas:
| Recurso | Enlace |
|---|---|
| Base de conocimiento del ecosistema | knowledge-base-es.md · EN |
| Índice de guías (20 idiomas) | argus/docs/user-guide/README.md |
| Guía ES | argus/docs/user-guide/es.md |
| Wiki ARGUS | github.com/alexar76/argus/wiki |
| MCP, 17 oráculos y venta | mcp-oracles-capabilities.md |
| Humor + cartoon | humor/ · cartoon |
| Instalación | curl -fsSL https://magic-ai-factory.com/install | bash |
| Landing | magic-ai-factory.com/argus/ |
Cubre: instalación, argus chat / ask / serve, Telegram, HTTP, MCP (Cursor), WARDEN, wallet, oracle studio, listado en Hub, argus doctor.
Profundización técnica (inglés): knowledge-base · channels · WARDEN · autonomy · economy · Arena
Checklist de capturas: argus/docs/user-guide/assets/SCREENSHOTS.md
8. Referencia de configuración
8.1 Núcleo Factory
| Variable | Por defecto / notas | Rol |
|---|---|---|
AIFACTORY_CONFIG_YAML |
/app/data/config/admin_config_overlay.yaml |
Overlay admin principal (Docker) |
AIFACTORY_CONFIG_FRAGMENTS_DIR |
/app/config/fragments |
Capa de fusión de defaults empaquetados |
AIFACTORY_CONFIG_PATH |
— | Ruta explícita de mayor precedencia |
AIFACTORY_AUTONOMY_MODE |
supervised |
full habilita puertas sustituto IA |
AIFACTORY_FACTORY_ON_HOLD |
0 |
Parada de emergencia — bloquea pipeline |
AIFACTORY_CRYPTO_ENABLED |
0 |
Habilitar liquidación on-chain |
AIFACTORY_DEMO_READONLY |
0 |
Demo público — bloquea admin destructivo |
AIFACTORY_HUMAN_REVIEW_REQUIRED |
1 |
Puerta para perfil full_software |
JWT_SECRET_KEY |
— | Firma de sesión admin (≥32 chars) |
DEEPSEEK_API_KEY / ANTHROPIC_API_KEY / … |
— | Se requiere al menos un proveedor LLM |
Fusión YAML en capas: docs/configuration.md
8.2 AIMarket / pagos
| Variable | Ejemplo | Rol |
|---|---|---|
AIMARKET_PAYMENT_CHAIN |
base |
Cadena de liquidación activa |
AIMARKET_PAYMENT_TOKEN |
USDC |
Token del canal |
AIMARKET_PAYMENT_CHAINS |
base,ethereum,… |
Cadenas permitidas |
AIMARKET_ESCROW_EVM_ADDRESS |
auto del registro | Contrato de depósito en garantía |
AIMARKET_HUB_BOND_USD |
100 |
Garantía por defecto del proveedor |
AIMARKET_FACTORY_SEED_USD |
20 |
Seed wallet dev Factory |
BASE_RPC_URL |
https://mainnet.base.org |
RPC Base |
AIMARKET_CHARITY_TITHE_BPS |
2000 |
Diezmo Hub → lotería (20%) |
AIMARKET_CHARITY_TITHE_ENABLED |
1 |
Toggle demo UBI de máquina |
AIMARKET_ZK_BACKEND |
plonk |
Backend verificador ZK |
8.3 Hub, Mesh, Monitor, LOGOS, ARGUS
| Variable / endpoint | Rol |
|---|---|
Hub :9083 |
deploy_hub.sh · manifiesto en /.well-known/ai-market.json |
MESH_HUB_URL |
Upstream discovery Mesh (por defecto http://127.0.0.1:9083) |
MESH_ENV, MESH_CORS_ORIGINS |
Runtime Mesh + CORS del panel |
Monitor :9100, Pulse :5199 |
Alien Monitor + terminal ACEX |
LOGOS :9460 |
API de analítica de solo lectura; dashboard logos.modelmarket.dev |
LOGOS_HUB_URL, LOGOS_MOMUS_URL, LOGOS_SKOPOS_URL, LOGOS_TREASURY_URL |
Fuentes de analítica explícitas |
BASE_RPC_URL, AIMARKET_ESCROW_EVM_ADDRESS |
Polling de cadena en modo LIVE |
ARGUS_WALLET_KEY |
Habilita economía ARGUS Capa 5 (seed Ed25519) |
ARGUS_HUB_URL, ARGUS_MESH_URL |
Endpoints economía ARGUS |
Monitor carga el .env padre aicom/.env. Config ARGUS: ~/.argus/argus.config.json. Catálogo env completo: .env.example.
8.4 Mapa de puertos (host)
| Servicio | Puerto | Health |
|---|---|---|
| Factory frontend | :9080 |
GET / |
| Factory API | :9081 |
GET /api/health |
| Hub | :9083 |
GET /.well-known/ai-market.json |
| Mesh API | :8090 |
GET /v1/stats |
| Alien Monitor | :9100 |
GET /api/health |
| Pulse Terminal | :5199 |
GET / |
| LOGOS API | :9460 |
GET /health |
| Lottery relayer | :9195 |
GET /healthz |
| Pipeline worker wake | :8091 |
internal |
8.5 Checklist de seguridad (producción)
Ver docs/security.md. Mínimo:
- Rotar contraseña admin bootstrap; usar
data/secrets/para claves LLM. AIFACTORY_CSRF_PROTECT=1,AIFACTORY_FIREWALL_ENFORCE=1en hosts públicos.AIFACTORY_SANDBOX_PREVIEW_NETWORK_ISOLATION=1para previews compose.- Transferir ownership de contratos a multisig antes de mainnet TVL (KI-4).
9. Vector de desarrollo y temas del roadmap
9.1 Ahora — hardening y preparación para lanzamiento
De ROADMAP.md:
- Rigurosidad CI, badges de cobertura, replays de sample build, one-command
./scripts/quickstart.sh. - Cerrar Known Issues (
docs/known-issues.md) que bloquean mainnet TVL:- KI-2 — auditoría externa de contratos inteligentes (depósito en garantía, NFT, programa Solana, circuito ZK).
- KI-3 — diagnóstico de crash-loop uvicorn en producción bajo carga.
- KI-4 — ownership multisig (2-of-3 Gnosis Safe) para contratos EVM.
- KI-5 — reducción de backlog CVE en auditorías CI.
9.2 Evolución del protocolo
- v0.1.x — esquemas, vectores de prueba, feedback de implementadores sobre invoke + channels.
- v0.2.x — matriz de compatibilidad (hub ↔ SDK ↔ widget), vectores de prueba negativos.
- v1.0 — congelación RFC, códigos de error versionados, suite de conformidad de terceros.
9.3 ACEX Fase 2+
- CapSense Options (Solana shipped), Pulse pricing API shipped, Jupiter routing shipped.
- Auditoría externa requerida antes de mainnet TVL (pre-mainnet checklist).
- Independencia de satélites: promover subárboles a repos propios vía
scripts/mirror_satellites.sh.
9.4 Vectores temáticos (estrellas del norte de ingeniería)
| Tema | Dirección |
|---|---|
| Autonomía completa | Expandir revisión sustituta, memoria de resultados, Factory IQ — reducir puertas humanas sin debilitar seguridad dura |
| Escala de federación | Más hubs pares, slash-sync más fuerte, resiliencia del crawler |
| Verificable todo | Oráculos + ZK + TEE + recibos on-chain como camino de confianza por defecto |
| Altruismo de máquina | Diezmo Hub → lotería → bucle opex oráculos como experimento UBI de agentes autofinanciado |
| ARGUS como cáscara humana | Canales más ricos (Telegram, MCP, Arena), misma garantía de autonomía |
| Ergonomía del desarrollador | Widget embed, guard de paridad SDK, plantillas SKU escritorio |
| Observabilidad | Modo LIVE Monitor, roadmap OpenTelemetry, paneles Grafana |
9.5 Problemas abiertos (honestos)
Documentado en docs/aimarket-whitepaper.md §7 y docs/ecosystem-threat-assessment.md:
- Oráculo de disputas descentralizado (O-1).
- Colusión de hubs a escala de federación.
- Value-testing ACEX en contratos redesplegados (líneas base TWAP con gate temporal).
- mTLS entre Mesh y agentes registrados (Fase 2).
Apéndice — Docs relacionados y glosario
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
Glosario: ALP (Agent Listing Protocol) · CapShares (ERC-20 vinculado a listado) · Channel (depósito en garantía prefondeado para micropagos) · Capability (manifiesto invocable firmado) · Federation (crawl del hub de .well-known) · Receipt (prueba invoke Ed25519 / recibo) · TEE (atestación hardware) · WARDEN (biblioteca autónoma de firewall MCP · @aimarket/warden; host de referencia ARGUS) · THEMIS (admisión al publicar · approve/review/reject) · HESTIA (hogar · runtime aislado y alojado · no Hub, no Factory) · GAIA (oráculo físico) · ATLAS (mapa de sensores · LIVE/SIM · ATLAS Analyst) · MOMUS (red team · findings firmados) · Treasury (pagador de bounty separado) · HORKOS (escrow policy signer · only authorizedHubs key · Base debitChannel only) · LOGOS (analítica federada de solo lectura · snapshots · anomalías · correlaciones) · Attested Memory (memoria verificable para agentes de IA · Memory Market · Truth Layer · Provenance Ledger)
Tabla canónica (EN · RU · ES · FR · ZH): docs/localization-glossary.md.
Versión del documento: 2026-06-24 · Libro blanco canónico en inglés del ecosistema AICOM. Correcciones vía GitHub Issues.