@open-e2ee/signal-protocol-sdk 8.1.0 → 9.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ADAPTERS.md +13 -31
- package/ARCHITECTURE.md +5 -7
- package/CHANGELOG.md +258 -0
- package/README.md +36 -48
- package/SECURITY.md +2 -2
- package/client/README.md +9 -0
- package/device/README.md +16 -7
- package/dist/client/client.d.ts +25 -16
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +115 -95
- package/dist/client/client.js.map +1 -1
- package/dist/client/config.d.ts +10 -17
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js.map +1 -1
- package/dist/client/event-hooks.js +27 -0
- package/dist/client/event-hooks.js.map +1 -1
- package/dist/client/group-outbox.d.ts +31 -1
- package/dist/client/group-outbox.d.ts.map +1 -1
- package/dist/client/group-outbox.js +67 -58
- package/dist/client/group-outbox.js.map +1 -1
- package/dist/client/group-receive-authorization.d.ts +5 -0
- package/dist/client/group-receive-authorization.d.ts.map +1 -0
- package/dist/client/group-receive-authorization.js +32 -0
- package/dist/client/group-receive-authorization.js.map +1 -0
- package/dist/client/group-sender-key-operations.d.ts +15 -0
- package/dist/client/group-sender-key-operations.d.ts.map +1 -0
- package/dist/client/group-sender-key-operations.js +31 -0
- package/dist/client/group-sender-key-operations.js.map +1 -0
- package/dist/client/groups.d.ts +3 -1
- package/dist/client/groups.d.ts.map +1 -1
- package/dist/client/groups.js +5 -2
- package/dist/client/groups.js.map +1 -1
- package/dist/client/hosted-anonymous-delivery.d.ts +9 -1
- package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
- package/dist/client/hosted-anonymous-delivery.js +61 -22
- package/dist/client/hosted-anonymous-delivery.js.map +1 -1
- package/dist/client/hosted-transport.d.ts +7 -0
- package/dist/client/hosted-transport.d.ts.map +1 -1
- package/dist/client/hosted-transport.js +44 -6
- package/dist/client/hosted-transport.js.map +1 -1
- package/dist/client/key-rotation.d.ts.map +1 -1
- package/dist/client/key-rotation.js +2 -4
- package/dist/client/key-rotation.js.map +1 -1
- package/dist/client/prekeys.d.ts.map +1 -1
- package/dist/client/prekeys.js +1 -1
- package/dist/client/prekeys.js.map +1 -1
- package/dist/client/relay-device-refusal.d.ts +32 -0
- package/dist/client/relay-device-refusal.d.ts.map +1 -0
- package/dist/client/relay-device-refusal.js +36 -0
- package/dist/client/relay-device-refusal.js.map +1 -0
- package/dist/client/relay-subscription.d.ts +2 -0
- package/dist/client/relay-subscription.d.ts.map +1 -1
- package/dist/client/relay-subscription.js +3 -1
- package/dist/client/relay-subscription.js.map +1 -1
- package/dist/client/relay-work.d.ts +26 -0
- package/dist/client/relay-work.d.ts.map +1 -1
- package/dist/client/relay-work.js +37 -0
- package/dist/client/relay-work.js.map +1 -1
- package/dist/client/sealed-sender.d.ts.map +1 -1
- package/dist/client/sealed-sender.js +12 -17
- package/dist/client/sealed-sender.js.map +1 -1
- package/dist/client/sender-key-distribution.d.ts.map +1 -1
- package/dist/client/sender-key-distribution.js +4 -1
- package/dist/client/sender-key-distribution.js.map +1 -1
- package/dist/client/sessions.d.ts.map +1 -1
- package/dist/client/sessions.js +2 -4
- package/dist/client/sessions.js.map +1 -1
- package/dist/client/signal-service-cipher.d.ts +94 -6
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +483 -184
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/types.d.ts +7 -0
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js.map +1 -1
- package/dist/index.d.ts +27 -21
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -17
- package/dist/index.js.map +1 -1
- package/dist/internal/crypto/pq/kyber.d.ts +1 -1
- package/dist/internal/crypto/pq/kyber.js +1 -1
- package/dist/internal/encoding/proto/sender-key-message.d.ts +2 -2
- package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -1
- package/dist/internal/encoding/proto/sender-key-message.js +5 -2
- package/dist/internal/encoding/proto/sender-key-message.js.map +1 -1
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +5 -2
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/groups/wire.d.ts +0 -2
- package/dist/internal/groups/wire.d.ts.map +1 -1
- package/dist/internal/groups/wire.js +0 -6
- package/dist/internal/groups/wire.js.map +1 -1
- package/dist/internal/manager/manager.d.ts +8 -7
- package/dist/internal/manager/manager.d.ts.map +1 -1
- package/dist/internal/manager/manager.js +34 -37
- package/dist/internal/manager/manager.js.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts +0 -17
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -1
- package/dist/internal/protocol/double-ratchet/ratchet.js +0 -4
- package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/certificate.d.ts +2 -32
- package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/certificate.js +4 -85
- package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/index.d.ts +2 -2
- package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/index.js +2 -6
- package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts +0 -19
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.js +1 -48
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +9 -13
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +90 -95
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/index.d.ts +1 -1
- 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/ml-kem-braid/incremental-kem.d.ts +0 -2
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +4 -12
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +1 -3
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/serialize.js +1 -4
- package/dist/internal/protocol/spqr/serialize.js.map +1 -1
- package/dist/internal/protocol/spqr/spqr.d.ts +1 -1
- package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -1
- package/dist/internal/protocol/spqr/spqr.js +2 -3
- package/dist/internal/protocol/spqr/spqr.js.map +1 -1
- package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -1
- package/dist/internal/protocol/x3dh/x3dh.js +1 -1
- package/dist/internal/protocol/x3dh/x3dh.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/credentials.d.ts +3 -54
- package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/credentials.js +4 -91
- package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/endorsements.d.ts +3 -64
- package/dist/internal/protocol/zk/credentials/endorsements.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/endorsements.js +4 -134
- package/dist/internal/protocol/zk/credentials/endorsements.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/index.d.ts +3 -3
- package/dist/internal/protocol/zk/credentials/index.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/index.js +3 -3
- package/dist/internal/protocol/zk/credentials/index.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/issuance.d.ts +3 -26
- package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/issuance.js +3 -80
- package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -1
- package/dist/internal/protocol/zk/credentials/presentation.d.ts +4 -73
- package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -1
- package/dist/internal/protocol/zk/credentials/presentation.js +4 -152
- package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts +1 -61
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/auth-credential.js +2 -196
- package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -1
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +1 -86
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js +1 -152
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -1
- package/dist/internal/protocol/zk/groups/index.d.ts +4 -4
- package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/index.js +4 -4
- package/dist/internal/protocol/zk/groups/index.js.map +1 -1
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +2 -57
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/profile-key-credential.js +2 -174
- package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
- package/dist/internal/protocol/zk/groups/server-params.d.ts +8 -72
- package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/server-params.js +8 -108
- package/dist/internal/protocol/zk/groups/server-params.js.map +1 -1
- package/dist/internal/protocol/zk/proofs/sign.d.ts +1 -2
- package/dist/internal/protocol/zk/proofs/sign.d.ts.map +1 -1
- package/dist/internal/protocol/zk/proofs/sign.js +2 -11
- package/dist/internal/protocol/zk/proofs/sign.js.map +1 -1
- package/dist/internal/sesame/device-registry.d.ts +24 -4
- package/dist/internal/sesame/device-registry.d.ts.map +1 -1
- package/dist/internal/sesame/device-registry.js +55 -28
- package/dist/internal/sesame/device-registry.js.map +1 -1
- package/dist/internal/sesame/manager.d.ts +79 -11
- package/dist/internal/sesame/manager.d.ts.map +1 -1
- package/dist/internal/sesame/manager.js +381 -280
- package/dist/internal/sesame/manager.js.map +1 -1
- package/dist/internal/session/cipher.d.ts +0 -5
- package/dist/internal/session/cipher.d.ts.map +1 -1
- package/dist/internal/session/cipher.js +3 -9
- package/dist/internal/session/cipher.js.map +1 -1
- package/dist/internal/session/ratchet.d.ts.map +1 -1
- package/dist/internal/session/ratchet.js +0 -2
- package/dist/internal/session/ratchet.js.map +1 -1
- package/dist/internal/session/record-locks.d.ts +46 -0
- package/dist/internal/session/record-locks.d.ts.map +1 -0
- package/dist/internal/session/record-locks.js +72 -0
- package/dist/internal/session/record-locks.js.map +1 -0
- package/dist/local/store/expo/adapter.d.ts +8 -2
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +24 -3
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/driver.d.ts +7 -0
- package/dist/local/store/expo/driver.d.ts.map +1 -1
- package/dist/local/store/expo/driver.js +16 -0
- package/dist/local/store/expo/driver.js.map +1 -1
- package/dist/local/store/key-value/adapter.d.ts +3 -3
- package/dist/local/store/key-value/adapter.d.ts.map +1 -1
- package/dist/local/store/key-value/adapter.js +91 -53
- 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 +25 -0
- package/dist/local/store/key-value/backend-conformance.js.map +1 -1
- package/dist/local/store/key-value/batch.d.ts +3 -1
- package/dist/local/store/key-value/batch.d.ts.map +1 -1
- package/dist/local/store/key-value/batch.js +9 -1
- package/dist/local/store/key-value/batch.js.map +1 -1
- package/dist/local/store/key-value/storage.d.ts +6 -0
- package/dist/local/store/key-value/storage.d.ts.map +1 -1
- package/dist/local/store/key-value/transactional-backend.d.ts +1 -1
- package/dist/local/store/key-value/transactional-backend.js +1 -1
- package/dist/local/store/memory/adapter.d.ts +13 -3
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +122 -73
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/reliability.d.ts +16 -0
- package/dist/local/store/reliability.d.ts.map +1 -1
- package/dist/local/store/reliability.js +58 -28
- package/dist/local/store/reliability.js.map +1 -1
- package/dist/local/store/sqlite/migrations.d.ts.map +1 -1
- package/dist/local/store/sqlite/migrations.js +18 -0
- package/dist/local/store/sqlite/migrations.js.map +1 -1
- package/dist/local/store/sqlite/models/skipped-sender-key.d.ts +3 -3
- package/dist/local/store/sqlite/models/skipped-sender-key.d.ts.map +1 -1
- package/dist/local/store/sqlite/models/skipped-sender-key.js +13 -17
- package/dist/local/store/sqlite/models/skipped-sender-key.js.map +1 -1
- package/dist/local/store/sqlite/store.d.ts +3 -3
- package/dist/local/store/sqlite/store.d.ts.map +1 -1
- package/dist/local/store/sqlite/store.js +53 -23
- package/dist/local/store/sqlite/store.js.map +1 -1
- package/dist/local/store/web/adapter.d.ts +3 -3
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +122 -73
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/local/vault/electron-safe-storage.d.ts.map +1 -1
- package/dist/local/vault/electron-safe-storage.js +15 -2
- package/dist/local/vault/electron-safe-storage.js.map +1 -1
- package/dist/profile/index.d.ts +2 -1
- package/dist/profile/index.d.ts.map +1 -1
- package/dist/profile/index.js +2 -1
- package/dist/profile/index.js.map +1 -1
- package/dist/profile/own-profile-key.d.ts +42 -0
- package/dist/profile/own-profile-key.d.ts.map +1 -0
- package/dist/profile/own-profile-key.js +64 -0
- package/dist/profile/own-profile-key.js.map +1 -0
- package/dist/profile/profile-key.d.ts +1 -34
- package/dist/profile/profile-key.d.ts.map +1 -1
- package/dist/profile/profile-key.js +3 -63
- package/dist/profile/profile-key.js.map +1 -1
- package/dist/profile/update-service.js +1 -1
- package/dist/profile/update-service.js.map +1 -1
- package/dist/remote/relay/index.d.ts +4 -7
- package/dist/remote/relay/index.d.ts.map +1 -1
- package/dist/remote/relay/index.js +5 -7
- package/dist/remote/relay/index.js.map +1 -1
- package/dist/remote/relay/types.d.ts +3 -3
- package/dist/types/api.d.ts +29 -8
- package/dist/types/api.d.ts.map +1 -1
- package/dist/username/link.d.ts.map +1 -1
- package/dist/username/link.js +1 -5
- package/dist/username/link.js.map +1 -1
- package/dist/utils/bounded-fan-out.d.ts +99 -0
- package/dist/utils/bounded-fan-out.d.ts.map +1 -0
- package/dist/utils/bounded-fan-out.js +180 -0
- package/dist/utils/bounded-fan-out.js.map +1 -0
- package/dist/utils/keyed-lock.d.ts +16 -0
- package/dist/utils/keyed-lock.d.ts.map +1 -0
- package/dist/utils/keyed-lock.js +39 -0
- package/dist/utils/keyed-lock.js.map +1 -0
- package/dist/versions.d.ts +3 -3
- package/dist/versions.js +3 -3
- package/dist/zk/credentials.d.ts +2 -2
- package/dist/zk/credentials.js +2 -2
- package/dist/zk/groups.d.ts +3 -3
- package/dist/zk/groups.d.ts.map +1 -1
- package/dist/zk/groups.js +3 -3
- package/dist/zk/groups.js.map +1 -1
- package/docs/ASSURANCE.md +69 -28
- package/docs/CLIENT_COMPOSITION.md +9 -3
- package/docs/DEVIATIONS.md +45 -27
- package/docs/GETTING_STARTED.md +42 -320
- package/docs/INTERFACES.md +7 -7
- package/docs/PACKAGE_SURFACE.md +14 -16
- package/docs/RECIPES.md +6 -112
- package/groups/README.md +9 -1
- package/hooks/README.md +11 -2
- package/local/store/README.md +26 -6
- package/local/store/expo/README.md +18 -5
- package/local/store/key-value/README.md +5 -3
- package/local/store/node/README.md +2 -1
- package/local/store/web-sqlite/README.md +28 -8
- package/local/vault/README.md +21 -2
- package/package.json +1 -30
- package/remote/README.md +12 -78
- package/remote/object-store/convex-r2/README.md +20 -42
- package/remote/relay/README.md +21 -18
- package/zk/README.md +6 -7
- package/dist/client/dual-store.d.ts +0 -70
- package/dist/client/dual-store.d.ts.map +0 -1
- package/dist/client/dual-store.js +0 -123
- package/dist/client/dual-store.js.map +0 -1
- package/dist/client/multi-device.d.ts +0 -74
- package/dist/client/multi-device.d.ts.map +0 -1
- package/dist/client/multi-device.js +0 -105
- package/dist/client/multi-device.js.map +0 -1
- package/dist/groups/server.d.ts +0 -10
- package/dist/groups/server.d.ts.map +0 -1
- package/dist/groups/server.js +0 -6
- package/dist/groups/server.js.map +0 -1
- package/dist/internal/encoding/index.d.ts +0 -2
- package/dist/internal/encoding/index.d.ts.map +0 -1
- package/dist/internal/encoding/index.js +0 -2
- package/dist/internal/encoding/index.js.map +0 -1
- package/dist/internal/groups/server-engine.d.ts +0 -118
- package/dist/internal/groups/server-engine.d.ts.map +0 -1
- package/dist/internal/groups/server-engine.js +0 -1268
- package/dist/internal/groups/server-engine.js.map +0 -1
- package/dist/internal/protocol/index.d.ts +0 -24
- package/dist/internal/protocol/index.d.ts.map +0 -1
- package/dist/internal/protocol/index.js +0 -9
- package/dist/internal/protocol/index.js.map +0 -1
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts +0 -56
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +0 -1
- package/dist/internal/protocol/sealed-sender/trust-root.js +0 -90
- package/dist/internal/protocol/sealed-sender/trust-root.js.map +0 -1
- package/dist/internal/protocol/triple-ratchet/index.d.ts +0 -21
- package/dist/internal/protocol/triple-ratchet/index.d.ts.map +0 -1
- package/dist/internal/protocol/triple-ratchet/index.js +0 -19
- package/dist/internal/protocol/triple-ratchet/index.js.map +0 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +0 -233
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +0 -1
- package/dist/internal/protocol/triple-ratchet/ratchet.js +0 -254
- package/dist/internal/protocol/triple-ratchet/ratchet.js.map +0 -1
- package/dist/internal/protocol/zk/proofs/index.d.ts +0 -13
- package/dist/internal/protocol/zk/proofs/index.d.ts.map +0 -1
- package/dist/internal/protocol/zk/proofs/index.js +0 -7
- package/dist/internal/protocol/zk/proofs/index.js.map +0 -1
- package/dist/local/store/sqlite/index.d.ts +0 -20
- package/dist/local/store/sqlite/index.d.ts.map +0 -1
- package/dist/local/store/sqlite/index.js +0 -18
- package/dist/local/store/sqlite/index.js.map +0 -1
- package/dist/remote/object-store/convex-r2/server/index.d.ts +0 -2
- package/dist/remote/object-store/convex-r2/server/index.d.ts.map +0 -1
- package/dist/remote/object-store/convex-r2/server/index.js +0 -2
- package/dist/remote/object-store/convex-r2/server/index.js.map +0 -1
- package/dist/remote/object-store/convex-r2/server.d.ts +0 -129
- package/dist/remote/object-store/convex-r2/server.d.ts.map +0 -1
- package/dist/remote/object-store/convex-r2/server.js +0 -244
- package/dist/remote/object-store/convex-r2/server.js.map +0 -1
- package/dist/remote/relay/memory/adapter.d.ts +0 -252
- package/dist/remote/relay/memory/adapter.d.ts.map +0 -1
- package/dist/remote/relay/memory/adapter.js +0 -1058
- package/dist/remote/relay/memory/adapter.js.map +0 -1
- package/dist/remote/relay/memory/failures.d.ts +0 -58
- package/dist/remote/relay/memory/failures.d.ts.map +0 -1
- package/dist/remote/relay/memory/failures.js +0 -124
- package/dist/remote/relay/memory/failures.js.map +0 -1
- package/dist/remote/relay/memory/group-server.d.ts +0 -13
- package/dist/remote/relay/memory/group-server.d.ts.map +0 -1
- package/dist/remote/relay/memory/group-server.js +0 -19
- package/dist/remote/relay/memory/group-server.js.map +0 -1
- package/dist/remote/relay/memory/index.d.ts +0 -11
- package/dist/remote/relay/memory/index.d.ts.map +0 -1
- package/dist/remote/relay/memory/index.js +0 -7
- package/dist/remote/relay/memory/index.js.map +0 -1
- package/examples/browser/README.md +0 -35
- package/examples/browser/index.html +0 -27
- package/examples/browser/src/exchange.ts +0 -69
- package/examples/browser/src/main.ts +0 -63
- package/examples/browser/src/style.css +0 -9
- package/examples/browser/src/worker.ts +0 -10
- package/examples/browser/vite.config.ts +0 -9
- package/remote/relay/memory/README.md +0 -72
- package/scripts/oe-groups.mjs +0 -166
|
@@ -88,20 +88,10 @@ export interface UnidentifiedSenderMessageProto {
|
|
|
88
88
|
encryptedStatic: Uint8Array;
|
|
89
89
|
encryptedMessage: Uint8Array;
|
|
90
90
|
}
|
|
91
|
-
/**
|
|
92
|
-
* Encode server certificate inner Certificate data to protobuf bytes.
|
|
93
|
-
*
|
|
94
|
-
* These are the bytes the trust root signs.
|
|
95
|
-
*/
|
|
96
|
-
export declare function encodeServerCertificateData(data: ServerCertificateData): Uint8Array;
|
|
97
91
|
/**
|
|
98
92
|
* Decode server certificate inner Certificate data from protobuf bytes.
|
|
99
93
|
*/
|
|
100
94
|
export declare function decodeServerCertificateData(bytes: Uint8Array): ServerCertificateData;
|
|
101
|
-
/**
|
|
102
|
-
* Encode server certificate outer wrapper to protobuf bytes.
|
|
103
|
-
*/
|
|
104
|
-
export declare function encodeServerCertificate(cert: ServerCertificateProto): Uint8Array;
|
|
105
95
|
/**
|
|
106
96
|
* Decode server certificate outer wrapper from protobuf bytes.
|
|
107
97
|
*
|
|
@@ -109,15 +99,6 @@ export declare function encodeServerCertificate(cert: ServerCertificateProto): U
|
|
|
109
99
|
* the signature covers.
|
|
110
100
|
*/
|
|
111
101
|
export declare function decodeServerCertificate(bytes: Uint8Array): ServerCertificateProto;
|
|
112
|
-
/**
|
|
113
|
-
* Encode sender certificate inner Certificate data to protobuf bytes.
|
|
114
|
-
* Field numbers are part of the sealed-sender wire format.
|
|
115
|
-
*
|
|
116
|
-
* These are the bytes the issuing server signs. Fields are written in field
|
|
117
|
-
* number order. `senderE164` is written only when the sender has one, which is
|
|
118
|
-
* the one field a certificate may legitimately omit.
|
|
119
|
-
*/
|
|
120
|
-
export declare function encodeSenderCertificateData(data: SenderCertificateData): Uint8Array;
|
|
121
102
|
/**
|
|
122
103
|
* Decode sender certificate inner Certificate data from protobuf bytes.
|
|
123
104
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../internal/protocol/sealed-sender/proto/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../internal/protocol/sealed-sender/proto/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAYnD;;GAEG;AACH,OAAO,EAAE,CAAC;AACV,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,CAAC;IACxB,iBAAiB,EAAE,UAAU,CAAC;IAC9B,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,IAAI,WAAW,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,uBAAuB,CAAC;IAC9B,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,UAAU,CAAC;IAC5B,eAAe,EAAE,UAAU,CAAC;IAC5B,gBAAgB,EAAE,UAAU,CAAC;CAC9B;AA0DD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CA6BpF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,sBAAsB,CAqBjF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAoDpF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,sBAAsB,CAqBjF;AAMD;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,6BAA6B,GAClC,UAAU,CAmBZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,UAAU,GAChB,6BAA6B,CA0C/B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,8BAA8B,GAAG,UAAU,CAM/F;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,UAAU,GAAG,8BAA8B,CAyBjG;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAExD"}
|
|
@@ -30,7 +30,7 @@ import { SealedSenderContentType } from '../types.js';
|
|
|
30
30
|
* barrel. The relay component bundles this codec, and a bundler parses every
|
|
31
31
|
* module the barrel reaches, whether or not a server runs it. */
|
|
32
32
|
import { bytesToBase64, base64ToBytes } from '../../../crypto/utils.js';
|
|
33
|
-
import { ProtoReader, concatFields, encodeBytesField, encodeEnumField,
|
|
33
|
+
import { ProtoReader, concatFields, encodeBytesField, encodeEnumField, encodeMessageField, encodeUint32Field } from '../../../encoding/proto/primitives.js';
|
|
34
34
|
/**
|
|
35
35
|
* Message type enum (matches proto).
|
|
36
36
|
*
|
|
@@ -86,23 +86,6 @@ const UNIDENTIFIED_SENDER_MESSAGE = {
|
|
|
86
86
|
function emptyBytes() {
|
|
87
87
|
return new Uint8Array(0);
|
|
88
88
|
}
|
|
89
|
-
// ============================================================================
|
|
90
|
-
// Server Certificate Encoding
|
|
91
|
-
// ============================================================================
|
|
92
|
-
/**
|
|
93
|
-
* Encode server certificate inner Certificate data to protobuf bytes.
|
|
94
|
-
*
|
|
95
|
-
* These are the bytes the trust root signs.
|
|
96
|
-
*/
|
|
97
|
-
export function encodeServerCertificateData(data) {
|
|
98
|
-
const parts = [
|
|
99
|
-
encodeUint32Field(SERVER_CERTIFICATE_DATA.id, data.id),
|
|
100
|
-
encodeBytesField(SERVER_CERTIFICATE_DATA.key, data.key),
|
|
101
|
-
];
|
|
102
|
-
parts.push(encodeFixed64Field(SERVER_CERTIFICATE_DATA.notBefore, BigInt(data.notBefore)));
|
|
103
|
-
parts.push(encodeFixed64Field(SERVER_CERTIFICATE_DATA.notAfter, BigInt(data.notAfter)));
|
|
104
|
-
return concatFields(...parts);
|
|
105
|
-
}
|
|
106
89
|
/**
|
|
107
90
|
* Decode server certificate inner Certificate data from protobuf bytes.
|
|
108
91
|
*/
|
|
@@ -134,12 +117,6 @@ export function decodeServerCertificateData(bytes) {
|
|
|
134
117
|
}
|
|
135
118
|
return { id, key, notBefore, notAfter };
|
|
136
119
|
}
|
|
137
|
-
/**
|
|
138
|
-
* Encode server certificate outer wrapper to protobuf bytes.
|
|
139
|
-
*/
|
|
140
|
-
export function encodeServerCertificate(cert) {
|
|
141
|
-
return concatFields(encodeBytesField(SERVER_CERTIFICATE.certificate, cert.certificate), encodeBytesField(SERVER_CERTIFICATE.signature, cert.signature));
|
|
142
|
-
}
|
|
143
120
|
/**
|
|
144
121
|
* Decode server certificate outer wrapper from protobuf bytes.
|
|
145
122
|
*
|
|
@@ -166,30 +143,6 @@ export function decodeServerCertificate(bytes) {
|
|
|
166
143
|
}
|
|
167
144
|
return { certificate, signature };
|
|
168
145
|
}
|
|
169
|
-
// ============================================================================
|
|
170
|
-
// Sender Certificate Encoding
|
|
171
|
-
// ============================================================================
|
|
172
|
-
/**
|
|
173
|
-
* Encode sender certificate inner Certificate data to protobuf bytes.
|
|
174
|
-
* Field numbers are part of the sealed-sender wire format.
|
|
175
|
-
*
|
|
176
|
-
* These are the bytes the issuing server signs. Fields are written in field
|
|
177
|
-
* number order. `senderE164` is written only when the sender has one, which is
|
|
178
|
-
* the one field a certificate may legitimately omit.
|
|
179
|
-
*/
|
|
180
|
-
export function encodeSenderCertificateData(data) {
|
|
181
|
-
const parts = [];
|
|
182
|
-
if (data.senderE164) {
|
|
183
|
-
parts.push(encodeStringField(SENDER_CERTIFICATE_DATA.senderE164, data.senderE164));
|
|
184
|
-
}
|
|
185
|
-
parts.push(encodeUint32Field(SENDER_CERTIFICATE_DATA.senderDevice, data.senderDevice));
|
|
186
|
-
parts.push(encodeFixed64Field(SENDER_CERTIFICATE_DATA.expires, BigInt(data.expires)));
|
|
187
|
-
parts.push(encodeBytesField(SENDER_CERTIFICATE_DATA.identityKey, data.identityKey));
|
|
188
|
-
parts.push(encodeBytesField(SENDER_CERTIFICATE_DATA.signerCertificate, data.signerCertificate));
|
|
189
|
-
parts.push(encodeStringField(SENDER_CERTIFICATE_DATA.senderUuid, data.senderUuid));
|
|
190
|
-
parts.push(encodeBytesField(SENDER_CERTIFICATE_DATA.relayScopeId, data.relayScopeId));
|
|
191
|
-
return concatFields(...parts);
|
|
192
|
-
}
|
|
193
146
|
/**
|
|
194
147
|
* Decode sender certificate inner Certificate data from protobuf bytes.
|
|
195
148
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../internal/protocol/sealed-sender/proto/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnD;;iEAEiE;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../internal/protocol/sealed-sender/proto/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -39,7 +39,7 @@ export interface SenderKeyState {
|
|
|
39
39
|
/**
|
|
40
40
|
* Sender key wire format version for protocol evolution.
|
|
41
41
|
*
|
|
42
|
-
* Format '
|
|
42
|
+
* Format 'v2': Ed25519 signatures, AES-256-CBC, and HKDF-Extract then Expand
|
|
43
43
|
* Future versions may support format changes or algorithm upgrades.
|
|
44
44
|
*/
|
|
45
45
|
senderKeyVersion: string;
|
|
@@ -72,6 +72,7 @@ export interface SenderKeyState {
|
|
|
72
72
|
distributionPending?: boolean;
|
|
73
73
|
}
|
|
74
74
|
export interface SenderKeyDistributionMessage {
|
|
75
|
+
senderKeyVersion: string;
|
|
75
76
|
senderKeyId: string;
|
|
76
77
|
chainId: number;
|
|
77
78
|
generation: number;
|
|
@@ -86,6 +87,10 @@ export interface EncryptedGroupMessage {
|
|
|
86
87
|
ciphertext: string;
|
|
87
88
|
signature: string;
|
|
88
89
|
}
|
|
90
|
+
/** Reject sender-key state or a distribution in an unsupported format. */
|
|
91
|
+
export declare function assertSenderKeyVersion(state: {
|
|
92
|
+
senderKeyVersion: string;
|
|
93
|
+
}): void;
|
|
89
94
|
export declare class SenderKeyManager {
|
|
90
95
|
private storage;
|
|
91
96
|
/** Resolved configuration values */
|
|
@@ -103,16 +108,14 @@ export declare class SenderKeyManager {
|
|
|
103
108
|
* getSenderKeyRecord (when available). On cache miss, previous states
|
|
104
109
|
* are loaded from storage.
|
|
105
110
|
*
|
|
106
|
-
* Key format:
|
|
111
|
+
* Key format: JSON tuple [groupId, userId, deviceId].
|
|
107
112
|
* Value: Array of previous states (most recent first), capped at MAX_SENDER_KEY_STATES - 1
|
|
108
113
|
* (the current state is in storage, previous states are here)
|
|
109
114
|
*/
|
|
110
115
|
private readonly previousStates;
|
|
111
116
|
private readonly logger;
|
|
112
117
|
constructor(storage: SignalProtocolLocalStore, config?: SenderKeysConfig, logger?: Required<Logger>);
|
|
113
|
-
/**
|
|
114
|
-
* Get the storage key for the previousStates map.
|
|
115
|
-
*/
|
|
118
|
+
/** Encode each cache address component separately, including delimiters in names. */
|
|
116
119
|
private stateKey;
|
|
117
120
|
/**
|
|
118
121
|
* Convert decrypted bytes into a lossless string representation.
|
|
@@ -245,13 +248,6 @@ export declare class SenderKeyManager {
|
|
|
245
248
|
* @returns Decrypted plaintext, or null if no matching state found
|
|
246
249
|
*/
|
|
247
250
|
private tryDecryptWithPreviousState;
|
|
248
|
-
/**
|
|
249
|
-
* Store skipped key with enforcement of maxSkippedKeys limit.
|
|
250
|
-
*
|
|
251
|
-
* If the limit is reached, deletes oldest keys to make room.
|
|
252
|
-
* The reference implementation uses capacity-only limits (no time-based expiration).
|
|
253
|
-
*/
|
|
254
|
-
private storeSkippedKeyWithLimit;
|
|
255
251
|
/**
|
|
256
252
|
* Rotate sender key (forward secrecy on membership changes)
|
|
257
253
|
*
|
|
@@ -305,7 +301,7 @@ export declare class SenderKeyManager {
|
|
|
305
301
|
*
|
|
306
302
|
* Two-step derivation:
|
|
307
303
|
* 1. Seed = HMAC-SHA256(Chain Key, 0x01)
|
|
308
|
-
* 2. Derived = HKDF
|
|
304
|
+
* 2. Derived = HKDF(Seed, zero salt, info, 48 bytes)
|
|
309
305
|
* - IV: bytes 0-15 (16 bytes for AES-CBC)
|
|
310
306
|
* - Cipher Key: bytes 16-47 (32 bytes)
|
|
311
307
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sender-keys/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sender-keys/manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -93,6 +93,12 @@ function resolveMaxSenderKeyAge(configured, logger) {
|
|
|
93
93
|
}
|
|
94
94
|
return configured;
|
|
95
95
|
}
|
|
96
|
+
/** Reject sender-key state or a distribution in an unsupported format. */
|
|
97
|
+
export function assertSenderKeyVersion(state) {
|
|
98
|
+
if (state.senderKeyVersion !== SENDER_KEY_FORMAT) {
|
|
99
|
+
throw new Error('Unsupported sender-key format. Reset group sender-key state and redistribute keys.');
|
|
100
|
+
}
|
|
101
|
+
}
|
|
96
102
|
export class SenderKeyManager {
|
|
97
103
|
storage;
|
|
98
104
|
/** Resolved configuration values */
|
|
@@ -110,7 +116,7 @@ export class SenderKeyManager {
|
|
|
110
116
|
* getSenderKeyRecord (when available). On cache miss, previous states
|
|
111
117
|
* are loaded from storage.
|
|
112
118
|
*
|
|
113
|
-
* Key format:
|
|
119
|
+
* Key format: JSON tuple [groupId, userId, deviceId].
|
|
114
120
|
* Value: Array of previous states (most recent first), capped at MAX_SENDER_KEY_STATES - 1
|
|
115
121
|
* (the current state is in storage, previous states are here)
|
|
116
122
|
*/
|
|
@@ -125,11 +131,9 @@ export class SenderKeyManager {
|
|
|
125
131
|
this.maxSkippedKeys = config?.maxSkippedKeys ?? SENDER_KEYS_DEFAULTS.maxSkippedKeys;
|
|
126
132
|
this.maxSenderKeyAge = resolveMaxSenderKeyAge(config?.maxSenderKeyAge, this.logger);
|
|
127
133
|
}
|
|
128
|
-
/**
|
|
129
|
-
* Get the storage key for the previousStates map.
|
|
130
|
-
*/
|
|
134
|
+
/** Encode each cache address component separately, including delimiters in names. */
|
|
131
135
|
stateKey(groupId, userId, deviceId) {
|
|
132
|
-
return
|
|
136
|
+
return JSON.stringify([groupId, userId, deviceId]);
|
|
133
137
|
}
|
|
134
138
|
/**
|
|
135
139
|
* Convert decrypted bytes into a lossless string representation.
|
|
@@ -230,6 +234,7 @@ export class SenderKeyManager {
|
|
|
230
234
|
this.previousStates.set(this.stateKey(groupId, userId, deviceId), []);
|
|
231
235
|
// Create distribution message (to send to other members)
|
|
232
236
|
const distributionMessage = {
|
|
237
|
+
senderKeyVersion: SENDER_KEY_FORMAT,
|
|
233
238
|
senderKeyId,
|
|
234
239
|
chainId,
|
|
235
240
|
generation: 1,
|
|
@@ -258,9 +263,11 @@ export class SenderKeyManager {
|
|
|
258
263
|
* @param message - Distribution message with key material
|
|
259
264
|
*/
|
|
260
265
|
async processSenderKeyDistribution(groupId, senderId, senderDeviceId, message) {
|
|
266
|
+
assertSenderKeyVersion(message);
|
|
261
267
|
// Validate against existing state (Specification Section 3.4)
|
|
262
268
|
const existing = await this.storage.getSenderKey(groupId, senderId, senderDeviceId);
|
|
263
269
|
if (existing !== null) {
|
|
270
|
+
assertSenderKeyVersion(existing);
|
|
264
271
|
// Reject if generation is lower (stale distribution)
|
|
265
272
|
if (message.generation < existing.generation) {
|
|
266
273
|
this.logger.debug('Rejected stale distribution (lower generation)', {
|
|
@@ -316,27 +323,13 @@ export class SenderKeyManager {
|
|
|
316
323
|
chainIndex: message.chainIndex ?? 0,
|
|
317
324
|
createdAt: Date.now(), // Received keys track when we got them (not checked for expiration)
|
|
318
325
|
};
|
|
319
|
-
//
|
|
320
|
-
// This allows decryption of in-flight messages encrypted with the
|
|
321
|
-
// previous key during the rotation window.
|
|
326
|
+
// Build the candidate archive without changing the committed cache.
|
|
322
327
|
const key = this.stateKey(groupId, senderId, senderDeviceId);
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
// Add current state to front of previous states (most recent first)
|
|
327
|
-
prev.unshift(existing);
|
|
328
|
-
// Cap at MAX_SENDER_KEY_STATES - 1 (the new state goes to storage)
|
|
329
|
-
while (prev.length >= MAX_SENDER_KEY_STATES) {
|
|
330
|
-
prev.pop();
|
|
331
|
-
}
|
|
332
|
-
this.previousStates.set(key, prev);
|
|
333
|
-
}
|
|
334
|
-
else {
|
|
335
|
-
prev = [];
|
|
336
|
-
this.previousStates.set(key, prev);
|
|
337
|
-
}
|
|
338
|
-
// Store sender key record (current + previous states) for this member
|
|
328
|
+
const prev = existing !== null
|
|
329
|
+
? [existing, ...(await this.loadPreviousStates(groupId, senderId, senderDeviceId))].slice(0, MAX_SENDER_KEY_STATES - 1)
|
|
330
|
+
: [];
|
|
339
331
|
await this.persistSenderKeyRecord(groupId, senderId, senderDeviceId, state, prev);
|
|
332
|
+
this.previousStates.set(key, prev);
|
|
340
333
|
this.logger.debug('Stored sender key', {
|
|
341
334
|
category: 'E2EE',
|
|
342
335
|
data: { senderKeyId: message.senderKeyId, senderId, senderDeviceId },
|
|
@@ -358,6 +351,7 @@ export class SenderKeyManager {
|
|
|
358
351
|
if (!state) {
|
|
359
352
|
throw new Error('SENDER_KEY_NOT_FOUND: No sender key for this group');
|
|
360
353
|
}
|
|
354
|
+
assertSenderKeyVersion(state);
|
|
361
355
|
// Received keys have no private signature key, so time-based expiration
|
|
362
356
|
// applies only to locally created encryption keys.
|
|
363
357
|
if (state.signatureKey) {
|
|
@@ -399,7 +393,7 @@ export class SenderKeyManager {
|
|
|
399
393
|
// Derive message key from chain key (Signal Protocol KDF_CK pattern)
|
|
400
394
|
// Two-step derivation:
|
|
401
395
|
// 1. Seed = HMAC-SHA256(Chain Key, 0x01)
|
|
402
|
-
// 2. Derived = HKDF
|
|
396
|
+
// 2. Derived = HKDF(Seed, zero salt, "WhisperGroup", 48 bytes) → IV[0:16] + CipherKey[16:48]
|
|
403
397
|
const { cipherKey, iv } = await this.deriveMessageKey(state.chainKey);
|
|
404
398
|
let ciphertextBase64;
|
|
405
399
|
try {
|
|
@@ -508,6 +502,7 @@ export class SenderKeyManager {
|
|
|
508
502
|
if (!state) {
|
|
509
503
|
throw new Error(`SENDER_KEY_NOT_FOUND: No sender key for ${senderId}.${senderDeviceId}`);
|
|
510
504
|
}
|
|
505
|
+
assertSenderKeyVersion(state);
|
|
511
506
|
// M11: If current state does not match, try previous states (rotation window)
|
|
512
507
|
// This allows decryption of in-flight messages encrypted with a previous key.
|
|
513
508
|
if (state.senderKeyId !== message.senderKeyId) {
|
|
@@ -523,6 +518,10 @@ export class SenderKeyManager {
|
|
|
523
518
|
if (!isValid) {
|
|
524
519
|
throw new Error('INVALID_SIGNATURE: Message signature verification failed');
|
|
525
520
|
}
|
|
521
|
+
const skippedKeys = {
|
|
522
|
+
maxSkippedKeys: this.maxSkippedKeys,
|
|
523
|
+
keys: [],
|
|
524
|
+
};
|
|
526
525
|
// Handle out-of-order messages (chain index gaps)
|
|
527
526
|
if (message.chainIndex > state.chainIndex) {
|
|
528
527
|
// DoS protection: Limit chain advancement to prevent CPU exhaustion
|
|
@@ -532,15 +531,19 @@ export class SenderKeyManager {
|
|
|
532
531
|
`current ${state.chainIndex} by ${chainGap} (max: ${this.maxChainAdvance}). ` +
|
|
533
532
|
`Request sender key redistribution.`);
|
|
534
533
|
}
|
|
535
|
-
//
|
|
534
|
+
// Stage skipped keys until successful decryption and the receive commit
|
|
536
535
|
// (the reference implementation uses capacity-only limits, no time-based expiration)
|
|
537
536
|
for (let i = state.chainIndex; i < message.chainIndex; i++) {
|
|
538
|
-
// Derive
|
|
537
|
+
// Derive the skipped message key
|
|
539
538
|
const { cipherKey, iv } = await this.deriveMessageKey(state.chainKey);
|
|
540
539
|
try {
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
540
|
+
skippedKeys.keys.push({
|
|
541
|
+
senderKeyId: state.senderKeyId,
|
|
542
|
+
chainIndex: i,
|
|
543
|
+
messageKey: {
|
|
544
|
+
cipherKey: crypto.bytesToBase64(cipherKey),
|
|
545
|
+
iv: crypto.bytesToBase64(iv),
|
|
546
|
+
},
|
|
544
547
|
});
|
|
545
548
|
}
|
|
546
549
|
finally {
|
|
@@ -559,7 +562,7 @@ export class SenderKeyManager {
|
|
|
559
562
|
// Derive message key from chain key (Signal Protocol KDF_CK pattern)
|
|
560
563
|
// Two-step derivation:
|
|
561
564
|
// 1. Seed = HMAC-SHA256(Chain Key, 0x01)
|
|
562
|
-
// 2. Derived = HKDF
|
|
565
|
+
// 2. Derived = HKDF(Seed, zero salt, "WhisperGroup", 48 bytes) → IV[0:16] + CipherKey[16:48]
|
|
563
566
|
const { cipherKey, iv } = await this.deriveMessageKey(state.chainKey);
|
|
564
567
|
let plaintextBytes;
|
|
565
568
|
try {
|
|
@@ -577,9 +580,12 @@ export class SenderKeyManager {
|
|
|
577
580
|
state.chainIndex++;
|
|
578
581
|
// Store updated state
|
|
579
582
|
const previous = await this.loadPreviousStates(groupId, senderId, senderDeviceId);
|
|
580
|
-
await this.storage.storeSenderKeyRecord(groupId, senderId, senderDeviceId, [state, ...previous],
|
|
581
|
-
|
|
582
|
-
:
|
|
583
|
+
await this.storage.storeSenderKeyRecord(groupId, senderId, senderDeviceId, [state, ...previous], {
|
|
584
|
+
skippedKeys,
|
|
585
|
+
content: receiveId
|
|
586
|
+
? { id: receiveId, plaintext, receivedAt: Date.now(), groupId }
|
|
587
|
+
: undefined,
|
|
588
|
+
});
|
|
583
589
|
this.logger.debug('Decrypted message with sender key', {
|
|
584
590
|
category: 'E2EE',
|
|
585
591
|
data: { senderId, senderDeviceId, chainIndex: message.chainIndex },
|
|
@@ -597,7 +603,7 @@ export class SenderKeyManager {
|
|
|
597
603
|
* @throws Error if skipped key not found or decryption fails
|
|
598
604
|
*/
|
|
599
605
|
async decryptWithSkippedKey(groupId, senderId, senderDeviceId, message, receiveId) {
|
|
600
|
-
const skippedKey = await this.storage.getSkippedSenderKey(groupId, senderId, senderDeviceId, message.chainIndex);
|
|
606
|
+
const skippedKey = await this.storage.getSkippedSenderKey(groupId, senderId, senderDeviceId, message.senderKeyId, message.chainIndex);
|
|
601
607
|
if (!skippedKey) {
|
|
602
608
|
// If chainIndex < state.chainIndex
|
|
603
609
|
// but no skipped key exists, the message was already consumed (duplicate).
|
|
@@ -615,19 +621,18 @@ export class SenderKeyManager {
|
|
|
615
621
|
crypto.secureZeroBytes(skippedIv);
|
|
616
622
|
}
|
|
617
623
|
const plaintext = this.encodeLosslessPlaintext(plaintextBytes);
|
|
618
|
-
|
|
619
|
-
if (
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
}
|
|
624
|
+
const states = await this.storage.getSenderKeyRecord(groupId, senderId, senderDeviceId);
|
|
625
|
+
if (!states?.length)
|
|
626
|
+
throw new Error('Missing sender-key record during receive');
|
|
627
|
+
await this.storage.storeSenderKeyRecord(groupId, senderId, senderDeviceId, states, {
|
|
628
|
+
content: receiveId
|
|
629
|
+
? { id: receiveId, plaintext, receivedAt: Date.now(), groupId }
|
|
630
|
+
: undefined,
|
|
631
|
+
consumedSkippedKey: {
|
|
632
|
+
senderKeyId: message.senderKeyId,
|
|
633
|
+
chainIndex: message.chainIndex,
|
|
634
|
+
},
|
|
635
|
+
});
|
|
631
636
|
this.logger.debug('Decrypted out-of-order message with skipped key', {
|
|
632
637
|
category: 'E2EE',
|
|
633
638
|
data: { senderId, senderDeviceId, chainIndex: message.chainIndex },
|
|
@@ -664,12 +669,17 @@ export class SenderKeyManager {
|
|
|
664
669
|
return null;
|
|
665
670
|
}
|
|
666
671
|
const prevState = prevStates[matchIdx];
|
|
672
|
+
assertSenderKeyVersion(prevState);
|
|
667
673
|
// Verify signature with previous state's public key
|
|
668
674
|
const messageToVerify = this.serializeForSigning(message.chainIndex, message.ciphertext, message.senderKeyId, prevState.chainId);
|
|
669
675
|
const isValid = await crypto.verify(prevState.publicSignatureKey, messageToVerify, message.signature);
|
|
670
676
|
if (!isValid) {
|
|
671
677
|
throw new Error('INVALID_SIGNATURE: Message signature verification failed');
|
|
672
678
|
}
|
|
679
|
+
const skippedKeys = {
|
|
680
|
+
maxSkippedKeys: this.maxSkippedKeys,
|
|
681
|
+
keys: [],
|
|
682
|
+
};
|
|
673
683
|
// Handle chain advancement for out-of-order messages
|
|
674
684
|
if (message.chainIndex > prevState.chainIndex) {
|
|
675
685
|
const chainGap = message.chainIndex - prevState.chainIndex;
|
|
@@ -678,13 +688,17 @@ export class SenderKeyManager {
|
|
|
678
688
|
`current ${prevState.chainIndex} by ${chainGap} (max: ${this.maxChainAdvance}). ` +
|
|
679
689
|
`Request sender key redistribution.`);
|
|
680
690
|
}
|
|
681
|
-
//
|
|
691
|
+
// Stage skipped keys until successful decryption and the receive commit
|
|
682
692
|
for (let i = prevState.chainIndex; i < message.chainIndex; i++) {
|
|
683
693
|
const { cipherKey, iv } = await this.deriveMessageKey(prevState.chainKey);
|
|
684
694
|
try {
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
695
|
+
skippedKeys.keys.push({
|
|
696
|
+
senderKeyId: prevState.senderKeyId,
|
|
697
|
+
chainIndex: i,
|
|
698
|
+
messageKey: {
|
|
699
|
+
cipherKey: crypto.bytesToBase64(cipherKey),
|
|
700
|
+
iv: crypto.bytesToBase64(iv),
|
|
701
|
+
},
|
|
688
702
|
});
|
|
689
703
|
}
|
|
690
704
|
finally {
|
|
@@ -715,13 +729,16 @@ export class SenderKeyManager {
|
|
|
715
729
|
prevState.chainIndex++;
|
|
716
730
|
// Persist updated previous states to storage
|
|
717
731
|
const currentState = await this.storage.getSenderKey(groupId, senderId, senderDeviceId);
|
|
718
|
-
if (currentState)
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
732
|
+
if (!currentState)
|
|
733
|
+
throw new Error('Missing sender-key record during receive');
|
|
734
|
+
const key = this.stateKey(groupId, senderId, senderDeviceId);
|
|
735
|
+
await this.storage.storeSenderKeyRecord(groupId, senderId, senderDeviceId, [currentState, ...prevStates], {
|
|
736
|
+
skippedKeys,
|
|
737
|
+
content: receiveId
|
|
738
|
+
? { id: receiveId, plaintext, receivedAt: Date.now(), groupId }
|
|
739
|
+
: undefined,
|
|
740
|
+
});
|
|
741
|
+
this.previousStates.set(key, prevStates);
|
|
725
742
|
this.logger.debug('Decrypted message with previous sender key state', {
|
|
726
743
|
category: 'E2EE',
|
|
727
744
|
data: {
|
|
@@ -734,23 +751,6 @@ export class SenderKeyManager {
|
|
|
734
751
|
});
|
|
735
752
|
return plaintext;
|
|
736
753
|
}
|
|
737
|
-
/**
|
|
738
|
-
* Store skipped key with enforcement of maxSkippedKeys limit.
|
|
739
|
-
*
|
|
740
|
-
* If the limit is reached, deletes oldest keys to make room.
|
|
741
|
-
* The reference implementation uses capacity-only limits (no time-based expiration).
|
|
742
|
-
*/
|
|
743
|
-
async storeSkippedKeyWithLimit(groupId, senderId, senderDeviceId, chainIndex, messageKey) {
|
|
744
|
-
// Check current count
|
|
745
|
-
const currentCount = await this.storage.countSkippedSenderKeys(groupId, senderId, senderDeviceId);
|
|
746
|
-
// If at limit, delete oldest to make room
|
|
747
|
-
if (currentCount >= this.maxSkippedKeys) {
|
|
748
|
-
const toDelete = currentCount - this.maxSkippedKeys + 1;
|
|
749
|
-
await this.storage.deleteOldestSkippedSenderKeys(groupId, senderId, senderDeviceId, toDelete);
|
|
750
|
-
}
|
|
751
|
-
// Store the new skipped key
|
|
752
|
-
await this.storage.storeSkippedSenderKey(groupId, senderId, senderDeviceId, chainIndex, messageKey);
|
|
753
|
-
}
|
|
754
754
|
/**
|
|
755
755
|
* Rotate sender key (forward secrecy on membership changes)
|
|
756
756
|
*
|
|
@@ -762,6 +762,8 @@ export class SenderKeyManager {
|
|
|
762
762
|
async rotateSenderKey(groupId, userId, deviceId, options) {
|
|
763
763
|
// Get old sender key state
|
|
764
764
|
const oldState = await this.storage.getSenderKey(groupId, userId, deviceId);
|
|
765
|
+
if (oldState)
|
|
766
|
+
assertSenderKeyVersion(oldState);
|
|
765
767
|
const senderKeyId = await crypto.generateUuidV4();
|
|
766
768
|
const chainId = this.generateChainId(senderKeyId);
|
|
767
769
|
// Generate new key material
|
|
@@ -780,25 +782,16 @@ export class SenderKeyManager {
|
|
|
780
782
|
createdAt: Date.now(),
|
|
781
783
|
...(options?.distributionPending && { distributionPending: true }),
|
|
782
784
|
};
|
|
783
|
-
//
|
|
785
|
+
// Build the candidate archive without changing the committed cache.
|
|
784
786
|
const key = this.stateKey(groupId, userId, deviceId);
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
prev.unshift(oldState);
|
|
789
|
-
while (prev.length >= MAX_SENDER_KEY_STATES) {
|
|
790
|
-
prev.pop();
|
|
791
|
-
}
|
|
792
|
-
this.previousStates.set(key, prev);
|
|
793
|
-
}
|
|
794
|
-
else {
|
|
795
|
-
prev = [];
|
|
796
|
-
this.previousStates.set(key, prev);
|
|
797
|
-
}
|
|
798
|
-
// Store new sender key record (current + previous states)
|
|
787
|
+
const prev = oldState
|
|
788
|
+
? [oldState, ...(await this.loadPreviousStates(groupId, userId, deviceId))].slice(0, MAX_SENDER_KEY_STATES - 1)
|
|
789
|
+
: [];
|
|
799
790
|
await this.persistSenderKeyRecord(groupId, userId, deviceId, newState, prev);
|
|
791
|
+
this.previousStates.set(key, prev);
|
|
800
792
|
// Create distribution message
|
|
801
793
|
const distributionMessage = {
|
|
794
|
+
senderKeyVersion: SENDER_KEY_FORMAT,
|
|
802
795
|
senderKeyId,
|
|
803
796
|
chainId,
|
|
804
797
|
generation: newState.generation,
|
|
@@ -821,7 +814,9 @@ export class SenderKeyManager {
|
|
|
821
814
|
const state = await this.storage.getSenderKey(groupId, userId, deviceId);
|
|
822
815
|
if (!state?.distributionPending)
|
|
823
816
|
return null;
|
|
817
|
+
assertSenderKeyVersion(state);
|
|
824
818
|
return {
|
|
819
|
+
senderKeyVersion: SENDER_KEY_FORMAT,
|
|
825
820
|
senderKeyId: state.senderKeyId,
|
|
826
821
|
chainId: state.chainId,
|
|
827
822
|
generation: state.generation,
|
|
@@ -888,7 +883,7 @@ export class SenderKeyManager {
|
|
|
888
883
|
*
|
|
889
884
|
* Two-step derivation:
|
|
890
885
|
* 1. Seed = HMAC-SHA256(Chain Key, 0x01)
|
|
891
|
-
* 2. Derived = HKDF
|
|
886
|
+
* 2. Derived = HKDF(Seed, zero salt, info, 48 bytes)
|
|
892
887
|
* - IV: bytes 0-15 (16 bytes for AES-CBC)
|
|
893
888
|
* - Cipher Key: bytes 16-47 (32 bytes)
|
|
894
889
|
*
|
|
@@ -903,9 +898,9 @@ export class SenderKeyManager {
|
|
|
903
898
|
try {
|
|
904
899
|
// Step 1: Derive seed using HMAC (Signal Protocol KDF_CK pattern)
|
|
905
900
|
seed = crypto.hmac(chainKey, MESSAGE_KEY_CONSTANT);
|
|
906
|
-
// Step 2:
|
|
901
|
+
// Step 2: Extract and expand the seed with the configured info string
|
|
907
902
|
const info = crypto.stringToBytes(this.hkdfInfoString);
|
|
908
|
-
derived = await crypto.
|
|
903
|
+
derived = await crypto.hkdf(seed, new Uint8Array(32), info, 48);
|
|
909
904
|
// Step 3: Split into IV (16 bytes for AES-CBC) and cipher key (32 bytes)
|
|
910
905
|
return {
|
|
911
906
|
iv: derived.slice(0, 16),
|
|
@@ -974,7 +969,7 @@ export class SenderKeyManager {
|
|
|
974
969
|
*
|
|
975
970
|
*/
|
|
976
971
|
serializeForSigning(chainIndex, ciphertext, senderKeyId, chainId) {
|
|
977
|
-
//
|
|
972
|
+
// Current sender-key profile version
|
|
978
973
|
const versionByte = new Uint8Array([SENDER_KEY_MESSAGE_VERSION]);
|
|
979
974
|
// Canonical signing format: version_byte || protobuf_encode(SenderKeyMessage)
|
|
980
975
|
// This is stable regardless of transport format (JSON or protobuf).
|