dpp-domain 0.17.0

EU Digital Product Passport domain types, port traits, and per-field disclosure policy
Documentation

dpp-domain

crates.io docs.rs License: Apache-2.0

Core domain types, port traits, and schema validation for the Odal Node Digital Product Passport system.

This is the foundational crate. All other dpp-* crates depend on it. It contains everything that changes when EU regulations change — and nothing else.

When to use this crate

  • You need the DPP data model: Passport, SectorData, TransferChain.
  • You are implementing a platform adapter (database, HTTP layer) and need the port trait interfaces: PassportRepository, IdentityPort, PluginHost, etc.
  • You want to validate passport data against embedded JSON schemas.

Example

use dpp_domain::access::{SectorAccessPolicy, filter_by_audience};
use dpp_domain::catalog::SectorCatalog;
use dpp_domain::Audience;
use serde_json::json;

// Sector metadata is data, not code: regime, status and retention all come
// from the catalog manifests.
let catalog = SectorCatalog::new();
let battery = catalog.get("battery").expect("battery is in the catalog");
assert_eq!(battery.key, "battery");

// Disclosure classes come from the schema *version* a passport declares,
// not from one unversioned map. That is what lets a published passport keep
// the classification its signatures were taken under: reclassifying a field
// is a new schema version, and an older passport goes on being filtered by
// the version it was validated against.
let policy = SectorAccessPolicy::for_schema_version("battery", &battery.current_schema_version)
    .expect("the current battery schema classifies every property");

let full = json!({ "productName": "EcoCell", "stateOfHealthPct": 87.5 });
let public = filter_by_audience(&full, &policy, Audience::Public);

// State of health is Annex XIII point 4 — data about one individual battery,
// reserved to holders of a legitimate interest and withheld from the public.
assert_eq!(public.filtered_data["productName"], "EcoCell");
assert!(public.filtered_data.get("stateOfHealthPct").is_none());

Relationship to other crates

Crate Role
dpp-crypto JWS signing and the keystore — no dependency in either direction
dpp-vc Credentials, did:web and status lists — depends on this crate
dpp-digital-link GS1 Digital Link parsing — depends on this crate
dpp-aas AAS submodel mapping — depends on this crate
dpp-registry EU Central Registry connector — depends on this crate
dpp-plugin-traits Wasm plugin ABI — standalone, no dependency on this crate

Minimum Rust version

1.96 (MSRV is enforced in CI)

License

Apache-2.0 — see LICENSE