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)
36 lines
1.1 KiB
Python
36 lines
1.1 KiB
Python
"""Buyer configuration -- loads .env and exposes typed settings."""
|
|
import os
|
|
from dataclasses import dataclass, field
|
|
from pathlib import Path
|
|
from typing import List
|
|
|
|
from dotenv import load_dotenv
|
|
|
|
load_dotenv(Path(__file__).parent / ".env")
|
|
|
|
|
|
@dataclass
|
|
class BuyerConfig:
|
|
ogmios_url: str
|
|
submit_url: str
|
|
buyer_mnemonic: str
|
|
escrow_script_hash: str
|
|
resolver_address: str
|
|
supplier_urls: List[str] = field(default_factory=list)
|
|
port: int = 8080
|
|
|
|
|
|
def get_config() -> BuyerConfig:
|
|
raw_urls = os.getenv("SUPPLIER_URLS", "http://localhost:9000")
|
|
supplier_urls = [u.strip() for u in raw_urls.split(",") if u.strip()]
|
|
|
|
return BuyerConfig(
|
|
ogmios_url=os.getenv("VECTOR_OGMIOS_URL", "https://ogmios.vector.testnet.apexfusion.org"),
|
|
submit_url=os.getenv("VECTOR_SUBMIT_URL", "https://submit.vector.apexfusion.org/api/submit/tx"),
|
|
buyer_mnemonic=os.getenv("BUYER_MNEMONIC", ""),
|
|
escrow_script_hash=os.getenv("ESCROW_SCRIPT_HASH", ""),
|
|
resolver_address=os.getenv("RESOLVER_ADDRESS", ""),
|
|
supplier_urls=supplier_urls,
|
|
port=int(os.getenv("BUYER_PORT", "8080")),
|
|
)
|