Skip to content
Registry stack docs v0 · draft

Registry Platform reference

Use this page to identify which shared crate owns a primitive and which repo owns the product behavior around it. The authoritative crate APIs live in the upstream registry-platform workspace.

CrateShared surfaceCurrent consumers
registry-platform-authcommonBearer parsing, API-key fingerprinting, static credential helpersRelay, Notary
registry-platform-auditAudit envelopes, async sinks, chain verification, redaction helpers, audit hash secret handlingRelay, Notary
registry-platform-cryptoEd25519 JWK parsing/signing/verification, DID validation, JSON canonicalizationRelay, Notary, Platform OIDC and SD-JWT crates
registry-platform-httpsecCORS validation, security headers, body limits, RFC 7807 helpersRelay, Notary
registry-platform-httputilOutbound HTTP clients, bounded reads, URL and fetch policy validationRelay, Notary, Platform OIDC
registry-platform-oidcOIDC discovery, JWKS fetch/cache, JWT verificationRelay, Notary
registry-platform-sdjwtSD-JWT VC issuance, disclosure construction, holder-proof validationRelay provenance helpers, Notary credential issuance
registry-platform-testingMock IdP, mock HTTP upstream, key fixtures, audit chain assertionsNotary tests, Platform cross-crate tests
ConcernPlatform ownsConsumer owns
API-key authFingerprint format, constant-time comparison helpers, Bearer parsingConfig shape, principal IDs, scopes, route enforcement
OIDCToken verification, JWKS fetch/cache, standard claim validationAccepted issuer/audience, scope mapping, allowed clients, auth mode selection
AuditEnvelope shape, chain state, sinks, verification, redaction helpersEvent schema, retention policy, sink configuration, operational monitoring
HTTP securityMiddleware primitives and reusable problem responsesWhich routes expose docs, CORS policy values, deployment proxy configuration
Outbound HTTPURL policy, bounded reads, client constructionWhich upstreams are trusted and what credentials are attached
SD-JWT VCIssuance and holder-proof helper primitivesCredential profile config, claim selection, disclosure policy, issuing workflow
Crypto and DIDShared Ed25519 JWK and DID helper behaviorWhich DID methods and issuers are accepted by a product surface

Registry applications should pin Platform by git tag or revision, then depend only on the crates they need. Local development in this workspace currently uses sibling path dependencies beside Relay and Notary.

The shared crates are private workspace crates, not a standalone hosted service. No Platform OpenAPI document exists because Platform does not own HTTP routes.