@open-e2ee/signal-protocol-sdk 11.0.0 → 12.0.1

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 (590) hide show
  1. package/ADAPTERS.md +4 -4
  2. package/ARCHITECTURE.md +6 -8
  3. package/CHANGELOG.md +1348 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +8 -8
  7. package/client/README.md +70 -37
  8. package/device/README.md +39 -85
  9. package/dist/client/client.d.ts +334 -63
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +1175 -186
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/config.d.ts +57 -42
  14. package/dist/client/config.d.ts.map +1 -1
  15. package/dist/client/config.js +1 -1
  16. package/dist/client/config.js.map +1 -1
  17. package/dist/client/constants.d.ts +42 -8
  18. package/dist/client/constants.d.ts.map +1 -1
  19. package/dist/client/constants.js +48 -3
  20. package/dist/client/constants.js.map +1 -1
  21. package/dist/client/content-adapter.d.ts +80 -0
  22. package/dist/client/content-adapter.d.ts.map +1 -1
  23. package/dist/client/content-adapter.js +225 -12
  24. package/dist/client/content-adapter.js.map +1 -1
  25. package/dist/client/delivery-error.d.ts +150 -0
  26. package/dist/client/delivery-error.d.ts.map +1 -0
  27. package/dist/client/delivery-error.js +226 -0
  28. package/dist/client/delivery-error.js.map +1 -0
  29. package/dist/client/delivery-status.d.ts +32 -6
  30. package/dist/client/delivery-status.d.ts.map +1 -1
  31. package/dist/client/delivery-status.js +61 -13
  32. package/dist/client/delivery-status.js.map +1 -1
  33. package/dist/client/device-set-reconciliation.d.ts +196 -0
  34. package/dist/client/device-set-reconciliation.d.ts.map +1 -0
  35. package/dist/client/device-set-reconciliation.js +282 -0
  36. package/dist/client/device-set-reconciliation.js.map +1 -0
  37. package/dist/client/distribution-records.d.ts +29 -0
  38. package/dist/client/distribution-records.d.ts.map +1 -0
  39. package/dist/client/distribution-records.js +33 -0
  40. package/dist/client/distribution-records.js.map +1 -0
  41. package/dist/client/event-hooks.d.ts +280 -14
  42. package/dist/client/event-hooks.d.ts.map +1 -1
  43. package/dist/client/event-hooks.js +8 -0
  44. package/dist/client/event-hooks.js.map +1 -1
  45. package/dist/client/group-device-set.d.ts +47 -0
  46. package/dist/client/group-device-set.d.ts.map +1 -0
  47. package/dist/client/group-device-set.js +65 -0
  48. package/dist/client/group-device-set.js.map +1 -0
  49. package/dist/client/group-fetcher.d.ts +116 -0
  50. package/dist/client/group-fetcher.d.ts.map +1 -0
  51. package/dist/client/group-fetcher.js +598 -0
  52. package/dist/client/group-fetcher.js.map +1 -0
  53. package/dist/client/group-outbox.d.ts +172 -10
  54. package/dist/client/group-outbox.d.ts.map +1 -1
  55. package/dist/client/group-outbox.js +915 -74
  56. package/dist/client/group-outbox.js.map +1 -1
  57. package/dist/client/group-receive-authorization.d.ts +127 -4
  58. package/dist/client/group-receive-authorization.d.ts.map +1 -1
  59. package/dist/client/group-receive-authorization.js +270 -20
  60. package/dist/client/group-receive-authorization.js.map +1 -1
  61. package/dist/client/group-sealed-sender.d.ts +3 -0
  62. package/dist/client/group-sealed-sender.d.ts.map +1 -1
  63. package/dist/client/group-sealed-sender.js +1 -0
  64. package/dist/client/group-sealed-sender.js.map +1 -1
  65. package/dist/client/group-sender-key-operations.d.ts +14 -3
  66. package/dist/client/group-sender-key-operations.d.ts.map +1 -1
  67. package/dist/client/group-sender-key-operations.js +26 -5
  68. package/dist/client/group-sender-key-operations.js.map +1 -1
  69. package/dist/client/groups.d.ts +5 -5
  70. package/dist/client/groups.d.ts.map +1 -1
  71. package/dist/client/groups.js +5 -4
  72. package/dist/client/groups.js.map +1 -1
  73. package/dist/client/hosted-anonymous-delivery.d.ts +61 -9
  74. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  75. package/dist/client/hosted-anonymous-delivery.js +242 -48
  76. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  77. package/dist/client/hosted-assertion-id.d.ts +7 -0
  78. package/dist/client/hosted-assertion-id.d.ts.map +1 -0
  79. package/dist/client/hosted-assertion-id.js +51 -0
  80. package/dist/client/hosted-assertion-id.js.map +1 -0
  81. package/dist/client/hosted-mailbox-subscription.d.ts +34 -2
  82. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  83. package/dist/client/hosted-mailbox-subscription.js +87 -17
  84. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  85. package/dist/client/hosted-push.d.ts +22 -4
  86. package/dist/client/hosted-push.d.ts.map +1 -1
  87. package/dist/client/hosted-push.js +75 -22
  88. package/dist/client/hosted-push.js.map +1 -1
  89. package/dist/client/hosted-transport.d.ts +22 -28
  90. package/dist/client/hosted-transport.d.ts.map +1 -1
  91. package/dist/client/hosted-transport.js +115 -55
  92. package/dist/client/hosted-transport.js.map +1 -1
  93. package/dist/client/hosted.d.ts +10 -4
  94. package/dist/client/hosted.d.ts.map +1 -1
  95. package/dist/client/hosted.js +10 -4
  96. package/dist/client/hosted.js.map +1 -1
  97. package/dist/client/index.d.ts +5 -3
  98. package/dist/client/index.d.ts.map +1 -1
  99. package/dist/client/index.js +2 -0
  100. package/dist/client/index.js.map +1 -1
  101. package/dist/client/messages.d.ts +25 -3
  102. package/dist/client/messages.d.ts.map +1 -1
  103. package/dist/client/messages.js +111 -20
  104. package/dist/client/messages.js.map +1 -1
  105. package/dist/client/receive-admission.d.ts +58 -0
  106. package/dist/client/receive-admission.d.ts.map +1 -0
  107. package/dist/client/receive-admission.js +78 -0
  108. package/dist/client/receive-admission.js.map +1 -0
  109. package/dist/client/receive-expiry.d.ts +31 -0
  110. package/dist/client/receive-expiry.d.ts.map +1 -0
  111. package/dist/client/receive-expiry.js +35 -0
  112. package/dist/client/receive-expiry.js.map +1 -0
  113. package/dist/client/receive-hook-bound.d.ts +50 -0
  114. package/dist/client/receive-hook-bound.d.ts.map +1 -0
  115. package/dist/client/receive-hook-bound.js +115 -0
  116. package/dist/client/receive-hook-bound.js.map +1 -0
  117. package/dist/client/receive-queue.d.ts +299 -0
  118. package/dist/client/receive-queue.d.ts.map +1 -0
  119. package/dist/client/receive-queue.js +1420 -0
  120. package/dist/client/receive-queue.js.map +1 -0
  121. package/dist/client/receive-work-seed.d.ts +54 -0
  122. package/dist/client/receive-work-seed.d.ts.map +1 -0
  123. package/dist/client/receive-work-seed.js +116 -0
  124. package/dist/client/receive-work-seed.js.map +1 -0
  125. package/dist/client/recovery-driver.d.ts +25 -0
  126. package/dist/client/recovery-driver.d.ts.map +1 -0
  127. package/dist/client/recovery-driver.js +121 -0
  128. package/dist/client/recovery-driver.js.map +1 -0
  129. package/dist/client/relay-acceptance.d.ts +20 -7
  130. package/dist/client/relay-acceptance.d.ts.map +1 -1
  131. package/dist/client/relay-acceptance.js +30 -12
  132. package/dist/client/relay-acceptance.js.map +1 -1
  133. package/dist/client/relay-device-refusal.d.ts +18 -0
  134. package/dist/client/relay-device-refusal.d.ts.map +1 -1
  135. package/dist/client/relay-device-refusal.js +31 -0
  136. package/dist/client/relay-device-refusal.js.map +1 -1
  137. package/dist/client/relay-sealed-route.d.ts +36 -0
  138. package/dist/client/relay-sealed-route.d.ts.map +1 -0
  139. package/dist/client/relay-sealed-route.js +45 -0
  140. package/dist/client/relay-sealed-route.js.map +1 -0
  141. package/dist/client/relay-subscription.d.ts +56 -13
  142. package/dist/client/relay-subscription.d.ts.map +1 -1
  143. package/dist/client/relay-subscription.js +193 -123
  144. package/dist/client/relay-subscription.js.map +1 -1
  145. package/dist/client/resendable-content.d.ts +98 -0
  146. package/dist/client/resendable-content.d.ts.map +1 -0
  147. package/dist/client/resendable-content.js +136 -0
  148. package/dist/client/resendable-content.js.map +1 -0
  149. package/dist/client/retry-family.d.ts +57 -10
  150. package/dist/client/retry-family.d.ts.map +1 -1
  151. package/dist/client/retry-family.js +54 -12
  152. package/dist/client/retry-family.js.map +1 -1
  153. package/dist/client/retry-request-envelope.d.ts +107 -8
  154. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  155. package/dist/client/retry-request-envelope.js +172 -23
  156. package/dist/client/retry-request-envelope.js.map +1 -1
  157. package/dist/client/retry-request-lifecycle.d.ts +70 -14
  158. package/dist/client/retry-request-lifecycle.d.ts.map +1 -1
  159. package/dist/client/retry-request-lifecycle.js +162 -32
  160. package/dist/client/retry-request-lifecycle.js.map +1 -1
  161. package/dist/client/retry-terminal-recovery.d.ts +100 -0
  162. package/dist/client/retry-terminal-recovery.d.ts.map +1 -0
  163. package/dist/client/retry-terminal-recovery.js +164 -0
  164. package/dist/client/retry-terminal-recovery.js.map +1 -0
  165. package/dist/client/retry-utils.d.ts +27 -0
  166. package/dist/client/retry-utils.d.ts.map +1 -1
  167. package/dist/client/retry-utils.js +46 -0
  168. package/dist/client/retry-utils.js.map +1 -1
  169. package/dist/client/retry.d.ts +100 -12
  170. package/dist/client/retry.d.ts.map +1 -1
  171. package/dist/client/retry.js +619 -116
  172. package/dist/client/retry.js.map +1 -1
  173. package/dist/client/sealed-sender.d.ts +23 -6
  174. package/dist/client/sealed-sender.d.ts.map +1 -1
  175. package/dist/client/sealed-sender.js +30 -6
  176. package/dist/client/sealed-sender.js.map +1 -1
  177. package/dist/client/sessions.d.ts +2 -2
  178. package/dist/client/sessions.js +2 -2
  179. package/dist/client/signal-service-cipher.d.ts +726 -19
  180. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  181. package/dist/client/signal-service-cipher.js +2260 -342
  182. package/dist/client/signal-service-cipher.js.map +1 -1
  183. package/dist/client/state.d.ts +5 -0
  184. package/dist/client/state.d.ts.map +1 -1
  185. package/dist/client/state.js +11 -1
  186. package/dist/client/state.js.map +1 -1
  187. package/dist/client/storage-protection.d.ts +64 -0
  188. package/dist/client/storage-protection.d.ts.map +1 -0
  189. package/dist/client/storage-protection.js +150 -0
  190. package/dist/client/storage-protection.js.map +1 -0
  191. package/dist/client/types.d.ts +149 -15
  192. package/dist/client/types.d.ts.map +1 -1
  193. package/dist/client/types.js +1 -1
  194. package/dist/client/types.js.map +1 -1
  195. package/dist/device/constants.d.ts +0 -5
  196. package/dist/device/constants.d.ts.map +1 -1
  197. package/dist/device/constants.js +0 -5
  198. package/dist/device/constants.js.map +1 -1
  199. package/dist/device/expo/index.d.ts +4 -17
  200. package/dist/device/expo/index.d.ts.map +1 -1
  201. package/dist/device/expo/index.js +4 -23
  202. package/dist/device/expo/index.js.map +1 -1
  203. package/dist/device/index.d.ts +0 -2
  204. package/dist/device/index.d.ts.map +1 -1
  205. package/dist/device/index.js +0 -7
  206. package/dist/device/index.js.map +1 -1
  207. package/dist/device/lifecycle/manager.d.ts +5 -4
  208. package/dist/device/lifecycle/manager.d.ts.map +1 -1
  209. package/dist/device/lifecycle/manager.js +16 -16
  210. package/dist/device/lifecycle/manager.js.map +1 -1
  211. package/dist/device/lifecycle/types.d.ts +2 -2
  212. package/dist/device/lifecycle/types.d.ts.map +1 -1
  213. package/dist/device/react-native/index.d.ts +4 -15
  214. package/dist/device/react-native/index.d.ts.map +1 -1
  215. package/dist/device/react-native/index.js +4 -21
  216. package/dist/device/react-native/index.js.map +1 -1
  217. package/dist/device/types.d.ts +1 -1
  218. package/dist/groups/index.d.ts +1 -1
  219. package/dist/groups/index.d.ts.map +1 -1
  220. package/dist/index.d.ts +8 -6
  221. package/dist/index.d.ts.map +1 -1
  222. package/dist/index.js +2 -1
  223. package/dist/index.js.map +1 -1
  224. package/dist/internal/crypto/ec/x25519-validation.d.ts +0 -1
  225. package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
  226. package/dist/internal/crypto/ec/x25519-validation.js +0 -1
  227. package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
  228. package/dist/internal/crypto/validation.d.ts +2 -2
  229. package/dist/internal/groups/index.d.ts +1 -0
  230. package/dist/internal/groups/index.d.ts.map +1 -1
  231. package/dist/internal/groups/index.js +1 -0
  232. package/dist/internal/groups/index.js.map +1 -1
  233. package/dist/internal/groups/manager.d.ts +37 -16
  234. package/dist/internal/groups/manager.d.ts.map +1 -1
  235. package/dist/internal/groups/manager.js +46 -1
  236. package/dist/internal/groups/manager.js.map +1 -1
  237. package/dist/internal/groups/receive-record.d.ts +78 -0
  238. package/dist/internal/groups/receive-record.d.ts.map +1 -0
  239. package/dist/internal/groups/receive-record.js +43 -0
  240. package/dist/internal/groups/receive-record.js.map +1 -0
  241. package/dist/internal/groups/sdk-store.d.ts +27 -3
  242. package/dist/internal/groups/sdk-store.d.ts.map +1 -1
  243. package/dist/internal/groups/sdk-store.js +151 -19
  244. package/dist/internal/groups/sdk-store.js.map +1 -1
  245. package/dist/internal/groups/wire.d.ts +12 -1
  246. package/dist/internal/groups/wire.d.ts.map +1 -1
  247. package/dist/internal/groups/wire.js +36 -0
  248. package/dist/internal/groups/wire.js.map +1 -1
  249. package/dist/internal/manager/index.d.ts +1 -1
  250. package/dist/internal/manager/manager.d.ts +26 -20
  251. package/dist/internal/manager/manager.d.ts.map +1 -1
  252. package/dist/internal/manager/manager.js +64 -41
  253. package/dist/internal/manager/manager.js.map +1 -1
  254. package/dist/internal/protocol/double-ratchet/chains.d.ts +4 -18
  255. package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
  256. package/dist/internal/protocol/double-ratchet/chains.js +23 -74
  257. package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
  258. package/dist/internal/protocol/double-ratchet/index.d.ts +1 -1
  259. package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -1
  260. package/dist/internal/protocol/double-ratchet/index.js +1 -1
  261. package/dist/internal/protocol/double-ratchet/index.js.map +1 -1
  262. package/dist/internal/protocol/double-ratchet/ratchet.d.ts +5 -7
  263. package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
  264. package/dist/internal/protocol/double-ratchet/ratchet.js +4 -6
  265. package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
  266. package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
  267. package/dist/internal/protocol/pqxdh/pqxdh.js +2 -1
  268. package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
  269. package/dist/internal/protocol/sealed-sender/types.d.ts +6 -8
  270. package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
  271. package/dist/internal/protocol/sealed-sender/types.js +8 -9
  272. package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
  273. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts +110 -0
  274. package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts.map +1 -0
  275. package/dist/internal/protocol/sender-keys/handoff-ledger.js +124 -0
  276. package/dist/internal/protocol/sender-keys/handoff-ledger.js.map +1 -0
  277. package/dist/internal/protocol/sender-keys/manager.d.ts +71 -62
  278. package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
  279. package/dist/internal/protocol/sender-keys/manager.js +228 -175
  280. package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
  281. package/dist/internal/protocol/spqr/index.d.ts +2 -2
  282. package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
  283. package/dist/internal/protocol/spqr/index.js +2 -2
  284. package/dist/internal/protocol/spqr/index.js.map +1 -1
  285. package/dist/internal/protocol/spqr/serialize.d.ts +9 -1
  286. package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
  287. package/dist/internal/protocol/spqr/serialize.js +56 -16
  288. package/dist/internal/protocol/spqr/serialize.js.map +1 -1
  289. package/dist/internal/protocol/spqr/spqr.d.ts +1 -14
  290. package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
  291. package/dist/internal/protocol/spqr/spqr.js +54 -42
  292. package/dist/internal/protocol/spqr/spqr.js.map +1 -1
  293. package/dist/internal/protocol/spqr/validate.d.ts +26 -6
  294. package/dist/internal/protocol/spqr/validate.d.ts.map +1 -1
  295. package/dist/internal/protocol/spqr/validate.js +49 -21
  296. package/dist/internal/protocol/spqr/validate.js.map +1 -1
  297. package/dist/internal/sesame/index.d.ts +1 -1
  298. package/dist/internal/sesame/index.d.ts.map +1 -1
  299. package/dist/internal/sesame/index.js.map +1 -1
  300. package/dist/internal/sesame/manager.d.ts +66 -13
  301. package/dist/internal/sesame/manager.d.ts.map +1 -1
  302. package/dist/internal/sesame/manager.js +221 -87
  303. package/dist/internal/sesame/manager.js.map +1 -1
  304. package/dist/internal/sesame/types.d.ts +95 -17
  305. package/dist/internal/sesame/types.d.ts.map +1 -1
  306. package/dist/internal/sesame/types.js +17 -0
  307. package/dist/internal/sesame/types.js.map +1 -1
  308. package/dist/internal/session/builder.d.ts +5 -5
  309. package/dist/internal/session/builder.d.ts.map +1 -1
  310. package/dist/internal/session/builder.js +12 -17
  311. package/dist/internal/session/builder.js.map +1 -1
  312. package/dist/internal/session/cipher.d.ts +15 -13
  313. package/dist/internal/session/cipher.d.ts.map +1 -1
  314. package/dist/internal/session/cipher.js +41 -23
  315. package/dist/internal/session/cipher.js.map +1 -1
  316. package/dist/internal/session/factory.d.ts +5 -5
  317. package/dist/internal/session/factory.d.ts.map +1 -1
  318. package/dist/internal/session/factory.js +4 -4
  319. package/dist/internal/session/factory.js.map +1 -1
  320. package/dist/internal/session/handshake.d.ts +14 -16
  321. package/dist/internal/session/handshake.d.ts.map +1 -1
  322. package/dist/internal/session/handshake.js +18 -75
  323. package/dist/internal/session/handshake.js.map +1 -1
  324. package/dist/internal/session/index.d.ts +1 -1
  325. package/dist/internal/session/index.js +1 -1
  326. package/dist/internal/session/record-locks.d.ts +17 -6
  327. package/dist/internal/session/record-locks.d.ts.map +1 -1
  328. package/dist/internal/session/record-locks.js +43 -7
  329. package/dist/internal/session/record-locks.js.map +1 -1
  330. package/dist/internal/session/session-resolver.d.ts +1 -1
  331. package/dist/internal/session/session-resolver.js +1 -1
  332. package/dist/internal/session/state.d.ts +2 -2
  333. package/dist/internal/session/state.js +1 -1
  334. package/dist/internal/session/types.d.ts +5 -13
  335. package/dist/internal/session/types.d.ts.map +1 -1
  336. package/dist/internal/session/types.js +1 -1
  337. package/dist/keys/generation.d.ts +2 -2
  338. package/dist/keys/generation.js +2 -2
  339. package/dist/keys/types.d.ts +5 -5
  340. package/dist/keys/types.d.ts.map +1 -1
  341. package/dist/keys/types.js +1 -1
  342. package/dist/layers.d.ts +1 -1
  343. package/dist/layers.js +2 -2
  344. package/dist/layers.js.map +1 -1
  345. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  346. package/dist/local/store/expo/adapter.js +12 -8
  347. package/dist/local/store/expo/adapter.js.map +1 -1
  348. package/dist/local/store/key-value/adapter.d.ts +76 -10
  349. package/dist/local/store/key-value/adapter.d.ts.map +1 -1
  350. package/dist/local/store/key-value/adapter.js +367 -61
  351. package/dist/local/store/key-value/adapter.js.map +1 -1
  352. package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
  353. package/dist/local/store/key-value/backend-conformance.js +74 -0
  354. package/dist/local/store/key-value/backend-conformance.js.map +1 -1
  355. package/dist/local/store/key-value/batch.d.ts +2 -0
  356. package/dist/local/store/key-value/batch.d.ts.map +1 -1
  357. package/dist/local/store/key-value/batch.js +26 -0
  358. package/dist/local/store/key-value/batch.js.map +1 -1
  359. package/dist/local/store/key-value/receive-work.d.ts +55 -0
  360. package/dist/local/store/key-value/receive-work.d.ts.map +1 -0
  361. package/dist/local/store/key-value/receive-work.js +162 -0
  362. package/dist/local/store/key-value/receive-work.js.map +1 -0
  363. package/dist/local/store/key-value/send-log.d.ts +61 -0
  364. package/dist/local/store/key-value/send-log.d.ts.map +1 -0
  365. package/dist/local/store/key-value/send-log.js +430 -0
  366. package/dist/local/store/key-value/send-log.js.map +1 -0
  367. package/dist/local/store/key-value/sender-key-handoff.d.ts +68 -0
  368. package/dist/local/store/key-value/sender-key-handoff.d.ts.map +1 -0
  369. package/dist/local/store/key-value/sender-key-handoff.js +189 -0
  370. package/dist/local/store/key-value/sender-key-handoff.js.map +1 -0
  371. package/dist/local/store/key-value/storage.d.ts +15 -0
  372. package/dist/local/store/key-value/storage.d.ts.map +1 -1
  373. package/dist/local/store/keyed-index.d.ts +23 -0
  374. package/dist/local/store/keyed-index.d.ts.map +1 -0
  375. package/dist/local/store/keyed-index.js +41 -0
  376. package/dist/local/store/keyed-index.js.map +1 -0
  377. package/dist/local/store/memory/adapter.d.ts +44 -12
  378. package/dist/local/store/memory/adapter.d.ts.map +1 -1
  379. package/dist/local/store/memory/adapter.js +197 -46
  380. package/dist/local/store/memory/adapter.js.map +1 -1
  381. package/dist/local/store/memory/send-log.d.ts +42 -0
  382. package/dist/local/store/memory/send-log.d.ts.map +1 -0
  383. package/dist/local/store/memory/send-log.js +190 -0
  384. package/dist/local/store/memory/send-log.js.map +1 -0
  385. package/dist/local/store/node/adapter.d.ts.map +1 -1
  386. package/dist/local/store/node/adapter.js +8 -6
  387. package/dist/local/store/node/adapter.js.map +1 -1
  388. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  389. package/dist/local/store/react-native/adapter.js +12 -8
  390. package/dist/local/store/react-native/adapter.js.map +1 -1
  391. package/dist/local/store/receive-work.d.ts +87 -0
  392. package/dist/local/store/receive-work.d.ts.map +1 -0
  393. package/dist/local/store/receive-work.js +204 -0
  394. package/dist/local/store/receive-work.js.map +1 -0
  395. package/dist/local/store/received-content.d.ts +3 -3
  396. package/dist/local/store/received-content.d.ts.map +1 -1
  397. package/dist/local/store/received-content.js +2 -11
  398. package/dist/local/store/received-content.js.map +1 -1
  399. package/dist/local/store/reliability.d.ts +317 -18
  400. package/dist/local/store/reliability.d.ts.map +1 -1
  401. package/dist/local/store/reliability.js +371 -46
  402. package/dist/local/store/reliability.js.map +1 -1
  403. package/dist/local/store/send-log-order.d.ts +15 -0
  404. package/dist/local/store/send-log-order.d.ts.map +1 -0
  405. package/dist/local/store/send-log-order.js +24 -0
  406. package/dist/local/store/send-log-order.js.map +1 -0
  407. package/dist/local/store/sender-key-handoff-index.d.ts +38 -0
  408. package/dist/local/store/sender-key-handoff-index.d.ts.map +1 -0
  409. package/dist/local/store/sender-key-handoff-index.js +101 -0
  410. package/dist/local/store/sender-key-handoff-index.js.map +1 -0
  411. package/dist/local/store/sender-key-handoff-table.d.ts +29 -0
  412. package/dist/local/store/sender-key-handoff-table.d.ts.map +1 -0
  413. package/dist/local/store/sender-key-handoff-table.js +97 -0
  414. package/dist/local/store/sender-key-handoff-table.js.map +1 -0
  415. package/dist/local/store/sqlite/driver.d.ts +9 -0
  416. package/dist/local/store/sqlite/driver.d.ts.map +1 -1
  417. package/dist/local/store/sqlite/encryption.d.ts +8 -1
  418. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  419. package/dist/local/store/sqlite/encryption.js +9 -0
  420. package/dist/local/store/sqlite/encryption.js.map +1 -1
  421. package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
  422. package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
  423. package/dist/local/store/sqlite/key-storage/index.js +68 -7
  424. package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
  425. package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
  426. package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
  427. package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
  428. package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
  429. package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
  430. package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
  431. package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
  432. package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
  433. package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
  434. package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
  435. package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
  436. package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
  437. package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
  438. package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
  439. package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
  440. package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
  441. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
  442. package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
  443. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
  444. package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
  445. package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
  446. package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
  447. package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
  448. package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
  449. package/dist/local/store/sqlite/migrations.js +101 -0
  450. package/dist/local/store/sqlite/migrations.js.map +1 -1
  451. package/dist/local/store/sqlite/models/index.d.ts +2 -1
  452. package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
  453. package/dist/local/store/sqlite/models/index.js +5 -1
  454. package/dist/local/store/sqlite/models/index.js.map +1 -1
  455. package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
  456. package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
  457. package/dist/local/store/sqlite/models/message-record.js +24 -0
  458. package/dist/local/store/sqlite/models/message-record.js.map +1 -1
  459. package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
  460. package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
  461. package/dist/local/store/sqlite/models/send-log.js +206 -0
  462. package/dist/local/store/sqlite/models/send-log.js.map +1 -0
  463. package/dist/local/store/sqlite/open-store.d.ts +9 -1
  464. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  465. package/dist/local/store/sqlite/open-store.js +20 -1
  466. package/dist/local/store/sqlite/open-store.js.map +1 -1
  467. package/dist/local/store/sqlite/schema.d.ts +34 -1
  468. package/dist/local/store/sqlite/schema.d.ts.map +1 -1
  469. package/dist/local/store/sqlite/schema.js +14 -0
  470. package/dist/local/store/sqlite/schema.js.map +1 -1
  471. package/dist/local/store/sqlite/store.d.ts +61 -11
  472. package/dist/local/store/sqlite/store.d.ts.map +1 -1
  473. package/dist/local/store/sqlite/store.js +191 -27
  474. package/dist/local/store/sqlite/store.js.map +1 -1
  475. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +2 -1
  476. package/dist/local/store/sqlite/web/worker.d.ts +8 -0
  477. package/dist/local/store/sqlite/web/worker.d.ts.map +1 -1
  478. package/dist/local/store/sqlite/web/worker.js +64 -2
  479. package/dist/local/store/sqlite/web/worker.js.map +1 -1
  480. package/dist/local/store/web/adapter.d.ts +76 -8
  481. package/dist/local/store/web/adapter.d.ts.map +1 -1
  482. package/dist/local/store/web/adapter.js +579 -127
  483. package/dist/local/store/web/adapter.js.map +1 -1
  484. package/dist/local/store/web/receive-work.d.ts +57 -0
  485. package/dist/local/store/web/receive-work.d.ts.map +1 -0
  486. package/dist/local/store/web/receive-work.js +99 -0
  487. package/dist/local/store/web/receive-work.js.map +1 -0
  488. package/dist/local/store/web/send-log.d.ts +92 -0
  489. package/dist/local/store/web/send-log.d.ts.map +1 -0
  490. package/dist/local/store/web/send-log.js +267 -0
  491. package/dist/local/store/web/send-log.js.map +1 -0
  492. package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
  493. package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
  494. package/dist/local/store/web/sender-key-handoff.js +156 -0
  495. package/dist/local/store/web/sender-key-handoff.js.map +1 -0
  496. package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
  497. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  498. package/dist/local/store/web-sqlite/adapter.js +12 -6
  499. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  500. package/dist/local/vault/custody.d.ts +8 -0
  501. package/dist/local/vault/custody.d.ts.map +1 -0
  502. package/dist/local/vault/custody.js +9 -0
  503. package/dist/local/vault/custody.js.map +1 -0
  504. package/dist/local/vault/electron-safe-storage.d.ts +3 -1
  505. package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
  506. package/dist/local/vault/electron-safe-storage.js +2 -0
  507. package/dist/local/vault/electron-safe-storage.js.map +1 -1
  508. package/dist/local/vault/expo-secure-store.d.ts +3 -1
  509. package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
  510. package/dist/local/vault/expo-secure-store.js +2 -0
  511. package/dist/local/vault/expo-secure-store.js.map +1 -1
  512. package/dist/local/vault/indexed-db.d.ts +3 -1
  513. package/dist/local/vault/indexed-db.d.ts.map +1 -1
  514. package/dist/local/vault/indexed-db.js +2 -0
  515. package/dist/local/vault/indexed-db.js.map +1 -1
  516. package/dist/local/vault/react-native-keychain.d.ts +3 -1
  517. package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
  518. package/dist/local/vault/react-native-keychain.js +2 -0
  519. package/dist/local/vault/react-native-keychain.js.map +1 -1
  520. package/dist/remote/relay/device-set.d.ts +94 -0
  521. package/dist/remote/relay/device-set.d.ts.map +1 -0
  522. package/dist/remote/relay/device-set.js +156 -0
  523. package/dist/remote/relay/device-set.js.map +1 -0
  524. package/dist/remote/relay/types.d.ts +92 -107
  525. package/dist/remote/relay/types.d.ts.map +1 -1
  526. package/dist/safety/core.d.ts +15 -6
  527. package/dist/safety/core.d.ts.map +1 -1
  528. package/dist/safety/core.js +41 -27
  529. package/dist/safety/core.js.map +1 -1
  530. package/dist/safety/index.d.ts +2 -1
  531. package/dist/safety/index.d.ts.map +1 -1
  532. package/dist/safety/index.js +12 -18
  533. package/dist/safety/index.js.map +1 -1
  534. package/dist/types/api.d.ts +707 -62
  535. package/dist/types/api.d.ts.map +1 -1
  536. package/dist/types/errors.d.ts +14 -33
  537. package/dist/types/errors.d.ts.map +1 -1
  538. package/dist/types/errors.js +14 -24
  539. package/dist/types/errors.js.map +1 -1
  540. package/dist/types/messages.d.ts +2 -2
  541. package/dist/types/messages.js +1 -1
  542. package/dist/types/protocol-config.d.ts +175 -42
  543. package/dist/types/protocol-config.d.ts.map +1 -1
  544. package/dist/types/protocol-config.js +19 -38
  545. package/dist/types/protocol-config.js.map +1 -1
  546. package/dist/types/protocol-constants.d.ts +6 -6
  547. package/dist/types/protocol-constants.js +6 -6
  548. package/dist/types/session.d.ts +7 -7
  549. package/dist/types/session.d.ts.map +1 -1
  550. package/dist/types/session.js +39 -21
  551. package/dist/types/session.js.map +1 -1
  552. package/dist/username/link.d.ts +2 -2
  553. package/dist/username/link.js +2 -2
  554. package/dist/utils/origin-lock.d.ts +45 -0
  555. package/dist/utils/origin-lock.d.ts.map +1 -0
  556. package/dist/utils/origin-lock.js +80 -0
  557. package/dist/utils/origin-lock.js.map +1 -0
  558. package/docs/ASSURANCE.md +6 -6
  559. package/docs/CLIENT_COMPOSITION.md +2 -2
  560. package/docs/DEVIATIONS.md +677 -182
  561. package/docs/E2EE.md +1 -1
  562. package/docs/ERROR_HANDLING.md +165 -2
  563. package/docs/GETTING_STARTED.md +7 -4
  564. package/docs/INTERFACES.md +1 -1
  565. package/docs/PACKAGE_SURFACE.md +6 -5
  566. package/docs/PROTOCOL_POLICY.md +102 -22
  567. package/docs/RECIPES.md +3 -15
  568. package/docs/SECURITY.md +90 -5
  569. package/keys/README.md +3 -3
  570. package/local/store/README.md +78 -14
  571. package/local/store/key-value/README.md +14 -3
  572. package/local/store/node/README.md +8 -3
  573. package/local/store/web/README.md +9 -0
  574. package/local/store/web-sqlite/README.md +14 -2
  575. package/local/vault/README.md +21 -0
  576. package/package.json +1 -6
  577. package/remote/README.md +0 -1
  578. package/remote/relay/README.md +2 -2
  579. package/dist/device/provisioning.d.ts +0 -242
  580. package/dist/device/provisioning.d.ts.map +0 -1
  581. package/dist/device/provisioning.js +0 -421
  582. package/dist/device/provisioning.js.map +0 -1
  583. package/dist/internal/protocol/x3dh/index.d.ts +0 -15
  584. package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
  585. package/dist/internal/protocol/x3dh/index.js +0 -13
  586. package/dist/internal/protocol/x3dh/index.js.map +0 -1
  587. package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
  588. package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
  589. package/dist/internal/protocol/x3dh/x3dh.js +0 -261
  590. package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
