@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.
- package/ADAPTERS.md +4 -4
- package/ARCHITECTURE.md +6 -8
- package/CHANGELOG.md +1348 -0
- package/README.md +1 -1
- package/SECURITY.md +2 -2
- package/TROUBLESHOOTING.md +8 -8
- package/client/README.md +70 -37
- package/device/README.md +39 -85
- package/dist/client/client.d.ts +334 -63
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +1175 -186
- package/dist/client/client.js.map +1 -1
- package/dist/client/config.d.ts +57 -42
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js +1 -1
- package/dist/client/config.js.map +1 -1
- package/dist/client/constants.d.ts +42 -8
- package/dist/client/constants.d.ts.map +1 -1
- package/dist/client/constants.js +48 -3
- package/dist/client/constants.js.map +1 -1
- package/dist/client/content-adapter.d.ts +80 -0
- package/dist/client/content-adapter.d.ts.map +1 -1
- package/dist/client/content-adapter.js +225 -12
- package/dist/client/content-adapter.js.map +1 -1
- package/dist/client/delivery-error.d.ts +150 -0
- package/dist/client/delivery-error.d.ts.map +1 -0
- package/dist/client/delivery-error.js +226 -0
- package/dist/client/delivery-error.js.map +1 -0
- package/dist/client/delivery-status.d.ts +32 -6
- package/dist/client/delivery-status.d.ts.map +1 -1
- package/dist/client/delivery-status.js +61 -13
- package/dist/client/delivery-status.js.map +1 -1
- package/dist/client/device-set-reconciliation.d.ts +196 -0
- package/dist/client/device-set-reconciliation.d.ts.map +1 -0
- package/dist/client/device-set-reconciliation.js +282 -0
- package/dist/client/device-set-reconciliation.js.map +1 -0
- package/dist/client/distribution-records.d.ts +29 -0
- package/dist/client/distribution-records.d.ts.map +1 -0
- package/dist/client/distribution-records.js +33 -0
- package/dist/client/distribution-records.js.map +1 -0
- package/dist/client/event-hooks.d.ts +280 -14
- package/dist/client/event-hooks.d.ts.map +1 -1
- package/dist/client/event-hooks.js +8 -0
- package/dist/client/event-hooks.js.map +1 -1
- package/dist/client/group-device-set.d.ts +47 -0
- package/dist/client/group-device-set.d.ts.map +1 -0
- package/dist/client/group-device-set.js +65 -0
- package/dist/client/group-device-set.js.map +1 -0
- package/dist/client/group-fetcher.d.ts +116 -0
- package/dist/client/group-fetcher.d.ts.map +1 -0
- package/dist/client/group-fetcher.js +598 -0
- package/dist/client/group-fetcher.js.map +1 -0
- package/dist/client/group-outbox.d.ts +172 -10
- package/dist/client/group-outbox.d.ts.map +1 -1
- package/dist/client/group-outbox.js +915 -74
- package/dist/client/group-outbox.js.map +1 -1
- package/dist/client/group-receive-authorization.d.ts +127 -4
- package/dist/client/group-receive-authorization.d.ts.map +1 -1
- package/dist/client/group-receive-authorization.js +270 -20
- package/dist/client/group-receive-authorization.js.map +1 -1
- package/dist/client/group-sealed-sender.d.ts +3 -0
- package/dist/client/group-sealed-sender.d.ts.map +1 -1
- package/dist/client/group-sealed-sender.js +1 -0
- package/dist/client/group-sealed-sender.js.map +1 -1
- package/dist/client/group-sender-key-operations.d.ts +14 -3
- package/dist/client/group-sender-key-operations.d.ts.map +1 -1
- package/dist/client/group-sender-key-operations.js +26 -5
- package/dist/client/group-sender-key-operations.js.map +1 -1
- package/dist/client/groups.d.ts +5 -5
- package/dist/client/groups.d.ts.map +1 -1
- package/dist/client/groups.js +5 -4
- package/dist/client/groups.js.map +1 -1
- package/dist/client/hosted-anonymous-delivery.d.ts +61 -9
- package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
- package/dist/client/hosted-anonymous-delivery.js +242 -48
- package/dist/client/hosted-anonymous-delivery.js.map +1 -1
- package/dist/client/hosted-assertion-id.d.ts +7 -0
- package/dist/client/hosted-assertion-id.d.ts.map +1 -0
- package/dist/client/hosted-assertion-id.js +51 -0
- package/dist/client/hosted-assertion-id.js.map +1 -0
- package/dist/client/hosted-mailbox-subscription.d.ts +34 -2
- package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
- package/dist/client/hosted-mailbox-subscription.js +87 -17
- package/dist/client/hosted-mailbox-subscription.js.map +1 -1
- package/dist/client/hosted-push.d.ts +22 -4
- package/dist/client/hosted-push.d.ts.map +1 -1
- package/dist/client/hosted-push.js +75 -22
- package/dist/client/hosted-push.js.map +1 -1
- package/dist/client/hosted-transport.d.ts +22 -28
- package/dist/client/hosted-transport.d.ts.map +1 -1
- package/dist/client/hosted-transport.js +115 -55
- package/dist/client/hosted-transport.js.map +1 -1
- package/dist/client/hosted.d.ts +10 -4
- package/dist/client/hosted.d.ts.map +1 -1
- package/dist/client/hosted.js +10 -4
- package/dist/client/hosted.js.map +1 -1
- package/dist/client/index.d.ts +5 -3
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/messages.d.ts +25 -3
- package/dist/client/messages.d.ts.map +1 -1
- package/dist/client/messages.js +111 -20
- package/dist/client/messages.js.map +1 -1
- package/dist/client/receive-admission.d.ts +58 -0
- package/dist/client/receive-admission.d.ts.map +1 -0
- package/dist/client/receive-admission.js +78 -0
- package/dist/client/receive-admission.js.map +1 -0
- package/dist/client/receive-expiry.d.ts +31 -0
- package/dist/client/receive-expiry.d.ts.map +1 -0
- package/dist/client/receive-expiry.js +35 -0
- package/dist/client/receive-expiry.js.map +1 -0
- package/dist/client/receive-hook-bound.d.ts +50 -0
- package/dist/client/receive-hook-bound.d.ts.map +1 -0
- package/dist/client/receive-hook-bound.js +115 -0
- package/dist/client/receive-hook-bound.js.map +1 -0
- package/dist/client/receive-queue.d.ts +299 -0
- package/dist/client/receive-queue.d.ts.map +1 -0
- package/dist/client/receive-queue.js +1420 -0
- package/dist/client/receive-queue.js.map +1 -0
- package/dist/client/receive-work-seed.d.ts +54 -0
- package/dist/client/receive-work-seed.d.ts.map +1 -0
- package/dist/client/receive-work-seed.js +116 -0
- package/dist/client/receive-work-seed.js.map +1 -0
- package/dist/client/recovery-driver.d.ts +25 -0
- package/dist/client/recovery-driver.d.ts.map +1 -0
- package/dist/client/recovery-driver.js +121 -0
- package/dist/client/recovery-driver.js.map +1 -0
- package/dist/client/relay-acceptance.d.ts +20 -7
- package/dist/client/relay-acceptance.d.ts.map +1 -1
- package/dist/client/relay-acceptance.js +30 -12
- package/dist/client/relay-acceptance.js.map +1 -1
- package/dist/client/relay-device-refusal.d.ts +18 -0
- package/dist/client/relay-device-refusal.d.ts.map +1 -1
- package/dist/client/relay-device-refusal.js +31 -0
- package/dist/client/relay-device-refusal.js.map +1 -1
- package/dist/client/relay-sealed-route.d.ts +36 -0
- package/dist/client/relay-sealed-route.d.ts.map +1 -0
- package/dist/client/relay-sealed-route.js +45 -0
- package/dist/client/relay-sealed-route.js.map +1 -0
- package/dist/client/relay-subscription.d.ts +56 -13
- package/dist/client/relay-subscription.d.ts.map +1 -1
- package/dist/client/relay-subscription.js +193 -123
- package/dist/client/relay-subscription.js.map +1 -1
- package/dist/client/resendable-content.d.ts +98 -0
- package/dist/client/resendable-content.d.ts.map +1 -0
- package/dist/client/resendable-content.js +136 -0
- package/dist/client/resendable-content.js.map +1 -0
- package/dist/client/retry-family.d.ts +57 -10
- package/dist/client/retry-family.d.ts.map +1 -1
- package/dist/client/retry-family.js +54 -12
- package/dist/client/retry-family.js.map +1 -1
- package/dist/client/retry-request-envelope.d.ts +107 -8
- package/dist/client/retry-request-envelope.d.ts.map +1 -1
- package/dist/client/retry-request-envelope.js +172 -23
- package/dist/client/retry-request-envelope.js.map +1 -1
- package/dist/client/retry-request-lifecycle.d.ts +70 -14
- package/dist/client/retry-request-lifecycle.d.ts.map +1 -1
- package/dist/client/retry-request-lifecycle.js +162 -32
- package/dist/client/retry-request-lifecycle.js.map +1 -1
- package/dist/client/retry-terminal-recovery.d.ts +100 -0
- package/dist/client/retry-terminal-recovery.d.ts.map +1 -0
- package/dist/client/retry-terminal-recovery.js +164 -0
- package/dist/client/retry-terminal-recovery.js.map +1 -0
- package/dist/client/retry-utils.d.ts +27 -0
- package/dist/client/retry-utils.d.ts.map +1 -1
- package/dist/client/retry-utils.js +46 -0
- package/dist/client/retry-utils.js.map +1 -1
- package/dist/client/retry.d.ts +100 -12
- package/dist/client/retry.d.ts.map +1 -1
- package/dist/client/retry.js +619 -116
- package/dist/client/retry.js.map +1 -1
- package/dist/client/sealed-sender.d.ts +23 -6
- package/dist/client/sealed-sender.d.ts.map +1 -1
- package/dist/client/sealed-sender.js +30 -6
- package/dist/client/sealed-sender.js.map +1 -1
- package/dist/client/sessions.d.ts +2 -2
- package/dist/client/sessions.js +2 -2
- package/dist/client/signal-service-cipher.d.ts +726 -19
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +2260 -342
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/state.d.ts +5 -0
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/state.js +11 -1
- package/dist/client/state.js.map +1 -1
- package/dist/client/storage-protection.d.ts +64 -0
- package/dist/client/storage-protection.d.ts.map +1 -0
- package/dist/client/storage-protection.js +150 -0
- package/dist/client/storage-protection.js.map +1 -0
- package/dist/client/types.d.ts +149 -15
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js +1 -1
- package/dist/client/types.js.map +1 -1
- package/dist/device/constants.d.ts +0 -5
- package/dist/device/constants.d.ts.map +1 -1
- package/dist/device/constants.js +0 -5
- package/dist/device/constants.js.map +1 -1
- package/dist/device/expo/index.d.ts +4 -17
- package/dist/device/expo/index.d.ts.map +1 -1
- package/dist/device/expo/index.js +4 -23
- package/dist/device/expo/index.js.map +1 -1
- package/dist/device/index.d.ts +0 -2
- package/dist/device/index.d.ts.map +1 -1
- package/dist/device/index.js +0 -7
- package/dist/device/index.js.map +1 -1
- package/dist/device/lifecycle/manager.d.ts +5 -4
- package/dist/device/lifecycle/manager.d.ts.map +1 -1
- package/dist/device/lifecycle/manager.js +16 -16
- package/dist/device/lifecycle/manager.js.map +1 -1
- package/dist/device/lifecycle/types.d.ts +2 -2
- package/dist/device/lifecycle/types.d.ts.map +1 -1
- package/dist/device/react-native/index.d.ts +4 -15
- package/dist/device/react-native/index.d.ts.map +1 -1
- package/dist/device/react-native/index.js +4 -21
- package/dist/device/react-native/index.js.map +1 -1
- package/dist/device/types.d.ts +1 -1
- package/dist/groups/index.d.ts +1 -1
- package/dist/groups/index.d.ts.map +1 -1
- package/dist/index.d.ts +8 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/ec/x25519-validation.d.ts +0 -1
- package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -1
- package/dist/internal/crypto/ec/x25519-validation.js +0 -1
- package/dist/internal/crypto/ec/x25519-validation.js.map +1 -1
- package/dist/internal/crypto/validation.d.ts +2 -2
- package/dist/internal/groups/index.d.ts +1 -0
- package/dist/internal/groups/index.d.ts.map +1 -1
- package/dist/internal/groups/index.js +1 -0
- package/dist/internal/groups/index.js.map +1 -1
- package/dist/internal/groups/manager.d.ts +37 -16
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +46 -1
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/groups/receive-record.d.ts +78 -0
- package/dist/internal/groups/receive-record.d.ts.map +1 -0
- package/dist/internal/groups/receive-record.js +43 -0
- package/dist/internal/groups/receive-record.js.map +1 -0
- package/dist/internal/groups/sdk-store.d.ts +27 -3
- package/dist/internal/groups/sdk-store.d.ts.map +1 -1
- package/dist/internal/groups/sdk-store.js +151 -19
- package/dist/internal/groups/sdk-store.js.map +1 -1
- package/dist/internal/groups/wire.d.ts +12 -1
- package/dist/internal/groups/wire.d.ts.map +1 -1
- package/dist/internal/groups/wire.js +36 -0
- package/dist/internal/groups/wire.js.map +1 -1
- package/dist/internal/manager/index.d.ts +1 -1
- package/dist/internal/manager/manager.d.ts +26 -20
- package/dist/internal/manager/manager.d.ts.map +1 -1
- package/dist/internal/manager/manager.js +64 -41
- package/dist/internal/manager/manager.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.d.ts +4 -18
- package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/chains.js +23 -74
- package/dist/internal/protocol/double-ratchet/chains.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/index.d.ts +1 -1
- package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/index.js +1 -1
- package/dist/internal/protocol/double-ratchet/index.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts +5 -7
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.js +4 -6
- package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -1
- package/dist/internal/protocol/pqxdh/pqxdh.js +2 -1
- package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.d.ts +6 -8
- package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.js +8 -9
- package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
- package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts +110 -0
- package/dist/internal/protocol/sender-keys/handoff-ledger.d.ts.map +1 -0
- package/dist/internal/protocol/sender-keys/handoff-ledger.js +124 -0
- package/dist/internal/protocol/sender-keys/handoff-ledger.js.map +1 -0
- package/dist/internal/protocol/sender-keys/manager.d.ts +71 -62
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +228 -175
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/index.d.ts +2 -2
- package/dist/internal/protocol/spqr/index.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/index.js +2 -2
- package/dist/internal/protocol/spqr/index.js.map +1 -1
- package/dist/internal/protocol/spqr/serialize.d.ts +9 -1
- package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/serialize.js +56 -16
- package/dist/internal/protocol/spqr/serialize.js.map +1 -1
- package/dist/internal/protocol/spqr/spqr.d.ts +1 -14
- package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/spqr.js +54 -42
- package/dist/internal/protocol/spqr/spqr.js.map +1 -1
- package/dist/internal/protocol/spqr/validate.d.ts +26 -6
- package/dist/internal/protocol/spqr/validate.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/validate.js +49 -21
- package/dist/internal/protocol/spqr/validate.js.map +1 -1
- package/dist/internal/sesame/index.d.ts +1 -1
- package/dist/internal/sesame/index.d.ts.map +1 -1
- package/dist/internal/sesame/index.js.map +1 -1
- package/dist/internal/sesame/manager.d.ts +66 -13
- package/dist/internal/sesame/manager.d.ts.map +1 -1
- package/dist/internal/sesame/manager.js +221 -87
- package/dist/internal/sesame/manager.js.map +1 -1
- package/dist/internal/sesame/types.d.ts +95 -17
- package/dist/internal/sesame/types.d.ts.map +1 -1
- package/dist/internal/sesame/types.js +17 -0
- package/dist/internal/sesame/types.js.map +1 -1
- package/dist/internal/session/builder.d.ts +5 -5
- package/dist/internal/session/builder.d.ts.map +1 -1
- package/dist/internal/session/builder.js +12 -17
- package/dist/internal/session/builder.js.map +1 -1
- package/dist/internal/session/cipher.d.ts +15 -13
- package/dist/internal/session/cipher.d.ts.map +1 -1
- package/dist/internal/session/cipher.js +41 -23
- package/dist/internal/session/cipher.js.map +1 -1
- package/dist/internal/session/factory.d.ts +5 -5
- package/dist/internal/session/factory.d.ts.map +1 -1
- package/dist/internal/session/factory.js +4 -4
- package/dist/internal/session/factory.js.map +1 -1
- package/dist/internal/session/handshake.d.ts +14 -16
- package/dist/internal/session/handshake.d.ts.map +1 -1
- package/dist/internal/session/handshake.js +18 -75
- package/dist/internal/session/handshake.js.map +1 -1
- package/dist/internal/session/index.d.ts +1 -1
- package/dist/internal/session/index.js +1 -1
- package/dist/internal/session/record-locks.d.ts +17 -6
- package/dist/internal/session/record-locks.d.ts.map +1 -1
- package/dist/internal/session/record-locks.js +43 -7
- package/dist/internal/session/record-locks.js.map +1 -1
- package/dist/internal/session/session-resolver.d.ts +1 -1
- package/dist/internal/session/session-resolver.js +1 -1
- package/dist/internal/session/state.d.ts +2 -2
- package/dist/internal/session/state.js +1 -1
- package/dist/internal/session/types.d.ts +5 -13
- package/dist/internal/session/types.d.ts.map +1 -1
- package/dist/internal/session/types.js +1 -1
- package/dist/keys/generation.d.ts +2 -2
- package/dist/keys/generation.js +2 -2
- package/dist/keys/types.d.ts +5 -5
- package/dist/keys/types.d.ts.map +1 -1
- package/dist/keys/types.js +1 -1
- package/dist/layers.d.ts +1 -1
- package/dist/layers.js +2 -2
- package/dist/layers.js.map +1 -1
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +12 -8
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/key-value/adapter.d.ts +76 -10
- package/dist/local/store/key-value/adapter.d.ts.map +1 -1
- package/dist/local/store/key-value/adapter.js +367 -61
- package/dist/local/store/key-value/adapter.js.map +1 -1
- package/dist/local/store/key-value/backend-conformance.d.ts.map +1 -1
- package/dist/local/store/key-value/backend-conformance.js +74 -0
- package/dist/local/store/key-value/backend-conformance.js.map +1 -1
- package/dist/local/store/key-value/batch.d.ts +2 -0
- package/dist/local/store/key-value/batch.d.ts.map +1 -1
- package/dist/local/store/key-value/batch.js +26 -0
- package/dist/local/store/key-value/batch.js.map +1 -1
- package/dist/local/store/key-value/receive-work.d.ts +55 -0
- package/dist/local/store/key-value/receive-work.d.ts.map +1 -0
- package/dist/local/store/key-value/receive-work.js +162 -0
- package/dist/local/store/key-value/receive-work.js.map +1 -0
- package/dist/local/store/key-value/send-log.d.ts +61 -0
- package/dist/local/store/key-value/send-log.d.ts.map +1 -0
- package/dist/local/store/key-value/send-log.js +430 -0
- package/dist/local/store/key-value/send-log.js.map +1 -0
- package/dist/local/store/key-value/sender-key-handoff.d.ts +68 -0
- package/dist/local/store/key-value/sender-key-handoff.d.ts.map +1 -0
- package/dist/local/store/key-value/sender-key-handoff.js +189 -0
- package/dist/local/store/key-value/sender-key-handoff.js.map +1 -0
- package/dist/local/store/key-value/storage.d.ts +15 -0
- package/dist/local/store/key-value/storage.d.ts.map +1 -1
- package/dist/local/store/keyed-index.d.ts +23 -0
- package/dist/local/store/keyed-index.d.ts.map +1 -0
- package/dist/local/store/keyed-index.js +41 -0
- package/dist/local/store/keyed-index.js.map +1 -0
- package/dist/local/store/memory/adapter.d.ts +44 -12
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +197 -46
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/memory/send-log.d.ts +42 -0
- package/dist/local/store/memory/send-log.d.ts.map +1 -0
- package/dist/local/store/memory/send-log.js +190 -0
- package/dist/local/store/memory/send-log.js.map +1 -0
- package/dist/local/store/node/adapter.d.ts.map +1 -1
- package/dist/local/store/node/adapter.js +8 -6
- package/dist/local/store/node/adapter.js.map +1 -1
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +12 -8
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/receive-work.d.ts +87 -0
- package/dist/local/store/receive-work.d.ts.map +1 -0
- package/dist/local/store/receive-work.js +204 -0
- package/dist/local/store/receive-work.js.map +1 -0
- package/dist/local/store/received-content.d.ts +3 -3
- package/dist/local/store/received-content.d.ts.map +1 -1
- package/dist/local/store/received-content.js +2 -11
- package/dist/local/store/received-content.js.map +1 -1
- package/dist/local/store/reliability.d.ts +317 -18
- package/dist/local/store/reliability.d.ts.map +1 -1
- package/dist/local/store/reliability.js +371 -46
- package/dist/local/store/reliability.js.map +1 -1
- package/dist/local/store/send-log-order.d.ts +15 -0
- package/dist/local/store/send-log-order.d.ts.map +1 -0
- package/dist/local/store/send-log-order.js +24 -0
- package/dist/local/store/send-log-order.js.map +1 -0
- package/dist/local/store/sender-key-handoff-index.d.ts +38 -0
- package/dist/local/store/sender-key-handoff-index.d.ts.map +1 -0
- package/dist/local/store/sender-key-handoff-index.js +101 -0
- package/dist/local/store/sender-key-handoff-index.js.map +1 -0
- package/dist/local/store/sender-key-handoff-table.d.ts +29 -0
- package/dist/local/store/sender-key-handoff-table.d.ts.map +1 -0
- package/dist/local/store/sender-key-handoff-table.js +97 -0
- package/dist/local/store/sender-key-handoff-table.js.map +1 -0
- package/dist/local/store/sqlite/driver.d.ts +9 -0
- package/dist/local/store/sqlite/driver.d.ts.map +1 -1
- package/dist/local/store/sqlite/encryption.d.ts +8 -1
- package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
- package/dist/local/store/sqlite/encryption.js +9 -0
- package/dist/local/store/sqlite/encryption.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/index.d.ts +25 -4
- package/dist/local/store/sqlite/key-storage/index.d.ts.map +1 -1
- package/dist/local/store/sqlite/key-storage/index.js +68 -7
- package/dist/local/store/sqlite/key-storage/index.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/message-records.d.ts +16 -4
- package/dist/local/store/sqlite/key-storage/message-records.d.ts.map +1 -1
- package/dist/local/store/sqlite/key-storage/message-records.js +49 -6
- package/dist/local/store/sqlite/key-storage/message-records.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/metadata.d.ts +8 -7
- package/dist/local/store/sqlite/key-storage/metadata.d.ts.map +1 -1
- package/dist/local/store/sqlite/key-storage/metadata.js +17 -15
- package/dist/local/store/sqlite/key-storage/metadata.js.map +1 -1
- package/dist/local/store/sqlite/key-storage/receive-work.d.ts +27 -0
- package/dist/local/store/sqlite/key-storage/receive-work.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/receive-work.js +98 -0
- package/dist/local/store/sqlite/key-storage/receive-work.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/send-log.d.ts +27 -0
- package/dist/local/store/sqlite/key-storage/send-log.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/send-log.js +178 -0
- package/dist/local/store/sqlite/key-storage/send-log.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts +27 -0
- package/dist/local/store/sqlite/key-storage/sender-key-handoff.d.ts.map +1 -0
- package/dist/local/store/sqlite/key-storage/sender-key-handoff.js +75 -0
- package/dist/local/store/sqlite/key-storage/sender-key-handoff.js.map +1 -0
- package/dist/local/store/sqlite/key-storage/session-trust.d.ts +2 -2
- package/dist/local/store/sqlite/key-storage/session-trust.js +5 -5
- package/dist/local/store/sqlite/key-storage/session-trust.js.map +1 -1
- package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
- package/dist/local/store/sqlite/migrations.js +101 -0
- package/dist/local/store/sqlite/migrations.js.map +1 -1
- package/dist/local/store/sqlite/models/index.d.ts +2 -1
- package/dist/local/store/sqlite/models/index.d.ts.map +1 -1
- package/dist/local/store/sqlite/models/index.js +5 -1
- package/dist/local/store/sqlite/models/index.js.map +1 -1
- package/dist/local/store/sqlite/models/message-record.d.ts +15 -0
- package/dist/local/store/sqlite/models/message-record.d.ts.map +1 -1
- package/dist/local/store/sqlite/models/message-record.js +24 -0
- package/dist/local/store/sqlite/models/message-record.js.map +1 -1
- package/dist/local/store/sqlite/models/send-log.d.ts +51 -0
- package/dist/local/store/sqlite/models/send-log.d.ts.map +1 -0
- package/dist/local/store/sqlite/models/send-log.js +206 -0
- package/dist/local/store/sqlite/models/send-log.js.map +1 -0
- package/dist/local/store/sqlite/open-store.d.ts +9 -1
- package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
- package/dist/local/store/sqlite/open-store.js +20 -1
- package/dist/local/store/sqlite/open-store.js.map +1 -1
- package/dist/local/store/sqlite/schema.d.ts +34 -1
- package/dist/local/store/sqlite/schema.d.ts.map +1 -1
- package/dist/local/store/sqlite/schema.js +14 -0
- package/dist/local/store/sqlite/schema.js.map +1 -1
- package/dist/local/store/sqlite/store.d.ts +61 -11
- package/dist/local/store/sqlite/store.d.ts.map +1 -1
- package/dist/local/store/sqlite/store.js +191 -27
- package/dist/local/store/sqlite/store.js.map +1 -1
- package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +2 -1
- package/dist/local/store/sqlite/web/worker.d.ts +8 -0
- package/dist/local/store/sqlite/web/worker.d.ts.map +1 -1
- package/dist/local/store/sqlite/web/worker.js +64 -2
- package/dist/local/store/sqlite/web/worker.js.map +1 -1
- package/dist/local/store/web/adapter.d.ts +76 -8
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +579 -127
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/local/store/web/receive-work.d.ts +57 -0
- package/dist/local/store/web/receive-work.d.ts.map +1 -0
- package/dist/local/store/web/receive-work.js +99 -0
- package/dist/local/store/web/receive-work.js.map +1 -0
- package/dist/local/store/web/send-log.d.ts +92 -0
- package/dist/local/store/web/send-log.d.ts.map +1 -0
- package/dist/local/store/web/send-log.js +267 -0
- package/dist/local/store/web/send-log.js.map +1 -0
- package/dist/local/store/web/sender-key-handoff.d.ts +81 -0
- package/dist/local/store/web/sender-key-handoff.d.ts.map +1 -0
- package/dist/local/store/web/sender-key-handoff.js +156 -0
- package/dist/local/store/web/sender-key-handoff.js.map +1 -0
- package/dist/local/store/web-sqlite/adapter.d.ts +2 -0
- package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
- package/dist/local/store/web-sqlite/adapter.js +12 -6
- package/dist/local/store/web-sqlite/adapter.js.map +1 -1
- package/dist/local/vault/custody.d.ts +8 -0
- package/dist/local/vault/custody.d.ts.map +1 -0
- package/dist/local/vault/custody.js +9 -0
- package/dist/local/vault/custody.js.map +1 -0
- package/dist/local/vault/electron-safe-storage.d.ts +3 -1
- package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
- package/dist/local/vault/electron-safe-storage.js +2 -0
- package/dist/local/vault/electron-safe-storage.js.map +1 -1
- package/dist/local/vault/expo-secure-store.d.ts +3 -1
- package/dist/local/vault/expo-secure-store.d.ts.map +1 -1
- package/dist/local/vault/expo-secure-store.js +2 -0
- package/dist/local/vault/expo-secure-store.js.map +1 -1
- package/dist/local/vault/indexed-db.d.ts +3 -1
- package/dist/local/vault/indexed-db.d.ts.map +1 -1
- package/dist/local/vault/indexed-db.js +2 -0
- package/dist/local/vault/indexed-db.js.map +1 -1
- package/dist/local/vault/react-native-keychain.d.ts +3 -1
- package/dist/local/vault/react-native-keychain.d.ts.map +1 -1
- package/dist/local/vault/react-native-keychain.js +2 -0
- package/dist/local/vault/react-native-keychain.js.map +1 -1
- package/dist/remote/relay/device-set.d.ts +94 -0
- package/dist/remote/relay/device-set.d.ts.map +1 -0
- package/dist/remote/relay/device-set.js +156 -0
- package/dist/remote/relay/device-set.js.map +1 -0
- package/dist/remote/relay/types.d.ts +92 -107
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/safety/core.d.ts +15 -6
- package/dist/safety/core.d.ts.map +1 -1
- package/dist/safety/core.js +41 -27
- package/dist/safety/core.js.map +1 -1
- package/dist/safety/index.d.ts +2 -1
- package/dist/safety/index.d.ts.map +1 -1
- package/dist/safety/index.js +12 -18
- package/dist/safety/index.js.map +1 -1
- package/dist/types/api.d.ts +707 -62
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/errors.d.ts +14 -33
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +14 -24
- package/dist/types/errors.js.map +1 -1
- package/dist/types/messages.d.ts +2 -2
- package/dist/types/messages.js +1 -1
- package/dist/types/protocol-config.d.ts +175 -42
- package/dist/types/protocol-config.d.ts.map +1 -1
- package/dist/types/protocol-config.js +19 -38
- package/dist/types/protocol-config.js.map +1 -1
- package/dist/types/protocol-constants.d.ts +6 -6
- package/dist/types/protocol-constants.js +6 -6
- package/dist/types/session.d.ts +7 -7
- package/dist/types/session.d.ts.map +1 -1
- package/dist/types/session.js +39 -21
- package/dist/types/session.js.map +1 -1
- package/dist/username/link.d.ts +2 -2
- package/dist/username/link.js +2 -2
- package/dist/utils/origin-lock.d.ts +45 -0
- package/dist/utils/origin-lock.d.ts.map +1 -0
- package/dist/utils/origin-lock.js +80 -0
- package/dist/utils/origin-lock.js.map +1 -0
- package/docs/ASSURANCE.md +6 -6
- package/docs/CLIENT_COMPOSITION.md +2 -2
- package/docs/DEVIATIONS.md +677 -182
- package/docs/E2EE.md +1 -1
- package/docs/ERROR_HANDLING.md +165 -2
- package/docs/GETTING_STARTED.md +7 -4
- package/docs/INTERFACES.md +1 -1
- package/docs/PACKAGE_SURFACE.md +6 -5
- package/docs/PROTOCOL_POLICY.md +102 -22
- package/docs/RECIPES.md +3 -15
- package/docs/SECURITY.md +90 -5
- package/keys/README.md +3 -3
- package/local/store/README.md +78 -14
- package/local/store/key-value/README.md +14 -3
- package/local/store/node/README.md +8 -3
- package/local/store/web/README.md +9 -0
- package/local/store/web-sqlite/README.md +14 -2
- package/local/vault/README.md +21 -0
- package/package.json +1 -6
- package/remote/README.md +0 -1
- package/remote/relay/README.md +2 -2
- package/dist/device/provisioning.d.ts +0 -242
- package/dist/device/provisioning.d.ts.map +0 -1
- package/dist/device/provisioning.js +0 -421
- package/dist/device/provisioning.js.map +0 -1
- package/dist/internal/protocol/x3dh/index.d.ts +0 -15
- package/dist/internal/protocol/x3dh/index.d.ts.map +0 -1
- package/dist/internal/protocol/x3dh/index.js +0 -13
- package/dist/internal/protocol/x3dh/index.js.map +0 -1
- package/dist/internal/protocol/x3dh/x3dh.d.ts +0 -131
- package/dist/internal/protocol/x3dh/x3dh.d.ts.map +0 -1
- package/dist/internal/protocol/x3dh/x3dh.js +0 -261
- package/dist/internal/protocol/x3dh/x3dh.js.map +0 -1
|
@@ -1,421 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Device Provisioning Manager
|
|
3
|
-
*
|
|
4
|
-
* Implements Signal Protocol's device linking flow:
|
|
5
|
-
* 1. Primary device generates ephemeral key pair and QR code
|
|
6
|
-
* 2. New device scans QR code and generates own ephemeral key pair
|
|
7
|
-
* 3. Both devices perform ECDH key agreement to establish shared secret
|
|
8
|
-
* 4. Primary device encrypts provisioned identity keys with shared secret
|
|
9
|
-
* 5. New device decrypts and stores those identities, then initializes
|
|
10
|
-
*
|
|
11
|
-
* Security Properties:
|
|
12
|
-
* - Physical proximity authentication (QR code)
|
|
13
|
-
* - Ephemeral ECDH key agreement (forward secrecy)
|
|
14
|
-
* - AES-256-GCM encryption
|
|
15
|
-
* - 5-minute session TTL
|
|
16
|
-
* - Account identity sharing (not full backup)
|
|
17
|
-
* - The provisioning service carries only encrypted key material
|
|
18
|
-
*
|
|
19
|
-
* Differences from Device Transfer:
|
|
20
|
-
* - Shares identity key only (not full backup with sessions)
|
|
21
|
-
* - Adds new device (does not migrate/wipe old device)
|
|
22
|
-
* - Multiple devices remain active
|
|
23
|
-
*
|
|
24
|
-
* This module is platform-free on purpose. The device's own description arrives
|
|
25
|
-
* as a `LocalDeviceMetadata` parameter, so nothing here needs to ask a platform
|
|
26
|
-
* what it is running on. The `./expo` module supplies that for Expo
|
|
27
|
-
* hosts.
|
|
28
|
-
*/
|
|
29
|
-
import * as crypto from '../internal/crypto/index.js';
|
|
30
|
-
import { parseUrl, queryValues } from '../internal/platform/index.js';
|
|
31
|
-
import { resolveSignalProtocolLogger } from '../logger.js';
|
|
32
|
-
import { asBase64 } from '../types/utils.js';
|
|
33
|
-
import { DEVICE_ID_KEY, LOCAL_IDENTITY_KEY } from './constants.js';
|
|
34
|
-
import { encryptDeviceName } from './device-name-crypto.js';
|
|
35
|
-
// ============================================================================
|
|
36
|
-
// Primary Device Flow
|
|
37
|
-
// ============================================================================
|
|
38
|
-
const DEFAULT_PROVISIONING_IDENTITY_TYPES = ['aci', 'pni'];
|
|
39
|
-
function toProvisionedIdentityKeyPair(identityKey) {
|
|
40
|
-
return {
|
|
41
|
-
dhPublicKey: identityKey.dhKey.publicKey,
|
|
42
|
-
dhPrivateKey: identityKey.dhKey.privateKey,
|
|
43
|
-
signingPublicKey: identityKey.signingKey.publicKey,
|
|
44
|
-
signingPrivateKey: identityKey.signingKey.privateKey,
|
|
45
|
-
registrationId: identityKey.registrationId,
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
function fromProvisionedIdentityKeyPair(identityKey) {
|
|
49
|
-
return {
|
|
50
|
-
dhKey: {
|
|
51
|
-
publicKey: asBase64(identityKey.dhPublicKey),
|
|
52
|
-
privateKey: asBase64(identityKey.dhPrivateKey),
|
|
53
|
-
},
|
|
54
|
-
signingKey: {
|
|
55
|
-
publicKey: asBase64(identityKey.signingPublicKey),
|
|
56
|
-
privateKey: asBase64(identityKey.signingPrivateKey),
|
|
57
|
-
},
|
|
58
|
-
registrationId: identityKey.registrationId,
|
|
59
|
-
};
|
|
60
|
-
}
|
|
61
|
-
async function collectProvisioningIdentityKeys(identityStore, explicitIdentityTypes) {
|
|
62
|
-
const requestedIdentityTypes = explicitIdentityTypes ?? DEFAULT_PROVISIONING_IDENTITY_TYPES;
|
|
63
|
-
const identityKeys = {};
|
|
64
|
-
for (const identityType of requestedIdentityTypes) {
|
|
65
|
-
const identityKey = await identityStore.getIdentityKey(identityType);
|
|
66
|
-
if (!identityKey) {
|
|
67
|
-
if (identityType === 'aci' || explicitIdentityTypes) {
|
|
68
|
-
throw new Error(`Identity key not found for primary device (${identityType})`);
|
|
69
|
-
}
|
|
70
|
-
continue;
|
|
71
|
-
}
|
|
72
|
-
identityKeys[identityType] = toProvisionedIdentityKeyPair(identityKey);
|
|
73
|
-
}
|
|
74
|
-
if (!identityKeys.aci) {
|
|
75
|
-
throw new Error('Provisioning requires an ACI identity key');
|
|
76
|
-
}
|
|
77
|
-
return identityKeys;
|
|
78
|
-
}
|
|
79
|
-
/**
|
|
80
|
-
* Default custom URL scheme prefix for device-linking QR codes, targeting the
|
|
81
|
-
* `signalprotocol://` scheme. Override per call via the `linkPrefix` parameter.
|
|
82
|
-
*/
|
|
83
|
-
export const DEFAULT_PROVISIONING_LINK_PREFIX = 'signalprotocol://link-device';
|
|
84
|
-
/**
|
|
85
|
-
* Generate QR Code for Device Linking (Primary Device)
|
|
86
|
-
*
|
|
87
|
-
* Creates a provisioning session and generates QR code data.
|
|
88
|
-
* The QR code contains the session ID and ephemeral public key.
|
|
89
|
-
*
|
|
90
|
-
* @param relay - Provisioning service interface
|
|
91
|
-
* @param userId - Current user ID
|
|
92
|
-
* @param providedLogger - Optional logger
|
|
93
|
-
* @param linkPrefix - Custom scheme prefix (defaults to {@link DEFAULT_PROVISIONING_LINK_PREFIX})
|
|
94
|
-
* @returns QR code URL and ephemeral key pair
|
|
95
|
-
*/
|
|
96
|
-
export async function generateProvisioningQR(relay, userId, providedLogger, linkPrefix = DEFAULT_PROVISIONING_LINK_PREFIX) {
|
|
97
|
-
const logger = resolveSignalProtocolLogger(providedLogger);
|
|
98
|
-
try {
|
|
99
|
-
// Generate ephemeral ECDH key pair
|
|
100
|
-
const ephemeralKeyPair = await crypto.generateECDHKeyPair();
|
|
101
|
-
// Create provisioning session on backend
|
|
102
|
-
const { sessionId } = await relay.createProvisioningSession(userId, ephemeralKeyPair.publicKey);
|
|
103
|
-
// Build QR code URL
|
|
104
|
-
// URL-encode the base64 key to handle +, /, and = characters
|
|
105
|
-
const qrCodeUrl = `${linkPrefix}?session=${encodeURIComponent(sessionId)}&key=${encodeURIComponent(ephemeralKeyPair.publicKey)}`;
|
|
106
|
-
logger.info('[Provisioning] QR code generated', { sessionId });
|
|
107
|
-
return {
|
|
108
|
-
qrCodeUrl,
|
|
109
|
-
sessionId,
|
|
110
|
-
ephemeralKeyPair,
|
|
111
|
-
};
|
|
112
|
-
}
|
|
113
|
-
catch (error) {
|
|
114
|
-
logger.error('[Provisioning] Failed to generate QR code', error);
|
|
115
|
-
throw error;
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
/**
|
|
119
|
-
* Send Provisioning Payload to New Device (Primary Device)
|
|
120
|
-
*
|
|
121
|
-
* Called after new device connects to provisioning session.
|
|
122
|
-
* Encrypts and sends all provisioned identity keys to the new device.
|
|
123
|
-
*
|
|
124
|
-
* @param relay - Provisioning service interface
|
|
125
|
-
* @param userProfile - User profile data (name, username, avatarUrl)
|
|
126
|
-
* @param sessionId - Provisioning session ID
|
|
127
|
-
* @param ephemeralPrivateKey - Primary's ephemeral private key
|
|
128
|
-
* @param newDeviceEphemeralPublicKey - New device's ephemeral public key
|
|
129
|
-
* @param userId - User ID
|
|
130
|
-
*/
|
|
131
|
-
export async function provisionDevice(relay, userProfile, sessionId, ephemeralPrivateKey, newDeviceEphemeralPublicKey, userId, options) {
|
|
132
|
-
const logger = resolveSignalProtocolLogger(options.logger);
|
|
133
|
-
try {
|
|
134
|
-
const identityKeys = await collectProvisioningIdentityKeys(options.identityStore, options.identityTypes);
|
|
135
|
-
// Gather group master keys for cross-device sync
|
|
136
|
-
const groupKeys = options.groupStateStore
|
|
137
|
-
? await options.groupStateStore.getAllMasterKeys()
|
|
138
|
-
: [];
|
|
139
|
-
// Build provisioning message
|
|
140
|
-
const provisioningMessage = {
|
|
141
|
-
identityKeys,
|
|
142
|
-
userId,
|
|
143
|
-
userProfile: {
|
|
144
|
-
name: userProfile.name,
|
|
145
|
-
username: userProfile.username,
|
|
146
|
-
usernameLink: userProfile.usernameLink ?? undefined,
|
|
147
|
-
},
|
|
148
|
-
groupMasterKeys: groupKeys.length > 0 ? groupKeys : undefined,
|
|
149
|
-
};
|
|
150
|
-
// Derive shared secret using ECDH
|
|
151
|
-
const sharedSecret = await crypto.computeSharedSecret(asBase64(ephemeralPrivateKey), asBase64(newDeviceEphemeralPublicKey));
|
|
152
|
-
// Derive encryption key from shared secret using HKDF
|
|
153
|
-
const encryptionKey = await crypto.hkdf(sharedSecret, new Uint8Array(32), // salt
|
|
154
|
-
crypto.stringToBytes('DeviceProvisioning'), 32 // key length
|
|
155
|
-
);
|
|
156
|
-
// Encrypt provisioning message with AES-256-GCM
|
|
157
|
-
const plaintextBytes = crypto.stringToBytes(JSON.stringify(provisioningMessage));
|
|
158
|
-
const encrypted = await crypto.aesGcmEncrypt(encryptionKey, plaintextBytes);
|
|
159
|
-
// Send encrypted message to backend
|
|
160
|
-
await relay.sendProvisioningMessage(sessionId, JSON.stringify(encrypted), userId);
|
|
161
|
-
logger.info('[Provisioning] Identities sent to new device', {
|
|
162
|
-
sessionId,
|
|
163
|
-
identityTypes: Object.keys(identityKeys),
|
|
164
|
-
});
|
|
165
|
-
// Wipe ephemeral keys for security
|
|
166
|
-
// Note: ephemeralPrivateKey is Base64 string, cannot be securely zeroed
|
|
167
|
-
crypto.secureZeroBytes(sharedSecret);
|
|
168
|
-
crypto.secureZeroBytes(encryptionKey);
|
|
169
|
-
}
|
|
170
|
-
catch (error) {
|
|
171
|
-
logger.error('[Provisioning] Failed to provision device', error);
|
|
172
|
-
throw error;
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
// ============================================================================
|
|
176
|
-
// New Device Flow
|
|
177
|
-
// ============================================================================
|
|
178
|
-
/**
|
|
179
|
-
* Parse Provisioning QR Code (New Device)
|
|
180
|
-
*
|
|
181
|
-
* Extracts session ID and ephemeral public key from QR code URL.
|
|
182
|
-
*
|
|
183
|
-
* @param qrCodeData - QR code data (URL format)
|
|
184
|
-
* @returns Session ID and primary's ephemeral public key (Base64)
|
|
185
|
-
*/
|
|
186
|
-
export function parseProvisioningQR(qrCodeData, providedLogger, linkPrefix = DEFAULT_PROVISIONING_LINK_PREFIX) {
|
|
187
|
-
const logger = resolveSignalProtocolLogger(providedLogger);
|
|
188
|
-
try {
|
|
189
|
-
// Parse URL: signalprotocol://link-device?session=xxx&key=xxx
|
|
190
|
-
const url = parseUrl(qrCodeData);
|
|
191
|
-
const expected = parseUrl(linkPrefix);
|
|
192
|
-
if (url.protocol !== expected.protocol ||
|
|
193
|
-
url.hostname !== expected.hostname ||
|
|
194
|
-
url.port !== expected.port ||
|
|
195
|
-
url.pathname !== expected.pathname) {
|
|
196
|
-
throw new Error('Invalid provisioning QR code prefix');
|
|
197
|
-
}
|
|
198
|
-
const sessionId = queryValues(url, 'session')[0];
|
|
199
|
-
const keyBase64 = queryValues(url, 'key')[0];
|
|
200
|
-
if (!sessionId || !keyBase64) {
|
|
201
|
-
throw new Error('Invalid provisioning QR code: missing session or key');
|
|
202
|
-
}
|
|
203
|
-
let decodedKey;
|
|
204
|
-
try {
|
|
205
|
-
decodedKey = crypto.base64ToBytes(asBase64(keyBase64));
|
|
206
|
-
}
|
|
207
|
-
catch {
|
|
208
|
-
throw new Error('Invalid provisioning QR code key');
|
|
209
|
-
}
|
|
210
|
-
if (decodedKey.length !== 32 || crypto.bytesToBase64(decodedKey) !== keyBase64) {
|
|
211
|
-
throw new Error('Invalid provisioning QR code key: expected 32-byte X25519 key');
|
|
212
|
-
}
|
|
213
|
-
return {
|
|
214
|
-
sessionId,
|
|
215
|
-
primaryEphemeralPublicKey: keyBase64,
|
|
216
|
-
};
|
|
217
|
-
}
|
|
218
|
-
catch (error) {
|
|
219
|
-
logger.error('[Provisioning] Failed to parse QR code', error);
|
|
220
|
-
throw new Error('Invalid provisioning QR code format');
|
|
221
|
-
}
|
|
222
|
-
}
|
|
223
|
-
/**
|
|
224
|
-
* Connect to Provisioning Session (New Device)
|
|
225
|
-
*
|
|
226
|
-
* Generates ephemeral key pair and connects to provisioning session.
|
|
227
|
-
*
|
|
228
|
-
* @param relay - Provisioning service interface
|
|
229
|
-
* @param sessionId - Provisioning session ID
|
|
230
|
-
* @param deviceMetadata - New device metadata
|
|
231
|
-
* @returns Ephemeral key pair for decryption
|
|
232
|
-
*/
|
|
233
|
-
export async function connectToProvisioningSession(relay, sessionId, deviceMetadata, providedLogger) {
|
|
234
|
-
const logger = resolveSignalProtocolLogger(providedLogger);
|
|
235
|
-
try {
|
|
236
|
-
// Generate ephemeral key pair
|
|
237
|
-
const ephemeralKeyPair = await crypto.generateECDHKeyPair();
|
|
238
|
-
// Connect to provisioning session
|
|
239
|
-
await relay.connectNewDevice(sessionId, ephemeralKeyPair.publicKey, toProvisioningConnectionMetadata(deviceMetadata));
|
|
240
|
-
logger.info('[Provisioning] Connected to session', { sessionId });
|
|
241
|
-
return ephemeralKeyPair;
|
|
242
|
-
}
|
|
243
|
-
catch (error) {
|
|
244
|
-
logger.error('[Provisioning] Failed to connect', error);
|
|
245
|
-
throw error;
|
|
246
|
-
}
|
|
247
|
-
}
|
|
248
|
-
/**
|
|
249
|
-
* Receive Provisioning Message (New Device)
|
|
250
|
-
*
|
|
251
|
-
* Polls for and decrypts provisioning message from primary device.
|
|
252
|
-
* Finalizes the server-side device link, then stores the received bootstrap
|
|
253
|
-
* state in the caller-provided Signal Protocol key store.
|
|
254
|
-
*
|
|
255
|
-
* @param relay - Provisioning service interface
|
|
256
|
-
* @param sessionId - Provisioning session ID
|
|
257
|
-
* @param ephemeralPrivateKey - New device's ephemeral private key
|
|
258
|
-
* @param primaryEphemeralPublicKey - Primary device's ephemeral public key
|
|
259
|
-
* @returns Provisioning message with identity keys and user info
|
|
260
|
-
*/
|
|
261
|
-
export async function receiveProvisioningMessage(relay, sessionId, ephemeralPrivateKey, primaryEphemeralPublicKey, options) {
|
|
262
|
-
const logger = resolveSignalProtocolLogger(options.logger);
|
|
263
|
-
const storedIdentityTypes = [];
|
|
264
|
-
const storedGroupIds = [];
|
|
265
|
-
let storedDeviceId = false;
|
|
266
|
-
let storedLocalIdentity = false;
|
|
267
|
-
let storedUsernameState = false;
|
|
268
|
-
let serverLinkedDeviceId = null;
|
|
269
|
-
const rollbackLocalProvisioningState = async () => {
|
|
270
|
-
for (const identityType of storedIdentityTypes.slice().reverse()) {
|
|
271
|
-
await options.identityStore.deleteIdentityKey(identityType);
|
|
272
|
-
}
|
|
273
|
-
if (storedLocalIdentity && options.localStateStore) {
|
|
274
|
-
await options.localStateStore.deleteItemAsync(LOCAL_IDENTITY_KEY);
|
|
275
|
-
}
|
|
276
|
-
if (storedDeviceId && options.localStateStore) {
|
|
277
|
-
await options.localStateStore.deleteItemAsync(DEVICE_ID_KEY);
|
|
278
|
-
}
|
|
279
|
-
if (storedUsernameState && options.usernameStateStore) {
|
|
280
|
-
await options.usernameStateStore.clearUsernameState();
|
|
281
|
-
}
|
|
282
|
-
for (const groupId of storedGroupIds.slice().reverse()) {
|
|
283
|
-
await options.groupStateStore?.deleteMasterKey(groupId);
|
|
284
|
-
}
|
|
285
|
-
};
|
|
286
|
-
let sharedSecret = null;
|
|
287
|
-
let decryptionKey = null;
|
|
288
|
-
try {
|
|
289
|
-
// Poll for provisioning message
|
|
290
|
-
const result = await relay.getProvisioningMessage(sessionId);
|
|
291
|
-
if (result.status !== 'ready' || !result.message) {
|
|
292
|
-
throw new Error(`Provisioning message not ready: ${result.status}`);
|
|
293
|
-
}
|
|
294
|
-
// Parse encrypted message
|
|
295
|
-
const encrypted = JSON.parse(result.message);
|
|
296
|
-
// Derive shared secret (same as primary device)
|
|
297
|
-
sharedSecret = await crypto.computeSharedSecret(asBase64(ephemeralPrivateKey), asBase64(primaryEphemeralPublicKey));
|
|
298
|
-
// Derive decryption key (same as primary device)
|
|
299
|
-
decryptionKey = await crypto.hkdf(sharedSecret, new Uint8Array(32), crypto.stringToBytes('DeviceProvisioning'), 32);
|
|
300
|
-
// Decrypt provisioning message
|
|
301
|
-
const plaintextBytes = await crypto.aesGcmDecrypt(decryptionKey, encrypted.ciphertext, encrypted.iv, encrypted.authTag);
|
|
302
|
-
const provisioningPayload = JSON.parse(crypto.bytesToString(plaintextBytes));
|
|
303
|
-
const aciIdentityKey = provisioningPayload.identityKeys.aci;
|
|
304
|
-
if (!aciIdentityKey) {
|
|
305
|
-
throw new Error('Provisioning message missing ACI identity key');
|
|
306
|
-
}
|
|
307
|
-
const encryptedDeviceName = await encryptDeviceName(options.deviceMetadata.deviceName, asBase64(aciIdentityKey.dhPublicKey));
|
|
308
|
-
// Finalize the server-side link before mutating local Signal Protocol state.
|
|
309
|
-
const completion = await relay.completeProvisioning(sessionId, {
|
|
310
|
-
encryptedDeviceName,
|
|
311
|
-
platform: options.deviceMetadata.platform,
|
|
312
|
-
appVersion: options.deviceMetadata.appVersion,
|
|
313
|
-
osVersion: options.deviceMetadata.osVersion,
|
|
314
|
-
});
|
|
315
|
-
serverLinkedDeviceId = completion.deviceId;
|
|
316
|
-
for (const identityType of DEFAULT_PROVISIONING_IDENTITY_TYPES) {
|
|
317
|
-
const identityKey = provisioningPayload.identityKeys[identityType];
|
|
318
|
-
if (!identityKey) {
|
|
319
|
-
continue;
|
|
320
|
-
}
|
|
321
|
-
await options.identityStore.storeIdentityKey(fromProvisionedIdentityKeyPair(identityKey), identityType);
|
|
322
|
-
storedIdentityTypes.push(identityType);
|
|
323
|
-
}
|
|
324
|
-
if (options.localStateStore) {
|
|
325
|
-
await options.localStateStore.setItemAsync(DEVICE_ID_KEY, completion.deviceId.toString());
|
|
326
|
-
storedDeviceId = true;
|
|
327
|
-
await options.localStateStore.setItemAsync(LOCAL_IDENTITY_KEY, aciIdentityKey.dhPublicKey);
|
|
328
|
-
storedLocalIdentity = true;
|
|
329
|
-
}
|
|
330
|
-
if (options.usernameStateStore) {
|
|
331
|
-
await options.usernameStateStore.setUsernameState({
|
|
332
|
-
fullUsername: provisioningPayload.userProfile.username ?? null,
|
|
333
|
-
usernameLink: provisioningPayload.userProfile.usernameLink ?? null,
|
|
334
|
-
});
|
|
335
|
-
storedUsernameState = true;
|
|
336
|
-
}
|
|
337
|
-
if (provisioningPayload.groupMasterKeys && options.groupStateStore) {
|
|
338
|
-
for (const entry of provisioningPayload.groupMasterKeys) {
|
|
339
|
-
const keyBytes = crypto.base64ToBytes(asBase64(entry.masterKey));
|
|
340
|
-
await options.groupStateStore.storeMasterKey(entry.groupId, keyBytes);
|
|
341
|
-
crypto.secureZeroBytes(keyBytes);
|
|
342
|
-
storedGroupIds.push(entry.groupId);
|
|
343
|
-
}
|
|
344
|
-
logger.info('[Provisioning] Stored group master keys', {
|
|
345
|
-
count: provisioningPayload.groupMasterKeys.length,
|
|
346
|
-
});
|
|
347
|
-
}
|
|
348
|
-
await relay.acknowledgeProvisioning(sessionId);
|
|
349
|
-
logger.info('[Provisioning] Provisioned identities stored after server link', {
|
|
350
|
-
deviceId: completion.deviceId,
|
|
351
|
-
identityTypes: storedIdentityTypes,
|
|
352
|
-
});
|
|
353
|
-
return {
|
|
354
|
-
...provisioningPayload,
|
|
355
|
-
deviceId: completion.deviceId,
|
|
356
|
-
};
|
|
357
|
-
}
|
|
358
|
-
catch (error) {
|
|
359
|
-
if (serverLinkedDeviceId !== null) {
|
|
360
|
-
try {
|
|
361
|
-
await relay.rollbackProvisioning(sessionId);
|
|
362
|
-
}
|
|
363
|
-
catch (rollbackError) {
|
|
364
|
-
logger.error('[Provisioning] Failed to roll back server-side provisioning', rollbackError);
|
|
365
|
-
}
|
|
366
|
-
}
|
|
367
|
-
if (storedIdentityTypes.length > 0 ||
|
|
368
|
-
storedGroupIds.length > 0 ||
|
|
369
|
-
storedDeviceId ||
|
|
370
|
-
storedLocalIdentity ||
|
|
371
|
-
storedUsernameState) {
|
|
372
|
-
try {
|
|
373
|
-
await rollbackLocalProvisioningState();
|
|
374
|
-
}
|
|
375
|
-
catch (rollbackError) {
|
|
376
|
-
logger.error('[Provisioning] Failed to roll back local provisioning state', rollbackError);
|
|
377
|
-
}
|
|
378
|
-
}
|
|
379
|
-
logger.error('[Provisioning] Failed to receive provisioning message', error);
|
|
380
|
-
throw error;
|
|
381
|
-
}
|
|
382
|
-
finally {
|
|
383
|
-
if (sharedSecret) {
|
|
384
|
-
crypto.secureZeroBytes(sharedSecret);
|
|
385
|
-
}
|
|
386
|
-
if (decryptionKey) {
|
|
387
|
-
crypto.secureZeroBytes(decryptionKey);
|
|
388
|
-
}
|
|
389
|
-
// Note: ephemeralPrivateKey is a Base64 string that will be garbage collected
|
|
390
|
-
}
|
|
391
|
-
}
|
|
392
|
-
// ============================================================================
|
|
393
|
-
// Utilities
|
|
394
|
-
// ============================================================================
|
|
395
|
-
function toProvisioningConnectionMetadata(metadata) {
|
|
396
|
-
return {
|
|
397
|
-
platform: metadata.platform,
|
|
398
|
-
appVersion: metadata.appVersion,
|
|
399
|
-
osVersion: metadata.osVersion,
|
|
400
|
-
};
|
|
401
|
-
}
|
|
402
|
-
/**
|
|
403
|
-
* Cancel Provisioning Session
|
|
404
|
-
*
|
|
405
|
-
* Deletes provisioning session and cleans up.
|
|
406
|
-
*
|
|
407
|
-
* @param relay - Provisioning service interface
|
|
408
|
-
* @param sessionId - Session ID to cancel
|
|
409
|
-
*/
|
|
410
|
-
export async function cancelProvisioning(relay, sessionId, userId, providedLogger) {
|
|
411
|
-
const logger = resolveSignalProtocolLogger(providedLogger);
|
|
412
|
-
try {
|
|
413
|
-
await relay.deleteProvisioningSession(sessionId, userId);
|
|
414
|
-
logger.info('[Provisioning] Session cancelled', { sessionId });
|
|
415
|
-
}
|
|
416
|
-
catch (error) {
|
|
417
|
-
logger.error('[Provisioning] Failed to cancel session', error);
|
|
418
|
-
// Do not throw - cleanup is best-effort
|
|
419
|
-
}
|
|
420
|
-
}
|
|
421
|
-
//# sourceMappingURL=provisioning.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"provisioning.js","sourceRoot":"","sources":["../../device/provisioning.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* X3DH (Extended Triple Diffie-Hellman)
|
|
3
|
-
*
|
|
4
|
-
* @layer 4 - Domain/Algorithms
|
|
5
|
-
*
|
|
6
|
-
* X3DH is the key agreement protocol used in the Signal Protocol to establish
|
|
7
|
-
* shared secrets between two parties. It provides mutual authentication,
|
|
8
|
-
* forward secrecy, and cryptographic deniability.
|
|
9
|
-
*
|
|
10
|
-
* @see https://signal.org/docs/specifications/x3dh/
|
|
11
|
-
*/
|
|
12
|
-
export {};
|
|
13
|
-
export { performX3DH, performX3DHResponder, calculateX3DHSharedSecret } from './x3dh.js';
|
|
14
|
-
export type { EphemeralKeyPair, X3DHResult, X3DHResponderResult, X3DHResponderInput } from './x3dh.js';
|
|
15
|
-
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC;AACV,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAEtF,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC"}
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* X3DH (Extended Triple Diffie-Hellman)
|
|
3
|
-
*
|
|
4
|
-
* @layer 4 - Domain/Algorithms
|
|
5
|
-
*
|
|
6
|
-
* X3DH is the key agreement protocol used in the Signal Protocol to establish
|
|
7
|
-
* shared secrets between two parties. It provides mutual authentication,
|
|
8
|
-
* forward secrecy, and cryptographic deniability.
|
|
9
|
-
*
|
|
10
|
-
* @see https://signal.org/docs/specifications/x3dh/
|
|
11
|
-
*/
|
|
12
|
-
export { performX3DH, performX3DHResponder, calculateX3DHSharedSecret } from './x3dh.js';
|
|
13
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC"}
|
|
@@ -1,131 +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 { type Logger } from '../../../logger.js';
|
|
16
|
-
import type { IdentityKeyPair, EcSignedPreKey, EcOneTimePreKey, PreKeyBundle, PublicKey, PrivateKey } from '../../../keys/index.js';
|
|
17
|
-
import type { Base64 } from '../../../types/index.js';
|
|
18
|
-
/**
|
|
19
|
-
* Ephemeral key pair for X3DH protocol
|
|
20
|
-
*/
|
|
21
|
-
export {};
|
|
22
|
-
export interface EphemeralKeyPair {
|
|
23
|
-
publicKey: PublicKey;
|
|
24
|
-
privateKey: PrivateKey;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* X3DH key agreement result
|
|
28
|
-
*/
|
|
29
|
-
export interface X3DHResult {
|
|
30
|
-
/** The shared secret derived from X3DH (32 bytes) - initial root key (SK) */
|
|
31
|
-
sharedSecret: Uint8Array;
|
|
32
|
-
/**
|
|
33
|
-
* Additional derived bytes from HKDF for compatibility.
|
|
34
|
-
* Bytes 32-64: Reserved by this wire format
|
|
35
|
-
* Bytes 64-96: Compatibility receiving chain key (the DH ratchet replaces it)
|
|
36
|
-
*
|
|
37
|
-
* Only present when derived with extended output size.
|
|
38
|
-
*/
|
|
39
|
-
additionalDerivedBytes?: Uint8Array;
|
|
40
|
-
/** Our ephemeral public key (sent to partner) */
|
|
41
|
-
ephemeralPublicKey: PublicKey;
|
|
42
|
-
/** Our ephemeral key pair (needed for session initialization as DHs) */
|
|
43
|
-
ephemeralKeyPair: EphemeralKeyPair;
|
|
44
|
-
/** ID of the signed prekey we used */
|
|
45
|
-
usedSignedPreKeyId: number;
|
|
46
|
-
/** ID of the one-time prekey we used (if any) */
|
|
47
|
-
usedOneTimePreKeyId?: number;
|
|
48
|
-
/** Kyber ciphertext for PQXDH (Kyber sessions only) */
|
|
49
|
-
kyberCiphertext?: Base64;
|
|
50
|
-
/** ID of the Kyber prekey we used (if any) */
|
|
51
|
-
usedKyberPreKeyId?: number;
|
|
52
|
-
/** Whether the session used PQXDH */
|
|
53
|
-
usedPQXDH: boolean;
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* X3DH responder result
|
|
57
|
-
*/
|
|
58
|
-
export interface X3DHResponderResult {
|
|
59
|
-
/** The shared secret derived from X3DH (32 bytes) - initial root key (SK) */
|
|
60
|
-
sharedSecret: Uint8Array;
|
|
61
|
-
/**
|
|
62
|
-
* Additional derived bytes from HKDF for compatibility.
|
|
63
|
-
* Only present when derived with extended output size.
|
|
64
|
-
*/
|
|
65
|
-
additionalDerivedBytes?: Uint8Array;
|
|
66
|
-
/** Whether the session used PQXDH */
|
|
67
|
-
usedPQXDH: boolean;
|
|
68
|
-
}
|
|
69
|
-
/**
|
|
70
|
-
* Information needed for X3DH responder to derive shared secret
|
|
71
|
-
*/
|
|
72
|
-
export interface X3DHResponderInput {
|
|
73
|
-
/** Sender's identity DH public key */
|
|
74
|
-
senderIdentityKey: PublicKey;
|
|
75
|
-
/** Sender's ephemeral public key from PreKeyMessage */
|
|
76
|
-
senderEphemeralKey: PublicKey;
|
|
77
|
-
/** ID of our signed prekey for this session */
|
|
78
|
-
usedSignedPreKeyId: number;
|
|
79
|
-
/** ID of our one-time prekey for this session (if any) */
|
|
80
|
-
usedOneTimePreKeyId?: number;
|
|
81
|
-
/** Kyber ciphertext for PQXDH (if any) */
|
|
82
|
-
kyberCiphertext?: Base64;
|
|
83
|
-
/** ID of our Kyber prekey for this session (if any) */
|
|
84
|
-
usedKyberPreKeyId?: number;
|
|
85
|
-
}
|
|
86
|
-
/**
|
|
87
|
-
* Run the X3DH key agreement as initiator (Alice)
|
|
88
|
-
*
|
|
89
|
-
* The caller invokes this when Alice wants to establish a session with Bob.
|
|
90
|
-
* Alice uses Bob's prekey bundle for the key agreement.
|
|
91
|
-
*
|
|
92
|
-
* @param myIdentityKey My identity key pair
|
|
93
|
-
* @param theirBundle Partner's prekey bundle
|
|
94
|
-
* @param infoString HKDF info string for key derivation
|
|
95
|
-
* @returns X3DH result containing shared secret and metadata
|
|
96
|
-
*
|
|
97
|
-
* @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
|
|
98
|
-
*/
|
|
99
|
-
export declare function performX3DH(myIdentityKey: IdentityKeyPair, theirBundle: PreKeyBundle, infoString: string, logger?: Required<Logger>): Promise<X3DHResult>;
|
|
100
|
-
/**
|
|
101
|
-
* Run the X3DH key agreement as responder (Bob)
|
|
102
|
-
*
|
|
103
|
-
* The caller invokes this when Bob receives Alice's PreKeyMessage.
|
|
104
|
-
* Bob uses his own prekeys and Alice's keys to derive the same shared secret.
|
|
105
|
-
*
|
|
106
|
-
* @param myIdentityKey My identity key pair
|
|
107
|
-
* @param mySignedPreKey My signed prekey for this session
|
|
108
|
-
* @param myOneTimePreKey My one-time prekey for this session (if any)
|
|
109
|
-
* @param input Information from Alice's PreKeyMessage
|
|
110
|
-
* @param infoString HKDF info string for key derivation
|
|
111
|
-
* @returns X3DH responder result containing shared secret
|
|
112
|
-
*
|
|
113
|
-
* @see https://signal.org/docs/specifications/x3dh/#the-x3dh-protocol
|
|
114
|
-
*/
|
|
115
|
-
export declare function performX3DHResponder(myIdentityKey: IdentityKeyPair, mySignedPreKey: EcSignedPreKey, myOneTimePreKey: EcOneTimePreKey | null, input: X3DHResponderInput, infoString: string, logger?: Required<Logger>): Promise<X3DHResponderResult>;
|
|
116
|
-
/**
|
|
117
|
-
* Calculate X3DH shared secret from DH outputs
|
|
118
|
-
*
|
|
119
|
-
* This is a lower-level function that takes pre-computed DH outputs
|
|
120
|
-
* and derives the shared secret. Useful when a caller runs the DH operations
|
|
121
|
-
* separately (e.g., with hardware security modules).
|
|
122
|
-
*
|
|
123
|
-
* @param dh1 DH1 output (IKa × SPKb or SPKb × IKa)
|
|
124
|
-
* @param dh2 DH2 output (EKa × IKb or IKb × EKa)
|
|
125
|
-
* @param dh3 DH3 output (EKa × SPKb or SPKb × EKa)
|
|
126
|
-
* @param dh4 DH4 output (EKa × OPKb or OPKb × EKa), optional
|
|
127
|
-
* @param infoString HKDF info string for key derivation
|
|
128
|
-
* @returns Shared secret (32 bytes)
|
|
129
|
-
*/
|
|
130
|
-
export declare function calculateX3DHSharedSecret(dh1: Uint8Array, dh2: Uint8Array, dh3: Uint8Array, dh4: Uint8Array | undefined, infoString: string): Promise<Uint8Array>;
|
|
131
|
-
//# sourceMappingURL=x3dh.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"x3dh.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/x3dh/x3dh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI3E,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,UAAU,EACX,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,YAAY,EAAE,UAAU,CAAC;IACzB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,UAAU,CAAC;IACpC,iDAAiD;IACjD,kBAAkB,EAAE,SAAS,CAAC;IAC9B,wEAAwE;IACxE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,YAAY,EAAE,UAAU,CAAC;IACzB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,UAAU,CAAC;IACpC,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,iBAAiB,EAAE,SAAS,CAAC;IAC7B,uDAAuD;IACvD,kBAAkB,EAAE,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,aAAa,EAAE,eAAe,EAC9B,WAAW,EAAE,YAAY,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAA+B,GACrD,OAAO,CAAC,UAAU,CAAC,CA6IrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,eAAe,EAC9B,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,eAAe,GAAG,IAAI,EACvC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAA+B,GACrD,OAAO,CAAC,mBAAmB,CAAC,CA6F9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAcrB"}
|