Documentation / @u-net/issuer
@u-net/issuer
Node-only provider SDK for direct credential requests, encrypted delivery, renewal, replacement, and provider-signed Ledger V2 operations.
npm install @u-net/issuer@nextimport { createDirectIssuerService, PostgresDirectIssuerRequestStore } from '@u-net/issuer';See docs.egress.live for guides and the versioned API reference.
Staged Core Recovery API
Recovery schema initialization, pooled and transaction-bound stores, gateway reconciliation and their types are exported for coordinated SDK 2 RC provider integration only, not approved stable. Providers must consume a built candidate package, not private source imports; existing installed packages are unchanged. This does not publish, deploy or introduce experimental standards exports. The caller of TransactionalIssuanceRecoveryStore owns the pinned transaction, policy/account locks, atomic publication, rollback and release. See the recovery API contract.
Domain-Admin Callback Security
Domain-admin issuance callbacks require protocol version 2, signed V2 control authorization and a durable, atomic consumeControlNonce callback. Protocol v1 and HMAC callback authorization are rejected; existing helper exports remain. The credential schema ID unet.provider.domain-admin.v1 is unchanged and must not be rewritten to match the callback protocol number.
Providers installed on 2.0.0-rc.2 need a released SDK upgrade containing this fix; editing SDK source alone does not update installed dependencies. Maintained provider route guards provide separate protection against legacy callbacks. See the behavior and migration note for required nonce-store semantics, test commands and coverage boundaries.
Classes
- InMemoryDirectIssuerRequestStore
- PostgresDirectIssuerRequestStore
- PostgresIssuanceRecoveryStore
- TransactionalIssuanceRecoveryStore
- TransactionalIssuerOperationLane
Interfaces
- AttestationCredentialPolicy
- CredentialClaimProofV2
- CredentialClaimV2
- CredentialEnvelopeV2
- CredentialValidityWindow
- DirectIssuerRenewalInput
- DirectIssuerRequestInput
- DirectIssuerRequestRecord
- DirectIssuerRequestStore
- DirectIssuerServiceOptions
- DirectIssuerWebAdapterOptions
- DomainAdminCallbackRequest
- DomainAdminControlAuthorizationPayload
- DomainAdminCredentialIssueResult
- EncryptedCredentialEnvelopeV2
- HolderRelinquishmentCallbackRequest
- IssuanceRecoverySqlPool
- IssuerActionEnvelope
- IssuerLaneAttempt
- IssuerLaneEvidenceOptions
- IssuerLaneIntent
- IssuerLaneRecord
- IssuerLaneTargetEvidence
- IssuerMiniappManifestInput
- IssuerSigner
- LedgerV2AnchorOperation
- LedgerV2Domain
- LedgerV2IssuerRetireOperation
- LedgerV2IssuerRevokeOperation
- LedgerV2IssuerRotateOperation
- LedgerV2Signer
- ProviderIssuerLaneTableConfig
- RecoveryAnchorReconciliationOptions
- RecoveryInput
- RecoveryPreparation
- RecoveryReceipt
- RecoveryRecord
- RecoverySubmission
- SignedDomainAdminCredentialResponse
- SqlClient
Type Aliases
- CredentialRenewalMode
- CredentialReplacementMode
- CredentialValidityMode
- DirectIssuerRequestState
- DirectIssuerService
- DomainAdminRole
- IssuerAction
- IssuerLaneExpiryEvidence
- IssuerLaneExpiryResult
- IssuerLaneTargetResult
- RecoveryAction
- RecoveryAnchorReconciliationResult
- RecoveryFailure
- RecoveryPhase
Variables
Functions
- anchorLedgerV2CredentialFromEnv
- buildFieldMerkleProofV2
- checkIssuerLaneExpiry
- checkIssuerLaneTarget
- createCredentialEnvelopeV2
- createDirectIssuerService
- createDirectIssuerWebHandlers
- createDomainAdminCallbackHandlerV2
- createDomainAdminControlAuthorizationV2
- createDomainAdminSignerFromEnv
- createHolderRelinquishmentCallbackHandler
- createIssuerMiniappManifest
- createIssuerSignerFromEnv
- createLedgerV2SignerFromEnv
- deriveClaimLeafV2
- deriveCredentialPublicKeyHash
- deriveHolderBindingV2
- deriveNullifierV2
- derivePredicateV2
- encryptCredentialEnvelopeV2
- ensureDirectIssuerSchema
- ensureIssuanceRecoverySchema
- ensureIssuerOperationLaneSchema
- fetchUnetControlPublicKeys
- generateAttestationIssuerEnv
- generateCredentialSigningKeyPair
- generateDomainAdminSignerEnv
- generateIssuerKeyPair
- generateIssuerKeyPairEnv
- generateLedgerV2Signer
- generateLedgerV2SignerEnv
- ledgerV2IssuerIdHash
- ledgerV2ReasonHash
- ledgerV2RequestHash
- prepareIssuerLaneExpiryRequest
- prepareIssuerLaneTargetRequest
- reconcileRecoveryAnchor
- resolveCredentialValidity
- revokeLedgerV2CredentialFromEnv
- signDomainAdminCredentialResponse
- signLedgerV2Anchor
- signLedgerV2IssuerRetire
- signLedgerV2IssuerRevoke
- signLedgerV2IssuerRotate
- submitLedgerV2Operation
- validateDomainAdminCallbackRequest
- validateIssuerLaneExpiryEvidence
- validateIssuerLaneTargetEvidence
- verifyDomainAdminControlAuthorizationV2