@@ -1,261 +0,0 @@
1
- /**
2
- * X3DH (Extended Triple Diffie-Hellman) Key Agreement
3
- *
4
- * Implements the X3DH key agreement protocol for establishing shared secrets
5
- * between two parties. X3DH provides mutual authentication and forward secrecy.
6
- *
7
- * X3DH runs 3-4 ECDH operations:
8
- * - DH1: Initiator's identity key × Responder's signed prekey
9
- * - DH2: Initiator's ephemeral key × Responder's identity key
10
- * - DH3: Initiator's ephemeral key × Responder's signed prekey
11
- * - DH4: Initiator's ephemeral key × Responder's one-time prekey (if available)
12
- *
13
- * @see https://signal.org/docs/specifications/x3dh/
14
- */
15
- import { defaultSignalProtocolLogger } from '../../../logger.js';
16
- import { generateECDHKeyPair, computeSharedSecret, concatBytes, stringToBytes, hkdf, secureZeroBytes, validateX25519PublicKey } from '../../crypto/index.js';
17
- import { PREKEY_ALGORITHM_X25519, verifyPreKeySignature } from '../../../keys/prekey-signature.js';
18
- // ============================================================================
19
- // FUNCTIONS
20
- // ============================================================================
21
- /**
22
- * Run the X3DH key agreement as initiator (Alice)
23
- *
24
- * The caller invokes this when Alice wants to establish a session with Bob.
25
- * Alice uses Bob's prekey bundle for the key agreement.
26
- *
27
- * @param myIdentityKey My identity key pair
28
- * @param theirBundle Partner's prekey bundle
29
- * @param infoString HKDF info string for key derivation
30
- * @returns X3DH result containing shared secret and metadata
31
- *
32
- * @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
33
- */
34
- export async function performX3DH(myIdentityKey, theirBundle, infoString, logger = defaultSignalProtocolLogger) {
35
- logger.breadcrumb('X3DH initiator key agreement', {
36
- category: 'E2EE',
37
- level: 'info',
38
- data: { operation: 'x3dh', role: 'initiator' },
39
- });
40
- // H4: Validate incoming public keys are canonical X25519 points.
41
- // Must reject low-order/torsion points BEFORE any DH operations to prevent
42
- // small-subgroup attacks that force all-zero shared secrets.
43
- validateX25519PublicKey(theirBundle.identity.x25519PublicKey, 'remote identity key', logger);
44
- validateX25519PublicKey(theirBundle.ecSignedPreKey.publicKey, 'remote signed prekey', logger);
45
- if (theirBundle.ecOneTimePreKey) {
46
- validateX25519PublicKey(theirBundle.ecOneTimePreKey.publicKey, 'remote one-time prekey', logger);
47
- }
48
- // Note: kemLastResortPreKey uses ML-KEM-1024 (1568 bytes), not X25519 - skip validation
49
- // Step 1: Verify signed prekey signature
50
- const isValid = await verifyPreKeySignature(theirBundle.identity, PREKEY_ALGORITHM_X25519, theirBundle.ecSignedPreKey.keyId, theirBundle.ecSignedPreKey.publicKey, theirBundle.ecSignedPreKey.signature);
51
- if (!isValid) {
52
- throw new Error('Invalid signed prekey signature');
53
- }
54
- // Step 2: Generate ephemeral key for this session
55
- const ephemeralKey = await generateECDHKeyPair();
56
- logger.debug('Alice X3DH: Key inputs', {
57
- category: 'E2EE',
58
- data: {
59
- myIdentityPub: myIdentityKey.dhKey.publicKey.substring(0, 20),
60
- myEphemeralPub: ephemeralKey.publicKey.substring(0, 20),
61
- bobIdentityPub: theirBundle.identity.x25519PublicKey.substring(0, 20),
62
- bobSignedPreKeyPub: theirBundle.ecSignedPreKey.publicKey.substring(0, 20),
63
- bobSignedPreKeyId: theirBundle.ecSignedPreKey.keyId,
64
- // DIAGNOSTIC: Log one-time prekey details to compare with Bob's side
65
- hasOneTimePreKey: !!theirBundle.ecOneTimePreKey,
66
- oneTimePreKeyId: theirBundle.ecOneTimePreKey?.keyId,
67
- oneTimePreKeyPub: theirBundle.ecOneTimePreKey?.publicKey?.substring(0, 20),
68
- },
69
- });
70
- const intermediateSecrets = new Set();
71
- const trackSecret = (secret) => {
72
- intermediateSecrets.add(secret);
73
- return secret;
74
- };
75
- try {
76
- // Step 3: ECDH operations
77
- // DH1: My identity DH private key × Their signed prekey public key
78
- const dh1 = trackSecret(await computeSharedSecret(myIdentityKey.dhKey.privateKey, theirBundle.ecSignedPreKey.publicKey));
79
- // DH2: My ephemeral private key × Their identity DH public key
80
- const dh2 = trackSecret(await computeSharedSecret(ephemeralKey.privateKey, theirBundle.identity.x25519PublicKey));
81
- // DH3: My ephemeral private key × Their signed prekey public key
82
- const dh3 = trackSecret(await computeSharedSecret(ephemeralKey.privateKey, theirBundle.ecSignedPreKey.publicKey));
83
- // DH4: My ephemeral private key × Their one-time prekey public key (if available)
84
- let dh4 = null;
85
- if (theirBundle.ecOneTimePreKey) {
86
- dh4 = trackSecret(await computeSharedSecret(ephemeralKey.privateKey, theirBundle.ecOneTimePreKey.publicKey));
87
- }
88
- // Step 4: Concatenate all DH outputs to create input key material (IKM)
89
- const dhOutputs = dh4 ? [dh1, dh2, dh3, dh4] : [dh1, dh2, dh3];
90
- // Per Signal Protocol X3DH spec: Prepend F || (32 bytes of 0xFF)
91
- // 32 bytes is correct for X25519 (the only curve the reference implementation uses).
92
- const F = new Uint8Array(32).fill(0xff);
93
- const ikm = trackSecret(concatBytes(F, ...dhOutputs));
94
- // Step 5: Use HKDF to derive shared secret
95
- // Per Signal Protocol X3DH spec: Use zero-filled salt
96
- const salt = new Uint8Array(32); // 32 bytes of zeros
97
- // Use configurable info string for session derivation
98
- const info = stringToBytes(infoString);
99
- // Derive 96 bytes from X3DH:
100
- // - Bytes 0-32: Shared secret (SK) / initial root key
101
- // - Bytes 32-64: Reserved (not used)
102
- // - Bytes 64-96: Compatibility receiving chain key
103
- const derivedKeys = trackSecret(await hkdf(ikm, salt, info, 96));
104
- const sharedSecret = derivedKeys.slice(0, 32);
105
- const additionalDerivedBytes = derivedKeys.slice(32, 96);
106
- // Step 6: Secure cleanup - zero ALL intermediate key material
107
- secureZeroBytes(dh1);
108
- secureZeroBytes(dh2);
109
- secureZeroBytes(dh3);
110
- if (dh4)
111
- secureZeroBytes(dh4);
112
- secureZeroBytes(ikm); // Zero IKM after HKDF
113
- secureZeroBytes(derivedKeys); // Zero derivedKeys after slicing
114
- // Note: The ephemeral private key (ephemeralKey.privateKey) is an immutable
115
- // Base64 string, and JavaScript cannot zero it. The byte-form copies
116
- // created internally by computeSharedSecret() are local variables that go
117
- // out of scope, and nothing zeroes them explicitly. The JS/TS runtime
118
- // imposes this limit. Callers that decode the key pair to bytes for session
119
- // initialization should zero their own decoded copies when done.
120
- logger.breadcrumb('X3DH initiator key agreement complete', {
121
- category: 'E2EE',
122
- level: 'info',
123
- data: { operation: 'x3dh', usedOneTimePreKey: !!theirBundle.ecOneTimePreKey },
124
- });
125
- return {
126
- sharedSecret,
127
- additionalDerivedBytes,
128
- ephemeralPublicKey: ephemeralKey.publicKey,
129
- ephemeralKeyPair: ephemeralKey,
130
- usedSignedPreKeyId: theirBundle.ecSignedPreKey.keyId,
131
- usedOneTimePreKeyId: theirBundle.ecOneTimePreKey?.keyId,
132
- usedPQXDH: false,
133
- };
134
- }
135
- finally {
136
- for (const secret of intermediateSecrets)
137
- secureZeroBytes(secret);
138
- }
139
- }
140
- /**
141
- * Run the X3DH key agreement as responder (Bob)
142
- *
143
- * The caller invokes this when Bob receives Alice's PreKeyMessage.
144
- * Bob uses his own prekeys and Alice's keys to derive the same shared secret.
145
- *
146
- * @param myIdentityKey My identity key pair
147
- * @param mySignedPreKey My signed prekey for this session
148
- * @param myOneTimePreKey My one-time prekey for this session (if any)
149
- * @param input Information from Alice's PreKeyMessage
150
- * @param infoString HKDF info string for key derivation
151
- * @returns X3DH responder result containing shared secret
152
- *
153
- * @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
154
- */
155
- export async function performX3DHResponder(myIdentityKey, mySignedPreKey, myOneTimePreKey, input, infoString, logger = defaultSignalProtocolLogger) {
156
- logger.breadcrumb('X3DH responder key agreement', {
157
- category: 'E2EE',
158
- level: 'info',
159
- data: { operation: 'x3dh', role: 'responder' },
160
- });
161
- logger.debug('Bob X3DH: Key inputs', {
162
- category: 'E2EE',
163
- data: {
164
- myIdentityPub: myIdentityKey.dhKey.publicKey.substring(0, 20),
165
- mySignedPreKeyPub: mySignedPreKey.publicKey.substring(0, 20),
166
- aliceIdentityPub: input.senderIdentityKey.substring(0, 20),
167
- aliceEphemeralPub: input.senderEphemeralKey.substring(0, 20),
168
- },
169
- });
170
- // H4: Validate incoming public keys are canonical X25519 points
171
- validateX25519PublicKey(input.senderIdentityKey, 'sender identity key', logger);
172
- validateX25519PublicKey(input.senderEphemeralKey, 'sender ephemeral key', logger);
173
- const intermediateSecrets = new Set();
174
- const trackSecret = (secret) => {
175
- intermediateSecrets.add(secret);
176
- return secret;
177
- };
178
- try {
179
- // Step 1: ECDH operations (same as initiator but using Bob's private keys)
180
- // DH1: Bob's signed prekey private × Alice's identity public
181
- const dh1 = trackSecret(await computeSharedSecret(mySignedPreKey.privateKey, input.senderIdentityKey));
182
- // DH2: Bob's identity private × Alice's ephemeral public
183
- const dh2 = trackSecret(await computeSharedSecret(myIdentityKey.dhKey.privateKey, input.senderEphemeralKey));
184
- // DH3: Bob's signed prekey private × Alice's ephemeral public
185
- const dh3 = trackSecret(await computeSharedSecret(mySignedPreKey.privateKey, input.senderEphemeralKey));
186
- // DH4: Bob's one-time prekey private × Alice's ephemeral public (if available)
187
- let dh4 = null;
188
- if (myOneTimePreKey && input.usedOneTimePreKeyId !== undefined) {
189
- dh4 = trackSecret(await computeSharedSecret(myOneTimePreKey.privateKey, input.senderEphemeralKey));
190
- logger.breadcrumb('One-time prekey used in X3DH', {
191
- category: 'E2EE',
192
- level: 'debug',
193
- data: { operation: 'x3dh' },
194
- });
195
- }
196
- // Step 2: Concatenate all DH outputs (same order as initiator)
197
- const dhOutputs = dh4 ? [dh1, dh2, dh3, dh4] : [dh1, dh2, dh3];
198
- // Per Signal Protocol X3DH spec: Prepend F || (32 bytes of 0xFF)
199
- // 32 bytes is correct for X25519 (the only curve the reference implementation uses).
200
- const F = new Uint8Array(32).fill(0xff);
201
- const ikm = trackSecret(concatBytes(F, ...dhOutputs));
202
- // Step 3: Use HKDF to derive shared secret
203
- // Per Signal Protocol X3DH spec: Use zero-filled salt
204
- const salt = new Uint8Array(32); // 32 bytes of zeros
205
- // Use configurable info string for session derivation
206
- const info = stringToBytes(infoString);
207
- // Derive 96 bytes from X3DH (matches initiator)
208
- const derivedKeys = trackSecret(await hkdf(ikm, salt, info, 96));
209
- const sharedSecret = derivedKeys.slice(0, 32);
210
- const additionalDerivedBytes = derivedKeys.slice(32, 96);
211
- // Step 4: Secure cleanup - zero ALL intermediate key material
212
- secureZeroBytes(dh1);
213
- secureZeroBytes(dh2);
214
- secureZeroBytes(dh3);
215
- if (dh4)
216
- secureZeroBytes(dh4);
217
- secureZeroBytes(ikm); // Zero IKM after HKDF
218
- secureZeroBytes(derivedKeys); // Zero derivedKeys after slicing
219
- logger.breadcrumb('X3DH responder key agreement complete', {
220
- category: 'E2EE',
221
- level: 'info',
222
- data: { operation: 'x3dh', usedOneTimePreKey: !!dh4 },
223
- });
224
- return {
225
- sharedSecret,
226
- additionalDerivedBytes,
227
- usedPQXDH: false,
228
- };
229
- }
230
- finally {
231
- for (const secret of intermediateSecrets)
232
- secureZeroBytes(secret);
233
- }
234
- }
235
- /**
236
- * Calculate X3DH shared secret from DH outputs
237
- *
238
- * This is a lower-level function that takes pre-computed DH outputs
239
- * and derives the shared secret. Useful when a caller runs the DH operations
240
- * separately (e.g., with hardware security modules).
241
- *
242
- * @param dh1 DH1 output (IKa × SPKb or SPKb × IKa)
243
- * @param dh2 DH2 output (EKa × IKb or IKb × EKa)
244
- * @param dh3 DH3 output (EKa × SPKb or SPKb × EKa)
245
- * @param dh4 DH4 output (EKa × OPKb or OPKb × EKa), optional
246
- * @param infoString HKDF info string for key derivation
247
- * @returns Shared secret (32 bytes)
248
- */
249
- export async function calculateX3DHSharedSecret(dh1, dh2, dh3, dh4, infoString) {
250
- // Concatenate all DH outputs
251
- const dhOutputs = dh4 ? [dh1, dh2, dh3, dh4] : [dh1, dh2, dh3];
252
- // Per Signal Protocol X3DH spec: Prepend F || (32 bytes of 0xFF)
253
- // 32 bytes is correct for X25519 (the only curve the reference implementation uses).
254
- const F = new Uint8Array(32).fill(0xff);
255
- const ikm = concatBytes(F, ...dhOutputs);
256
- // Use HKDF to derive shared secret
257
- const salt = new Uint8Array(32); // 32 bytes of zeros
258
- const info = stringToBytes(infoString);
259
- return await hkdf(ikm, salt, info, 32);
260
- }
261
- //# sourceMappingURL=x3dh.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"x3dh.js","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/x3dh.ts"],"names":[],"mappings":"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"}