Directories
¶
| Path | Synopsis |
|---|---|
|
Package agentaccess defines the profile-level artifacts for successful, evidence-qualified AI Agent delivery and for declaring the evaluated access paths of a deployment.
|
Package agentaccess defines the profile-level artifacts for successful, evidence-qualified AI Agent delivery and for declaring the evaluated access paths of a deployment. |
|
Package allowlist matches a candidate DID against a trust pattern — the admission decision behind a pipeline's allow-list.
|
Package allowlist matches a candidate DID against a trust pattern — the admission decision behind a pipeline's allow-list. |
|
Package appraisal defines the pure domain model for an exact evidence view and a policy-relative decision over its scoped evidence vector.
|
Package appraisal defines the pure domain model for an exact evidence view and a policy-relative decision over its scoped evidence vector. |
|
chain
Package chain builds a dPLaaX EvidenceView from the exact credential spine selected and verified by a chain walker, then applies one local profile.
|
Package chain builds a dPLaaX EvidenceView from the exact credential spine selected and verified by a chain walker, then applies one local profile. |
|
inputcapture
Package inputcapture records the immutable identities of external inputs a verifier actually reads during one appraisal.
|
Package inputcapture records the immutable identities of external inputs a verifier actually reads during one appraisal. |
|
Package bundle defines the portable audit-evidence bundle: the on-disk convention a relying party archives during live operation so that a provenance chain re-verifies offline — years later, with every piece of the emitting infrastructure gone — plus the assembly (Export) and the offline verification (Verify) that operate it.
|
Package bundle defines the portable audit-evidence bundle: the on-disk convention a relying party archives during live operation so that a provenance chain re-verifies offline — years later, with every piece of the emitting infrastructure gone — plus the assembly (Export) and the offline verification (Verify) that operate it. |
|
Package canon owns the deterministic byte representation of JSON signing scopes ("canonicalization") and the strict decoder that protects them.
|
Package canon owns the deterministic byte representation of JSON signing scopes ("canonicalization") and the strict decoder that protects them. |
|
jcs
Package jcs implements RFC 8785 (JSON Canonicalization Scheme) — the Phase 1 (MUST) canonicalization for dplaax signing scopes.
|
Package jcs implements RFC 8785 (JSON Canonicalization Scheme) — the Phase 1 (MUST) canonicalization for dplaax signing scopes. |
|
urdna2015
Package urdna2015 implements RDF Dataset Canonicalization (URDNA2015) for the eddsa-rdfc-2022 cryptosuite, wrapping github.com/piprate/json-gold.
|
Package urdna2015 implements RDF Dataset Canonicalization (URDNA2015) for the eddsa-rdfc-2022 cryptosuite, wrapping github.com/piprate/json-gold. |
|
cmd
|
|
|
network
command
Command network is the dplaax network node: a control-plane-only binary that loads its HOCON config, constructs the DID / Schema / Signer / VC / Audit / Chain services over file-backed stores, and serves them via ConnectRPC (h2c) behind the L1 authorization interceptors, plus the public W3C DID resolution route, /healthz (liveness), and /readyz (dependency-aware readiness).
|
Command network is the dplaax network node: a control-plane-only binary that loads its HOCON config, constructs the DID / Schema / Signer / VC / Audit / Chain services over file-backed stores, and serves them via ConnectRPC (h2c) behind the L1 authorization interceptors, plus the public W3C DID resolution route, /healthz (liveness), and /readyz (dependency-aware readiness). |
|
pipeline
command
Command pipeline is the dplaax data-plane deployment root: a short-lived, per-execution binary (STL) that loads its HOCON config from a single required file (the CONFIG_FILE convention, hoconconfig.LoadFile), composes pipeline/runtime — the network-agnostic data plane — against WIRE clients to a cmd/network registry, and runs the configured transport loops.
|
Command pipeline is the dplaax data-plane deployment root: a short-lived, per-execution binary (STL) that loads its HOCON config from a single required file (the CONFIG_FILE convention, hoconconfig.LoadFile), composes pipeline/runtime — the network-agnostic data plane — against WIRE clients to a cmd/network registry, and runs the configured transport loops. |
|
provin
command
Command provin is the operator CLI for DID, schema, and chain management against a dplaax registry (see README.md).
|
Command provin is the operator CLI for DID, schema, and chain management against a dplaax registry (see README.md). |
|
provin/internal/client
Package client builds the ConnectRPC clients the provin CLI drives a registry with: base-URL validation, the L1 bearer-token interceptor, and nothing else — commands own request shaping, this package owns the wire.
|
Package client builds the ConnectRPC clients the provin CLI drives a registry with: base-URL validation, the L1 bearer-token interceptor, and nothing else — commands own request shaping, this package owns the wire. |
|
provin/internal/commands
Package commands implements the provin CLI's command groups (one file per group).
|
Package commands implements the provin CLI's command groups (one file per group). |
|
provin/internal/keyfile
Package keyfile persists a CLI-local owner key as a single JWK file — the only private key that ever exists outside the registry (KMS model; see cmd/provin/README.md).
|
Package keyfile persists a CLI-local owner key as a single JWK file — the only private key that ever exists outside the registry (KMS model; see cmd/provin/README.md). |
|
Package crypto defines the key-generation, signing, and verification interfaces.
|
Package crypto defines the key-generation, signing, and verification interfaces. |
|
ed25519
Package ed25519 is the Ed25519 implementation of the crypto interfaces — the PoC's only signature suite — plus the raw signing primitive.
|
Package ed25519 is the Ed25519 implementation of the crypto interfaces — the PoC's only signature suite — plus the raw signing primitive. |
|
Package delegation implements the owner-signed DelegationCredential: an Owner DID's assertion that a Pipeline or Process DID acts under its authority.
|
Package delegation implements the owner-signed DelegationCredential: an Owner DID's assertion that a Pipeline or Process DID acts under its authority. |
|
deploy
|
|
|
quickstart/provision
command
Command provision lays down the operator-mode NATS trust material the quickstart's broker and its two nodes (`network`, the control plane; `pipeline`, the data plane — the separated topology, PR3c) consume — an operator trust root, the deployment's account, a system account with a narrowed claims-push user, the account-claims JWTs in a resolver directory, and a broker config running the directory resolver over that same directory.
|
Command provision lays down the operator-mode NATS trust material the quickstart's broker and its two nodes (`network`, the control plane; `pipeline`, the data plane — the separated topology, PR3c) consume — an operator trust root, the deployment's account, a system account with a narrowed claims-push user, the account-claims JWTs in a resolver directory, and a broker config running the directory resolver over that same directory. |
|
Package did is the method-agnostic DID domain: the W3C DID Document model shared by every consumer (resolution, verification, key extraction) and the method-dispatch primitive.
|
Package did is the method-agnostic DID domain: the W3C DID Document model shared by every consumer (resolution, verification, key extraction) and the method-dispatch primitive. |
|
dplaax
Package dplaax implements the did:dplaax DID method — the T1 native method of the provin profile and the only method admitted on the credential-issuance plane (Process / Pipeline / Owner DIDs behind a PipelinePassCredential's issuer).
|
Package dplaax implements the did:dplaax DID method — the T1 native method of the provin profile and the only method admitted on the credential-issuance plane (Process / Pipeline / Owner DIDs behind a PipelinePassCredential's issuer). |
|
gen
|
|
|
Package hoconconfig implements a three-layer HOCON configuration loader.
|
Package hoconconfig implements a three-layer HOCON configuration loader. |
|
internal
|
|
|
httpserve
Package httpserve is the shared HTTP/2 serving plumbing for the node binaries (TLS/h2c posture, graceful drain).
|
Package httpserve is the shared HTTP/2 serving plumbing for the node binaries (TLS/h2c posture, graceful drain). |
|
netcompose
Package netcompose is the registry control-plane composition shared by the node binaries: service wiring (BuildHandler), the audit and batch runners, the chain operator, readiness, and the metrics mount.
|
Package netcompose is the registry control-plane composition shared by the node binaries: service wiring (BuildHandler), the audit and batch runners, the chain operator, readiness, and the metrics mount. |
|
numberinventory
Package numberinventory scans persisted JSON artifacts for numbers that the RFC 8785 canonicalization switch would re-serialize, so the switch can be gated on evidence rather than on an assumption (ForkW-1 §2.2b-1).
|
Package numberinventory scans persisted JSON artifacts for numbers that the RFC 8785 canonicalization switch would re-serialize, so the switch can be gated on evidence rather than on an assumption (ForkW-1 §2.2b-1). |
|
numberinventory/cmd/numberinventory
command
Command numberinventory scans persisted stores for numbers that the RFC 8785 canonicalization switch would re-serialize (ForkW-1 §2.2b-1).
|
Command numberinventory scans persisted stores for numbers that the RFC 8785 canonicalization switch would re-serialize (ForkW-1 §2.2b-1). |
|
Package keystore defines the local key-custody contract: persisting key material for at-issuance key generation and signing on behalf of a DID's key.
|
Package keystore defines the local key-custody contract: persisting key material for at-issuance key generation and signing on behalf of a DID's key. |
|
filestore
Package filestore is the file-backed keystore.KeyStore: the production key-at-rest store for the registry process (KMS model).
|
Package filestore is the file-backed keystore.KeyStore: the production key-at-rest store for the registry process (KMS model). |
|
Package multibase implements the multiformats multibase encoding for the self-describing byte strings this repository puts on the wire: Data Integrity proofValue and Multikey publicKeyMultibase, both base58btc ("z" prefix).
|
Package multibase implements the multiformats multibase encoding for the self-describing byte strings this repository puts on the wire: Data Integrity proofValue and Multikey publicKeyMultibase, both base58btc ("z" prefix). |
|
network
|
|
|
pkg/auth
Package auth is the network layer's authorization-enforcement wiring (the PEP).
|
Package auth is the network layer's authorization-enforcement wiring (the PEP). |
|
pkg/chainconfig
Package chainconfig is the chain transport configuration layer: it selects the pub-sub backend (nats in production, noop in debug builds) and carries the nats parameters (endpoint, account/trust-root seeds, resolver directory, node identity).
|
Package chainconfig is the chain transport configuration layer: it selects the pub-sub backend (nats in production, noop in debug builds) and carries the nats parameters (endpoint, account/trust-root seeds, resolver directory, node identity). |
|
pkg/core
Package core is the network server foundation: SSRF-resistant outbound URL validation, secret URI resolution, and the typed/validated config tree built on hoconconfig.
|
Package core is the network server foundation: SSRF-resistant outbound URL validation, secret URI resolution, and the typed/validated config tree built on hoconconfig. |
|
pkg/didresolver
Package didresolver is the outbound, cross-registry DID resolver: given a did:dplaax DID it derives the owning registry's W3C resolution URL, fetches the document over an SSRF-guarded HTTP client, and returns the parsed *did.DIDDocument.
|
Package didresolver is the outbound, cross-registry DID resolver: given a did:dplaax DID it derives the owning registry's W3C resolution URL, fetches the document over an SSRF-guarded HTTP client, and returns the parsed *did.DIDDocument. |
|
pkg/pagination
Package pagination codifies the repo's paged-RPC conventions, set by the discovery slice's first paged RPCs and shared by every later one:
|
Package pagination codifies the repo's paged-RPC conventions, set by the discovery slice's first paged RPCs and shared by every later one: |
|
pkg/pipelineconfig
Package pipelineconfig is the data-plane configuration layer: it declares the pipeline transport loops a cmd/pipeline node runs.
|
Package pipelineconfig is the data-plane configuration layer: it declares the pipeline transport loops a cmd/pipeline node runs. |
|
pkg/registry
Package registry is the registry-identity configuration layer: the did:dplaax {registry} segment this server is authoritative for, and the service endpoints embedded in every issued DID Document.
|
Package registry is the registry-identity configuration layer: the did:dplaax {registry} segment this server is authoritative for, and the service endpoints embedded in every issued DID Document. |
|
pkg/services/auditor
Package auditor is the verdict half of the async chain-audit path (slice-17h): a background Runner drains a registry of consumed chain heads, assembles each chain from the LOCAL store (the substrate slice-17g fills) by reusing chainwalk over a local-store resolver, runs vc.VerifyChain (L1 proofs + chain structure + origin), and records a per-head audit status (three-state + per-axis + coverage).
|
Package auditor is the verdict half of the async chain-audit path (slice-17h): a background Runner drains a registry of consumed chain heads, assembles each chain from the LOCAL store (the substrate slice-17g fills) by reusing chainwalk over a local-store resolver, runs vc.VerifyChain (L1 proofs + chain structure + origin), and records a per-head audit status (three-state + per-axis + coverage). |
|
pkg/services/auditor/client
Package client is the production network client for AuditService's write surface: RegisterEvidence registers evidence (a head's wire variant id — StoreVCResult.WireVariantID, not a body content address, see P1-A — plus the source content addresses it consumed) with a single wireauth-signed call that writes an irreversible receipt; RegisterAuditHead registers a head for audit the SAME way but WITHOUT a consumed-set receipt (the wire form of the data plane's in-process AuditRegistrar.Add).
|
Package client is the production network client for AuditService's write surface: RegisterEvidence registers evidence (a head's wire variant id — StoreVCResult.WireVariantID, not a body content address, see P1-A — plus the source content addresses it consumed) with a single wireauth-signed call that writes an irreversible receipt; RegisterAuditHead registers a head for audit the SAME way but WITHOUT a consumed-set receipt (the wire form of the data plane's in-process AuditRegistrar.Add). |
|
pkg/services/auditor/filestore
Package filestore is the file-backed implementation of the auditor's StatusStore, ReceiptStore, and AuditQueue — the durable audit half of the evidence substrate (spec: evidence-persistence, E2E-F-023 in provin.e2e's FINDINGS.md).
|
Package filestore is the file-backed implementation of the auditor's StatusStore, ReceiptStore, and AuditQueue — the durable audit half of the evidence substrate (spec: evidence-persistence, E2E-F-023 in provin.e2e's FINDINGS.md). |
|
pkg/services/auditor/handler
Package handler is the proto↔domain boundary for AuditService: it converts the recorded auditor.AuditRecord to the wire response and maps the read service's sentinel errors to Connect codes (errors.Is, never string matching).
|
Package handler is the proto↔domain boundary for AuditService: it converts the recorded auditor.AuditRecord to the wire response and maps the read service's sentinel errors to Connect codes (errors.Is, never string matching). |
|
pkg/services/auditor/internal/storecontract
Package storecontract is the shared behavioral suite for auditor StatusStore, ReceiptStore, and AuditQueue implementations: the mem and file stores both run it, so their semantics (sentinel errors, dedup, attempt preservation, ordering) cannot drift apart silently.
|
Package storecontract is the shared behavioral suite for auditor StatusStore, ReceiptStore, and AuditQueue implementations: the mem and file stores both run it, so their semantics (sentinel errors, dedup, attempt preservation, ordering) cannot drift apart silently. |
|
pkg/services/auditor/wirecontract
Package wirecontract holds the auditor service's wire-level contract: the wireauth op names and signed-view field builders every write RPC's client and handler must derive IDENTICALLY (D7 — an evidence-write RPC carries an L2-style wireauth proof signed by the acting pipeline/process DID), plus the consumed-set canonicalization (consumedset.go) both the receipt stores and the RPC handler enforce.
|
Package wirecontract holds the auditor service's wire-level contract: the wireauth op names and signed-view field builders every write RPC's client and handler must derive IDENTICALLY (D7 — an evidence-write RPC carries an L2-style wireauth proof signed by the acting pipeline/process DID), plus the consumed-set canonicalization (consumedset.go) both the receipt stores and the RPC handler enforce. |
|
pkg/services/chainmanager
Package chainmanager is the cross-pipeline connection control plane: two surfaces over one frozen wire (dplaax.chain.v1).
|
Package chainmanager is the cross-pipeline connection control plane: two surfaces over one frozen wire (dplaax.chain.v1). |
|
pkg/services/chainmanager/emithealth
Package emithealth is a per-publisher, in-memory TTL store of ReportEmitHealth reports: a publisher's self-reported stripped-publish health, expiring after a configured TTL.
|
Package emithealth is a per-publisher, in-memory TTL store of ReportEmitHealth reports: a publisher's self-reported stripped-publish health, expiring after a configured TTL. |
|
pkg/services/chainmanager/evidence
Package evidence is the chain manager's relationship-evidence log: the durable, append-only record of a counterparty-signed control-plane request plus the key material used to verify it (transfer.relationship.record).
|
Package evidence is the chain manager's relationship-evidence log: the durable, append-only record of a counterparty-signed control-plane request plus the key material used to verify it (transfer.relationship.record). |
|
pkg/services/chainmanager/handler
Package handler is the proto↔domain boundary for the chainmanager services.
|
Package handler is the proto↔domain boundary for the chainmanager services. |
|
pkg/services/chainmanager/infra
Package infra defines the transport-level operator abstraction for chain connections — the Hub swap point for the network-side pub-sub backend.
|
Package infra defines the transport-level operator abstraction for chain connections — the Hub swap point for the network-side pub-sub backend. |
|
pkg/services/chainmanager/infra/nats
Package nats is the production-shaped infra.Operator: a NATS decentralized-auth control-plane that maintains one local NATS account's exports/imports as a signed account-claims JWT, so the broker — independently of the peer-layer admission (slice-11/12) — enforces cross-account isolation.
|
Package nats is the production-shaped infra.Operator: a NATS decentralized-auth control-plane that maintains one local NATS account's exports/imports as a signed account-claims JWT, so the broker — independently of the peer-layer admission (slice-11/12) — enforces cross-account isolation. |
|
pkg/services/chainmanager/infra/nats/livepublisher
Package livepublisher pushes account claims to the RUNNING broker over the system-account API, so a grant issued to a live stack takes effect without a broker restart.
|
Package livepublisher pushes account claims to the RUNNING broker over the system-account API, so a grant issued to a live stack takes effect without a broker restart. |
|
pkg/services/chainmanager/infra/noop
Package noop is a debug/test-only infra.Operator: it records nothing and wires no real transport.
|
Package noop is a debug/test-only infra.Operator: it records nothing and wires no real transport. |
|
pkg/services/chainmanager/peerclient
Package peerclient is the outbound side of the chainmanager connection flow: the ConnectRPC client this CM uses to call a remote publisher's ChainPeerService.
|
Package peerclient is the outbound side of the chainmanager connection flow: the ConnectRPC client this CM uses to call a remote publisher's ChainPeerService. |
|
pkg/services/chainmanager/reportclient
Package reportclient is the production network client for ChainService's ReportEmitHealth RPC: a publisher self-reports its stripped-publish health with a single wireauth-signed call and receives back the TTL that report stays fresh for.
|
Package reportclient is the production network client for ChainService's ReportEmitHealth RPC: a publisher self-reports its stripped-publish health with a single wireauth-signed call and receives back the TTL that report stays fresh for. |
|
pkg/services/chainmanager/store
Package store defines the persistence contracts of the chain manager: subscriptions and allow-lists.
|
Package store defines the persistence contracts of the chain manager: subscriptions and allow-lists. |
|
pkg/services/chainmanager/store/memstore
Package memstore is the in-memory chainmanager store: SubscriptionStore and AllowListStore backed by mutex-guarded maps.
|
Package memstore is the in-memory chainmanager store: SubscriptionStore and AllowListStore backed by mutex-guarded maps. |
|
pkg/services/chainmanager/store/yamlstore
Package yamlstore is the filesystem chainmanager store: SubscriptionStore and AllowListStore persisted as one YAML file per record under a root directory.
|
Package yamlstore is the filesystem chainmanager store: SubscriptionStore and AllowListStore persisted as one YAML file per record under a root directory. |
|
pkg/services/chainmanager/wireauth
Package wireauth is the L2 peer-authentication layer of the chain manager: every internet-facing ChainPeerService RPC carries an Ed25519 Proof over a JCS-canonicalized per-RPC view, and this package signs and verifies them.
|
Package wireauth is the L2 peer-authentication layer of the chain manager: every internet-facing ChainPeerService RPC carries an Ed25519 Proof over a JCS-canonicalized per-RPC view, and this package signs and verifies them. |
|
pkg/services/chainmanager/wirecontract
Package wirecontract holds chainmanager's wire-level contract for the ReportEmitHealth RPC: the wireauth op name and signed-view field builder the reportclient (signing) and chainmanager/handler (verifying) packages must derive IDENTICALLY.
|
Package wirecontract holds chainmanager's wire-level contract for the ReportEmitHealth RPC: the wireauth op name and signed-view field builder the reportclient (signing) and chainmanager/handler (verifying) packages must derive IDENTICALLY. |
|
pkg/services/didregistry
Package didregistry is the domain service of the DID-lifecycle registry: it registers self-sovereign Owner DIDs, issues Pipeline/Process DIDs under owner-signed delegations, resolves documents and delegations, revokes, lists, and maintains each DID's append-only lifecycle log.
|
Package didregistry is the domain service of the DID-lifecycle registry: it registers self-sovereign Owner DIDs, issues Pipeline/Process DIDs under owner-signed delegations, resolves documents and delegations, revokes, lists, and maintains each DID's append-only lifecycle log. |
|
pkg/services/didregistry/handler
Package handler is the proto↔domain boundary for DIDService: it converts connect request/response messages to and from the didregistry domain types and maps domain sentinel errors to Connect codes.
|
Package handler is the proto↔domain boundary for DIDService: it converts connect request/response messages to and from the didregistry domain types and maps domain sentinel errors to Connect codes. |
|
pkg/services/didregistry/store
Package store defines the persistence contracts of the DID registry service.
|
Package store defines the persistence contracts of the DID registry service. |
|
pkg/services/didregistry/store/yamlstore
Package yamlstore is the filesystem DIDStore: the did:dplaax hierarchy maps to a directory tree and each DID node holds its document, delegation, status, and append-only lifecycle log as files.
|
Package yamlstore is the filesystem DIDStore: the did:dplaax hierarchy maps to a directory tree and each DID node holds its document, delegation, status, and append-only lifecycle log as files. |
|
pkg/services/payloadresolver
Package payloadresolver is the publisher's serving-boundary domain for by-reference payload delivery: it retains the payload bytes a producing process emitted (keyed by their content address) together with the set of pipeline DIDs that emitted them, and serves them back by content address.
|
Package payloadresolver is the publisher's serving-boundary domain for by-reference payload delivery: it retains the payload bytes a producing process emitted (keyed by their content address) together with the set of pipeline DIDs that emitted them, and serves them back by content address. |
|
pkg/services/payloadresolver/client
Package client is the production network client for the payload services: ResolvePayload dereferences a by-reference payload by content address from a publisher's serving boundary; Retain streams THIS node's own produced bytes to its own PayloadStoreService for later by-reference serving.
|
Package client is the production network client for the payload services: ResolvePayload dereferences a by-reference payload by content address from a publisher's serving boundary; Retain streams THIS node's own produced bytes to its own PayloadStoreService for later by-reference serving. |
|
pkg/services/payloadresolver/filestore
Package filestore is the file-backed payloadresolver.Store — the durable serving substrate for by-reference payload delivery.
|
Package filestore is the file-backed payloadresolver.Store — the durable serving substrate for by-reference payload delivery. |
|
pkg/services/payloadresolver/handler
Package handler is the proto↔domain boundary for PayloadService: it verifies each request's L2 wireauth proof in-band (no L1 interceptor — mirrors the chain.v1 peer surface), delegates authorize-then-serve to the serving boundary, and streams the returned bytes back.
|
Package handler is the proto↔domain boundary for PayloadService: it verifies each request's L2 wireauth proof in-band (no L1 interceptor — mirrors the chain.v1 peer surface), delegates authorize-then-serve to the serving boundary, and streams the returned bytes back. |
|
pkg/services/payloadresolver/memstore
Package memstore is the in-memory payloadresolver.Store — the non-durable sibling of filestore, for tests and ephemeral deployments.
|
Package memstore is the in-memory payloadresolver.Store — the non-durable sibling of filestore, for tests and ephemeral deployments. |
|
pkg/services/payloadresolver/storehandler
Package storehandler is the proto↔domain boundary for PayloadStoreService's RetainPayload.
|
Package storehandler is the proto↔domain boundary for PayloadStoreService's RetainPayload. |
|
pkg/services/payloadresolver/wirecontract
Package wirecontract holds the payloadresolver service's wire-level contract: the wireauth op name and signed-view field builder every RetainPayload client and handler must derive IDENTICALLY.
|
Package wirecontract holds the payloadresolver service's wire-level contract: the wireauth op name and signed-view field builder every RetainPayload client and handler must derive IDENTICALLY. |
|
pkg/services/schemaregistry
Package schemaregistry is the domain service of the append-only schema registry: it assigns content-addressed versions, validates schema bodies at admission, and enforces idempotent registration over a SchemaStore.
|
Package schemaregistry is the domain service of the append-only schema registry: it assigns content-addressed versions, validates schema bodies at admission, and enforces idempotent registration over a SchemaStore. |
|
pkg/services/schemaregistry/client
Package client is the production network client for SchemaService's read surface: GetSchema resolves one exact (name, version) schema record over the wire.
|
Package client is the production network client for SchemaService's read surface: GetSchema resolves one exact (name, version) schema record over the wire. |
|
pkg/services/schemaregistry/handler
Package handler is the proto↔domain boundary for SchemaService: it converts connect request/response messages to and from the schemaregistry domain types and maps domain sentinel errors to Connect codes.
|
Package handler is the proto↔domain boundary for SchemaService: it converts connect request/response messages to and from the schemaregistry domain types and maps domain sentinel errors to Connect codes. |
|
pkg/services/schemaregistry/store
Package store defines the persistence contract of the schema registry.
|
Package store defines the persistence contract of the schema registry. |
|
pkg/services/schemaregistry/store/yamlstore
Package yamlstore is the filesystem SchemaStore: one YAML record per version at {root}/{name}/{version}.yaml.
|
Package yamlstore is the filesystem SchemaStore: one YAML record per version at {root}/{name}/{version}.yaml. |
|
pkg/services/signer
Package signer is the KMS-model signing service: it exposes the crypto.Signer seam over the network so private keys never cross the RPC boundary.
|
Package signer is the KMS-model signing service: it exposes the crypto.Signer seam over the network so private keys never cross the RPC boundary. |
|
pkg/services/signer/client
Package client is the production crypto.Signer that routes signing to a remote SignerService, so private keys stay server-side (the KMS model).
|
Package client is the production crypto.Signer that routes signing to a remote SignerService, so private keys stay server-side (the KMS model). |
|
pkg/services/signer/handler
Package handler is the proto↔domain boundary for SignerService: it converts connect request/response messages to and from the signer domain and maps domain sentinel errors to Connect codes.
|
Package handler is the proto↔domain boundary for SignerService: it converts connect request/response messages to and from the signer domain and maps domain sentinel errors to Connect codes. |
|
pkg/services/tlogservice
Package tlogservice is the read service behind dplaax.tlog.v1.TlogService: a registry of the node's per-loop emission logs (keyed by log id = the producing loop's output subject), serving signed checkpoints and record ranges for transport-loss reconciliation.
|
Package tlogservice is the read service behind dplaax.tlog.v1.TlogService: a registry of the node's per-loop emission logs (keyed by log id = the producing loop's output subject), serving signed checkpoints and record ranges for transport-loss reconciliation. |
|
pkg/services/tlogservice/client
Package client is the production network client for TlogService's mirror surface (spec D-T2/D-T6): it ships checkpoint-aligned segments of a local tlog.Log to the registry via MirrorLogSegment, and reads the registry's durable resume cursor via GetMirrorState.
|
Package client is the production network client for TlogService's mirror surface (spec D-T2/D-T6): it ships checkpoint-aligned segments of a local tlog.Log to the registry via MirrorLogSegment, and reads the registry's durable resume cursor via GetMirrorState. |
|
pkg/services/tlogservice/handler
Package handler is the proto↔domain boundary for TlogService: it converts wire messages to and from the tlogservice domain and maps sentinel errors to Connect codes (errors.Is, never string matching).
|
Package handler is the proto↔domain boundary for TlogService: it converts wire messages to and from the tlogservice domain and maps sentinel errors to Connect codes (errors.Is, never string matching). |
|
pkg/services/tlogservice/logident
Package logident implements the log-identity predicate (tlog custody spec D-T3): the single fail-closed definition of what a tlog log id means and who signs it.
|
Package logident implements the log-identity predicate (tlog custody spec D-T3): the single fail-closed definition of what a tlog log id means and who signs it. |
|
pkg/services/tlogservice/mirrorstore
Package mirrorstore is the registry-side durable mirror of remote signed-hash-chain logs (spec: 2026-07-19-tlog-custody.md, D-T4): custody, not production.
|
Package mirrorstore is the registry-side durable mirror of remote signed-hash-chain logs (spec: 2026-07-19-tlog-custody.md, D-T4): custody, not production. |
|
pkg/services/tlogservice/wirecontract
Package wirecontract holds the tlogservice mirror surface's wire-level contract: the wireauth op name and signed-view field builders every MirrorLogSegment client and handler must derive IDENTICALLY (D-T2: every mirror-write RPC carries an L2-style wireauth proof signed by the log's writer identity), plus the record_payloads_framed wire codec (segmentframe.go) and the sentinels it shares with the rest of tlogservice.
|
Package wirecontract holds the tlogservice mirror surface's wire-level contract: the wireauth op name and signed-view field builders every MirrorLogSegment client and handler must derive IDENTICALLY (D-T2: every mirror-write RPC carries an L2-style wireauth proof signed by the log's writer identity), plus the record_payloads_framed wire codec (segmentframe.go) and the sentinels it shares with the rest of tlogservice. |
|
pkg/services/vcresolver
Package vcresolver stores VCs submitted by pipeline runtimes and resolves previousCredential chains across registry boundaries.
|
Package vcresolver stores VCs submitted by pipeline runtimes and resolves previousCredential chains across registry boundaries. |
|
pkg/services/vcresolver/batchresolver
Package batchresolver drains the vcresolver unresolved pool: a background Runner periodically lists queued predecessor holes, fetches each missing credential from a peer's VCResolverService, verifies its content address, and re-submits it through the local StoreVC seam — which fills the hole and enqueues the next-deeper predecessor.
|
Package batchresolver drains the vcresolver unresolved pool: a background Runner periodically lists queued predecessor holes, fetches each missing credential from a peer's VCResolverService, verifies its content address, and re-submits it through the local StoreVC seam — which fills the hole and enqueues the next-deeper predecessor. |
|
pkg/services/vcresolver/client
Package client is the production network client for a VCResolverService: it resolves pipeline credentials by content address and publishes issued credentials to the store.
|
Package client is the production network client for a VCResolverService: it resolves pipeline credentials by content address and publishes issued credentials to the store. |
|
pkg/services/vcresolver/filestore
Package filestore is the file-backed implementation of the vcresolver Store and Pool — the durable evidence substrate (spec: evidence-persistence, driven by E2E-F-023 in provin.e2e's FINDINGS.md: a restart must not erase the audit evidence).
|
Package filestore is the file-backed implementation of the vcresolver Store and Pool — the durable evidence substrate (spec: evidence-persistence, driven by E2E-F-023 in provin.e2e's FINDINGS.md: a restart must not erase the audit evidence). |
|
pkg/services/vcresolver/handler
Package handler is the proto↔domain boundary for VCResolverService: it converts connect request/response messages to and from the vcresolver domain and maps domain sentinel errors to Connect codes.
|
Package handler is the proto↔domain boundary for VCResolverService: it converts connect request/response messages to and from the vcresolver domain and maps domain sentinel errors to Connect codes. |
|
pkg/services/vcresolver/internal/storecontract
Package storecontract is the shared behavioral suite for vcresolver backend and Pool implementations: the mem and file versions both run it, so their semantics (atomic create, upsert merge, ordering, sentinel errors) cannot drift apart silently — the parity the evidence-persistence spec pins.
|
Package storecontract is the shared behavioral suite for vcresolver backend and Pool implementations: the mem and file versions both run it, so their semantics (atomic create, upsert merge, ordering, sentinel errors) cannot drift apart silently — the parity the evidence-persistence spec pins. |
|
pkg/services/vcresolver/memstore
Package memstore is the in-memory PoC implementation of the vcresolver variant backend and unresolved pool.
|
Package memstore is the in-memory PoC implementation of the vcresolver variant backend and unresolved pool. |
|
pkg/wireautherr
Package wireautherr is the single wireauth-sentinel → Connect status code classifier for every network handler that carries a wireauth.Proof.
|
Package wireautherr is the single wireauth-sentinel → Connect status code classifier for every network handler that carries a wireauth.Proof. |
|
Package orgverify verifies that a did:dplaax Owner DID's orgId (FQDN) is endorsed by the actual domain owner via a DNS TXT record at _dplaax-org.<orgId>.
|
Package orgverify verifies that a did:dplaax Owner DID's orgId (FQDN) is endorsed by the actual domain owner via a DNS TXT record at _dplaax-org.<orgId>. |
|
pipeline
|
|
|
chained
Package chained implements the Chained Process event processor.
|
Package chained implements the Chained Process event processor. |
|
chained/converter
Package converter defines the Converter interface and subset output validation for the ConvertFlow pipeline step.
|
Package converter defines the Converter interface and subset output validation for the ConvertFlow pipeline step. |
|
chained/converter/jsonata
Package jsonata implements converter.Converter using JSONata expressions (github.com/blues/jsonata-go).
|
Package jsonata implements converter.Converter using JSONata expressions (github.com/blues/jsonata-go). |
|
chained/filter
Package filter defines the FilterFlow step contract: stateless conditional pass/drop over a single event payload.
|
Package filter defines the FilterFlow step contract: stateless conditional pass/drop over a single event payload. |
|
chained/filter/jsonata
Package jsonata implements filter.Filter using JSONata expressions (github.com/blues/jsonata-go).
|
Package jsonata implements filter.Filter using JSONata expressions (github.com/blues/jsonata-go). |
|
contract
Package contract defines the Pipeline Contract — the public contract every Pipeline Process conforms to on at least one I/O side.
|
Package contract defines the Pipeline Contract — the public contract every Pipeline Process conforms to on at least one I/O side. |
|
observer/logobserver
Package logobserver is a reference contract.ProcessObserver that emits each processed event as one structured slog record.
|
Package logobserver is a reference contract.ProcessObserver that emits each processed event as one structured slog record. |
|
provenance
Package provenance defines the process-facing interfaces over the VC machinery in vc — shared signing/verification mechanics carrying no process semantics.
|
Package provenance defines the process-facing interfaces over the VC machinery in vc — shared signing/verification mechanics carrying no process semantics. |
|
provenance/vcdid
Package vcdid is the DID/VC-backed implementation of the provenance signing capabilities: it adapts vc.Builder (Ed25519 Data Integrity signing behind a crypto.Signer) to the process-facing provenance.SourceSigner and provenance.ChainedSigner interfaces.
|
Package vcdid is the DID/VC-backed implementation of the provenance signing capabilities: it adapts vc.Builder (Ed25519 Data Integrity signing behind a crypto.Signer) to the process-facing provenance.SourceSigner and provenance.ChainedSigner interfaces. |
|
provenance/verifycount
Package verifycount is a counting decorator over provenance.Verifier: it delegates every Verify call unchanged and counts the call's OUTCOME — the verifier API result, NOT the consumer's effective verdict (a chained/sink runtime maps a non-context Verify error to an indeterminate rejection, an aggregate drops the input; this package deliberately measures the seam below those policies).
|
Package verifycount is a counting decorator over provenance.Verifier: it delegates every Verify call unchanged and counts the call's OUTCOME — the verifier API result, NOT the consumer's effective verdict (a chained/sink runtime maps a non-context Verify error to an indeterminate rejection, an aggregate drops the input; this package deliberately measures the seam below those policies). |
|
sink
Package sink implements the Sink Process runtime: it consumes a pipeline-conformant envelope, verifies the credential (or chain), writes the payload to an external system, and produces nothing in-network.
|
Package sink implements the Sink Process runtime: it consumes a pipeline-conformant envelope, verifies the credential (or chain), writes the payload to an external system, and produces nothing in-network. |
|
sink/console
Package console implements sink.Writer as an NDJSON emitter — the observation-only reference sink.
|
Package console implements sink.Writer as an NDJSON emitter — the observation-only reference sink. |
|
sink/file
Package file implements sink.Writer as a durable NDJSON append stream — the second reference sink surface.
|
Package file implements sink.Writer as a durable NDJSON append stream — the second reference sink surface. |
|
source/aggregate
Package aggregate implements the aggregate Source Process runtime: a stateful pool + window mechanic that consumes N Pipeline-conformant ingress inputs and, on a timer/window trigger, folds them into a single FirstDrop carrying a multi-source vc.SourceCommitment (transformationClaim provin:aggregate).
|
Package aggregate implements the aggregate Source Process runtime: a stateful pool + window mechanic that consumes N Pipeline-conformant ingress inputs and, on a timer/window trigger, folds them into a single FirstDrop carrying a multi-source vc.SourceCommitment (transformationClaim provin:aggregate). |
|
source/ingest
Package ingest implements the Source Process event processor for external ingestion (N=0): raw external bytes become a FirstDrop credential — a fresh chain origin.
|
Package ingest implements the Source Process event processor for external ingestion (N=0): raw external bytes become a FirstDrop credential — a fresh chain origin. |
|
source/ingest/apipush
Package apipush is the reference HTTP push adapter for external ingestion (pipeline/source/ingest/README.md): POST push accepts a JSON payload and publishes the bytes verbatim to a Source Process's input queue; GET health reports the underlying transport's liveness.
|
Package apipush is the reference HTTP push adapter for external ingestion (pipeline/source/ingest/README.md): POST push accepts a JSON payload and publishes the bytes verbatim to a Source Process's input queue; GET health reports the underlying transport's liveness. |
|
transport
Package transport defines the pub-sub boundary between Pipeline Processes.
|
Package transport defines the pub-sub boundary between Pipeline Processes. |
|
transport/envelopecodec
Package envelopecodec is the wire codec for pipeline envelopes — the reference implementation of contract.EnvelopeCodec over the dplaax.pipeline.v1 wire form.
|
Package envelopecodec is the wire codec for pipeline envelopes — the reference implementation of contract.EnvelopeCodec over the dplaax.pipeline.v1 wire form. |
|
transport/nats
Package nats is the production NATS backend for the pipeline transport boundary: it implements transport.Publisher and transport.Subscriber over the nats.go client.
|
Package nats is the production NATS backend for the pipeline transport boundary: it implements transport.Publisher and transport.Subscriber over the nats.go client. |
|
transport/tlogship
Package tlogship is the background mirror shipper (tlog custody spec D-T6): it replicates checkpoint-aligned segments of ONE local tlog.Log to a registry's TlogService mirror surface (dplaax.tlog.v1 MirrorLogSegment/GetMirrorState), asynchronously and on a timer, so that custody of the producing loop's durable log survives the pipeline process's own lifetime.
|
Package tlogship is the background mirror shipper (tlog custody spec D-T6): it replicates checkpoint-aligned segments of ONE local tlog.Log to a registry's TlogService mirror surface (dplaax.tlog.v1 MirrorLogSegment/GetMirrorState), asynchronously and on a timer, so that custody of the producing loop's durable log survives the pipeline process's own lifetime. |
|
Package resolver defines DID Document resolution.
|
Package resolver defines DID Document resolution. |
|
cache
Package cache bounds the cost of repeated DID document resolution: a decorator over any resolver.Resolver that serves recently resolved documents from memory instead of re-resolving them.
|
Package cache bounds the cost of repeated DID document resolution: a decorator over any resolver.Resolver that serves recently resolved documents from memory instead of re-resolving them. |
|
local
Package local is the in-memory resolver.Resolver for tests and fixtures: a DID → DID Document map.
|
Package local is the in-memory resolver.Resolver for tests and fixtures: a DID → DID Document map. |
|
Package schema defines payload validation against registered schemas — the client-side contract of the schema registry.
|
Package schema defines payload validation against registered schemas — the client-side contract of the schema registry. |
|
internal/schemadoc
Package schemadoc is the single JSON Schema document policy shared by the schema-registry admission check (schema.ValidateJSONSchema) and the in-memory validator implementation (schema/local): strict-decode the document (the only JSON decode path permitted on protocol boundaries — duplicate keywords, trailing data and invalid Unicode are rejected), pin the dialect to Draft 2020-12 (the library's default tracks "latest supported" and shifts), and deny external $ref so a schema is self-contained as a structural guarantee.
|
Package schemadoc is the single JSON Schema document policy shared by the schema-registry admission check (schema.ValidateJSONSchema) and the in-memory validator implementation (schema/local): strict-decode the document (the only JSON decode path permitted on protocol boundaries — duplicate keywords, trailing data and invalid Unicode are rejected), pin the dialect to Draft 2020-12 (the library's default tracks "latest supported" and shifts), and deny external $ref so a schema is self-contained as a structural guarantee. |
|
local
Package local is the in-memory schema.Validator for the PoC and in-org deployments: a SchemaRef.ID → registered JSON Schema map, the validation counterpart of resolver/local.
|
Package local is the in-memory schema.Validator for the PoC and in-org deployments: a SchemaRef.ID → registered JSON Schema map, the validation counterpart of resolver/local. |
|
Package tlog defines the per-organization transparency log contract: append-only, tamper-evident, independently verifiable record sequences.
|
Package tlog defines the per-organization transparency log contract: append-only, tamper-evident, independently verifiable record sequences. |
|
filelog
Package filelog is the durable PoC implementation of tlog.Log: an append-only, hash-chained NDJSON file, replay-verified at open.
|
Package filelog is the durable PoC implementation of tlog.Log: an append-only, hash-chained NDJSON file, replay-verified at open. |
|
internal/logcontract
Package logcontract is the shared behavioral suite for tlog.Log implementations, split by what a family shares:
|
Package logcontract is the shared behavioral suite for tlog.Log implementations, split by what a family shares: |
|
internal/rfc6962
Package rfc6962 is the pinned Merkle tree-hashing scheme for tree logs: RFC 6962 over SHA-256 (leaf prefix 0x00, interior prefix 0x01, MTH with odd-subtree promotion, empty root = SHA-256("")), plus the proof generation (RFC 6962 §2.1.1/§2.1.2) and verification (RFC 9162 §2.1.3.2/§2.1.4.2) algorithms.
|
Package rfc6962 is the pinned Merkle tree-hashing scheme for tree logs: RFC 6962 over SHA-256 (leaf prefix 0x00, interior prefix 0x01, MTH with odd-subtree promotion, empty root = SHA-256("")), plus the proof generation (RFC 6962 §2.1.1/§2.1.2) and verification (RFC 9162 §2.1.3.2/§2.1.4.2) algorithms. |
|
memlog
Package memlog is a minimal in-memory tlog.Log: an append-only, hash-chained, tamper-evident record sequence held in memory.
|
Package memlog is a minimal in-memory tlog.Log: an append-only, hash-chained, tamper-evident record sequence held in memory. |
|
merklelog
Package merklelog is the proof-capable tlog.Log: an RFC 6962 Merkle tree (SHA-256; the scheme pinned in tlog/internal/rfc6962) over a durable append-only NDJSON leaf journal.
|
Package merklelog is the proof-capable tlog.Log: an RFC 6962 Merkle tree (SHA-256; the scheme pinned in tlog/internal/rfc6962) over a durable append-only NDJSON leaf journal. |
|
Package vc implements W3C Verifiable Credentials with Data Integrity proofs: the credential model, proof creation/verification, cryptosuite dispatch, and trust evaluation for PipelinePassCredential — the VC issued at every pipeline process boundary.
|
Package vc implements W3C Verifiable Credentials with Data Integrity proofs: the credential model, proof creation/verification, cryptosuite dispatch, and trust evaluation for PipelinePassCredential — the VC issued at every pipeline process boundary. |
|
chainwalk
Package chainwalk implements provenance.ChainVerifier by walking a credential chain from its head: it resolves each previousCredential by content address, assembles the chain origin-first, and delegates the per-credential and chain-structure verification to an injected core (vc.Verifier.VerifyChain semantics).
|
Package chainwalk implements provenance.ChainVerifier by walking a credential chain from its head: it resolves each previousCredential by content address, assembles the chain origin-first, and delegates the per-credential and chain-structure verification to an injected core (vc.Verifier.VerifyChain semantics). |
|
Package wireprofile pins wire-level conventions shared across deployment roots.
|
Package wireprofile pins wire-level conventions shared across deployment roots. |
Click to show internal directories.
Click to hide internal directories.