@open-e2ee/signal-protocol-sdk 0.3.0 → 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.
Files changed (273) hide show
  1. package/ADAPTERS.md +7 -0
  2. package/ARCHITECTURE.md +2 -0
  3. package/CHANGELOG.md +96 -5
  4. package/README.md +67 -102
  5. package/SECURITY.md +2 -2
  6. package/THIRD_PARTY_NOTICES.md +1 -1
  7. package/TROUBLESHOOTING.md +7 -0
  8. package/blocking/README.md +1 -0
  9. package/client/README.md +10 -0
  10. package/device/README.md +12 -5
  11. package/dist/client/client.d.ts +3 -2
  12. package/dist/client/client.d.ts.map +1 -1
  13. package/dist/client/client.js +58 -25
  14. package/dist/client/client.js.map +1 -1
  15. package/dist/client/config.d.ts +46 -7
  16. package/dist/client/config.d.ts.map +1 -1
  17. package/dist/client/config.js +2 -2
  18. package/dist/client/config.js.map +1 -1
  19. package/dist/client/group-outbox.d.ts +38 -0
  20. package/dist/client/group-outbox.d.ts.map +1 -0
  21. package/dist/client/group-outbox.js +221 -0
  22. package/dist/client/group-outbox.js.map +1 -0
  23. package/dist/client/group-sealed-sender.d.ts +28 -0
  24. package/dist/client/group-sealed-sender.d.ts.map +1 -0
  25. package/dist/client/group-sealed-sender.js +74 -0
  26. package/dist/client/group-sealed-sender.js.map +1 -0
  27. package/dist/client/groups.d.ts.map +1 -1
  28. package/dist/client/groups.js +14 -4
  29. package/dist/client/groups.js.map +1 -1
  30. package/dist/client/hosted-push.d.ts +77 -0
  31. package/dist/client/hosted-push.d.ts.map +1 -0
  32. package/dist/client/hosted-push.js +90 -0
  33. package/dist/client/hosted-push.js.map +1 -0
  34. package/dist/client/hosted.d.ts +207 -0
  35. package/dist/client/hosted.d.ts.map +1 -0
  36. package/dist/client/hosted.js +505 -0
  37. package/dist/client/hosted.js.map +1 -0
  38. package/dist/client/index.d.ts +4 -2
  39. package/dist/client/index.d.ts.map +1 -1
  40. package/dist/client/index.js +2 -0
  41. package/dist/client/index.js.map +1 -1
  42. package/dist/client/relay-subscription.d.ts.map +1 -1
  43. package/dist/client/relay-subscription.js +34 -7
  44. package/dist/client/relay-subscription.js.map +1 -1
  45. package/dist/client/{sealed-sender-ops.d.ts → sealed-sender.d.ts} +39 -22
  46. package/dist/client/sealed-sender.d.ts.map +1 -0
  47. package/dist/client/sealed-sender.js +296 -0
  48. package/dist/client/sealed-sender.js.map +1 -0
  49. package/dist/client/signal-service-cipher.d.ts +23 -26
  50. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  51. package/dist/client/signal-service-cipher.js +465 -706
  52. package/dist/client/signal-service-cipher.js.map +1 -1
  53. package/dist/client/types.d.ts +18 -3
  54. package/dist/client/types.d.ts.map +1 -1
  55. package/dist/client/types.js +6 -0
  56. package/dist/client/types.js.map +1 -1
  57. package/dist/device/index.d.ts +2 -2
  58. package/dist/device/index.d.ts.map +1 -1
  59. package/dist/device/index.js +1 -1
  60. package/dist/device/index.js.map +1 -1
  61. package/dist/device/transfer.d.ts +7 -43
  62. package/dist/device/transfer.d.ts.map +1 -1
  63. package/dist/device/transfer.js +31 -150
  64. package/dist/device/transfer.js.map +1 -1
  65. package/dist/device/types.d.ts +6 -47
  66. package/dist/device/types.d.ts.map +1 -1
  67. package/dist/device/types.js +1 -1
  68. package/dist/device/types.js.map +1 -1
  69. package/dist/index.d.ts +5 -4
  70. package/dist/index.d.ts.map +1 -1
  71. package/dist/index.js +5 -5
  72. package/dist/index.js.map +1 -1
  73. package/dist/internal/encoding/proto/pq-ratchet-serialize.js +1 -1
  74. package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
  75. package/dist/internal/encoding/proto/primitives.js +1 -1
  76. package/dist/internal/encoding/proto/primitives.js.map +1 -1
  77. package/dist/internal/groups/manager.d.ts +3 -3
  78. package/dist/internal/groups/manager.d.ts.map +1 -1
  79. package/dist/internal/groups/manager.js +5 -4
  80. package/dist/internal/groups/manager.js.map +1 -1
  81. package/dist/internal/protocol/sealed-sender/certificate.d.ts +10 -4
  82. package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
  83. package/dist/internal/protocol/sealed-sender/certificate.js +64 -7
  84. package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
  85. package/dist/internal/protocol/sealed-sender/decryption.d.ts +34 -47
  86. package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
  87. package/dist/internal/protocol/sealed-sender/decryption.js +95 -182
  88. package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
  89. package/dist/internal/protocol/sealed-sender/encryption.d.ts +49 -64
  90. package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
  91. package/dist/internal/protocol/sealed-sender/encryption.js +120 -123
  92. package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
  93. package/dist/internal/protocol/sealed-sender/index.d.ts +5 -7
  94. package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
  95. package/dist/internal/protocol/sealed-sender/index.js +4 -12
  96. package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
  97. package/dist/internal/protocol/sealed-sender/{v2-helpers.d.ts → multi-recipient-crypto.d.ts} +1 -1
  98. package/dist/internal/protocol/sealed-sender/multi-recipient-crypto.d.ts.map +1 -0
  99. package/dist/internal/protocol/sealed-sender/{v2-helpers.js → multi-recipient-crypto.js} +1 -1
  100. package/dist/internal/protocol/sealed-sender/multi-recipient-crypto.js.map +1 -0
  101. package/dist/internal/protocol/sealed-sender/{v2-binary.d.ts → multi-recipient-message.d.ts} +3 -2
  102. package/dist/internal/protocol/sealed-sender/multi-recipient-message.d.ts.map +1 -0
  103. package/dist/internal/protocol/sealed-sender/{v2-binary.js → multi-recipient-message.js} +16 -8
  104. package/dist/internal/protocol/sealed-sender/multi-recipient-message.js.map +1 -0
  105. package/dist/internal/protocol/sealed-sender/proto/index.d.ts +3 -0
  106. package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
  107. package/dist/internal/protocol/sealed-sender/proto/index.js +25 -2
  108. package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
  109. package/dist/internal/protocol/sealed-sender/trust-root.d.ts +11 -1
  110. package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -1
  111. package/dist/internal/protocol/sealed-sender/trust-root.js +13 -1
  112. package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -1
  113. package/dist/internal/protocol/sealed-sender/types.d.ts +20 -135
  114. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  115. package/dist/internal/protocol/sealed-sender/types.js +15 -6
  116. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  117. package/dist/internal/protocol/sender-keys/manager.d.ts +22 -1
  118. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  119. package/dist/internal/protocol/sender-keys/manager.js +39 -4
  120. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  121. package/dist/internal/protocol/spqr/braid-serialize.js +1 -1
  122. package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -1
  123. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +4 -4
  124. package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
  125. package/dist/internal/protocol/zk/groups/index.d.ts +1 -1
  126. package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
  127. package/dist/internal/protocol/zk/groups/index.js +1 -1
  128. package/dist/internal/protocol/zk/groups/index.js.map +1 -1
  129. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +37 -12
  130. package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
  131. package/dist/internal/protocol/zk/groups/profile-key-credential.js +104 -31
  132. package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
  133. package/dist/internal/sesame/types.d.ts +0 -2
  134. package/dist/internal/sesame/types.d.ts.map +1 -1
  135. package/dist/internal/sesame/types.js +0 -2
  136. package/dist/internal/sesame/types.js.map +1 -1
  137. package/dist/local/store/expo/adapter.d.ts +1 -0
  138. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  139. package/dist/local/store/expo/adapter.js +3 -0
  140. package/dist/local/store/expo/adapter.js.map +1 -1
  141. package/dist/local/store/expo/key-storage.d.ts +1 -0
  142. package/dist/local/store/expo/key-storage.d.ts.map +1 -1
  143. package/dist/local/store/expo/key-storage.js +4 -0
  144. package/dist/local/store/expo/key-storage.js.map +1 -1
  145. package/dist/local/store/memory/adapter.d.ts +1 -0
  146. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  147. package/dist/local/store/memory/adapter.js +4 -0
  148. package/dist/local/store/memory/adapter.js.map +1 -1
  149. package/dist/local/store/node/adapter.d.ts +1 -0
  150. package/dist/local/store/node/adapter.d.ts.map +1 -1
  151. package/dist/local/store/node/adapter.js +3 -0
  152. package/dist/local/store/node/adapter.js.map +1 -1
  153. package/dist/local/store/node/database.d.ts +1 -0
  154. package/dist/local/store/node/database.d.ts.map +1 -1
  155. package/dist/local/store/node/database.js +5 -0
  156. package/dist/local/store/node/database.js.map +1 -1
  157. package/dist/local/store/react-native/adapter.d.ts +1 -0
  158. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  159. package/dist/local/store/react-native/adapter.js +4 -0
  160. package/dist/local/store/react-native/adapter.js.map +1 -1
  161. package/dist/local/store/react-native/reference-backend.js +1 -1
  162. package/dist/local/store/react-native/reference-backend.js.map +1 -1
  163. package/dist/local/store/reliability.d.ts +63 -0
  164. package/dist/local/store/reliability.d.ts.map +1 -0
  165. package/dist/local/store/reliability.js +219 -0
  166. package/dist/local/store/reliability.js.map +1 -0
  167. package/dist/local/store/web/adapter.d.ts +1 -0
  168. package/dist/local/store/web/adapter.d.ts.map +1 -1
  169. package/dist/local/store/web/adapter.js +5 -0
  170. package/dist/local/store/web/adapter.js.map +1 -1
  171. package/dist/media/index.d.ts +0 -1
  172. package/dist/media/index.d.ts.map +1 -1
  173. package/dist/media/index.js +0 -1
  174. package/dist/media/index.js.map +1 -1
  175. package/dist/remote/relay/convex/backend.d.ts +6 -16
  176. package/dist/remote/relay/convex/backend.d.ts.map +1 -1
  177. package/dist/remote/relay/convex/backend.js +12 -21
  178. package/dist/remote/relay/convex/backend.js.map +1 -1
  179. package/dist/remote/relay/convex/component/_generated/component.d.ts +9 -16
  180. package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -1
  181. package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -1
  182. package/dist/remote/relay/convex/component/certificates.js +14 -5
  183. package/dist/remote/relay/convex/component/certificates.js.map +1 -1
  184. package/dist/remote/relay/convex/component/messages.d.ts +2 -15
  185. package/dist/remote/relay/convex/component/messages.d.ts.map +1 -1
  186. package/dist/remote/relay/convex/component/messages.js +14 -48
  187. package/dist/remote/relay/convex/component/messages.js.map +1 -1
  188. package/dist/remote/relay/convex/component/schema.d.ts +5 -3
  189. package/dist/remote/relay/convex/component/schema.js +2 -1
  190. package/dist/remote/relay/convex/component/schema.js.map +1 -1
  191. package/dist/remote/relay/convex/component/zkAuth.d.ts +7 -1
  192. package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -1
  193. package/dist/remote/relay/convex/component/zkAuth.js +29 -14
  194. package/dist/remote/relay/convex/component/zkAuth.js.map +1 -1
  195. package/dist/remote/relay/convex/relay.d.ts +2 -5
  196. package/dist/remote/relay/convex/relay.d.ts.map +1 -1
  197. package/dist/remote/relay/convex/relay.js +17 -47
  198. package/dist/remote/relay/convex/relay.js.map +1 -1
  199. package/dist/remote/relay/memory/adapter.d.ts +4 -10
  200. package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
  201. package/dist/remote/relay/memory/adapter.js +31 -34
  202. package/dist/remote/relay/memory/adapter.js.map +1 -1
  203. package/dist/remote/relay/types.d.ts +6 -19
  204. package/dist/remote/relay/types.d.ts.map +1 -1
  205. package/dist/types/api.d.ts +2 -0
  206. package/dist/types/api.d.ts.map +1 -1
  207. package/dist/types/errors.d.ts +3 -1
  208. package/dist/types/errors.d.ts.map +1 -1
  209. package/dist/types/errors.js +4 -2
  210. package/dist/types/errors.js.map +1 -1
  211. package/dist/types/protocol-config.d.ts +1 -1
  212. package/dist/username/link.d.ts.map +1 -1
  213. package/dist/username/link.js +1 -1
  214. package/dist/username/link.js.map +1 -1
  215. package/dist/utils/retry.d.ts +2 -1
  216. package/dist/utils/retry.d.ts.map +1 -1
  217. package/dist/utils/retry.js +2 -1
  218. package/dist/utils/retry.js.map +1 -1
  219. package/docs/ASSURANCE.md +16 -10
  220. package/docs/CLIENT_COMPOSITION.md +3 -0
  221. package/docs/DEVIATIONS.md +32 -61
  222. package/docs/DOCUMENTATION_STANDARDS.md +28 -0
  223. package/docs/ERROR_HANDLING.md +91 -60
  224. package/docs/GETTING_STARTED.md +27 -1
  225. package/docs/INTERFACES.md +5 -0
  226. package/docs/PACKAGE_SURFACE.md +1 -0
  227. package/docs/PROTOCOL_POLICY.md +6 -0
  228. package/docs/RECIPES.md +9 -0
  229. package/docs/SECURITY.md +6 -0
  230. package/encoding/README.md +1 -0
  231. package/files/README.md +1 -0
  232. package/groups/README.md +1 -0
  233. package/keys/README.md +2 -0
  234. package/local/store/README.md +2 -0
  235. package/local/store/expo/README.md +2 -0
  236. package/local/store/memory/README.md +2 -0
  237. package/local/store/node/README.md +1 -0
  238. package/local/store/react-native/README.md +2 -0
  239. package/local/store/web/README.md +1 -0
  240. package/local/vault/README.md +1 -0
  241. package/media/README.md +2 -0
  242. package/package.json +4 -2
  243. package/profile/README.md +1 -0
  244. package/remote/README.md +6 -0
  245. package/remote/object-store/README.md +1 -0
  246. package/remote/object-store/convex-r2/README.md +2 -0
  247. package/remote/object-store/s3/README.md +1 -0
  248. package/remote/relay/README.md +2 -0
  249. package/remote/relay/convex/README.md +1 -0
  250. package/remote/relay/convex/component/README.md +29 -14
  251. package/remote/relay/memory/README.md +2 -0
  252. package/safety/README.md +1 -0
  253. package/scripts/oe-groups.mjs +5 -1
  254. package/sealed-sender/README.md +1 -0
  255. package/types/README.md +1 -0
  256. package/username/README.md +1 -0
  257. package/utils/README.md +1 -0
  258. package/zk/README.md +1 -0
  259. package/dist/client/sealed-sender-ops.d.ts.map +0 -1
  260. package/dist/client/sealed-sender-ops.js +0 -203
  261. package/dist/client/sealed-sender-ops.js.map +0 -1
  262. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts +0 -46
  263. package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +0 -1
  264. package/dist/internal/protocol/sealed-sender/decryption-v2.js +0 -198
  265. package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +0 -1
  266. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts +0 -56
  267. package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +0 -1
  268. package/dist/internal/protocol/sealed-sender/encryption-v2.js +0 -163
  269. package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +0 -1
  270. package/dist/internal/protocol/sealed-sender/v2-binary.d.ts.map +0 -1
  271. package/dist/internal/protocol/sealed-sender/v2-binary.js.map +0 -1
  272. package/dist/internal/protocol/sealed-sender/v2-helpers.d.ts.map +0 -1
  273. package/dist/internal/protocol/sealed-sender/v2-helpers.js.map +0 -1
