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)
30 lines
958 B
Python
30 lines
958 B
Python
"""Simple supplier discovery -- checks health of known supplier URLs."""
|
|
import asyncio
|
|
from typing import List
|
|
|
|
from lib.protocol import SupplierInfo
|
|
from supplier_client import check_supplier_health
|
|
|
|
|
|
async def discover_suppliers(config) -> List[SupplierInfo]:
|
|
"""Check health of each URL in config.supplier_urls and return reachable suppliers.
|
|
|
|
Args:
|
|
config: BuyerConfig with supplier_urls list.
|
|
|
|
Returns:
|
|
List of SupplierInfo for reachable suppliers.
|
|
"""
|
|
tasks = [check_supplier_health(url) for url in config.supplier_urls]
|
|
results = await asyncio.gather(*tasks, return_exceptions=True)
|
|
|
|
suppliers = []
|
|
for i, result in enumerate(results):
|
|
if isinstance(result, SupplierInfo):
|
|
# Ensure the endpoint field reflects the URL we queried
|
|
if not result.endpoint:
|
|
result.endpoint = config.supplier_urls[i]
|
|
suppliers.append(result)
|
|
|
|
return suppliers
|