Lab Demo

This lab demo runs a full MaterialDNA/ProductDNA → Offer → Match → Transfer flow using the sandbox API. It is not a pilot or production deployment.

Open specification Back to docs

Run the demo locally

Start infrastructure
Bring up Postgres + Redis + MinIO with docker compose.
Execute the demo
Run the single command to migrate, seed, and simulate.
Review output
Use the timeline log and events stream for validation.

cp .env.docker.example .env.docker
docker compose --env-file .env.docker up -d
bun run lab:demo

Events stream

/api/v1/stream (SSE)

Event log

/api/v1/events

Metrics

/api/metrics

Privacy notice

/api/privacy

Optional API key protection

If you enable API key protection, write endpoints require an x-api-keyheader (or Authorization: Bearer <key>). This is optional and disabled by default.

API_KEY_ENABLED=true
API_KEY=change-me

Federation relay demo (two nodes)

Spins up two local node instances and relays events to demonstrate lab-only federation messaging. Nodes share a single lab database for convenience and do not represent production federation.

bun run lab:federation

Relay endpoint

/api/v1/relay

Events stream

/api/v1/stream (SSE)

Interop flow snapshot

Conceptual view of the four-step lab flow.

Event timeline preview

Sample output from the lab simulation script.