@@ -1,203 +0,0 @@
1
- /**
2
- * Sealed Sender Operations
3
- *
4
- * Provides seal/unseal wrapping for the message send/receive pipeline.
5
- * Called by SignalProtocolServiceCipher when sealed sender is enabled.
6
- *
7
- * @see https://signal.org/blog/sealed-sender/
8
- */
9
- import { resolveSignalProtocolLogger } from '../logger.js';
10
- import { SealedSenderContentType, SEALED_SENDER_V2_SERVICE_ID_VERSION, SEALED_SENDER_V2_UUID_VERSION, } from '../internal/protocol/sealed-sender/types.js';
11
- export async function sealMessage(ciphertextBase64, senderCertificateBase64, senderIdentityPrivate, recipientIdentityPublic, _config, _providedLogger, contentType) {
12
- const { seal, deserializeSenderCertificate, encodeUnidentifiedSenderMessage } = await import('../internal/protocol/sealed-sender/index.js');
13
- const { base64ToBytes, bytesToBase64 } = await import('../internal/crypto/index.js');
14
- // Deserialize the sender certificate
15
- const certBytes = base64ToBytes(senderCertificateBase64);
16
- const senderCertificate = deserializeSenderCertificate(certBytes);
17
- // Convert ciphertext to bytes for seal()
18
- const signalProtocolMessage = base64ToBytes(ciphertextBase64);
19
- // Seal the message
20
- const sealed = await seal({
21
- senderCertificate,
22
- senderIdentityPrivate,
23
- recipientIdentityPublic,
24
- signalProtocolMessage,
25
- contentType,
26
- });
27
- // Serialize: version byte + protobuf-encoded message (Sealed Sender wire format)
28
- const protoBytes = encodeUnidentifiedSenderMessage({
29
- ephemeralPublic: base64ToBytes(sealed.ephemeralPublic),
30
- encryptedStatic: base64ToBytes(sealed.encryptedStatic),
31
- encryptedMessage: base64ToBytes(sealed.encryptedMessage),
32
- });
33
- // Prepend version byte
34
- const sealedBytes = new Uint8Array(1 + protoBytes.length);
35
- sealedBytes[0] = sealed.version;
36
- sealedBytes.set(protoBytes, 1);
37
- return bytesToBase64(sealedBytes);
38
- }
39
- /**
40
- * Unseal a sealed sender message to reveal the sender and inner ciphertext.
41
- *
42
- * Called when an incoming envelope has messageType === 'unidentified_sender'.
43
- * Validates the certificate chain, reveals sender identity, and returns
44
- * the inner Signal Protocol ciphertext for normal decryption.
45
- *
46
- * @param sealedCiphertextBase64 - Base64-encoded sealed sender message
47
- * @param recipientIdentityPrivate - Recipient's X25519 identity private key
48
- * @param recipientUuid - Recipient's user ID (for self-send detection)
49
- * @param recipientDeviceId - Recipient's device ID
50
- * @param config - Sealed sender config with trust roots
51
- * @returns Unsealed envelope info with sender identity and inner ciphertext
52
- */
53
- export async function unsealMessage(sealedCiphertextBase64, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, providedLogger) {
54
- const logger = resolveSignalProtocolLogger(providedLogger);
55
- const { base64ToBytes, bytesToBase64 } = await import('../internal/crypto/index.js');
56
- // Decode sealed bytes and check version byte for V1 vs V2 dispatch
57
- const sealedBytes = base64ToBytes(sealedCiphertextBase64);
58
- const versionByte = sealedBytes[0];
59
- // V2 detection: 0x22 = UUID version (ReceivedMessage), 0x23 = ServiceId version
60
- if (versionByte === SEALED_SENDER_V2_UUID_VERSION ||
61
- versionByte === SEALED_SENDER_V2_SERVICE_ID_VERSION) {
62
- return unsealV2Message(sealedBytes, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, logger);
63
- }
64
- // V1 path (0x11). Existing code
65
- const { unseal, decodeUnidentifiedSenderMessage } = await import('../internal/protocol/sealed-sender/index.js');
66
- const version = versionByte;
67
- const sealedProto = decodeUnidentifiedSenderMessage(sealedBytes.subarray(1));
68
- // Build the UnidentifiedSenderMessage structure
69
- const sealedMessage = {
70
- version,
71
- ephemeralPublic: bytesToBase64(sealedProto.ephemeralPublic),
72
- encryptedStatic: bytesToBase64(sealedProto.encryptedStatic),
73
- encryptedMessage: bytesToBase64(sealedProto.encryptedMessage),
74
- };
75
- // Build trust roots as base64 strings
76
- const trustRoots = config.trustRoots.map((root) => bytesToBase64(root));
77
- // Unseal the message
78
- const content = await unseal({
79
- sealedMessage,
80
- recipientIdentityPrivate,
81
- trustRoots,
82
- recipientUuid,
83
- recipientDeviceId,
84
- });
85
- logger.debug('Sealed sender message unsealed', {
86
- category: 'E2EE',
87
- data: {
88
- senderUuid: content.senderCertificate.senderUuid,
89
- senderDeviceId: content.senderCertificate.senderDeviceId,
90
- },
91
- });
92
- return {
93
- senderUserId: content.senderCertificate.senderUuid,
94
- senderDeviceId: content.senderCertificate.senderDeviceId,
95
- innerCiphertextBase64: content.signalProtocolMessage,
96
- contentType: content.contentType,
97
- };
98
- }
99
- /**
100
- * Unseal a V2 multi-recipient sealed sender message (per-device view).
101
- *
102
- * The server constructs a per-device view: [0x22][C_i(32)][AT_i(16)][e_pub(32)][ciphertext]
103
- * We deserialize this, build a SealedSenderV2Message, and call unsealV2().
104
- */
105
- async function unsealV2Message(sealedBytes, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, logger) {
106
- const { deserializeReceivedMessage } = await import('../internal/protocol/sealed-sender/v2-binary.js');
107
- const { unsealV2 } = await import('../internal/protocol/sealed-sender/decryption-v2.js');
108
- const { bytesToBase64 } = await import('../internal/crypto/index.js');
109
- const { x25519 } = await import('@noble/curves/ed25519.js');
110
- // 1. Deserialize per-device ReceivedMessage
111
- const deserialized = deserializeReceivedMessage(sealedBytes);
112
- // 2. Derive recipient public key from private
113
- const recipientIdentityPublic = x25519.getPublicKey(recipientIdentityPrivate);
114
- // 3. Build SealedSenderV2Message with single recipient entry
115
- const message = {
116
- version: SEALED_SENDER_V2_UUID_VERSION,
117
- ephemeralPublic: bytesToBase64(deserialized.ephemeralPublic),
118
- recipients: [
119
- {
120
- serviceId: recipientUuid,
121
- deviceId: recipientDeviceId,
122
- registrationId: 0, // Not needed for unseal. Only used in send path
123
- encryptedMessageKey: bytesToBase64(deserialized.encryptedMessageKey),
124
- authenticationTag: bytesToBase64(deserialized.authenticationTag),
125
- },
126
- ],
127
- messageCiphertext: bytesToBase64(deserialized.messageCiphertext),
128
- };
129
- // 4. Build trust roots as Base64 strings
130
- const trustRoots = config.trustRoots.map((root) => bytesToBase64(root));
131
- // 5. Call unsealV2
132
- const content = await unsealV2({
133
- sealedMessage: message,
134
- recipientIdentityPrivate,
135
- recipientIdentityPublic,
136
- recipientServiceId: recipientUuid,
137
- recipientDeviceId,
138
- trustRoots,
139
- });
140
- logger.debug('V2 sealed sender message unsealed', {
141
- category: 'E2EE',
142
- data: {
143
- senderUuid: content.senderCertificate.senderUuid,
144
- senderDeviceId: content.senderCertificate.senderDeviceId,
145
- },
146
- });
147
- return {
148
- senderUserId: content.senderCertificate.senderUuid,
149
- senderDeviceId: content.senderCertificate.senderDeviceId,
150
- innerCiphertextBase64: content.signalProtocolMessage,
151
- contentType: content.contentType,
152
- };
153
- }
154
- /**
155
- * Reconstruct an Envelope from an unsealed message.
156
- *
157
- * Takes the original sealed sender envelope (with empty sender fields)
158
- * and fills in the sender identity revealed by unsealing.
159
- *
160
- * @param originalEnvelope - The incoming envelope with messageType 'unidentified_sender'
161
- * @param unsealed - The unsealed sender info and inner ciphertext
162
- * @returns A new envelope with real sender info and the inner ciphertext
163
- */
164
- export function reconstructEnvelope(originalEnvelope, unsealed) {
165
- return {
166
- ...originalEnvelope,
167
- senderUserId: unsealed.senderUserId,
168
- senderDeviceId: unsealed.senderDeviceId,
169
- ciphertext: unsealed.innerCiphertextBase64,
170
- messageType: envelopeTypeForContent(unsealed.contentType),
171
- };
172
- }
173
- /**
174
- * Map a sealed envelope's content type onto the envelope type the decrypt
175
- * path routes on.
176
- *
177
- * Exported because both receive paths need it. `SignalProtocolServiceCipher`
178
- * via `reconstructEnvelope`, and `SignalProtocolClient.processIncomingEnvelope`
179
- * directly. Two copies of this mapping would drift.
180
- *
181
- * `SENDERKEY_MESSAGE` is the only case that matters here. It is what keeps
182
- * group routing working now that no group identifier travels on an envelope,
183
- * sealed or otherwise. Both `PREKEY_MESSAGE` and `MESSAGE` decrypt as pairwise
184
- * ratchet messages, and the ratchet distinguishes them from the payload
185
- * itself.
186
- *
187
- * The default is unreachable: `isSealedSenderContentType` rejects every other
188
- * value at the parse, so nothing arrives here that this function cannot map.
189
- * It exists so that adding an enum member without a route fails loudly rather
190
- * than silently decrypting as something it is not.
191
- */
192
- export function envelopeTypeForContent(contentType) {
193
- switch (contentType) {
194
- case SealedSenderContentType.SENDERKEY_MESSAGE:
195
- return 'sender_key';
196
- case SealedSenderContentType.PREKEY_MESSAGE:
197
- case SealedSenderContentType.MESSAGE:
198
- return 'ciphertext';
199
- default:
200
- throw new Error('Unsupported sealed sender content type');
201
- }
202
- }
203
- //# sourceMappingURL=sealed-sender-ops.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sealed-sender-ops.js","sourceRoot":"","sources":["../../client/sealed-sender-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,2BAA2B,EAAgB,MAAM,WAAW,CAAC;AAEtE,OAAO,EACL,uBAAuB,EACvB,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,0CAA0C,CAAC;AAmBlD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,gBAAwB,EACxB,uBAA+B,EAC/B,qBAAiC,EACjC,uBAAmC,EACnC,OAA2B,EAC3B,eAAyB,EACzB,WAAqC;IAErC,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,GAC3E,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IACrD,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE5E,qCAAqC;IACrC,MAAM,SAAS,GAAG,aAAa,CAAC,uBAAiC,CAAC,CAAC;IACnE,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAElE,yCAAyC;IACzC,MAAM,qBAAqB,GAAG,aAAa,CAAC,gBAA0B,CAAC,CAAC;IAExE,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;QACxB,iBAAiB;QACjB,qBAAqB;QACrB,uBAAuB;QACvB,qBAAqB;QACrB,WAAW;KACZ,CAAC,CAAC;IAEH,iFAAiF;IACjF,MAAM,UAAU,GAAG,+BAA+B,CAAC;QACjD,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,eAAyB,CAAC;QAChE,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,eAAyB,CAAC;QAChE,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,gBAA0B,CAAC;KACnE,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1D,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAE/B,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,sBAA8B,EAC9B,wBAAoC,EACpC,aAAqB,EACrB,iBAAyB,EACzB,MAA0B,EAC1B,cAAwB;IAOxB,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE5E,mEAAmE;IACnE,MAAM,WAAW,GAAG,aAAa,CAAC,sBAAgC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAEnC,gFAAgF;IAChF,IACE,WAAW,KAAK,6BAA6B;QAC7C,WAAW,KAAK,mCAAmC,EACnD,CAAC;QACD,OAAO,eAAe,CACpB,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,MAAM,CACP,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,GAC/C,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,WAAW,CAAC;IAC5B,MAAM,WAAW,GAAG,+BAA+B,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,gDAAgD;IAChD,MAAM,aAAa,GAAG;QACpB,OAAO;QACP,eAAe,EAAE,aAAa,CAAC,WAAW,CAAC,eAAe,CAAW;QACrE,eAAe,EAAE,aAAa,CAAC,WAAW,CAAC,eAAe,CAAW;QACrE,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,gBAAgB,CAAW;KACxE,CAAC;IAEF,sCAAsC;IACtC,MAAM,UAAU,GAAa,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAW,CAAC,CAAC;IAE5F,qBAAqB;IACrB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAC3B,aAAa;QACb,wBAAwB;QACxB,UAAU;QACV,aAAa;QACb,iBAAiB;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE;QAC7C,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE;YACJ,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU;YAChD,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc;SACzD;KACF,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU;QAClD,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc;QACxD,qBAAqB,EAAE,OAAO,CAAC,qBAA+B;QAC9D,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,WAAuB,EACvB,wBAAoC,EACpC,aAAqB,EACrB,iBAAyB,EACzB,MAA0B,EAC1B,MAAyB;IAOzB,MAAM,EAAE,0BAA0B,EAAE,GAClC,MAAM,MAAM,CAAC,8CAA8C,CAAC,CAAC;IAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kDAAkD,CAAC,CAAC;IACtF,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAE5D,4CAA4C;IAC5C,MAAM,YAAY,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAE7D,8CAA8C;IAC9C,MAAM,uBAAuB,GAAG,MAAM,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;IAE9E,6DAA6D;IAC7D,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,6BAAqE;QAC9E,eAAe,EAAE,aAAa,CAAC,YAAY,CAAC,eAAe,CAAW;QACtE,UAAU,EAAE;YACV;gBACE,SAAS,EAAE,aAAa;gBACxB,QAAQ,EAAE,iBAAiB;gBAC3B,cAAc,EAAE,CAAC,EAAE,gDAAgD;gBACnE,mBAAmB,EAAE,aAAa,CAAC,YAAY,CAAC,mBAAmB,CAAW;gBAC9E,iBAAiB,EAAE,aAAa,CAAC,YAAY,CAAC,iBAAiB,CAAW;aAC3E;SACF;QACD,iBAAiB,EAAE,aAAa,CAAC,YAAY,CAAC,iBAAiB,CAAW;KAC3E,CAAC;IAEF,yCAAyC;IACzC,MAAM,UAAU,GAAa,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAW,CAAC,CAAC;IAE5F,mBAAmB;IACnB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC7B,aAAa,EAAE,OAAO;QACtB,wBAAwB;QACxB,uBAAuB;QACvB,kBAAkB,EAAE,aAAa;QACjC,iBAAiB;QACjB,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;QAChD,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE;YACJ,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU;YAChD,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc;SACzD;KACF,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU;QAClD,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc;QACxD,qBAAqB,EAAE,OAAO,CAAC,qBAA+B;QAC9D,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,gBAA0B,EAC1B,QAKC;IAED,OAAO;QACL,GAAG,gBAAgB;QACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,UAAU,EAAE,QAAQ,CAAC,qBAAqB;QAC1C,WAAW,EAAE,sBAAsB,CAAC,QAAQ,CAAC,WAAW,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAoC;IAEpC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,uBAAuB,CAAC,iBAAiB;YAC5C,OAAO,YAAY,CAAC;QACtB,KAAK,uBAAuB,CAAC,cAAc,CAAC;QAC5C,KAAK,uBAAuB,CAAC,OAAO;YAClC,OAAO,YAAY,CAAC;QACtB;YACE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}
@@ -1,46 +0,0 @@
1
- /**
2
- * Sealed Sender V2 Multi-Recipient Decryption
3
- *
4
- * Implements V2 multi-recipient sealed-sender decryption.
5
- *
6
- * Algorithm:
7
- * 1. Parse version, find my recipient entry by serviceId
8
- * 2. M = apply_agreement_xor(recipient_identity, ephemeral_pub, encrypted_key)
9
- * 3. Verify E_pub matches X25519(derive_private_from_M(M)) - authenticates XOR decryption
10
- * 4. K = HKDF(M, LABEL_K)
11
- * 5. usmc = AES-GCM-SIV.Decrypt(K, nonce=zeros, ciphertext) - authenticated decryption
12
- * 6. Parse certificate from usmc to get sender identity
13
- * 7. Verify auth_tag using identity-to-identity ECDH (binds sender to message)
14
- * 8. Validate sender certificate, return content
15
- *
16
- * IMPORTANT: Auth tag is verified AFTER decryption because it requires sender identity
17
- * from the certificate. This is safe because:
18
- * - AES-GCM-SIV provides authenticated encryption
19
- * - Ephemeral key consistency check authenticates the XOR decryption
20
- * - Auth tag binds the sender's identity to the message
21
- *
22
- */
23
- import type { UnsealV2Options, UnidentifiedSenderMessageContent } from './types.js';
24
- /** Generic error message for all unseal failures */
25
- export {};
26
- /**
27
- * Unseal a V2 multi-recipient Sealed Sender message.
28
- *
29
- * @param options V2 unsealing options
30
- * @returns Decrypted content with validated sender certificate
31
- * @throws Error (generic) if any validation fails
32
- *
33
- * @example
34
- * ```typescript
35
- * const content = await unsealV2({
36
- * sealedMessage: receivedMessage,
37
- * recipientIdentityPrivate: myPrivateKey,
38
- * recipientIdentityPublic: myPublicKey,
39
- * recipientServiceId: 'my-user-id',
40
- * recipientDeviceId: 1,
41
- * trustRoots: [trustRootPublicKey],
42
- * });
43
- * ```
44
- */
45
- export declare function unsealV2(options: UnsealV2Options): Promise<UnidentifiedSenderMessageContent>;
46
- //# sourceMappingURL=decryption-v2.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"decryption-v2.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/decryption-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAgC,EAAqB,MAAM,SAAS,CAAC;AA2BpG,oDAAoD;AACpD,OAAO,EAAE,CAAC;AA6EV;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gCAAgC,CAAC,CAuI3C"}
@@ -1,198 +0,0 @@
1
- /**
2
- * Sealed Sender V2 Multi-Recipient Decryption
3
- *
4
- * Implements V2 multi-recipient sealed-sender decryption.
5
- *
6
- * Algorithm:
7
- * 1. Parse version, find my recipient entry by serviceId
8
- * 2. M = apply_agreement_xor(recipient_identity, ephemeral_pub, encrypted_key)
9
- * 3. Verify E_pub matches X25519(derive_private_from_M(M)) - authenticates XOR decryption
10
- * 4. K = HKDF(M, LABEL_K)
11
- * 5. usmc = AES-GCM-SIV.Decrypt(K, nonce=zeros, ciphertext) - authenticated decryption
12
- * 6. Parse certificate from usmc to get sender identity
13
- * 7. Verify auth_tag using identity-to-identity ECDH (binds sender to message)
14
- * 8. Validate sender certificate, return content
15
- *
16
- * IMPORTANT: Auth tag is verified AFTER decryption because it requires sender identity
17
- * from the certificate. This is safe because:
18
- * - AES-GCM-SIV provides authenticated encryption
19
- * - Ephemeral key consistency check authenticates the XOR decryption
20
- * - Auth tag binds the sender's identity to the message
21
- *
22
- */
23
- import { SEALED_SENDER_V2_UUID_VERSION, SEALED_SENDER_V2_SERVICE_ID_VERSION, isSealedSenderContentType, } from './types.js';
24
- import { deserializeSenderCertificate, validateSenderCertificate } from './certificate.js';
25
- import { deriveEphemeralPrivateFromM, deriveCipherKeyFromM, applyAgreementXor, computeAuthenticationTag, verifyAuthenticationTag, } from './v2-helpers.js';
26
- import { bytesToBase64, base64ToBytes, constantTimeEqual, secureZeroBytes, aesGcmSivDecryptZeroNonce, } from '../../crypto/index.js';
27
- import { decodeVarint } from '../../encoding/proto/primitives.js';
28
- import { x25519 } from '@noble/curves/ed25519.js';
29
- const GENERIC_ERROR = 'Sealed sender verification failed';
30
- /** contentType(1) + certLen varint(1) + msgLen varint(1) + contentHint(1). */
31
- const MIN_ENVELOPE_BYTES = 4;
32
- /**
33
- * Parse decrypted envelope to extract certificate and message.
34
- */
35
- function parseEnvelope(envelope) {
36
- // Smallest well-formed envelope: type, two zero-length varints, hint.
37
- if (envelope.length < MIN_ENVELOPE_BYTES) {
38
- throw new Error(GENERIC_ERROR);
39
- }
40
- // Read content type (1 byte)
41
- const contentType = envelope[0];
42
- if (!isSealedSenderContentType(contentType)) {
43
- throw new Error(GENERIC_ERROR);
44
- }
45
- let offset = 1;
46
- // Read certificate length
47
- const { value: certLen, bytesRead: certLenBytes } = decodeVarint(envelope, offset);
48
- if (certLenBytes === 0) {
49
- throw new Error(GENERIC_ERROR);
50
- }
51
- offset += certLenBytes;
52
- if (offset + certLen > envelope.length) {
53
- throw new Error(GENERIC_ERROR);
54
- }
55
- // Read certificate bytes
56
- const certBytes = envelope.slice(offset, offset + certLen);
57
- offset += certLen;
58
- // Read message length
59
- const { value: msgLen, bytesRead: msgLenBytes } = decodeVarint(envelope, offset);
60
- if (msgLenBytes === 0) {
61
- throw new Error(GENERIC_ERROR);
62
- }
63
- offset += msgLenBytes;
64
- if (offset + msgLen > envelope.length) {
65
- throw new Error(GENERIC_ERROR);
66
- }
67
- // Read message bytes
68
- const message = envelope.slice(offset, offset + msgLen);
69
- offset += msgLen;
70
- // Read content hint. The serializer always writes it, and nothing follows
71
- // it any more, so it is required rather than optional.
72
- if (offset >= envelope.length) {
73
- throw new Error(GENERIC_ERROR);
74
- }
75
- const contentHint = envelope[offset];
76
- offset += 1;
77
- // The envelope is exactly its fields. Trailing bytes would make the format
78
- // non-canonical. Two distinct envelopes parsing to the same content.
79
- if (offset !== envelope.length) {
80
- throw new Error(GENERIC_ERROR);
81
- }
82
- // Deserialize certificate
83
- const certificate = deserializeSenderCertificate(certBytes);
84
- return { certificate, message, contentType, contentHint };
85
- }
86
- /**
87
- * Unseal a V2 multi-recipient Sealed Sender message.
88
- *
89
- * @param options V2 unsealing options
90
- * @returns Decrypted content with validated sender certificate
91
- * @throws Error (generic) if any validation fails
92
- *
93
- * @example
94
- * ```typescript
95
- * const content = await unsealV2({
96
- * sealedMessage: receivedMessage,
97
- * recipientIdentityPrivate: myPrivateKey,
98
- * recipientIdentityPublic: myPublicKey,
99
- * recipientServiceId: 'my-user-id',
100
- * recipientDeviceId: 1,
101
- * trustRoots: [trustRootPublicKey],
102
- * });
103
- * ```
104
- */
105
- export async function unsealV2(options) {
106
- const { sealedMessage, recipientIdentityPrivate, recipientIdentityPublic, recipientServiceId, recipientDeviceId, trustRoots, currentTime, } = options;
107
- // Track sensitive material for secure zeroing
108
- const toZero = [];
109
- // ========================================================================
110
- // Step 1: Validate version and find my recipient entry
111
- // ========================================================================
112
- const version = sealedMessage.version;
113
- if (version !== SEALED_SENDER_V2_UUID_VERSION &&
114
- version !== SEALED_SENDER_V2_SERVICE_ID_VERSION) {
115
- throw new Error(GENERIC_ERROR);
116
- }
117
- // Find my recipient entry
118
- const myRecipient = sealedMessage.recipients.find((r) => r.serviceId === recipientServiceId && r.deviceId === recipientDeviceId);
119
- if (!myRecipient) {
120
- throw new Error(GENERIC_ERROR);
121
- }
122
- try {
123
- const ephemeralPublic = base64ToBytes(sealedMessage.ephemeralPublic);
124
- const encryptedMessageKey = base64ToBytes(myRecipient.encryptedMessageKey);
125
- const receivedAuthTag = base64ToBytes(myRecipient.authenticationTag);
126
- const messageCiphertext = base64ToBytes(sealedMessage.messageCiphertext);
127
- if (ephemeralPublic.length !== 32) {
128
- throw new Error(GENERIC_ERROR);
129
- }
130
- // ========================================================================
131
- // Step 2: Decrypt M using XOR (ephemeral-to-identity ECDH)
132
- // ========================================================================
133
- const M = await applyAgreementXor(recipientIdentityPrivate, ephemeralPublic, ephemeralPublic, // For receiving: both ECDH target and IKM are the ephemeral key
134
- 'receiving', encryptedMessageKey);
135
- toZero.push(M);
136
- // ========================================================================
137
- // Step 3: Verify ephemeral public key consistency
138
- // This authenticates the XOR decryption - if M was wrong, derived key will not match
139
- // ========================================================================
140
- const derivedEphemeralPrivate = await deriveEphemeralPrivateFromM(M);
141
- toZero.push(derivedEphemeralPrivate);
142
- const derivedEphemeralPublic = x25519.getPublicKey(derivedEphemeralPrivate);
143
- if (!constantTimeEqual(ephemeralPublic, derivedEphemeralPublic)) {
144
- throw new Error(GENERIC_ERROR);
145
- }
146
- // ========================================================================
147
- // Step 4: Derive cipher key K from M
148
- // ========================================================================
149
- const cipherKey = await deriveCipherKeyFromM(M);
150
- toZero.push(cipherKey);
151
- // ========================================================================
152
- // Step 5: Decrypt message with AES-GCM-SIV (provides authenticated decryption)
153
- // ========================================================================
154
- let envelope;
155
- try {
156
- envelope = aesGcmSivDecryptZeroNonce(cipherKey, messageCiphertext);
157
- }
158
- catch {
159
- throw new Error(GENERIC_ERROR);
160
- }
161
- // ========================================================================
162
- // Step 6: Parse envelope to get sender certificate
163
- // ========================================================================
164
- const { certificate, message, contentType, contentHint } = parseEnvelope(envelope);
165
- // ========================================================================
166
- // Step 7: Verify authentication tag (identity-to-identity ECDH).
167
- // Now that we have the sender's identity from the certificate, verify the
168
- // auth tag. This binds the sender's identity to the message.
169
- // ========================================================================
170
- const senderIdentityPublic = base64ToBytes(certificate.senderIdentityKey);
171
- const expectedAuthTag = await computeAuthenticationTag(recipientIdentityPrivate, recipientIdentityPublic, senderIdentityPublic, ephemeralPublic, encryptedMessageKey, 'receiving');
172
- if (!verifyAuthenticationTag(expectedAuthTag, receivedAuthTag)) {
173
- throw new Error(GENERIC_ERROR);
174
- }
175
- // ========================================================================
176
- // Step 8: Validate sender certificate
177
- // ========================================================================
178
- await validateSenderCertificate(certificate, trustRoots, currentTime);
179
- // Self-send detection
180
- if (certificate.senderUuid === recipientServiceId &&
181
- certificate.senderDeviceId === recipientDeviceId) {
182
- throw new Error(GENERIC_ERROR);
183
- }
184
- return {
185
- senderCertificate: certificate,
186
- signalProtocolMessage: bytesToBase64(message),
187
- contentHint,
188
- contentType,
189
- };
190
- }
191
- finally {
192
- // Security: Zero all sensitive key material
193
- for (const arr of toZero) {
194
- secureZeroBytes(arr);
195
- }
196
- }
197
- }
198
- //# sourceMappingURL=decryption-v2.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"decryption-v2.js","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/decryption-v2.ts"],"names":[],"mappings":"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"}
@@ -1,56 +0,0 @@
1
- /**
2
- * Sealed Sender V2 Multi-Recipient Encryption
3
- *
4
- * Implements V2 multi-recipient sealed sender based on
5
- * Barbosa & Farshim's randomness reuse technique (IMA 2007).
6
- *
7
- * Key efficiency gain: A single ephemeral key and message ciphertext
8
- * is shared across all recipients, with per-recipient key encapsulation.
9
- *
10
- * Algorithm:
11
- * 1. Generate random M (32 bytes)
12
- * 2. Derive ephemeral keypair E from M via HKDF(LABEL_R)
13
- * 3. Derive symmetric key K from M via HKDF(LABEL_K)
14
- * 4. Encrypt USMC with AES-GCM-SIV(K, nonce=zeros, plaintext=usmc)
15
- * 5. For each recipient i:
16
- * a. ikm = X25519(E_private, recipient_pub[i]) || E_pub || recipient_pub[i]
17
- * b. xor_key = HKDF(ikm, info=LABEL_DH)
18
- * c. encrypted_key[i] = M XOR xor_key
19
- * d. auth_ikm = X25519(sender_identity, recipient_pub[i]) || E_pub || encrypted_key[i] || sender_id_pub || recipient_pub[i]
20
- * e. auth_tag[i] = HKDF(auth_ikm, info=LABEL_DH_S) (16 bytes)
21
- * 6. Return { version, E_pub, recipients[], ciphertext }
22
- *
23
- */
24
- import type { SealMultiRecipientOptions, SealedSenderV2Message } from './types.js';
25
- /** Generic error message for all seal failures */
26
- export {};
27
- /**
28
- * Seal a Signal Protocol message for multiple recipients using V2 format.
29
- *
30
- * Uses randomness reuse (Barbosa & Farshim 2007) for efficiency:
31
- * - Single ephemeral key shared across all recipients
32
- * - Single message ciphertext shared across all recipients
33
- * - Per-recipient key encapsulation via XOR with HKDF-derived key
34
- * - Per-recipient auth tag using identity-to-identity ECDH
35
- *
36
- * @param options Multi-recipient sealing options
37
- * @returns V2 sealed sender message
38
- * @throws Error (generic) if any validation fails
39
- *
40
- * @example
41
- * ```typescript
42
- * const sealed = await sealMultiRecipient({
43
- * senderCertificate: cert,
44
- * senderIdentityPrivate: myPrivateKey,
45
- * senderIdentityPublic: myPublicKey,
46
- * recipients: [
47
- * { serviceId: 'user1', deviceId: 1, registrationId: 12345, identityPublic: user1Pub },
48
- * { serviceId: 'user2', deviceId: 1, registrationId: 23456, identityPublic: user2Pub },
49
- * ],
50
- * signalProtocolMessage: encryptedMessage,
51
- * });
52
- * ```
53
- */
54
- export declare function sealMultiRecipient(options: SealMultiRecipientOptions): Promise<SealedSenderV2Message>;
55
- export { deriveEphemeralFromM, deriveCipherKeyFromM, applyAgreementXor, computeAuthenticationTag, } from './v2-helpers.js';
56
- //# sourceMappingURL=encryption-v2.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"encryption-v2.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/encryption-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAuBjB,kDAAkD;AAClD,OAAO,EAAE,CAAC;AAkCV;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CA0HhC;AAGD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}