cbab81efbd
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)
64 lines
2.5 KiB
Python
64 lines
2.5 KiB
Python
from cbor2 import CBORTag
|
|
|
|
|
|
def _build_datum_fields(
|
|
task_hash_hex, buyer_vkh, supplier_vkh, payment_dfm,
|
|
buyer_bond, supplier_bond, deadline_posix_ms, dispute_window_ms,
|
|
state_field, resolver_cred,
|
|
):
|
|
if supplier_vkh is None:
|
|
supplier_field = CBORTag(122, [])
|
|
else:
|
|
supplier_field = CBORTag(121, [CBORTag(121, [supplier_vkh])])
|
|
|
|
return CBORTag(121, [
|
|
bytes.fromhex(task_hash_hex),
|
|
CBORTag(121, [buyer_vkh]),
|
|
payment_dfm,
|
|
buyer_bond,
|
|
supplier_field,
|
|
supplier_bond,
|
|
deadline_posix_ms,
|
|
dispute_window_ms,
|
|
state_field,
|
|
CBORTag(121, [resolver_cred]),
|
|
])
|
|
|
|
|
|
def build_open_datum(task_hash_hex, buyer_vkh, payment_dfm, buyer_bond,
|
|
supplier_bond, deadline_posix_ms, dispute_window_ms, resolver_cred):
|
|
state_field = CBORTag(121, [])
|
|
return _build_datum_fields(
|
|
task_hash_hex=task_hash_hex, buyer_vkh=buyer_vkh, supplier_vkh=None,
|
|
payment_dfm=payment_dfm, buyer_bond=buyer_bond, supplier_bond=supplier_bond,
|
|
deadline_posix_ms=deadline_posix_ms, dispute_window_ms=dispute_window_ms,
|
|
state_field=state_field, resolver_cred=resolver_cred,
|
|
)
|
|
|
|
|
|
def build_claimed_datum(task_hash_hex, buyer_vkh, supplier_vkh, payment_dfm,
|
|
buyer_bond, supplier_bond, deadline_posix_ms, dispute_window_ms,
|
|
resolver_cred):
|
|
state_field = CBORTag(122, [])
|
|
return _build_datum_fields(
|
|
task_hash_hex=task_hash_hex, buyer_vkh=buyer_vkh, supplier_vkh=supplier_vkh,
|
|
payment_dfm=payment_dfm, buyer_bond=buyer_bond, supplier_bond=supplier_bond,
|
|
deadline_posix_ms=deadline_posix_ms, dispute_window_ms=dispute_window_ms,
|
|
state_field=state_field, resolver_cred=resolver_cred,
|
|
)
|
|
|
|
|
|
def build_submitted_datum(task_hash_hex, buyer_vkh, supplier_vkh, payment_dfm,
|
|
buyer_bond, supplier_bond, deadline_posix_ms, dispute_window_ms,
|
|
result_hash_hex, submitted_posix_ms, resolver_cred):
|
|
state_field = CBORTag(123, [
|
|
bytes.fromhex(result_hash_hex),
|
|
submitted_posix_ms,
|
|
])
|
|
return _build_datum_fields(
|
|
task_hash_hex=task_hash_hex, buyer_vkh=buyer_vkh, supplier_vkh=supplier_vkh,
|
|
payment_dfm=payment_dfm, buyer_bond=buyer_bond, supplier_bond=supplier_bond,
|
|
deadline_posix_ms=deadline_posix_ms, dispute_window_ms=dispute_window_ms,
|
|
state_field=state_field, resolver_cred=resolver_cred,
|
|
)
|