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)
67 lines
1.3 KiB
Plaintext
67 lines
1.3 KiB
Plaintext
# Top-level .dockerignore — applies to every `docker build` invoked with
|
|
# the repo root as the context (which is what all three service Dockerfiles
|
|
# use, so they can resolve the workspace via pnpm).
|
|
#
|
|
# We keep this conservative on purpose: each service Dockerfile is explicit
|
|
# about which directories it COPYs in (packages/shared + its own dir), so we
|
|
# don't strictly need to exclude every other service's source. But excluding
|
|
# build artifacts and secrets at the context layer makes builds faster and
|
|
# safer.
|
|
|
|
# Dependencies — installed inside builder stage, not from host
|
|
**/node_modules
|
|
|
|
# Compiled / built artifacts (Vite + tsc) — rebuilt in builder
|
|
**/dist
|
|
**/build
|
|
**/.vite
|
|
**/.vitest-cache
|
|
**/*.tsbuildinfo
|
|
|
|
# Logs
|
|
**/*.log
|
|
logs/
|
|
|
|
# Environment files (NEVER ship local .env into images)
|
|
.env
|
|
.env.*
|
|
!.env.example
|
|
**/.env
|
|
**/.env.*
|
|
!**/.env.example
|
|
|
|
# Local data dirs (SQLite cache, etc.) — handled via named volumes
|
|
data/
|
|
indexer/data/
|
|
|
|
# Editor / OS noise
|
|
.DS_Store
|
|
.idea/
|
|
.vscode/
|
|
*.swp
|
|
|
|
# Git metadata
|
|
.git
|
|
.gitignore
|
|
.gitattributes
|
|
|
|
# CI / scripts not needed for runtime
|
|
.github/
|
|
coverage/
|
|
|
|
# Tests — not needed in production images
|
|
**/tests
|
|
**/*.test.ts
|
|
**/*.test.tsx
|
|
**/*.spec.ts
|
|
**/*.spec.tsx
|
|
|
|
# Docs — not needed in production images
|
|
docs/
|
|
README.md
|
|
deploy/
|
|
|
|
# Contracts (Aiken/Plutus build outputs)
|
|
contracts/build/
|
|
contracts/.aiken/
|