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)
75 lines
2.6 KiB
TypeScript
75 lines
2.6 KiB
TypeScript
/**
|
|
* buyer-sdk-lifecycle.test.ts — RED phase (M1-E)
|
|
*
|
|
* Category F: SDK — Marketplace lifecycle (~5 tests)
|
|
*
|
|
* All tests FAIL until M1-E-green.
|
|
*/
|
|
|
|
import { describe, it, expect, vi } from "vitest";
|
|
import { Marketplace } from "../../buyer/src/sdk/Marketplace.js";
|
|
import { MockChainProvider } from "../../packages/shared/src/chain/MockChainProvider.js";
|
|
import { buildBuyerWalletKey } from "../fixtures/buyer-side/wallet-keys.js";
|
|
import type { ProgressEvent } from "../../buyer/src/sdk/types.js";
|
|
|
|
function makeMp() {
|
|
return new Marketplace({
|
|
chain: new MockChainProvider(),
|
|
indexerUrl: "http://indexer.test",
|
|
walletKey: buildBuyerWalletKey(),
|
|
networkParams: { networkId: 0 },
|
|
});
|
|
}
|
|
|
|
describe("Marketplace lifecycle", () => {
|
|
it("new Marketplace(...) constructs synchronously without any network calls", () => {
|
|
const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response());
|
|
const mp = new Marketplace({
|
|
chain: new MockChainProvider(),
|
|
indexerUrl: "http://indexer.test",
|
|
walletKey: buildBuyerWalletKey(),
|
|
networkParams: { networkId: 0 },
|
|
});
|
|
expect(mp).toBeDefined();
|
|
expect(fetchSpy).not.toHaveBeenCalled();
|
|
fetchSpy.mockRestore();
|
|
});
|
|
|
|
it("marketplace.on('progress', listener) receives progress events emitted via emitProgress", () => {
|
|
const mp = makeMp();
|
|
const received: ProgressEvent[] = [];
|
|
mp.on("progress", (e) => received.push(e));
|
|
mp.emitProgress({ type: "escrow_posted", escrow_ref: "x".repeat(64) + "#0" });
|
|
expect(received).toHaveLength(1);
|
|
expect(received[0].type).toBe("escrow_posted");
|
|
});
|
|
|
|
it("marketplace.off('progress', listener) stops receiving events", () => {
|
|
const mp = makeMp();
|
|
const received: ProgressEvent[] = [];
|
|
const listener = (e: ProgressEvent) => received.push(e);
|
|
mp.on("progress", listener);
|
|
mp.emitProgress({ type: "escrow_posted" });
|
|
mp.off("progress", listener);
|
|
mp.emitProgress({ type: "supplier_called" });
|
|
expect(received).toHaveLength(1);
|
|
expect(received[0].type).toBe("escrow_posted");
|
|
});
|
|
|
|
it("marketplace.close() does not throw (no-op in v1)", () => {
|
|
const mp = makeMp();
|
|
expect(() => mp.close()).not.toThrow();
|
|
});
|
|
|
|
it("multiple listeners can be registered for 'progress'", () => {
|
|
const mp = makeMp();
|
|
const received1: string[] = [];
|
|
const received2: string[] = [];
|
|
mp.on("progress", (e) => received1.push(e.type));
|
|
mp.on("progress", (e) => received2.push(e.type));
|
|
mp.emitProgress({ type: "receipt_verified" });
|
|
expect(received1).toEqual(["receipt_verified"]);
|
|
expect(received2).toEqual(["receipt_verified"]);
|
|
});
|
|
});
|