BDI Kerncomponenten

A reference implementation of the three core components of the Basis Data Infrastructuur (TN-559705): the Associatie Register (ASR), the Orkestratie Register (ORS), and the BDI Connector (CON). Open source under EUPL 1.2.

Explore interactively Quick start API reference

TypeScript + Bun

Monorepo on Bun 1.3. No bundler gymnastics, no transpile step. Tests, TS, SQLite and Valkey clients all ship in the runtime.

Clean architecture

Each service is layered domain → application → infrastructure → interface. Ports & adapters everywhere. No framework-driven magic.

Cryptography you can audit

EdDSA/ES256/PS256 only. BDI JWS profile with crit header. RFC 7523 client assertions. Real ACME server + client. X.509 via DER/ASN.1.

Production ports

Postgres + RLS, Valkey streams, HSM/PKCS#11, OIDC/SAML identity, Cedar/OPA/Keycloak PDPs, OTLP. Swappable at the composition root.

The three components

ASR — Associatie Register

Governs who can participate. Member onboarding, 4-eyes approval, connector binding, trustlist, BVAD issuance, RFC 8693 federation.

ORS — Orkestratie Register

Governs what happens in a chain. Chain contexts, delegations, pseudonymised natural persons, BVOD issuance, event subscriptions.

CON — Connector

Runs at each member. Validates inbound BVAD + BVOD, runs the PDP, dispatches outbound webhooks with backoff, handles proxy forwarding.

Try it in 60 seconds

# Install Bun 1.3+
curl -fsSL https://bun.sh/install | bash

# Clone and install
git clone https://github.com/transportial/basic-data-infrastructure.git
cd basic-data-infrastructure
bun install

# Run every test (offline, no external services)
bun test

# Boot any service
bun run --filter '@bdi/asr' dev
bun run --filter '@bdi/ors' dev
bun run --filter '@bdi/con' dev

What's inside

Interactive explorer →

Click through the components, run animated flows for onboarding, BVAD/BVOD issuance, webhook delivery and federation.

OpenAPI references →

Browse the ASR, ORS and CON HTTP contracts rendered with Scalar. Try requests straight from the page.

Written docs →

Architecture, setup, contribution guide, security policy, and the architecture decision records.