@veridid/signing 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +39 -2
- package/build/SigningApi.d.mts +368 -0
- package/build/SigningApi.d.mts.map +1 -0
- package/build/SigningApi.mjs +516 -0
- package/build/SigningApi.mjs.map +1 -0
- package/build/SigningEvents.d.mts +71 -0
- package/build/SigningEvents.d.mts.map +1 -0
- package/build/SigningEvents.mjs +16 -0
- package/build/SigningEvents.mjs.map +1 -0
- package/build/SigningModule.d.mts +42 -0
- package/build/SigningModule.d.mts.map +1 -0
- package/build/SigningModule.mjs +91 -0
- package/build/SigningModule.mjs.map +1 -0
- package/build/SigningRole.d.mts +25 -0
- package/build/SigningRole.d.mts.map +1 -0
- package/build/SigningRole.mjs +27 -0
- package/build/SigningRole.mjs.map +1 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorate.mjs +10 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateMetadata.mjs +7 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateParam.mjs +9 -0
- package/build/compat.d.mts +24 -0
- package/build/compat.d.mts.map +1 -0
- package/build/compat.mjs +26 -0
- package/build/compat.mjs.map +1 -0
- package/build/delivery/ArtifactDeliveryStrategy.d.mts +74 -0
- package/build/delivery/ArtifactDeliveryStrategy.d.mts.map +1 -0
- package/build/delivery/InlineBase64Strategy.d.mts +50 -0
- package/build/delivery/InlineBase64Strategy.d.mts.map +1 -0
- package/build/delivery/InlineBase64Strategy.mjs +80 -0
- package/build/delivery/InlineBase64Strategy.mjs.map +1 -0
- package/build/delivery/index.mjs +1 -0
- package/build/errors/ArtifactTooLargeError.d.mts +12 -0
- package/build/errors/ArtifactTooLargeError.d.mts.map +1 -0
- package/build/errors/ArtifactTooLargeError.mjs +15 -0
- package/build/errors/ArtifactTooLargeError.mjs.map +1 -0
- package/build/errors/DigestMismatchError.d.mts +12 -0
- package/build/errors/DigestMismatchError.d.mts.map +1 -0
- package/build/errors/DigestMismatchError.mjs +15 -0
- package/build/errors/DigestMismatchError.mjs.map +1 -0
- package/build/errors/IdempotencyConflictError.d.mts +12 -0
- package/build/errors/IdempotencyConflictError.d.mts.map +1 -0
- package/build/errors/IdempotencyConflictError.mjs +15 -0
- package/build/errors/IdempotencyConflictError.mjs.map +1 -0
- package/build/errors/InvalidStateError.d.mts +14 -0
- package/build/errors/InvalidStateError.d.mts.map +1 -0
- package/build/errors/InvalidStateError.mjs +16 -0
- package/build/errors/InvalidStateError.mjs.map +1 -0
- package/build/errors/PolicyEnforcementError.d.mts +12 -0
- package/build/errors/PolicyEnforcementError.d.mts.map +1 -0
- package/build/errors/PolicyEnforcementError.mjs +15 -0
- package/build/errors/PolicyEnforcementError.mjs.map +1 -0
- package/build/errors/SigningError.d.mts +16 -0
- package/build/errors/SigningError.d.mts.map +1 -0
- package/build/errors/SigningError.mjs +16 -0
- package/build/errors/SigningError.mjs.map +1 -0
- package/build/errors/ThresholdNotMetError.d.mts +12 -0
- package/build/errors/ThresholdNotMetError.d.mts.map +1 -0
- package/build/errors/ThresholdNotMetError.mjs +15 -0
- package/build/errors/ThresholdNotMetError.mjs.map +1 -0
- package/build/errors/UnsupportedCanonicalizerError.d.mts +12 -0
- package/build/errors/UnsupportedCanonicalizerError.d.mts.map +1 -0
- package/build/errors/UnsupportedCanonicalizerError.mjs +16 -0
- package/build/errors/UnsupportedCanonicalizerError.mjs.map +1 -0
- package/build/errors/UnsupportedSuiteError.d.mts +12 -0
- package/build/errors/UnsupportedSuiteError.d.mts.map +1 -0
- package/build/errors/UnsupportedSuiteError.mjs +16 -0
- package/build/errors/UnsupportedSuiteError.mjs.map +1 -0
- package/build/errors/index.d.mts +9 -0
- package/build/errors/index.mjs +9 -0
- package/build/handlers/CombineMessageHandler.d.mts +22 -0
- package/build/handlers/CombineMessageHandler.d.mts.map +1 -0
- package/build/handlers/CombineMessageHandler.mjs +25 -0
- package/build/handlers/CombineMessageHandler.mjs.map +1 -0
- package/build/handlers/ConsentMessageHandler.d.mts +19 -0
- package/build/handlers/ConsentMessageHandler.d.mts.map +1 -0
- package/build/handlers/ConsentMessageHandler.mjs +21 -0
- package/build/handlers/ConsentMessageHandler.mjs.map +1 -0
- package/build/handlers/DeclineMessageHandler.d.mts +19 -0
- package/build/handlers/DeclineMessageHandler.d.mts.map +1 -0
- package/build/handlers/DeclineMessageHandler.mjs +21 -0
- package/build/handlers/DeclineMessageHandler.mjs.map +1 -0
- package/build/handlers/PartialSignatureMessageHandler.d.mts +19 -0
- package/build/handlers/PartialSignatureMessageHandler.d.mts.map +1 -0
- package/build/handlers/PartialSignatureMessageHandler.mjs +21 -0
- package/build/handlers/PartialSignatureMessageHandler.mjs.map +1 -0
- package/build/handlers/ProposeSigningMessageHandler.d.mts +19 -0
- package/build/handlers/ProposeSigningMessageHandler.d.mts.map +1 -0
- package/build/handlers/ProposeSigningMessageHandler.mjs +21 -0
- package/build/handlers/ProposeSigningMessageHandler.mjs.map +1 -0
- package/build/handlers/ProvideArtifactsMessageHandler.d.mts +19 -0
- package/build/handlers/ProvideArtifactsMessageHandler.d.mts.map +1 -0
- package/build/handlers/ProvideArtifactsMessageHandler.mjs +21 -0
- package/build/handlers/ProvideArtifactsMessageHandler.mjs.map +1 -0
- package/build/handlers/RequestSigningMessageHandler.d.mts +19 -0
- package/build/handlers/RequestSigningMessageHandler.d.mts.map +1 -0
- package/build/handlers/RequestSigningMessageHandler.mjs +21 -0
- package/build/handlers/RequestSigningMessageHandler.mjs.map +1 -0
- package/build/handlers/SigningAckMessageHandler.d.mts +22 -0
- package/build/handlers/SigningAckMessageHandler.d.mts.map +1 -0
- package/build/handlers/SigningAckMessageHandler.mjs +25 -0
- package/build/handlers/SigningAckMessageHandler.mjs.map +1 -0
- package/build/handlers/SigningProblemReportMessageHandler.d.mts +19 -0
- package/build/handlers/SigningProblemReportMessageHandler.d.mts.map +1 -0
- package/build/handlers/SigningProblemReportMessageHandler.mjs +21 -0
- package/build/handlers/SigningProblemReportMessageHandler.mjs.map +1 -0
- package/build/handlers/index.d.mts +9 -0
- package/build/handlers/index.mjs +9 -0
- package/build/index.d.mts +75 -0
- package/build/index.mjs +63 -0
- package/build/messages/CombineMessage.d.mts +32 -0
- package/build/messages/CombineMessage.d.mts.map +1 -0
- package/build/messages/CombineMessage.mjs +47 -0
- package/build/messages/CombineMessage.mjs.map +1 -0
- package/build/messages/ConsentMessage.d.mts +32 -0
- package/build/messages/ConsentMessage.d.mts.map +1 -0
- package/build/messages/ConsentMessage.mjs +46 -0
- package/build/messages/ConsentMessage.mjs.map +1 -0
- package/build/messages/DeclineMessage.d.mts +26 -0
- package/build/messages/DeclineMessage.d.mts.map +1 -0
- package/build/messages/DeclineMessage.mjs +47 -0
- package/build/messages/DeclineMessage.mjs.map +1 -0
- package/build/messages/PartialSignatureMessage.d.mts +36 -0
- package/build/messages/PartialSignatureMessage.d.mts.map +1 -0
- package/build/messages/PartialSignatureMessage.mjs +72 -0
- package/build/messages/PartialSignatureMessage.mjs.map +1 -0
- package/build/messages/ProposeSigningMessage.d.mts +27 -0
- package/build/messages/ProposeSigningMessage.d.mts.map +1 -0
- package/build/messages/ProposeSigningMessage.mjs +41 -0
- package/build/messages/ProposeSigningMessage.mjs.map +1 -0
- package/build/messages/ProvideArtifactsMessage.d.mts +62 -0
- package/build/messages/ProvideArtifactsMessage.d.mts.map +1 -0
- package/build/messages/ProvideArtifactsMessage.mjs +40 -0
- package/build/messages/ProvideArtifactsMessage.mjs.map +1 -0
- package/build/messages/RequestSigningMessage.d.mts +38 -0
- package/build/messages/RequestSigningMessage.d.mts.map +1 -0
- package/build/messages/RequestSigningMessage.mjs +62 -0
- package/build/messages/RequestSigningMessage.mjs.map +1 -0
- package/build/messages/SigningAckMessage.d.mts +26 -0
- package/build/messages/SigningAckMessage.d.mts.map +1 -0
- package/build/messages/SigningAckMessage.mjs +46 -0
- package/build/messages/SigningAckMessage.mjs.map +1 -0
- package/build/messages/SigningProblemReportMessage.d.mts +44 -0
- package/build/messages/SigningProblemReportMessage.d.mts.map +1 -0
- package/build/messages/SigningProblemReportMessage.mjs +65 -0
- package/build/messages/SigningProblemReportMessage.mjs.map +1 -0
- package/build/messages/index.d.mts +9 -0
- package/build/messages/index.mjs +9 -0
- package/build/models/AggregationResult.d.mts +85 -0
- package/build/models/AggregationResult.d.mts.map +1 -0
- package/build/models/ArtifactMetadata.d.mts +37 -0
- package/build/models/ArtifactMetadata.d.mts.map +1 -0
- package/build/models/AuthzArtifact.d.mts +178 -0
- package/build/models/AuthzArtifact.d.mts.map +1 -0
- package/build/models/Capabilities.d.mts +109 -0
- package/build/models/Capabilities.d.mts.map +1 -0
- package/build/models/JoinToken.d.mts +344 -0
- package/build/models/JoinToken.d.mts.map +1 -0
- package/build/models/JoinToken.mjs +14 -0
- package/build/models/JoinToken.mjs.map +1 -0
- package/build/models/PartialSignature.d.mts +82 -0
- package/build/models/PartialSignature.d.mts.map +1 -0
- package/build/models/PolicyContext.d.mts +55 -0
- package/build/models/PolicyContext.d.mts.map +1 -0
- package/build/models/RouterAttestation.d.mts +186 -0
- package/build/models/RouterAttestation.d.mts.map +1 -0
- package/build/models/Session.d.mts +62 -0
- package/build/models/Session.d.mts.map +1 -0
- package/build/models/Session.mjs +19 -0
- package/build/models/Session.mjs.map +1 -0
- package/build/models/SignableObject.d.mts +71 -0
- package/build/models/SignableObject.d.mts.map +1 -0
- package/build/models/SigningState.d.mts +21 -0
- package/build/models/SigningState.d.mts.map +1 -0
- package/build/models/SigningState.mjs +23 -0
- package/build/models/SigningState.mjs.map +1 -0
- package/build/models/Suite.d.mts +59 -0
- package/build/models/Suite.d.mts.map +1 -0
- package/build/models/index.d.mts +12 -0
- package/build/pdf/PdfUtils.d.mts +160 -0
- package/build/pdf/PdfUtils.d.mts.map +1 -0
- package/build/pdf/PdfUtils.mjs +283 -0
- package/build/pdf/PdfUtils.mjs.map +1 -0
- package/build/pdf/index.mjs +1 -0
- package/build/registry/aggregators/Aggregator.d.mts +85 -0
- package/build/registry/aggregators/Aggregator.d.mts.map +1 -0
- package/build/registry/aggregators/AggregatorRegistry.d.mts +55 -0
- package/build/registry/aggregators/AggregatorRegistry.d.mts.map +1 -0
- package/build/registry/aggregators/AggregatorRegistry.mjs +76 -0
- package/build/registry/aggregators/AggregatorRegistry.mjs.map +1 -0
- package/build/registry/aggregators/BundleNoneAggregator.d.mts +43 -0
- package/build/registry/aggregators/BundleNoneAggregator.d.mts.map +1 -0
- package/build/registry/aggregators/BundleNoneAggregator.mjs +65 -0
- package/build/registry/aggregators/BundleNoneAggregator.mjs.map +1 -0
- package/build/registry/aggregators/index.d.mts +3 -0
- package/build/registry/aggregators/index.mjs +2 -0
- package/build/registry/canonicalizers/Canonicalizer.d.mts +67 -0
- package/build/registry/canonicalizers/Canonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts +55 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts.map +1 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.mjs +78 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.mjs.map +1 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts +126 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs +143 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs.map +1 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts +34 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs +55 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs.map +1 -0
- package/build/registry/canonicalizers/index.d.mts +4 -0
- package/build/registry/canonicalizers/index.mjs +3 -0
- package/build/registry/index.d.mts +18 -0
- package/build/registry/index.mjs +14 -0
- package/build/registry/policies/Policy.d.mts +62 -0
- package/build/registry/policies/Policy.d.mts.map +1 -0
- package/build/registry/policies/PolicyRegistry.d.mts +54 -0
- package/build/registry/policies/PolicyRegistry.d.mts.map +1 -0
- package/build/registry/policies/PolicyRegistry.mjs +73 -0
- package/build/registry/policies/PolicyRegistry.mjs.map +1 -0
- package/build/registry/policies/TimeWindowPolicy.d.mts +85 -0
- package/build/registry/policies/TimeWindowPolicy.d.mts.map +1 -0
- package/build/registry/policies/TimeWindowPolicy.mjs +111 -0
- package/build/registry/policies/TimeWindowPolicy.mjs.map +1 -0
- package/build/registry/policies/index.d.mts +3 -0
- package/build/registry/policies/index.mjs +2 -0
- package/build/registry/suites/JwsEd25519Suite.d.mts +47 -0
- package/build/registry/suites/JwsEd25519Suite.d.mts.map +1 -0
- package/build/registry/suites/JwsEd25519Suite.mjs +101 -0
- package/build/registry/suites/JwsEd25519Suite.mjs.map +1 -0
- package/build/registry/suites/PadesBLtaSuite.d.mts +106 -0
- package/build/registry/suites/PadesBLtaSuite.d.mts.map +1 -0
- package/build/registry/suites/PadesBLtaSuite.mjs +122 -0
- package/build/registry/suites/PadesBLtaSuite.mjs.map +1 -0
- package/build/registry/suites/SignatureSuite.d.mts +128 -0
- package/build/registry/suites/SignatureSuite.d.mts.map +1 -0
- package/build/registry/suites/SignatureSuiteRegistry.d.mts +62 -0
- package/build/registry/suites/SignatureSuiteRegistry.d.mts.map +1 -0
- package/build/registry/suites/SignatureSuiteRegistry.mjs +87 -0
- package/build/registry/suites/SignatureSuiteRegistry.mjs.map +1 -0
- package/build/registry/suites/index.d.mts +4 -0
- package/build/registry/suites/index.mjs +3 -0
- package/build/repository/CounterRecord.d.mts +84 -0
- package/build/repository/CounterRecord.d.mts.map +1 -0
- package/build/repository/CounterRecord.mjs +82 -0
- package/build/repository/CounterRecord.mjs.map +1 -0
- package/build/repository/CounterRepository.d.mts +22 -0
- package/build/repository/CounterRepository.d.mts.map +1 -0
- package/build/repository/CounterRepository.mjs +51 -0
- package/build/repository/CounterRepository.mjs.map +1 -0
- package/build/repository/SigningSessionRecord.d.mts +102 -0
- package/build/repository/SigningSessionRecord.d.mts.map +1 -0
- package/build/repository/SigningSessionRecord.mjs +96 -0
- package/build/repository/SigningSessionRecord.mjs.map +1 -0
- package/build/repository/SigningSessionRepository.d.mts +30 -0
- package/build/repository/SigningSessionRepository.d.mts.map +1 -0
- package/build/repository/SigningSessionRepository.mjs +52 -0
- package/build/repository/SigningSessionRepository.mjs.map +1 -0
- package/build/repository/index.d.mts +4 -0
- package/build/repository/index.mjs +4 -0
- package/build/services/CounterService.d.mts +121 -0
- package/build/services/CounterService.d.mts.map +1 -0
- package/build/services/CounterService.mjs +176 -0
- package/build/services/CounterService.mjs.map +1 -0
- package/build/services/HPKEService.d.mts +174 -0
- package/build/services/HPKEService.d.mts.map +1 -0
- package/build/services/HPKEService.mjs +195 -0
- package/build/services/HPKEService.mjs.map +1 -0
- package/build/services/SigningService.d.mts +387 -0
- package/build/services/SigningService.d.mts.map +1 -0
- package/build/services/SigningService.mjs +1104 -0
- package/build/services/SigningService.mjs.map +1 -0
- package/build/services/index.d.mts +3 -0
- package/build/services/index.mjs +3 -0
- package/package.json +44 -3
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HPKEService.mjs","names":[],"sources":["../../src/services/HPKEService.ts"],"sourcesContent":["/**\n * HPKE Service - Hybrid Public Key Encryption\n *\n * Implements RFC 9180 HPKE for sealed secret delivery in join tokens.\n *\n * Spec Requirements (Lines 759-799):\n * - KEM: DHKEM-X25519-HKDF-SHA256 (MUST)\n * - KDF: HKDF-SHA256 (MUST)\n * - AEAD: AES-256-GCM or ChaCha20-Poly1305 (MUST support ≥1)\n * - AAD: MUST include ticket_digest to bind envelope to token\n *\n * Security Properties:\n * - Confidentiality: Payload encrypted with ephemeral key\n * - Authenticity: AAD binds envelope to specific token\n * - Forward secrecy: Ephemeral keys used for each encryption\n * - Device binding: Sealed to specific recipient public key\n */\n\nimport { injectable } from '@credo-ts/core'\nimport { CipherSuite, Aes256Gcm, HkdfSha256, DhkemP256HkdfSha256 } from '@hpke/core'\nimport { sha256 } from '@noble/hashes/sha256'\n\n/**\n * HPKE encryption result\n */\nexport interface HPKEEncryptResult {\n /**\n * Encrypted payload (ciphertext)\n */\n ciphertext: Uint8Array\n\n /**\n * Ephemeral public key (encapsulated key)\n */\n ephemeralPublicKey: Uint8Array\n\n /**\n * Encryption metadata\n */\n metadata: {\n kem: string\n kdf: string\n aead: string\n }\n}\n\n/**\n * HPKE decryption result\n */\nexport interface HPKEDecryptResult {\n /**\n * Decrypted payload (plaintext)\n */\n plaintext: Uint8Array\n}\n\n@injectable()\nexport class HPKEService {\n /**\n * Get CipherSuite for HPKE operations\n *\n * Uses the default configuration per spec:\n * - KEM: DHKEM(P-256, HKDF-SHA256) (using P-256 as X25519 requires extension)\n * - KDF: HKDF-SHA256\n * - AEAD: AES-256-GCM\n */\n private getCipherSuite(): CipherSuite {\n return new CipherSuite({\n kem: new DhkemP256HkdfSha256(),\n kdf: new HkdfSha256(),\n aead: new Aes256Gcm(),\n })\n }\n\n /**\n * Get algorithm names for metadata\n */\n private getAlgorithmNames(): {\n kem: string\n kdf: string\n aead: string\n } {\n return {\n kem: 'DHKEM-P256-HKDF-SHA256',\n kdf: 'HKDF-SHA256',\n aead: 'AES-256-GCM',\n }\n }\n\n /**\n * Compute ticket digest for AAD binding\n *\n * Per spec: AAD MUST include sha-256(serialize(token))\n *\n * @param ticketBytes - Serialized ticket bytes\n * @returns Base64-encoded SHA-256 digest\n */\n public computeTicketDigest(ticketBytes: Uint8Array): string {\n const hash = sha256(ticketBytes)\n return Buffer.from(hash).toString('base64')\n }\n\n /**\n * Serialize AAD for HPKE encryption\n *\n * Creates the Additional Authenticated Data that cryptographically\n * binds the envelope to the specific token.\n *\n * @param aad - AAD object with ticket_digest\n * @returns Serialized AAD bytes\n */\n private serializeAAD(aad: { ticket_digest: string; session_id?: string; device?: string }): Uint8Array {\n // Serialize as JSON for simplicity\n const aadString = JSON.stringify(aad)\n return new TextEncoder().encode(aadString)\n }\n\n /**\n * Encrypt payload with HPKE\n *\n * Uses HPKE Base mode to seal a payload to a recipient's public key.\n * The AAD cryptographically binds the envelope to the token digest.\n *\n * @param recipientPublicKey - Recipient's public key (raw bytes)\n * @param plaintext - Payload to encrypt\n * @param aad - Additional Authenticated Data (includes ticket_digest)\n * @param config - Optional HPKE configuration\n * @returns Encryption result with ciphertext and ephemeral key\n *\n * @example\n * ```typescript\n * const result = await hpkeService.encrypt(\n * alicePublicKey,\n * Buffer.from('secret payload'),\n * {\n * ticket_digest: 'sha-256:abc123...',\n * session_id: 'sess_xyz',\n * device: 'did:ex:alice#device1'\n * }\n * )\n * ```\n */\n public async encrypt(\n recipientPublicKey: Uint8Array,\n plaintext: Uint8Array,\n aad: { ticket_digest: string; session_id?: string; device?: string }\n ): Promise<HPKEEncryptResult> {\n // Get cipher suite\n const suite = this.getCipherSuite()\n\n // Serialize AAD\n const aadBytes = this.serializeAAD(aad)\n\n // Import recipient public key\n const pkR = await suite.kem.importKey('raw', recipientPublicKey, true)\n\n // Encrypt using HPKE Base mode\n const sender = await suite.createSenderContext({\n recipientPublicKey: pkR,\n })\n\n const ciphertext = new Uint8Array(await sender.seal(plaintext, aadBytes))\n\n return {\n ciphertext,\n ephemeralPublicKey: new Uint8Array(sender.enc),\n metadata: this.getAlgorithmNames(),\n }\n }\n\n /**\n * Decrypt payload with HPKE\n *\n * Uses HPKE Base mode to open a sealed envelope using the recipient's\n * private key. Verifies AAD binding to prevent envelope transplant attacks.\n *\n * @param recipientPrivateKey - Recipient's private key (raw bytes)\n * @param ciphertext - Encrypted payload\n * @param ephemeralPublicKey - Ephemeral public key from encryption\n * @param aad - Additional Authenticated Data (must match encryption AAD)\n * @param config - Optional HPKE configuration\n * @returns Decryption result with plaintext\n *\n * @throws Error if AAD doesn't match or decryption fails\n *\n * @example\n * ```typescript\n * const result = await hpkeService.decrypt(\n * alicePrivateKey,\n * encryptedData,\n * ephemeralKey,\n * {\n * ticket_digest: 'sha-256:abc123...',\n * session_id: 'sess_xyz',\n * device: 'did:ex:alice#device1'\n * }\n * )\n * ```\n */\n public async decrypt(\n recipientPrivateKey: Uint8Array,\n ciphertext: Uint8Array,\n ephemeralPublicKey: Uint8Array,\n aad: { ticket_digest: string; session_id?: string; device?: string }\n ): Promise<HPKEDecryptResult> {\n // Get cipher suite\n const suite = this.getCipherSuite()\n\n // Serialize AAD (must match encryption AAD)\n const aadBytes = this.serializeAAD(aad)\n\n // Import recipient private key\n const skR = await suite.kem.importKey('raw', recipientPrivateKey, false)\n\n // Decrypt using HPKE Base mode\n try {\n const recipient = await suite.createRecipientContext({\n recipientKey: skR,\n enc: ephemeralPublicKey,\n })\n\n const plaintext = new Uint8Array(await recipient.open(ciphertext, aadBytes))\n\n return { plaintext }\n } catch (error) {\n throw new Error(`HPKE decryption failed: ${error instanceof Error ? error.message : 'unknown error'}`)\n }\n }\n\n /**\n * Generate key pair for HPKE\n *\n * Generates a new random key pair suitable for HPKE operations.\n *\n * @returns Object with public and private keys\n *\n * @example\n * ```typescript\n * const { publicKey, privateKey } = await hpkeService.generateKeyPair()\n * ```\n */\n public async generateKeyPair(): Promise<{\n publicKey: Uint8Array\n privateKey: Uint8Array\n }> {\n const suite = this.getCipherSuite()\n const keyPair = await suite.kem.generateKeyPair()\n\n // Export keys to raw format\n const publicKeyRaw = await suite.kem.serializePublicKey(keyPair.publicKey)\n const privateKeyRaw = await suite.kem.serializePrivateKey(keyPair.privateKey)\n\n return {\n publicKey: new Uint8Array(publicKeyRaw),\n privateKey: new Uint8Array(privateKeyRaw),\n }\n }\n\n /**\n * Derive public key from private key\n *\n * Derives the corresponding public key from a private key.\n *\n * @param privateKey - Private key\n * @returns Public key\n */\n public async derivePublicKey(privateKey: Uint8Array): Promise<Uint8Array> {\n const suite = this.getCipherSuite()\n\n // Import the private key and derive public key\n const keyPair = await suite.kem.importKey('raw', privateKey, false)\n\n // Export public key to raw format\n const publicKeyRaw = await suite.kem.serializePublicKey(keyPair.publicKey)\n\n return new Uint8Array(publicKeyRaw)\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyDO,wBAAM,YAAY;;;;;;;;;CASvB,AAAQ,iBAA8B;AACpC,SAAO,IAAI,YAAY;GACrB,KAAK,IAAI,qBAAqB;GAC9B,KAAK,IAAI,YAAY;GACrB,MAAM,IAAI,WAAW;GACtB,CAAC;;;;;CAMJ,AAAQ,oBAIN;AACA,SAAO;GACL,KAAK;GACL,KAAK;GACL,MAAM;GACP;;;;;;;;;;CAWH,AAAO,oBAAoB,aAAiC;EAC1D,MAAM,OAAO,OAAO,YAAY;AAChC,SAAO,OAAO,KAAK,KAAK,CAAC,SAAS,SAAS;;;;;;;;;;;CAY7C,AAAQ,aAAa,KAAkF;EAErG,MAAM,YAAY,KAAK,UAAU,IAAI;AACrC,SAAO,IAAI,aAAa,CAAC,OAAO,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B5C,MAAa,QACX,oBACA,WACA,KAC4B;EAE5B,MAAM,QAAQ,KAAK,gBAAgB;EAGnC,MAAM,WAAW,KAAK,aAAa,IAAI;EAGvC,MAAM,MAAM,MAAM,MAAM,IAAI,UAAU,OAAO,oBAAoB,KAAK;EAGtE,MAAM,SAAS,MAAM,MAAM,oBAAoB,EAC7C,oBAAoB,KACrB,CAAC;AAIF,SAAO;GACL,YAHiB,IAAI,WAAW,MAAM,OAAO,KAAK,WAAW,SAAS,CAAC;GAIvE,oBAAoB,IAAI,WAAW,OAAO,IAAI;GAC9C,UAAU,KAAK,mBAAmB;GACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCH,MAAa,QACX,qBACA,YACA,oBACA,KAC4B;EAE5B,MAAM,QAAQ,KAAK,gBAAgB;EAGnC,MAAM,WAAW,KAAK,aAAa,IAAI;EAGvC,MAAM,MAAM,MAAM,MAAM,IAAI,UAAU,OAAO,qBAAqB,MAAM;AAGxE,MAAI;GACF,MAAM,YAAY,MAAM,MAAM,uBAAuB;IACnD,cAAc;IACd,KAAK;IACN,CAAC;AAIF,UAAO,EAAE,WAFS,IAAI,WAAW,MAAM,UAAU,KAAK,YAAY,SAAS,CAAC,EAExD;WACb,OAAO;AACd,SAAM,IAAI,MAAM,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,kBAAkB;;;;;;;;;;;;;;;CAgB1G,MAAa,kBAGV;EACD,MAAM,QAAQ,KAAK,gBAAgB;EACnC,MAAM,UAAU,MAAM,MAAM,IAAI,iBAAiB;EAGjD,MAAM,eAAe,MAAM,MAAM,IAAI,mBAAmB,QAAQ,UAAU;EAC1E,MAAM,gBAAgB,MAAM,MAAM,IAAI,oBAAoB,QAAQ,WAAW;AAE7E,SAAO;GACL,WAAW,IAAI,WAAW,aAAa;GACvC,YAAY,IAAI,WAAW,cAAc;GAC1C;;;;;;;;;;CAWH,MAAa,gBAAgB,YAA6C;EACxE,MAAM,QAAQ,KAAK,gBAAgB;EAGnC,MAAM,UAAU,MAAM,MAAM,IAAI,UAAU,OAAO,YAAY,MAAM;EAGnE,MAAM,eAAe,MAAM,MAAM,IAAI,mBAAmB,QAAQ,UAAU;AAE1E,SAAO,IAAI,WAAW,aAAa;;;0BA3NtC,YAAY"}
|
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
import { SignableObject } from "../models/SignableObject.mjs";
|
|
2
|
+
import { Session } from "../models/Session.mjs";
|
|
3
|
+
import { SuiteConfig } from "../models/Suite.mjs";
|
|
4
|
+
import { AuthzVerificationResult, CreateAuthzArtifactOptions, SigningAuthz, VerifyAuthzArtifactOptions } from "../models/AuthzArtifact.mjs";
|
|
5
|
+
import { CreateJoinTokenOptions, JoinToken, JoinTokenVerificationResult, VerifyJoinTokenOptions } from "../models/JoinToken.mjs";
|
|
6
|
+
import { CreateRouterAttestationOptions, RouterAttestation, RouterAttestationVerificationResult, VerifyRouterAttestationOptions } from "../models/RouterAttestation.mjs";
|
|
7
|
+
import "../models/index.mjs";
|
|
8
|
+
import { SigningSessionRecord } from "../repository/SigningSessionRecord.mjs";
|
|
9
|
+
import { SigningSessionRepository } from "../repository/SigningSessionRepository.mjs";
|
|
10
|
+
import { CanonicalizerRegistry } from "../registry/canonicalizers/CanonicalizerRegistry.mjs";
|
|
11
|
+
import "../registry/canonicalizers/index.mjs";
|
|
12
|
+
import { SignatureSuiteRegistry } from "../registry/suites/SignatureSuiteRegistry.mjs";
|
|
13
|
+
import "../registry/suites/index.mjs";
|
|
14
|
+
import { AggregatorRegistry } from "../registry/aggregators/AggregatorRegistry.mjs";
|
|
15
|
+
import "../registry/aggregators/index.mjs";
|
|
16
|
+
import { PolicyRegistry } from "../registry/policies/PolicyRegistry.mjs";
|
|
17
|
+
import "../registry/policies/index.mjs";
|
|
18
|
+
import { InlineBase64Strategy } from "../delivery/InlineBase64Strategy.mjs";
|
|
19
|
+
import { HPKEService } from "./HPKEService.mjs";
|
|
20
|
+
import { CounterService } from "./CounterService.mjs";
|
|
21
|
+
import { ProposeSigningMessage } from "../messages/ProposeSigningMessage.mjs";
|
|
22
|
+
import { RequestSigningMessage } from "../messages/RequestSigningMessage.mjs";
|
|
23
|
+
import { ConsentMessage } from "../messages/ConsentMessage.mjs";
|
|
24
|
+
import { PartialSignatureMessage } from "../messages/PartialSignatureMessage.mjs";
|
|
25
|
+
import { ProvideArtifactsMessage } from "../messages/ProvideArtifactsMessage.mjs";
|
|
26
|
+
import { DeclineMessage } from "../messages/DeclineMessage.mjs";
|
|
27
|
+
import { SigningProblemReportMessage } from "../messages/SigningProblemReportMessage.mjs";
|
|
28
|
+
import "../messages/index.mjs";
|
|
29
|
+
import { AgentContext, EventEmitter } from "@credo-ts/core";
|
|
30
|
+
import { DidCommInboundMessageContext, DidCommMessageRepository, DidCommMessageSender } from "@credo-ts/didcomm";
|
|
31
|
+
|
|
32
|
+
//#region src/services/SigningService.d.ts
|
|
33
|
+
/**
|
|
34
|
+
* Signing Service
|
|
35
|
+
*
|
|
36
|
+
* Core service that orchestrates the DIDComm Signing Protocol.
|
|
37
|
+
* Handles session management, message creation, state transitions,
|
|
38
|
+
* signature collection, verification, and artifact delivery.
|
|
39
|
+
*/
|
|
40
|
+
declare class SigningService {
|
|
41
|
+
private sessionRepository;
|
|
42
|
+
private messageSender;
|
|
43
|
+
private didCommMessageRepository;
|
|
44
|
+
private canonicalizerRegistry;
|
|
45
|
+
private suiteRegistry;
|
|
46
|
+
private aggregatorRegistry;
|
|
47
|
+
private policyRegistry;
|
|
48
|
+
private artifactDelivery;
|
|
49
|
+
private eventEmitter;
|
|
50
|
+
private hpkeService;
|
|
51
|
+
private counterService;
|
|
52
|
+
constructor(sessionRepository: SigningSessionRepository, messageSender: DidCommMessageSender, didCommMessageRepository: DidCommMessageRepository, canonicalizerRegistry: CanonicalizerRegistry, suiteRegistry: SignatureSuiteRegistry, aggregatorRegistry: AggregatorRegistry, policyRegistry: PolicyRegistry, artifactDelivery: InlineBase64Strategy, eventEmitter: EventEmitter, hpkeService: HPKEService, counterService: CounterService);
|
|
53
|
+
/**
|
|
54
|
+
* Emit a state changed event
|
|
55
|
+
*/
|
|
56
|
+
private emitStateChangedEvent;
|
|
57
|
+
/**
|
|
58
|
+
* Create and send a signing proposal
|
|
59
|
+
* Role: Requester → Signer
|
|
60
|
+
*/
|
|
61
|
+
createProposal(agentContext: AgentContext, options: {
|
|
62
|
+
connectionId: string;
|
|
63
|
+
session?: Session;
|
|
64
|
+
}): Promise<{
|
|
65
|
+
record: SigningSessionRecord;
|
|
66
|
+
message: ProposeSigningMessage;
|
|
67
|
+
}>;
|
|
68
|
+
/**
|
|
69
|
+
* Process received proposal
|
|
70
|
+
* Role: Signer receives from Requester
|
|
71
|
+
*/
|
|
72
|
+
processProposal(messageContext: DidCommInboundMessageContext<ProposeSigningMessage>): Promise<SigningSessionRecord>;
|
|
73
|
+
/**
|
|
74
|
+
* Create and send a signing request
|
|
75
|
+
* Role: Requester → Signer(s)
|
|
76
|
+
*/
|
|
77
|
+
createRequest(agentContext: AgentContext, options: {
|
|
78
|
+
connectionId: string;
|
|
79
|
+
object: SignableObject;
|
|
80
|
+
suite: SuiteConfig;
|
|
81
|
+
session?: Session;
|
|
82
|
+
idempotencyKey?: string;
|
|
83
|
+
}): Promise<{
|
|
84
|
+
record: SigningSessionRecord;
|
|
85
|
+
message: RequestSigningMessage;
|
|
86
|
+
}>;
|
|
87
|
+
/**
|
|
88
|
+
* Process received signing request
|
|
89
|
+
* Role: Signer receives from Requester
|
|
90
|
+
*/
|
|
91
|
+
processRequest(messageContext: DidCommInboundMessageContext<RequestSigningMessage>): Promise<SigningSessionRecord>;
|
|
92
|
+
/**
|
|
93
|
+
* Create and send consent to sign
|
|
94
|
+
* Role: Signer → Requester
|
|
95
|
+
*/
|
|
96
|
+
createConsent(agentContext: AgentContext, options: {
|
|
97
|
+
sessionId: string;
|
|
98
|
+
objectId: string;
|
|
99
|
+
keyId: string;
|
|
100
|
+
keyBindingPayload?: string;
|
|
101
|
+
}): Promise<{
|
|
102
|
+
record: SigningSessionRecord;
|
|
103
|
+
message: ConsentMessage;
|
|
104
|
+
}>;
|
|
105
|
+
/**
|
|
106
|
+
* Process received consent
|
|
107
|
+
* Role: Requester receives from Signer
|
|
108
|
+
*/
|
|
109
|
+
processConsent(messageContext: DidCommInboundMessageContext<ConsentMessage>): Promise<SigningSessionRecord>;
|
|
110
|
+
/**
|
|
111
|
+
* Create and send signature
|
|
112
|
+
* Role: Signer → Requester/Coordinator
|
|
113
|
+
*/
|
|
114
|
+
createSignature(agentContext: AgentContext, options: {
|
|
115
|
+
sessionId: string;
|
|
116
|
+
objectId: string;
|
|
117
|
+
keyId: string;
|
|
118
|
+
round?: number;
|
|
119
|
+
}): Promise<{
|
|
120
|
+
record: SigningSessionRecord;
|
|
121
|
+
message: PartialSignatureMessage;
|
|
122
|
+
}>;
|
|
123
|
+
/**
|
|
124
|
+
* Process received signature
|
|
125
|
+
* Role: Requester/Coordinator receives from Signer
|
|
126
|
+
*/
|
|
127
|
+
processSignature(messageContext: DidCommInboundMessageContext<PartialSignatureMessage>): Promise<SigningSessionRecord>;
|
|
128
|
+
/**
|
|
129
|
+
* Combine signatures and complete signing
|
|
130
|
+
* Role: Requester/Coordinator
|
|
131
|
+
*/
|
|
132
|
+
completeSession(agentContext: AgentContext, options: {
|
|
133
|
+
sessionId: string;
|
|
134
|
+
artifactData?: Uint8Array;
|
|
135
|
+
artifactMimeType?: string;
|
|
136
|
+
}): Promise<{
|
|
137
|
+
record: SigningSessionRecord;
|
|
138
|
+
message: ProvideArtifactsMessage;
|
|
139
|
+
}>;
|
|
140
|
+
/**
|
|
141
|
+
* Process signing completion
|
|
142
|
+
* Role: Signer receives completion from Requester
|
|
143
|
+
*/
|
|
144
|
+
processComplete(messageContext: DidCommInboundMessageContext<ProvideArtifactsMessage>): Promise<SigningSessionRecord>;
|
|
145
|
+
/**
|
|
146
|
+
* Decline signing request
|
|
147
|
+
* Role: Signer → Requester
|
|
148
|
+
*/
|
|
149
|
+
createDecline(agentContext: AgentContext, options: {
|
|
150
|
+
sessionId: string;
|
|
151
|
+
reason?: string;
|
|
152
|
+
}): Promise<{
|
|
153
|
+
record: SigningSessionRecord;
|
|
154
|
+
message: DeclineMessage;
|
|
155
|
+
}>;
|
|
156
|
+
/**
|
|
157
|
+
* Process decline message
|
|
158
|
+
*/
|
|
159
|
+
processDecline(messageContext: DidCommInboundMessageContext<DeclineMessage>): Promise<SigningSessionRecord>;
|
|
160
|
+
/**
|
|
161
|
+
* Abandon signing session
|
|
162
|
+
* Role: Any participant
|
|
163
|
+
*/
|
|
164
|
+
createAbandon(agentContext: AgentContext, options: {
|
|
165
|
+
sessionId: string;
|
|
166
|
+
code: string;
|
|
167
|
+
explain?: string;
|
|
168
|
+
}): Promise<{
|
|
169
|
+
record: SigningSessionRecord;
|
|
170
|
+
message: SigningProblemReportMessage;
|
|
171
|
+
}>;
|
|
172
|
+
/**
|
|
173
|
+
* Process abandon message
|
|
174
|
+
*/
|
|
175
|
+
processAbandon(messageContext: DidCommInboundMessageContext<SigningProblemReportMessage>): Promise<SigningSessionRecord>;
|
|
176
|
+
/**
|
|
177
|
+
* Verify all collected signatures
|
|
178
|
+
*/
|
|
179
|
+
private verifySignatures;
|
|
180
|
+
/**
|
|
181
|
+
* Find a session by record ID
|
|
182
|
+
*/
|
|
183
|
+
findById(agentContext: AgentContext, id: string): Promise<SigningSessionRecord | null>;
|
|
184
|
+
/**
|
|
185
|
+
* Get all signing sessions
|
|
186
|
+
*/
|
|
187
|
+
getAll(agentContext: AgentContext): Promise<SigningSessionRecord[]>;
|
|
188
|
+
/**
|
|
189
|
+
* Find sessions by query
|
|
190
|
+
*/
|
|
191
|
+
findAllByQuery(agentContext: AgentContext, query: any, queryOptions?: any): Promise<SigningSessionRecord[]>;
|
|
192
|
+
/**
|
|
193
|
+
* Get session by record ID (throws if not found)
|
|
194
|
+
*/
|
|
195
|
+
getSessionById(agentContext: AgentContext, id: string): Promise<SigningSessionRecord>;
|
|
196
|
+
/**
|
|
197
|
+
* Get session by session ID (throws if not found)
|
|
198
|
+
*/
|
|
199
|
+
private getSessionBySessionId;
|
|
200
|
+
/**
|
|
201
|
+
* Create an authorization artifact for Group Messaging Protocol
|
|
202
|
+
*
|
|
203
|
+
* Creates a signed authorization artifact that proves admin approval for
|
|
204
|
+
* privileged operations (invite, moderate, update). Supports both single
|
|
205
|
+
* admin and threshold (n-of-m) approval modes.
|
|
206
|
+
*
|
|
207
|
+
* Used by Group Messaging Protocol for:
|
|
208
|
+
* - Admin authorization (invite, moderate operations)
|
|
209
|
+
* - Room policy updates
|
|
210
|
+
* - Threshold admin approval (2-of-3, etc.)
|
|
211
|
+
*
|
|
212
|
+
* @param agentContext - Agent context
|
|
213
|
+
* @param options - Authorization artifact options
|
|
214
|
+
* @returns Authorization artifact with signatures
|
|
215
|
+
*
|
|
216
|
+
* @example
|
|
217
|
+
* ```typescript
|
|
218
|
+
* const authz = await signingService.createAuthzArtifact(agentContext, {
|
|
219
|
+
* action: 'invite',
|
|
220
|
+
* roomDid: 'did:peer:room123',
|
|
221
|
+
* targetDid: 'did:ex:alice',
|
|
222
|
+
* adminDids: ['did:ex:admin1', 'did:ex:admin2'],
|
|
223
|
+
* threshold: 2,
|
|
224
|
+
* payload: { room: 'did:peer:room123', invitee: 'did:ex:alice' }
|
|
225
|
+
* })
|
|
226
|
+
* ```
|
|
227
|
+
*/
|
|
228
|
+
createAuthzArtifact(agentContext: AgentContext, options: CreateAuthzArtifactOptions): Promise<SigningAuthz>;
|
|
229
|
+
/**
|
|
230
|
+
* Verify an authorization artifact
|
|
231
|
+
*
|
|
232
|
+
* Verifies that an authorization artifact has valid signatures from
|
|
233
|
+
* authorized admins and meets threshold requirements.
|
|
234
|
+
*
|
|
235
|
+
* @param agentContext - Agent context
|
|
236
|
+
* @param authz - Authorization artifact to verify
|
|
237
|
+
* @param options - Verification options
|
|
238
|
+
* @returns Verification result with validity and details
|
|
239
|
+
*
|
|
240
|
+
* @example
|
|
241
|
+
* ```typescript
|
|
242
|
+
* const result = await signingService.verifyAuthzArtifact(agentContext, authz, {
|
|
243
|
+
* roomDid: 'did:peer:room123',
|
|
244
|
+
* requiredAction: 'invite',
|
|
245
|
+
* allowedAdmins: ['did:ex:admin1', 'did:ex:admin2'],
|
|
246
|
+
* threshold: 2
|
|
247
|
+
* })
|
|
248
|
+
* ```
|
|
249
|
+
*/
|
|
250
|
+
verifyAuthzArtifact(agentContext: AgentContext, authz: SigningAuthz, options: VerifyAuthzArtifactOptions): Promise<AuthzVerificationResult>;
|
|
251
|
+
/**
|
|
252
|
+
* Create a join token with HPKE envelope
|
|
253
|
+
*
|
|
254
|
+
* Creates a replay-proof join token that encapsulates:
|
|
255
|
+
* - Signed authorization ticket with monotonic counter
|
|
256
|
+
* - HPKE-encrypted payload (e.g., MLS Welcome message)
|
|
257
|
+
* - AAD binding to prevent envelope transplant attacks
|
|
258
|
+
*
|
|
259
|
+
* Used by Group Messaging Protocol for:
|
|
260
|
+
* - Secure room invitations with encrypted Welcome messages
|
|
261
|
+
* - Device-bound, single-use credentials
|
|
262
|
+
* - Replay-protected authorization
|
|
263
|
+
*
|
|
264
|
+
* Security Properties:
|
|
265
|
+
* - Replay protection via monotonic counter
|
|
266
|
+
* - Device binding via HPKE encryption to device public key
|
|
267
|
+
* - Transplant resistance via AAD binding (ticket_digest)
|
|
268
|
+
* - Short-lived tokens (default 2 minutes)
|
|
269
|
+
* - Single-use enforcement (cap = 1)
|
|
270
|
+
*
|
|
271
|
+
* @param agentContext - Agent context
|
|
272
|
+
* @param options - Join token creation options
|
|
273
|
+
* @returns Complete join token ready for transmission
|
|
274
|
+
*
|
|
275
|
+
* @example
|
|
276
|
+
* ```typescript
|
|
277
|
+
* const joinToken = await signingService.createJoinToken(agentContext, {
|
|
278
|
+
* sessionId: 'session_abc123',
|
|
279
|
+
* deviceDid: 'did:ex:alice#device1',
|
|
280
|
+
* devicePublicKey: aliceX25519PublicKey,
|
|
281
|
+
* payload: { welcome: mlsWelcomeMessage, groupInfo: ... },
|
|
282
|
+
* expiresIn: 120,
|
|
283
|
+
* capacity: 1,
|
|
284
|
+
* scope: 'join'
|
|
285
|
+
* })
|
|
286
|
+
* ```
|
|
287
|
+
*/
|
|
288
|
+
createJoinToken(agentContext: AgentContext, options: CreateJoinTokenOptions): Promise<JoinToken>;
|
|
289
|
+
/**
|
|
290
|
+
* Verify and decrypt a join token
|
|
291
|
+
*
|
|
292
|
+
* Verifies a join token by:
|
|
293
|
+
* 1. Verifying the ticket signature
|
|
294
|
+
* 2. Checking counter for replay attacks
|
|
295
|
+
* 3. Verifying expiry
|
|
296
|
+
* 4. Checking AAD binding
|
|
297
|
+
* 5. Decrypting the envelope with device private key
|
|
298
|
+
*
|
|
299
|
+
* CRITICAL: Counter is persisted BEFORE token consumption to prevent
|
|
300
|
+
* replay attacks even if consumption fails.
|
|
301
|
+
*
|
|
302
|
+
* @param agentContext - Agent context
|
|
303
|
+
* @param joinToken - Join token to verify
|
|
304
|
+
* @param options - Verification options
|
|
305
|
+
* @returns Verification result with decrypted payload
|
|
306
|
+
*
|
|
307
|
+
* @example
|
|
308
|
+
* ```typescript
|
|
309
|
+
* const result = await signingService.verifyJoinToken(agentContext, joinToken, {
|
|
310
|
+
* devicePrivateKey: aliceX25519PrivateKey,
|
|
311
|
+
* enforceExpiry: true,
|
|
312
|
+
* enforceCounter: true,
|
|
313
|
+
* expectedCoordinator: 'did:ex:coordinator'
|
|
314
|
+
* })
|
|
315
|
+
*
|
|
316
|
+
* if (result.valid) {
|
|
317
|
+
* const { welcome, groupInfo } = result.payload
|
|
318
|
+
* // Process MLS Welcome message...
|
|
319
|
+
* }
|
|
320
|
+
* ```
|
|
321
|
+
*/
|
|
322
|
+
verifyJoinToken(agentContext: AgentContext, joinToken: JoinToken, options: VerifyJoinTokenOptions): Promise<JoinTokenVerificationResult>;
|
|
323
|
+
/**
|
|
324
|
+
* Create a router attestation for Group Messaging Protocol
|
|
325
|
+
*
|
|
326
|
+
* Creates a signed attestation that proves a router is authorized to relay
|
|
327
|
+
* messages for a room to a specific reach set of DIDs.
|
|
328
|
+
*
|
|
329
|
+
* Used by Group Messaging Protocol for:
|
|
330
|
+
* - Router registration with Host
|
|
331
|
+
* - Mesh relay authorization
|
|
332
|
+
* - Reach set advertisement
|
|
333
|
+
*
|
|
334
|
+
* Security Properties:
|
|
335
|
+
* - Router identity binding via DID signature
|
|
336
|
+
* - Room-specific authorization
|
|
337
|
+
* - Time-bounded validity (expiry)
|
|
338
|
+
* - Optional admin co-signature for additional trust
|
|
339
|
+
*
|
|
340
|
+
* @param agentContext - Agent context
|
|
341
|
+
* @param options - Router attestation options
|
|
342
|
+
* @returns Router attestation with signature(s)
|
|
343
|
+
*
|
|
344
|
+
* @example
|
|
345
|
+
* ```typescript
|
|
346
|
+
* const attestation = await signingService.createRouterAttestation(agentContext, {
|
|
347
|
+
* routerDid: 'did:ex:router1',
|
|
348
|
+
* roomDid: 'did:peer:room123',
|
|
349
|
+
* reach: ['did:ex:alice', 'did:ex:bob', 'did:ex:charlie'],
|
|
350
|
+
* expiresIn: 86400, // 24 hours
|
|
351
|
+
* policyHash: 'sha-256:abc123...',
|
|
352
|
+
* adminDids: ['did:ex:admin1'], // Optional co-signature
|
|
353
|
+
* })
|
|
354
|
+
* ```
|
|
355
|
+
*/
|
|
356
|
+
createRouterAttestation(agentContext: AgentContext, options: CreateRouterAttestationOptions): Promise<RouterAttestation>;
|
|
357
|
+
/**
|
|
358
|
+
* Verify a router attestation
|
|
359
|
+
*
|
|
360
|
+
* Verifies that a router attestation has:
|
|
361
|
+
* - Valid signature from router DID
|
|
362
|
+
* - Correct room DID
|
|
363
|
+
* - Not expired
|
|
364
|
+
* - Optional admin co-signature validation
|
|
365
|
+
*
|
|
366
|
+
* @param agentContext - Agent context
|
|
367
|
+
* @param attestation - Router attestation to verify
|
|
368
|
+
* @param options - Verification options
|
|
369
|
+
* @returns Verification result with validity and details
|
|
370
|
+
*
|
|
371
|
+
* @example
|
|
372
|
+
* ```typescript
|
|
373
|
+
* const result = await signingService.verifyRouterAttestation(agentContext, attestation, {
|
|
374
|
+
* roomDid: 'did:peer:room123',
|
|
375
|
+
* expectedRouter: 'did:ex:router1',
|
|
376
|
+
* enforceExpiry: true,
|
|
377
|
+
* allowedRouters: ['did:ex:router1', 'did:ex:router2'],
|
|
378
|
+
* authorizedAdmins: ['did:ex:admin1'],
|
|
379
|
+
* requireAdminSignature: false,
|
|
380
|
+
* })
|
|
381
|
+
* ```
|
|
382
|
+
*/
|
|
383
|
+
verifyRouterAttestation(agentContext: AgentContext, attestation: RouterAttestation, options: VerifyRouterAttestationOptions): Promise<RouterAttestationVerificationResult>;
|
|
384
|
+
}
|
|
385
|
+
//#endregion
|
|
386
|
+
export { SigningService };
|
|
387
|
+
//# sourceMappingURL=SigningService.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SigningService.d.mts","names":[],"sources":["../../src/services/SigningService.ts"],"mappings":"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"}
|