Documentation

Odal Node creates, signs and serves EU Digital Product Passports on your own infrastructure, with your own keys. Anyone can verify a passport it publishes without going through Odal. The regulatory library is Apache-2.0; the node is BSL-1.1 and free to self-host for your own compliance obligations. The project is pre-production.

Get started

• Introduction: what Odal Node is, its licences and its status.
• Quick Start: run a node and publish a signed passport over the REST API.
• What the core does: use the Rust library on its own.
• Licensing: what is free, and where the line is.

Use the node

• Importing product data: spreadsheets in, draft passports out.
• A passport’s lifecycle: publish, correct, replace, suspend, retire, end of life.
• Handing over responsibility: moving a passport to another operator.
• Proof files and verification: the evidence dossier and how anyone checks it.
• Access credentials: letting repairers and recyclers see restricted data.
• Your operator identity: operator details, identifiers and facilities.
• Integrations and statistics: webhooks, scan counts and machine-readable views.
• Electronic seals: sealing, seal status and trusted lists.
• The unsold-goods disclosure: the yearly report, which is not a passport.

Run the node

• Self-Hosting, Production deployment, Backup, restore and key custody and Upgrading.

Reference

• Configuration reference, The CLI, Webhook events, Error reference and Troubleshooting.

Concepts

• Core Concepts: the design in three rules.
• How the node works, What Odal can and cannot see, Permanence and retention and Operating securely.

The law

• ESPR overview: what the regulation requires, and how the software maps to it.
• Product groups: batteries, textiles, toys, detergents, construction products, vehicles, and phones and tablets.
• Acts and standards: every act and standard the code relies on.

API reference

• API reference: every route a node serves, with request and response schemas, rendered from the OpenAPI 3.1 document (also available as openapi.yaml). Its “Test request” button calls a node straight from your browser, so that node’s CORS_ALLOWED_ORIGINS must include this site’s origin.