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)
49 lines
1.4 KiB
YAML
49 lines
1.4 KiB
YAML
# MAINNET DEPLOYMENT — DEFERRED
|
|
# Wired but not yet exercised. Mainnet rollout requires:
|
|
# - ARCHITECTURE.md §9 #5 (mainnet safety: env-gate, wallet allowlist, MAINNET=1 flag)
|
|
# - Real funded mainnet wallets
|
|
# - Vector mainnet ogmios stack (apex-dashboard-mainnet) running on the same host
|
|
# Do NOT `docker compose up` until those land.
|
|
#
|
|
# deploy/mainnet/docker-compose.ollama.yml — Ollama (local LLM) — MAINNET
|
|
#
|
|
# Mirrors the testnet ollama compose file, with mainnet-prefixed names so a
|
|
# testnet stack and a mainnet stack can run side-by-side on the same host.
|
|
#
|
|
# One-shot prerequisite (run once on the host):
|
|
# docker network create marketplace-mainnet-net
|
|
#
|
|
# Bring up (DO NOT until mainnet safety lands):
|
|
# docker compose -f deploy/mainnet/docker-compose.ollama.yml up -d
|
|
|
|
name: marketplace-mainnet-ollama
|
|
|
|
services:
|
|
ollama:
|
|
image: ollama/ollama:latest
|
|
container_name: marketplace-mainnet-ollama
|
|
restart: unless-stopped
|
|
volumes:
|
|
- marketplace_mainnet_ollama_models:/root/.ollama
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "ollama list >/dev/null 2>&1 || exit 1"]
|
|
interval: 30s
|
|
timeout: 10s
|
|
retries: 5
|
|
start_period: 30s
|
|
networks:
|
|
- marketplace-mainnet-net
|
|
logging:
|
|
driver: json-file
|
|
options:
|
|
max-size: "10m"
|
|
max-file: "3"
|
|
|
|
networks:
|
|
marketplace-mainnet-net:
|
|
external: true
|
|
name: marketplace-mainnet-net
|
|
|
|
volumes:
|
|
marketplace_mainnet_ollama_models:
|