jerry/agents-marketplace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
agents-marketplace/contracts/marketplace
History
jelisaveta-talbot cbab81efbd M1-F: end-to-end LLM marketplace lifecycle on Vector testnet 
Bonded-escrow marketplace for prompt → response between buyers and
local-LLM suppliers, settling on Vector (UTxO) via Aiken Plutus V3
validators. Lifecycle PostEscrow → Claim → Submit → Accept proven on
Vector testnet 2026-05-06; AcceptEscrow tx 125e3cfe…7dc100d distributes
payment + bonds per the validator's distribution rule.

Workspace layout (pnpm + TypeScript):
  contracts/marketplace/      Aiken validators (advert + escrow) + plutus.json
  packages/shared/            Tx-builders (lucid-evolution), CBOR codecs,
                              chain providers (mock / read-only / live Ogmios)
  supplier/                   OpenAI-compatible HTTP node (Ollama by default;
                              vLLM / llama.cpp / OpenRouter / OpenClaw all
                              swap-in via OLLAMA_URL); 202+poll chat handler
  buyer/                      Express + React SPA; server-side runs the full
                              chain lifecycle via /v1/submit-prompt and
                              /v1/accept; SPA never holds the buyer key
  indexer/                    Chain-follower (extends apex-dashboard pattern),
                              SSE event stream + REST queries
  indexer-ui/                 Operator dashboard (events + suppliers + escrow
                              lookup)
  tests/                      1098 vitest unit + integration tests (10 skipped
                              under M1-F-D-defer for UPLC test plumbing)
  deploy/testnet/             Per-service docker-compose for the Hetzner stack
  docs/EXECUTIVE_SUMMARY.*    Marp deck (PDF + PPTX) — 11 slides, mermaid
                              diagrams pre-rendered for portable export
  docs/CLOUDFLARE_WAF_BYPASS.md  CF Skip-rule runbook for /v1/* paths
  docs/ARCHITECTURE.md        canonical spec

Live demo (testnet, 2026-05-06):
  https://mp-buyers.vector.testnet.apexfusion.org      (buyer SPA)
  https://mp-suppliers.vector.testnet.apexfusion.org   (supplier API)
  https://mp-indexer.vector.testnet.apexfusion.org     (indexer + UI)
2026-05-06 13:27:48 +02:00
..
.github/workflows
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
lib/marketplace
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
validators
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
.gitignore
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
aiken.lock
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
aiken.toml
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
plutus.json
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00
README.md
M1-F: end-to-end LLM marketplace lifecycle on Vector testnet
2026-05-06 13:27:48 +02:00

README.md

local-agents/marketplace

Aiken validators for the Local Agents Marketplace (M1, v1). Two validators ship from this project:

  • AdvertScript (validators/advert.ak) — supplier-owned advertisement registry; redeemers PostAdvert | UpdateAdvert | RetireAdvert.
  • EscrowScript (validators/escrow.ak) — happy-path bonded escrow, state machine Open → Claimed → Submitted → Accepted | Released (and Open|Claimed → Reclaimed); redeemers Claim | Submit | Accept | Reclaim | Release.

Datum schemas mirror packages/shared/src/cbor/types.ts byte-for-byte (Plutus Constr0 with fields in declaration order). Spec: docs/ARCHITECTURE.md §4. ACCEPT_WINDOW = 600_000 ms (10 min) lives in lib/marketplace/common.ak. Compile with aiken check && aiken build; the resulting plutus.json is consumed by M1-B's tx builders.