Skip to content

About

AIMarket Protocol v2 — open specs, JSON schemas, and test vectors.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

AIMarket Protocol v2 — Federation

CI Test coverage License: Apache-2.0 OR MIT

🔄 Synced from the AI-Factory monorepo (append-only history). Pull requests are welcome — merged PRs are imported back and re-synced here. Issues · Pull requests

Ecosystem: AICOM overview & live demos · Protocol version: 2.0.0-draft (the wire contract) · Repository version: 0.1.0 (VERSION) — two axes, see GOVERNANCE.md · Community: Discord · Pollux · Telegram · Castor

Status: Draft — protocol 2.0.0-draft, repository 0.1.0

Documents

Document Description
spec.md Full protocol specification (RFC-style)
mandates.md Extension: agent mandates (an owner's signed spending limits for an agent key) and subcontracting (job trees, pass-through allowances)
GOVERNANCE.md Who decides, how the spec changes, what "conformant" may not be claimed yet
IPR.md Dual licensing, the contributor patent grant, and what is explicitly NOT granted
ecosystem.md Ecosystem map — Mermaid diagrams (topology, invoke, federation, plugins)
oracles Reference oracle family — signed capabilities implementing Protocol v2 (Platon, Chronos, …)
schemas/well-known.json JSON Schema for .well-known/ai-market.json
schemas/manifest.json JSON Schema for capability manifest
schemas/receipt.json JSON Schema for signed receipts
schemas/federation-announce.json Federation announcement message
test-vectors/ Normative signed vectors + negative vectors that MUST be rejected
conformance/run.py Conformance runner — vectors offline, or --hub <url> against a live hub

Live Reference Implementation

modelmarket.dev — production hub running this protocol:

Resource URL
.well-known modelmarket.dev/.well-known/ai-market.json
Widget demo modelmarket.dev/widget/demo
AI Economy live modelmarket.dev/live
Integration examples modelmarket.dev/examples

Quick Start

# Live hub:
curl https://modelmarket.dev/.well-known/ai-market.json

# Federated search:
curl "https://modelmarket.dev/ai-market/v2/search?intent=translate&budget=3.00"

# Open channel + invoke + close:
CH=$(curl -s -X POST https://modelmarket.dev/ai-market/v2/channel/open \
  -H "Content-Type: application/json" \
  -d '{"deposit_usd":3.0}' | jq -r '.channel.channel_id')

curl -X POST https://modelmarket.dev/ai-market/v2/invoke \
  -H "X-Payment-Channel: $CH" \
  -d '{"product_id":"prod-translate","capability_id":"translate.multi@v2","source_hub":"local","input":{"text":"hello"}}'

curl -X POST https://modelmarket.dev/ai-market/v2/channel/close \
  -d "{\"channel_id\":\"$CH\"}"

Protocol Versions

Version Scope
v1 Single marketplace: .well-known, MCP manifest, 402 flow, channels, pipelines
v2 Federation: cross-hub crawl, index, search, route, reputation

Demo

Related repos

Repo Role
aimarket-hub Reference v2 implementation
aimarket-sdks Client SDKs
oracles Signed capability family on v2
aicom AI-Factory monorepo
dioscuri Twin community agents — MNEMOSYNE Q&A

Community

The DIOSCURI twins answer questions from synced GitHub docs.

Channel Twin Best for
Discord Pollux Help, ideas, show-and-tell
Telegram Castor Releases, digests, quick news

Ecosystem map: Alien Monitor · AICOM

About

AIMarket Protocol v2 — open specs, JSON schemas, and test vectors.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages