@open-e2ee/signal-protocol-sdk 0.1.0-alpha.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 +195 -0
- package/ARCHITECTURE.md +206 -0
- package/CHANGELOG.md +13 -0
- package/LICENSE +661 -0
- package/NOTICE +27 -0
- package/README.md +152 -0
- package/SECURITY.md +125 -0
- package/THIRD_PARTY_NOTICES.md +31 -0
- package/TROUBLESHOOTING.md +203 -0
- package/blocking/README.md +42 -0
- package/client/README.md +169 -0
- package/device/README.md +166 -0
- package/dist/blocking/index.d.ts +4 -0
- package/dist/blocking/index.d.ts.map +1 -0
- package/dist/blocking/index.js +2 -0
- package/dist/blocking/index.js.map +1 -0
- package/dist/blocking/manager.d.ts +27 -0
- package/dist/blocking/manager.d.ts.map +1 -0
- package/dist/blocking/manager.js +61 -0
- package/dist/blocking/manager.js.map +1 -0
- package/dist/blocking/types.d.ts +43 -0
- package/dist/blocking/types.d.ts.map +1 -0
- package/dist/blocking/types.js +9 -0
- package/dist/blocking/types.js.map +1 -0
- package/dist/client/client.d.ts +1281 -0
- package/dist/client/client.d.ts.map +1 -0
- package/dist/client/client.js +2296 -0
- package/dist/client/client.js.map +1 -0
- package/dist/client/compose.d.ts +105 -0
- package/dist/client/compose.d.ts.map +1 -0
- package/dist/client/compose.js +41 -0
- package/dist/client/compose.js.map +1 -0
- package/dist/client/config.d.ts +707 -0
- package/dist/client/config.d.ts.map +1 -0
- package/dist/client/config.js +19 -0
- package/dist/client/config.js.map +1 -0
- package/dist/client/constants.d.ts +48 -0
- package/dist/client/constants.d.ts.map +1 -0
- package/dist/client/constants.js +40 -0
- package/dist/client/constants.js.map +1 -0
- package/dist/client/content-adapter.d.ts +106 -0
- package/dist/client/content-adapter.d.ts.map +1 -0
- package/dist/client/content-adapter.js +423 -0
- package/dist/client/content-adapter.js.map +1 -0
- package/dist/client/dual-store.d.ts +70 -0
- package/dist/client/dual-store.d.ts.map +1 -0
- package/dist/client/dual-store.js +123 -0
- package/dist/client/dual-store.js.map +1 -0
- package/dist/client/endorsement-manager.d.ts +143 -0
- package/dist/client/endorsement-manager.d.ts.map +1 -0
- package/dist/client/endorsement-manager.js +259 -0
- package/dist/client/endorsement-manager.js.map +1 -0
- package/dist/client/event-hooks.d.ts +330 -0
- package/dist/client/event-hooks.d.ts.map +1 -0
- package/dist/client/event-hooks.js +59 -0
- package/dist/client/event-hooks.js.map +1 -0
- package/dist/client/files.d.ts +73 -0
- package/dist/client/files.d.ts.map +1 -0
- package/dist/client/files.js +192 -0
- package/dist/client/files.js.map +1 -0
- package/dist/client/groups.d.ts +204 -0
- package/dist/client/groups.d.ts.map +1 -0
- package/dist/client/groups.js +340 -0
- package/dist/client/groups.js.map +1 -0
- package/dist/client/headless.d.ts +99 -0
- package/dist/client/headless.d.ts.map +1 -0
- package/dist/client/headless.js +163 -0
- package/dist/client/headless.js.map +1 -0
- package/dist/client/index.d.ts +33 -0
- package/dist/client/index.d.ts.map +1 -0
- package/dist/client/index.js +7 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/key-rotation-core.d.ts +167 -0
- package/dist/client/key-rotation-core.d.ts.map +1 -0
- package/dist/client/key-rotation-core.js +459 -0
- package/dist/client/key-rotation-core.js.map +1 -0
- package/dist/client/key-rotation.d.ts +45 -0
- package/dist/client/key-rotation.d.ts.map +1 -0
- package/dist/client/key-rotation.js +174 -0
- package/dist/client/key-rotation.js.map +1 -0
- package/dist/client/media.d.ts +173 -0
- package/dist/client/media.d.ts.map +1 -0
- package/dist/client/media.js +476 -0
- package/dist/client/media.js.map +1 -0
- package/dist/client/messages.d.ts +131 -0
- package/dist/client/messages.d.ts.map +1 -0
- package/dist/client/messages.js +546 -0
- package/dist/client/messages.js.map +1 -0
- package/dist/client/multi-device.d.ts +73 -0
- package/dist/client/multi-device.d.ts.map +1 -0
- package/dist/client/multi-device.js +104 -0
- package/dist/client/multi-device.js.map +1 -0
- package/dist/client/prekeys.d.ts +133 -0
- package/dist/client/prekeys.d.ts.map +1 -0
- package/dist/client/prekeys.js +608 -0
- package/dist/client/prekeys.js.map +1 -0
- package/dist/client/relay-subscription.d.ts +83 -0
- package/dist/client/relay-subscription.d.ts.map +1 -0
- package/dist/client/relay-subscription.js +353 -0
- package/dist/client/relay-subscription.js.map +1 -0
- package/dist/client/retry-utils.d.ts +42 -0
- package/dist/client/retry-utils.d.ts.map +1 -0
- package/dist/client/retry-utils.js +107 -0
- package/dist/client/retry-utils.js.map +1 -0
- package/dist/client/retry.d.ts +121 -0
- package/dist/client/retry.d.ts.map +1 -0
- package/dist/client/retry.js +499 -0
- package/dist/client/retry.js.map +1 -0
- package/dist/client/sealed-sender-ops.d.ts +61 -0
- package/dist/client/sealed-sender-ops.d.ts.map +1 -0
- package/dist/client/sealed-sender-ops.js +173 -0
- package/dist/client/sealed-sender-ops.js.map +1 -0
- package/dist/client/sessions.d.ts +108 -0
- package/dist/client/sessions.d.ts.map +1 -0
- package/dist/client/sessions.js +367 -0
- package/dist/client/sessions.js.map +1 -0
- package/dist/client/signal-service-cipher.d.ts +331 -0
- package/dist/client/signal-service-cipher.d.ts.map +1 -0
- package/dist/client/signal-service-cipher.js +1506 -0
- package/dist/client/signal-service-cipher.js.map +1 -0
- package/dist/client/state.d.ts +147 -0
- package/dist/client/state.d.ts.map +1 -0
- package/dist/client/state.js +226 -0
- package/dist/client/state.js.map +1 -0
- package/dist/client/types.d.ts +423 -0
- package/dist/client/types.d.ts.map +1 -0
- package/dist/client/types.js +42 -0
- package/dist/client/types.js.map +1 -0
- package/dist/device/connection.d.ts +46 -0
- package/dist/device/connection.d.ts.map +1 -0
- package/dist/device/connection.js +239 -0
- package/dist/device/connection.js.map +1 -0
- package/dist/device/constants.d.ts +69 -0
- package/dist/device/constants.d.ts.map +1 -0
- package/dist/device/constants.js +64 -0
- package/dist/device/constants.js.map +1 -0
- package/dist/device/device-id.d.ts +45 -0
- package/dist/device/device-id.d.ts.map +1 -0
- package/dist/device/device-id.js +87 -0
- package/dist/device/device-id.js.map +1 -0
- package/dist/device/device-name-crypto.d.ts +39 -0
- package/dist/device/device-name-crypto.d.ts.map +1 -0
- package/dist/device/device-name-crypto.js +165 -0
- package/dist/device/device-name-crypto.js.map +1 -0
- package/dist/device/index.d.ts +31 -0
- package/dist/device/index.d.ts.map +1 -0
- package/dist/device/index.js +35 -0
- package/dist/device/index.js.map +1 -0
- package/dist/device/lifecycle/index.d.ts +25 -0
- package/dist/device/lifecycle/index.d.ts.map +1 -0
- package/dist/device/lifecycle/index.js +3 -0
- package/dist/device/lifecycle/index.js.map +1 -0
- package/dist/device/lifecycle/manager.d.ts +273 -0
- package/dist/device/lifecycle/manager.d.ts.map +1 -0
- package/dist/device/lifecycle/manager.js +1229 -0
- package/dist/device/lifecycle/manager.js.map +1 -0
- package/dist/device/lifecycle/types.d.ts +372 -0
- package/dist/device/lifecycle/types.d.ts.map +1 -0
- package/dist/device/lifecycle/types.js +10 -0
- package/dist/device/lifecycle/types.js.map +1 -0
- package/dist/device/lifecycle/utils.d.ts +37 -0
- package/dist/device/lifecycle/utils.d.ts.map +1 -0
- package/dist/device/lifecycle/utils.js +79 -0
- package/dist/device/lifecycle/utils.js.map +1 -0
- package/dist/device/provisioning.d.ts +249 -0
- package/dist/device/provisioning.d.ts.map +1 -0
- package/dist/device/provisioning.js +439 -0
- package/dist/device/provisioning.js.map +1 -0
- package/dist/device/transfer.d.ts +231 -0
- package/dist/device/transfer.d.ts.map +1 -0
- package/dist/device/transfer.js +628 -0
- package/dist/device/transfer.js.map +1 -0
- package/dist/device/types.d.ts +275 -0
- package/dist/device/types.d.ts.map +1 -0
- package/dist/device/types.js +42 -0
- package/dist/device/types.js.map +1 -0
- package/dist/encoding/base64.d.ts +14 -0
- package/dist/encoding/base64.d.ts.map +1 -0
- package/dist/encoding/base64.js +2 -0
- package/dist/encoding/base64.js.map +1 -0
- package/dist/encoding/hex.d.ts +14 -0
- package/dist/encoding/hex.d.ts.map +1 -0
- package/dist/encoding/hex.js +2 -0
- package/dist/encoding/hex.js.map +1 -0
- package/dist/encoding/index.d.ts +17 -0
- package/dist/encoding/index.d.ts.map +1 -0
- package/dist/encoding/index.js +3 -0
- package/dist/encoding/index.js.map +1 -0
- package/dist/files/index.d.ts +16 -0
- package/dist/files/index.d.ts.map +1 -0
- package/dist/files/index.js +15 -0
- package/dist/files/index.js.map +1 -0
- package/dist/groups/index.d.ts +12 -0
- package/dist/groups/index.d.ts.map +1 -0
- package/dist/groups/index.js +9 -0
- package/dist/groups/index.js.map +1 -0
- package/dist/hooks/index.d.ts +20 -0
- package/dist/hooks/index.d.ts.map +1 -0
- package/dist/hooks/index.js +6 -0
- package/dist/hooks/index.js.map +1 -0
- package/dist/hooks/use-connection-presence.d.ts +68 -0
- package/dist/hooks/use-connection-presence.d.ts.map +1 -0
- package/dist/hooks/use-connection-presence.js +300 -0
- package/dist/hooks/use-connection-presence.js.map +1 -0
- package/dist/hooks/use-group-membership.d.ts +66 -0
- package/dist/hooks/use-group-membership.d.ts.map +1 -0
- package/dist/hooks/use-group-membership.js +156 -0
- package/dist/hooks/use-group-membership.js.map +1 -0
- package/dist/hooks/use-key-rotation.d.ts +119 -0
- package/dist/hooks/use-key-rotation.d.ts.map +1 -0
- package/dist/hooks/use-key-rotation.js +198 -0
- package/dist/hooks/use-key-rotation.js.map +1 -0
- package/dist/hooks/use-session-health.d.ts +51 -0
- package/dist/hooks/use-session-health.d.ts.map +1 -0
- package/dist/hooks/use-session-health.js +59 -0
- package/dist/hooks/use-session-health.js.map +1 -0
- package/dist/hooks/use-single-flight.d.ts +29 -0
- package/dist/hooks/use-single-flight.d.ts.map +1 -0
- package/dist/hooks/use-single-flight.js +59 -0
- package/dist/hooks/use-single-flight.js.map +1 -0
- package/dist/index.d.ts +203 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +169 -0
- package/dist/index.js.map +1 -0
- package/dist/internal/crypto/ec/ed25519.d.ts +78 -0
- package/dist/internal/crypto/ec/ed25519.d.ts.map +1 -0
- package/dist/internal/crypto/ec/ed25519.js +108 -0
- package/dist/internal/crypto/ec/ed25519.js.map +1 -0
- package/dist/internal/crypto/ec/index.d.ts +5 -0
- package/dist/internal/crypto/ec/index.d.ts.map +1 -0
- package/dist/internal/crypto/ec/index.js +4 -0
- package/dist/internal/crypto/ec/index.js.map +1 -0
- package/dist/internal/crypto/ec/x25519-validation.d.ts +70 -0
- package/dist/internal/crypto/ec/x25519-validation.d.ts.map +1 -0
- package/dist/internal/crypto/ec/x25519-validation.js +137 -0
- package/dist/internal/crypto/ec/x25519-validation.js.map +1 -0
- package/dist/internal/crypto/ec/x25519.d.ts +91 -0
- package/dist/internal/crypto/ec/x25519.d.ts.map +1 -0
- package/dist/internal/crypto/ec/x25519.js +124 -0
- package/dist/internal/crypto/ec/x25519.js.map +1 -0
- package/dist/internal/crypto/hash/index.d.ts +4 -0
- package/dist/internal/crypto/hash/index.d.ts.map +1 -0
- package/dist/internal/crypto/hash/index.js +3 -0
- package/dist/internal/crypto/hash/index.js.map +1 -0
- package/dist/internal/crypto/hash/sha256.d.ts +24 -0
- package/dist/internal/crypto/hash/sha256.d.ts.map +1 -0
- package/dist/internal/crypto/hash/sha256.js +23 -0
- package/dist/internal/crypto/hash/sha256.js.map +1 -0
- package/dist/internal/crypto/hash/sha512.d.ts +16 -0
- package/dist/internal/crypto/hash/sha512.d.ts.map +1 -0
- package/dist/internal/crypto/hash/sha512.js +27 -0
- package/dist/internal/crypto/hash/sha512.js.map +1 -0
- package/dist/internal/crypto/index.d.ts +60 -0
- package/dist/internal/crypto/index.d.ts.map +1 -0
- package/dist/internal/crypto/index.js +107 -0
- package/dist/internal/crypto/index.js.map +1 -0
- package/dist/internal/crypto/kdf/hkdf.d.ts +300 -0
- package/dist/internal/crypto/kdf/hkdf.d.ts.map +1 -0
- package/dist/internal/crypto/kdf/hkdf.js +452 -0
- package/dist/internal/crypto/kdf/hkdf.js.map +1 -0
- package/dist/internal/crypto/kdf/index.d.ts +4 -0
- package/dist/internal/crypto/kdf/index.d.ts.map +1 -0
- package/dist/internal/crypto/kdf/index.js +3 -0
- package/dist/internal/crypto/kdf/index.js.map +1 -0
- package/dist/internal/crypto/kdf/pbkdf2.d.ts +42 -0
- package/dist/internal/crypto/kdf/pbkdf2.d.ts.map +1 -0
- package/dist/internal/crypto/kdf/pbkdf2.js +44 -0
- package/dist/internal/crypto/kdf/pbkdf2.js.map +1 -0
- package/dist/internal/crypto/key-prefix.d.ts +82 -0
- package/dist/internal/crypto/key-prefix.d.ts.map +1 -0
- package/dist/internal/crypto/key-prefix.js +116 -0
- package/dist/internal/crypto/key-prefix.js.map +1 -0
- package/dist/internal/crypto/pq/index.d.ts +3 -0
- package/dist/internal/crypto/pq/index.d.ts.map +1 -0
- package/dist/internal/crypto/pq/index.js +2 -0
- package/dist/internal/crypto/pq/index.js.map +1 -0
- package/dist/internal/crypto/pq/kyber.d.ts +232 -0
- package/dist/internal/crypto/pq/kyber.d.ts.map +1 -0
- package/dist/internal/crypto/pq/kyber.js +317 -0
- package/dist/internal/crypto/pq/kyber.js.map +1 -0
- package/dist/internal/crypto/random.d.ts +22 -0
- package/dist/internal/crypto/random.d.ts.map +1 -0
- package/dist/internal/crypto/random.js +45 -0
- package/dist/internal/crypto/random.js.map +1 -0
- package/dist/internal/crypto/symmetric/aes-ctr.d.ts +73 -0
- package/dist/internal/crypto/symmetric/aes-ctr.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/aes-ctr.js +98 -0
- package/dist/internal/crypto/symmetric/aes-ctr.js.map +1 -0
- package/dist/internal/crypto/symmetric/aes-gcm-siv.d.ts +77 -0
- package/dist/internal/crypto/symmetric/aes-gcm-siv.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/aes-gcm-siv.js +111 -0
- package/dist/internal/crypto/symmetric/aes-gcm-siv.js.map +1 -0
- package/dist/internal/crypto/symmetric/aes.d.ts +211 -0
- package/dist/internal/crypto/symmetric/aes.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/aes.js +386 -0
- package/dist/internal/crypto/symmetric/aes.js.map +1 -0
- package/dist/internal/crypto/symmetric/hmac.d.ts +32 -0
- package/dist/internal/crypto/symmetric/hmac.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/hmac.js +20 -0
- package/dist/internal/crypto/symmetric/hmac.js.map +1 -0
- package/dist/internal/crypto/symmetric/index.d.ts +9 -0
- package/dist/internal/crypto/symmetric/index.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/index.js +8 -0
- package/dist/internal/crypto/symmetric/index.js.map +1 -0
- package/dist/internal/crypto/symmetric/mac.d.ts +154 -0
- package/dist/internal/crypto/symmetric/mac.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/mac.js +292 -0
- package/dist/internal/crypto/symmetric/mac.js.map +1 -0
- package/dist/internal/crypto/symmetric/padding.d.ts +55 -0
- package/dist/internal/crypto/symmetric/padding.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/padding.js +90 -0
- package/dist/internal/crypto/symmetric/padding.js.map +1 -0
- package/dist/internal/crypto/symmetric/streaming-aead.d.ts +89 -0
- package/dist/internal/crypto/symmetric/streaming-aead.d.ts.map +1 -0
- package/dist/internal/crypto/symmetric/streaming-aead.js +253 -0
- package/dist/internal/crypto/symmetric/streaming-aead.js.map +1 -0
- package/dist/internal/crypto/utils.d.ts +119 -0
- package/dist/internal/crypto/utils.d.ts.map +1 -0
- package/dist/internal/crypto/utils.js +366 -0
- package/dist/internal/crypto/utils.js.map +1 -0
- package/dist/internal/crypto/validation.d.ts +45 -0
- package/dist/internal/crypto/validation.d.ts.map +1 -0
- package/dist/internal/crypto/validation.js +37 -0
- package/dist/internal/crypto/validation.js.map +1 -0
- package/dist/internal/encoding/index.d.ts +2 -0
- package/dist/internal/encoding/index.d.ts.map +1 -0
- package/dist/internal/encoding/index.js +2 -0
- package/dist/internal/encoding/index.js.map +1 -0
- package/dist/internal/encoding/proto/envelope.d.ts +120 -0
- package/dist/internal/encoding/proto/envelope.d.ts.map +1 -0
- package/dist/internal/encoding/proto/envelope.js +160 -0
- package/dist/internal/encoding/proto/envelope.js.map +1 -0
- package/dist/internal/encoding/proto/index.d.ts +25 -0
- package/dist/internal/encoding/proto/index.d.ts.map +1 -0
- package/dist/internal/encoding/proto/index.js +30 -0
- package/dist/internal/encoding/proto/index.js.map +1 -0
- package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts +118 -0
- package/dist/internal/encoding/proto/pq-ratchet-serialize.d.ts.map +1 -0
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js +383 -0
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -0
- package/dist/internal/encoding/proto/primitives.d.ts +98 -0
- package/dist/internal/encoding/proto/primitives.d.ts.map +1 -0
- package/dist/internal/encoding/proto/primitives.js +179 -0
- package/dist/internal/encoding/proto/primitives.js.map +1 -0
- package/dist/internal/encoding/proto/sender-key-message.d.ts +147 -0
- package/dist/internal/encoding/proto/sender-key-message.d.ts.map +1 -0
- package/dist/internal/encoding/proto/sender-key-message.js +220 -0
- package/dist/internal/encoding/proto/sender-key-message.js.map +1 -0
- package/dist/internal/encoding/proto/signal-message.d.ts +174 -0
- package/dist/internal/encoding/proto/signal-message.d.ts.map +1 -0
- package/dist/internal/encoding/proto/signal-message.js +372 -0
- package/dist/internal/encoding/proto/signal-message.js.map +1 -0
- package/dist/internal/groups/group-id.d.ts +74 -0
- package/dist/internal/groups/group-id.d.ts.map +1 -0
- package/dist/internal/groups/group-id.js +63 -0
- package/dist/internal/groups/group-id.js.map +1 -0
- package/dist/internal/groups/index.d.ts +15 -0
- package/dist/internal/groups/index.d.ts.map +1 -0
- package/dist/internal/groups/index.js +2 -0
- package/dist/internal/groups/index.js.map +1 -0
- package/dist/internal/groups-v2/access-control.d.ts +101 -0
- package/dist/internal/groups-v2/access-control.d.ts.map +1 -0
- package/dist/internal/groups-v2/access-control.js +184 -0
- package/dist/internal/groups-v2/access-control.js.map +1 -0
- package/dist/internal/groups-v2/change-actions.d.ts +35 -0
- package/dist/internal/groups-v2/change-actions.d.ts.map +1 -0
- package/dist/internal/groups-v2/change-actions.js +358 -0
- package/dist/internal/groups-v2/change-actions.js.map +1 -0
- package/dist/internal/groups-v2/encrypted-state.d.ts +121 -0
- package/dist/internal/groups-v2/encrypted-state.d.ts.map +1 -0
- package/dist/internal/groups-v2/encrypted-state.js +455 -0
- package/dist/internal/groups-v2/encrypted-state.js.map +1 -0
- package/dist/internal/groups-v2/index.d.ts +14 -0
- package/dist/internal/groups-v2/index.d.ts.map +1 -0
- package/dist/internal/groups-v2/index.js +11 -0
- package/dist/internal/groups-v2/index.js.map +1 -0
- package/dist/internal/groups-v2/invite-link.d.ts +55 -0
- package/dist/internal/groups-v2/invite-link.d.ts.map +1 -0
- package/dist/internal/groups-v2/invite-link.js +111 -0
- package/dist/internal/groups-v2/invite-link.js.map +1 -0
- package/dist/internal/groups-v2/manager.d.ts +351 -0
- package/dist/internal/groups-v2/manager.d.ts.map +1 -0
- package/dist/internal/groups-v2/manager.js +1093 -0
- package/dist/internal/groups-v2/manager.js.map +1 -0
- package/dist/internal/groups-v2/types.d.ts +371 -0
- package/dist/internal/groups-v2/types.d.ts.map +1 -0
- package/dist/internal/groups-v2/types.js +61 -0
- package/dist/internal/groups-v2/types.js.map +1 -0
- package/dist/internal/manager/index.d.ts +16 -0
- package/dist/internal/manager/index.d.ts.map +1 -0
- package/dist/internal/manager/index.js +2 -0
- package/dist/internal/manager/index.js.map +1 -0
- package/dist/internal/manager/manager.d.ts +378 -0
- package/dist/internal/manager/manager.d.ts.map +1 -0
- package/dist/internal/manager/manager.js +1079 -0
- package/dist/internal/manager/manager.js.map +1 -0
- package/dist/internal/protocol/double-ratchet/chains.d.ts +135 -0
- package/dist/internal/protocol/double-ratchet/chains.d.ts.map +1 -0
- package/dist/internal/protocol/double-ratchet/chains.js +417 -0
- package/dist/internal/protocol/double-ratchet/chains.js.map +1 -0
- package/dist/internal/protocol/double-ratchet/index.d.ts +20 -0
- package/dist/internal/protocol/double-ratchet/index.d.ts.map +1 -0
- package/dist/internal/protocol/double-ratchet/index.js +21 -0
- package/dist/internal/protocol/double-ratchet/index.js.map +1 -0
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts +231 -0
- package/dist/internal/protocol/double-ratchet/ratchet.d.ts.map +1 -0
- package/dist/internal/protocol/double-ratchet/ratchet.js +198 -0
- package/dist/internal/protocol/double-ratchet/ratchet.js.map +1 -0
- package/dist/internal/protocol/index.d.ts +24 -0
- package/dist/internal/protocol/index.d.ts.map +1 -0
- package/dist/internal/protocol/index.js +9 -0
- package/dist/internal/protocol/index.js.map +1 -0
- package/dist/internal/protocol/pqxdh/index.d.ts +19 -0
- package/dist/internal/protocol/pqxdh/index.d.ts.map +1 -0
- package/dist/internal/protocol/pqxdh/index.js +16 -0
- package/dist/internal/protocol/pqxdh/index.js.map +1 -0
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts +141 -0
- package/dist/internal/protocol/pqxdh/pqxdh.d.ts.map +1 -0
- package/dist/internal/protocol/pqxdh/pqxdh.js +399 -0
- package/dist/internal/protocol/pqxdh/pqxdh.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/certificate.d.ts +94 -0
- package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/certificate.js +254 -0
- package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts +46 -0
- package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/decryption-v2.js +184 -0
- package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/decryption.d.ts +59 -0
- package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/decryption.js +268 -0
- package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/delivery-token.d.ts +48 -0
- package/dist/internal/protocol/sealed-sender/delivery-token.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/delivery-token.js +71 -0
- package/dist/internal/protocol/sealed-sender/delivery-token.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts +56 -0
- package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/encryption-v2.js +169 -0
- package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/encryption.d.ts +66 -0
- package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/encryption.js +174 -0
- package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/index.d.ts +23 -0
- package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/index.js +61 -0
- package/dist/internal/protocol/sealed-sender/index.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts +129 -0
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/proto/index.js +267 -0
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/types.d.ts +461 -0
- package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/types.js +99 -0
- package/dist/internal/protocol/sealed-sender/types.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/v2-binary.d.ts +124 -0
- package/dist/internal/protocol/sealed-sender/v2-binary.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/v2-binary.js +295 -0
- package/dist/internal/protocol/sealed-sender/v2-binary.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/v2-helpers.d.ts +107 -0
- package/dist/internal/protocol/sealed-sender/v2-helpers.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/v2-helpers.js +185 -0
- package/dist/internal/protocol/sealed-sender/v2-helpers.js.map +1 -0
- package/dist/internal/protocol/sender-keys/index.d.ts +11 -0
- package/dist/internal/protocol/sender-keys/index.d.ts.map +1 -0
- package/dist/internal/protocol/sender-keys/index.js +2 -0
- package/dist/internal/protocol/sender-keys/index.js.map +1 -0
- package/dist/internal/protocol/sender-keys/manager.d.ts +298 -0
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -0
- package/dist/internal/protocol/sender-keys/manager.js +839 -0
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -0
- package/dist/internal/protocol/spqr/braid-serialize.d.ts +128 -0
- package/dist/internal/protocol/spqr/braid-serialize.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/braid-serialize.js +373 -0
- package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -0
- package/dist/internal/protocol/spqr/braid.d.ts +164 -0
- package/dist/internal/protocol/spqr/braid.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/braid.js +305 -0
- package/dist/internal/protocol/spqr/braid.js.map +1 -0
- package/dist/internal/protocol/spqr/index.d.ts +161 -0
- package/dist/internal/protocol/spqr/index.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/index.js +115 -0
- package/dist/internal/protocol/spqr/index.js.map +1 -0
- package/dist/internal/protocol/spqr/message.d.ts +237 -0
- package/dist/internal/protocol/spqr/message.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/message.js +298 -0
- package/dist/internal/protocol/spqr/message.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts +174 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.js +248 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/authenticator.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.d.ts +29 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.js +43 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/chunk-domain.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/errors.d.ts +170 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/errors.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/errors.js +249 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/errors.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts +84 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js +138 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/incremental-kem.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts +45 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/index.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/index.js +94 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/index.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.d.ts +52 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js +121 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/kdf.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts +12 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js +15 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/arithmetic.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts +136 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js +796 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/noble-pq/index.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts +454 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js +790 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/codec.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.d.ts +108 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.js +125 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/field.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/index.d.ts +12 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/index.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/index.js +5 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/index.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/tables-16.d.ts +28 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/tables-16.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/tables-16.js +13953 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/galois/tables-16.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.d.ts +40 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js +52 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/index.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.d.ts +151 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js +297 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/lagrange.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.d.ts +97 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.js +201 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/rs/polynomial.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts +249 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js +731 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/serialize.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts +127 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +894 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts +387 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/types.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/types.js +121 -0
- package/dist/internal/protocol/spqr/ml-kem-braid/types.js.map +1 -0
- package/dist/internal/protocol/spqr/serialize.d.ts +149 -0
- package/dist/internal/protocol/spqr/serialize.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/serialize.js +370 -0
- package/dist/internal/protocol/spqr/serialize.js.map +1 -0
- package/dist/internal/protocol/spqr/spqr.d.ts +486 -0
- package/dist/internal/protocol/spqr/spqr.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/spqr.js +1031 -0
- package/dist/internal/protocol/spqr/spqr.js.map +1 -0
- package/dist/internal/protocol/spqr/validate.d.ts +35 -0
- package/dist/internal/protocol/spqr/validate.d.ts.map +1 -0
- package/dist/internal/protocol/spqr/validate.js +62 -0
- package/dist/internal/protocol/spqr/validate.js.map +1 -0
- package/dist/internal/protocol/triple-ratchet/index.d.ts +21 -0
- package/dist/internal/protocol/triple-ratchet/index.d.ts.map +1 -0
- package/dist/internal/protocol/triple-ratchet/index.js +19 -0
- package/dist/internal/protocol/triple-ratchet/index.js.map +1 -0
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts +233 -0
- package/dist/internal/protocol/triple-ratchet/ratchet.d.ts.map +1 -0
- package/dist/internal/protocol/triple-ratchet/ratchet.js +254 -0
- package/dist/internal/protocol/triple-ratchet/ratchet.js.map +1 -0
- package/dist/internal/protocol/username/generate.d.ts +9 -0
- package/dist/internal/protocol/username/generate.d.ts.map +1 -0
- package/dist/internal/protocol/username/generate.js +16 -0
- package/dist/internal/protocol/username/generate.js.map +1 -0
- package/dist/internal/protocol/username/hash.d.ts +74 -0
- package/dist/internal/protocol/username/hash.d.ts.map +1 -0
- package/dist/internal/protocol/username/hash.js +228 -0
- package/dist/internal/protocol/username/hash.js.map +1 -0
- package/dist/internal/protocol/username/link.d.ts +50 -0
- package/dist/internal/protocol/username/link.d.ts.map +1 -0
- package/dist/internal/protocol/username/link.js +187 -0
- package/dist/internal/protocol/username/link.js.map +1 -0
- package/dist/internal/protocol/username/proof.d.ts +34 -0
- package/dist/internal/protocol/username/proof.d.ts.map +1 -0
- package/dist/internal/protocol/username/proof.js +83 -0
- package/dist/internal/protocol/username/proof.js.map +1 -0
- package/dist/internal/protocol/version.d.ts +184 -0
- package/dist/internal/protocol/version.d.ts.map +1 -0
- package/dist/internal/protocol/version.js +163 -0
- package/dist/internal/protocol/version.js.map +1 -0
- package/dist/internal/protocol/x3dh/index.d.ts +15 -0
- package/dist/internal/protocol/x3dh/index.d.ts.map +1 -0
- package/dist/internal/protocol/x3dh/index.js +13 -0
- package/dist/internal/protocol/x3dh/index.js.map +1 -0
- package/dist/internal/protocol/x3dh/x3dh.d.ts +131 -0
- package/dist/internal/protocol/x3dh/x3dh.d.ts.map +1 -0
- package/dist/internal/protocol/x3dh/x3dh.js +261 -0
- package/dist/internal/protocol/x3dh/x3dh.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/attributes.d.ts +157 -0
- package/dist/internal/protocol/zk/credentials/attributes.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/attributes.js +177 -0
- package/dist/internal/protocol/zk/credentials/attributes.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/credentials.d.ts +129 -0
- package/dist/internal/protocol/zk/credentials/credentials.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/credentials.js +204 -0
- package/dist/internal/protocol/zk/credentials/credentials.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/endorsements.d.ts +235 -0
- package/dist/internal/protocol/zk/credentials/endorsements.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/endorsements.js +520 -0
- package/dist/internal/protocol/zk/credentials/endorsements.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/index.d.ts +14 -0
- package/dist/internal/protocol/zk/credentials/index.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/index.js +6 -0
- package/dist/internal/protocol/zk/credentials/index.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/issuance.d.ts +135 -0
- package/dist/internal/protocol/zk/credentials/issuance.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/issuance.js +338 -0
- package/dist/internal/protocol/zk/credentials/issuance.js.map +1 -0
- package/dist/internal/protocol/zk/credentials/presentation.d.ts +160 -0
- package/dist/internal/protocol/zk/credentials/presentation.d.ts.map +1 -0
- package/dist/internal/protocol/zk/credentials/presentation.js +447 -0
- package/dist/internal/protocol/zk/credentials/presentation.js.map +1 -0
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts +191 -0
- package/dist/internal/protocol/zk/groups/auth-credential.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/auth-credential.js +377 -0
- package/dist/internal/protocol/zk/groups/auth-credential.js.map +1 -0
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts +73 -0
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js +140 -0
- package/dist/internal/protocol/zk/groups/client-zk-group-cipher.js.map +1 -0
- package/dist/internal/protocol/zk/groups/group-params.d.ts +93 -0
- package/dist/internal/protocol/zk/groups/group-params.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/group-params.js +184 -0
- package/dist/internal/protocol/zk/groups/group-params.js.map +1 -0
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts +245 -0
- package/dist/internal/protocol/zk/groups/group-send-endorsement.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js +404 -0
- package/dist/internal/protocol/zk/groups/group-send-endorsement.js.map +1 -0
- package/dist/internal/protocol/zk/groups/index.d.ts +19 -0
- package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/index.js +12 -0
- package/dist/internal/protocol/zk/groups/index.js.map +1 -0
- package/dist/internal/protocol/zk/groups/lizard.d.ts +51 -0
- package/dist/internal/protocol/zk/groups/lizard.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/lizard.js +478 -0
- package/dist/internal/protocol/zk/groups/lizard.js.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts +35 -0
- package/dist/internal/protocol/zk/groups/profile-key-commitment.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-commitment.js +99 -0
- package/dist/internal/protocol/zk/groups/profile-key-commitment.js.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +195 -0
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-credential.js +370 -0
- package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts +45 -0
- package/dist/internal/protocol/zk/groups/profile-key-encryption.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-encryption.js +125 -0
- package/dist/internal/protocol/zk/groups/profile-key-encryption.js.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-struct.d.ts +33 -0
- package/dist/internal/protocol/zk/groups/profile-key-struct.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-struct.js +62 -0
- package/dist/internal/protocol/zk/groups/profile-key-struct.js.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-version.d.ts +17 -0
- package/dist/internal/protocol/zk/groups/profile-key-version.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/profile-key-version.js +33 -0
- package/dist/internal/protocol/zk/groups/profile-key-version.js.map +1 -0
- package/dist/internal/protocol/zk/groups/server-params.d.ts +114 -0
- package/dist/internal/protocol/zk/groups/server-params.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/server-params.js +146 -0
- package/dist/internal/protocol/zk/groups/server-params.js.map +1 -0
- package/dist/internal/protocol/zk/groups/uid-encryption.d.ts +41 -0
- package/dist/internal/protocol/zk/groups/uid-encryption.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/uid-encryption.js +113 -0
- package/dist/internal/protocol/zk/groups/uid-encryption.js.map +1 -0
- package/dist/internal/protocol/zk/groups/uid-struct.d.ts +48 -0
- package/dist/internal/protocol/zk/groups/uid-struct.d.ts.map +1 -0
- package/dist/internal/protocol/zk/groups/uid-struct.js +77 -0
- package/dist/internal/protocol/zk/groups/uid-struct.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/args.d.ts +33 -0
- package/dist/internal/protocol/zk/proofs/args.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/args.js +43 -0
- package/dist/internal/protocol/zk/proofs/args.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/index.d.ts +13 -0
- package/dist/internal/protocol/zk/proofs/index.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/index.js +7 -0
- package/dist/internal/protocol/zk/proofs/index.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/proof.d.ts +30 -0
- package/dist/internal/protocol/zk/proofs/proof.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/proof.js +48 -0
- package/dist/internal/protocol/zk/proofs/proof.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/sho-sha256.d.ts +34 -0
- package/dist/internal/protocol/zk/proofs/sho-sha256.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/sho-sha256.js +138 -0
- package/dist/internal/protocol/zk/proofs/sho-sha256.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/sho.d.ts +120 -0
- package/dist/internal/protocol/zk/proofs/sho.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/sho.js +221 -0
- package/dist/internal/protocol/zk/proofs/sho.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/sign.d.ts +29 -0
- package/dist/internal/protocol/zk/proofs/sign.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/sign.js +34 -0
- package/dist/internal/protocol/zk/proofs/sign.js.map +1 -0
- package/dist/internal/protocol/zk/proofs/statement.d.ts +103 -0
- package/dist/internal/protocol/zk/proofs/statement.d.ts.map +1 -0
- package/dist/internal/protocol/zk/proofs/statement.js +282 -0
- package/dist/internal/protocol/zk/proofs/statement.js.map +1 -0
- package/dist/internal/sesame/device-registry.d.ts +208 -0
- package/dist/internal/sesame/device-registry.d.ts.map +1 -0
- package/dist/internal/sesame/device-registry.js +431 -0
- package/dist/internal/sesame/device-registry.js.map +1 -0
- package/dist/internal/sesame/index.d.ts +31 -0
- package/dist/internal/sesame/index.d.ts.map +1 -0
- package/dist/internal/sesame/index.js +40 -0
- package/dist/internal/sesame/index.js.map +1 -0
- package/dist/internal/sesame/manager.d.ts +351 -0
- package/dist/internal/sesame/manager.d.ts.map +1 -0
- package/dist/internal/sesame/manager.js +1760 -0
- package/dist/internal/sesame/manager.js.map +1 -0
- package/dist/internal/sesame/types.d.ts +840 -0
- package/dist/internal/sesame/types.d.ts.map +1 -0
- package/dist/internal/sesame/types.js +290 -0
- package/dist/internal/sesame/types.js.map +1 -0
- package/dist/internal/sesame/validation.d.ts +72 -0
- package/dist/internal/sesame/validation.d.ts.map +1 -0
- package/dist/internal/sesame/validation.js +136 -0
- package/dist/internal/sesame/validation.js.map +1 -0
- package/dist/internal/session/builder.d.ts +94 -0
- package/dist/internal/session/builder.d.ts.map +1 -0
- package/dist/internal/session/builder.js +266 -0
- package/dist/internal/session/builder.js.map +1 -0
- package/dist/internal/session/cipher.d.ts +256 -0
- package/dist/internal/session/cipher.d.ts.map +1 -0
- package/dist/internal/session/cipher.js +1222 -0
- package/dist/internal/session/cipher.js.map +1 -0
- package/dist/internal/session/decryption.d.ts +37 -0
- package/dist/internal/session/decryption.d.ts.map +1 -0
- package/dist/internal/session/decryption.js +256 -0
- package/dist/internal/session/decryption.js.map +1 -0
- package/dist/internal/session/factory.d.ts +161 -0
- package/dist/internal/session/factory.d.ts.map +1 -0
- package/dist/internal/session/factory.js +211 -0
- package/dist/internal/session/factory.js.map +1 -0
- package/dist/internal/session/handshake.d.ts +72 -0
- package/dist/internal/session/handshake.d.ts.map +1 -0
- package/dist/internal/session/handshake.js +343 -0
- package/dist/internal/session/handshake.js.map +1 -0
- package/dist/internal/session/identity-binding.d.ts +5 -0
- package/dist/internal/session/identity-binding.d.ts.map +1 -0
- package/dist/internal/session/identity-binding.js +15 -0
- package/dist/internal/session/identity-binding.js.map +1 -0
- package/dist/internal/session/index.d.ts +73 -0
- package/dist/internal/session/index.d.ts.map +1 -0
- package/dist/internal/session/index.js +75 -0
- package/dist/internal/session/index.js.map +1 -0
- package/dist/internal/session/keys.d.ts +220 -0
- package/dist/internal/session/keys.d.ts.map +1 -0
- package/dist/internal/session/keys.js +78 -0
- package/dist/internal/session/keys.js.map +1 -0
- package/dist/internal/session/ratchet.d.ts +97 -0
- package/dist/internal/session/ratchet.d.ts.map +1 -0
- package/dist/internal/session/ratchet.js +187 -0
- package/dist/internal/session/ratchet.js.map +1 -0
- package/dist/internal/session/session-resolver.d.ts +138 -0
- package/dist/internal/session/session-resolver.d.ts.map +1 -0
- package/dist/internal/session/session-resolver.js +190 -0
- package/dist/internal/session/session-resolver.js.map +1 -0
- package/dist/internal/session/state.d.ts +278 -0
- package/dist/internal/session/state.d.ts.map +1 -0
- package/dist/internal/session/state.js +167 -0
- package/dist/internal/session/state.js.map +1 -0
- package/dist/internal/session/types.d.ts +192 -0
- package/dist/internal/session/types.d.ts.map +1 -0
- package/dist/internal/session/types.js +16 -0
- package/dist/internal/session/types.js.map +1 -0
- package/dist/internal/session/validation.d.ts +145 -0
- package/dist/internal/session/validation.d.ts.map +1 -0
- package/dist/internal/session/validation.js +340 -0
- package/dist/internal/session/validation.js.map +1 -0
- package/dist/keys/branded.d.ts +85 -0
- package/dist/keys/branded.d.ts.map +1 -0
- package/dist/keys/branded.js +26 -0
- package/dist/keys/branded.js.map +1 -0
- package/dist/keys/generation.d.ts +101 -0
- package/dist/keys/generation.d.ts.map +1 -0
- package/dist/keys/generation.js +181 -0
- package/dist/keys/generation.js.map +1 -0
- package/dist/keys/identity.d.ts +27 -0
- package/dist/keys/identity.d.ts.map +1 -0
- package/dist/keys/identity.js +200 -0
- package/dist/keys/identity.js.map +1 -0
- package/dist/keys/index.d.ts +24 -0
- package/dist/keys/index.d.ts.map +1 -0
- package/dist/keys/index.js +22 -0
- package/dist/keys/index.js.map +1 -0
- package/dist/keys/prekey-signature.d.ts +13 -0
- package/dist/keys/prekey-signature.d.ts.map +1 -0
- package/dist/keys/prekey-signature.js +46 -0
- package/dist/keys/prekey-signature.js.map +1 -0
- package/dist/keys/types.d.ts +255 -0
- package/dist/keys/types.d.ts.map +1 -0
- package/dist/keys/types.js +11 -0
- package/dist/keys/types.js.map +1 -0
- package/dist/layers.d.ts +228 -0
- package/dist/layers.d.ts.map +1 -0
- package/dist/layers.js +328 -0
- package/dist/layers.js.map +1 -0
- package/dist/local/store/expo/adapter.d.ts +243 -0
- package/dist/local/store/expo/adapter.d.ts.map +1 -0
- package/dist/local/store/expo/adapter.js +619 -0
- package/dist/local/store/expo/adapter.js.map +1 -0
- package/dist/local/store/expo/database-key.d.ts +142 -0
- package/dist/local/store/expo/database-key.d.ts.map +1 -0
- package/dist/local/store/expo/database-key.js +312 -0
- package/dist/local/store/expo/database-key.js.map +1 -0
- package/dist/local/store/expo/db.d.ts +92 -0
- package/dist/local/store/expo/db.d.ts.map +1 -0
- package/dist/local/store/expo/db.js +142 -0
- package/dist/local/store/expo/db.js.map +1 -0
- package/dist/local/store/expo/index.d.ts +22 -0
- package/dist/local/store/expo/index.d.ts.map +1 -0
- package/dist/local/store/expo/index.js +10 -0
- package/dist/local/store/expo/index.js.map +1 -0
- package/dist/local/store/expo/key-storage.d.ts +422 -0
- package/dist/local/store/expo/key-storage.d.ts.map +1 -0
- package/dist/local/store/expo/key-storage.js +1292 -0
- package/dist/local/store/expo/key-storage.js.map +1 -0
- package/dist/local/store/expo/maintenance.d.ts +4 -0
- package/dist/local/store/expo/maintenance.d.ts.map +1 -0
- package/dist/local/store/expo/maintenance.js +36 -0
- package/dist/local/store/expo/maintenance.js.map +1 -0
- package/dist/local/store/expo/models/ec-one-time-prekey.d.ts +155 -0
- package/dist/local/store/expo/models/ec-one-time-prekey.d.ts.map +1 -0
- package/dist/local/store/expo/models/ec-one-time-prekey.js +309 -0
- package/dist/local/store/expo/models/ec-one-time-prekey.js.map +1 -0
- package/dist/local/store/expo/models/ec-signed-prekey.d.ts +189 -0
- package/dist/local/store/expo/models/ec-signed-prekey.d.ts.map +1 -0
- package/dist/local/store/expo/models/ec-signed-prekey.js +359 -0
- package/dist/local/store/expo/models/ec-signed-prekey.js.map +1 -0
- package/dist/local/store/expo/models/identity-key-id.d.ts +9 -0
- package/dist/local/store/expo/models/identity-key-id.d.ts.map +1 -0
- package/dist/local/store/expo/models/identity-key-id.js +10 -0
- package/dist/local/store/expo/models/identity-key-id.js.map +1 -0
- package/dist/local/store/expo/models/index.d.ts +20 -0
- package/dist/local/store/expo/models/index.d.ts.map +1 -0
- package/dist/local/store/expo/models/index.js +80 -0
- package/dist/local/store/expo/models/index.js.map +1 -0
- package/dist/local/store/expo/models/kyber-one-time-prekey.d.ts +183 -0
- package/dist/local/store/expo/models/kyber-one-time-prekey.d.ts.map +1 -0
- package/dist/local/store/expo/models/kyber-one-time-prekey.js +353 -0
- package/dist/local/store/expo/models/kyber-one-time-prekey.js.map +1 -0
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts +37 -0
- package/dist/local/store/expo/models/kyber-prekey-used.d.ts.map +1 -0
- package/dist/local/store/expo/models/kyber-prekey-used.js +59 -0
- package/dist/local/store/expo/models/kyber-prekey-used.js.map +1 -0
- package/dist/local/store/expo/models/kyber-prekey.d.ts +172 -0
- package/dist/local/store/expo/models/kyber-prekey.d.ts.map +1 -0
- package/dist/local/store/expo/models/kyber-prekey.js +314 -0
- package/dist/local/store/expo/models/kyber-prekey.js.map +1 -0
- package/dist/local/store/expo/models/local-identity.d.ts +52 -0
- package/dist/local/store/expo/models/local-identity.d.ts.map +1 -0
- package/dist/local/store/expo/models/local-identity.js +166 -0
- package/dist/local/store/expo/models/local-identity.js.map +1 -0
- package/dist/local/store/expo/models/message-record.d.ts +198 -0
- package/dist/local/store/expo/models/message-record.d.ts.map +1 -0
- package/dist/local/store/expo/models/message-record.js +298 -0
- package/dist/local/store/expo/models/message-record.js.map +1 -0
- package/dist/local/store/expo/models/recipient-identity.d.ts +21 -0
- package/dist/local/store/expo/models/recipient-identity.d.ts.map +1 -0
- package/dist/local/store/expo/models/recipient-identity.js +66 -0
- package/dist/local/store/expo/models/recipient-identity.js.map +1 -0
- package/dist/local/store/expo/models/replaced-prekey-utils.d.ts +33 -0
- package/dist/local/store/expo/models/replaced-prekey-utils.d.ts.map +1 -0
- package/dist/local/store/expo/models/replaced-prekey-utils.js +54 -0
- package/dist/local/store/expo/models/replaced-prekey-utils.js.map +1 -0
- package/dist/local/store/expo/models/sender-key.d.ts +210 -0
- package/dist/local/store/expo/models/sender-key.d.ts.map +1 -0
- package/dist/local/store/expo/models/sender-key.js +379 -0
- package/dist/local/store/expo/models/sender-key.js.map +1 -0
- package/dist/local/store/expo/models/session.d.ts +175 -0
- package/dist/local/store/expo/models/session.d.ts.map +1 -0
- package/dist/local/store/expo/models/session.js +496 -0
- package/dist/local/store/expo/models/session.js.map +1 -0
- package/dist/local/store/expo/schema.d.ts +1734 -0
- package/dist/local/store/expo/schema.d.ts.map +1 -0
- package/dist/local/store/expo/schema.js +155 -0
- package/dist/local/store/expo/schema.js.map +1 -0
- package/dist/local/store/expo/secure-store-options.d.ts +10 -0
- package/dist/local/store/expo/secure-store-options.d.ts.map +1 -0
- package/dist/local/store/expo/secure-store-options.js +5 -0
- package/dist/local/store/expo/secure-store-options.js.map +1 -0
- package/dist/local/store/index.d.ts +41 -0
- package/dist/local/store/index.d.ts.map +1 -0
- package/dist/local/store/index.js +34 -0
- package/dist/local/store/index.js.map +1 -0
- package/dist/local/store/mock/adapter.d.ts +185 -0
- package/dist/local/store/mock/adapter.d.ts.map +1 -0
- package/dist/local/store/mock/adapter.js +875 -0
- package/dist/local/store/mock/adapter.js.map +1 -0
- package/dist/local/store/mock/index.d.ts +10 -0
- package/dist/local/store/mock/index.d.ts.map +1 -0
- package/dist/local/store/mock/index.js +6 -0
- package/dist/local/store/mock/index.js.map +1 -0
- package/dist/local/store/node/adapter.d.ts +85 -0
- package/dist/local/store/node/adapter.d.ts.map +1 -0
- package/dist/local/store/node/adapter.js +274 -0
- package/dist/local/store/node/adapter.js.map +1 -0
- package/dist/local/store/node/database-encryption.d.ts +109 -0
- package/dist/local/store/node/database-encryption.d.ts.map +1 -0
- package/dist/local/store/node/database-encryption.js +202 -0
- package/dist/local/store/node/database-encryption.js.map +1 -0
- package/dist/local/store/node/database-key.d.ts +124 -0
- package/dist/local/store/node/database-key.d.ts.map +1 -0
- package/dist/local/store/node/database-key.js +264 -0
- package/dist/local/store/node/database-key.js.map +1 -0
- package/dist/local/store/node/database.d.ts +156 -0
- package/dist/local/store/node/database.d.ts.map +1 -0
- package/dist/local/store/node/database.js +630 -0
- package/dist/local/store/node/database.js.map +1 -0
- package/dist/local/store/node/index.d.ts +11 -0
- package/dist/local/store/node/index.d.ts.map +1 -0
- package/dist/local/store/node/index.js +8 -0
- package/dist/local/store/node/index.js.map +1 -0
- package/dist/local/store/react-native/adapter.d.ts +240 -0
- package/dist/local/store/react-native/adapter.d.ts.map +1 -0
- package/dist/local/store/react-native/adapter.js +1108 -0
- package/dist/local/store/react-native/adapter.js.map +1 -0
- package/dist/local/store/react-native/index.d.ts +19 -0
- package/dist/local/store/react-native/index.d.ts.map +1 -0
- package/dist/local/store/react-native/index.js +6 -0
- package/dist/local/store/react-native/index.js.map +1 -0
- package/dist/local/store/react-native/storage.d.ts +39 -0
- package/dist/local/store/react-native/storage.d.ts.map +1 -0
- package/dist/local/store/react-native/storage.js +2 -0
- package/dist/local/store/react-native/storage.js.map +1 -0
- package/dist/local/store/session-codec.d.ts +5 -0
- package/dist/local/store/session-codec.d.ts.map +1 -0
- package/dist/local/store/session-codec.js +42 -0
- package/dist/local/store/session-codec.js.map +1 -0
- package/dist/local/store/web/adapter.d.ts +190 -0
- package/dist/local/store/web/adapter.d.ts.map +1 -0
- package/dist/local/store/web/adapter.js +1188 -0
- package/dist/local/store/web/adapter.js.map +1 -0
- package/dist/local/store/web/index.d.ts +11 -0
- package/dist/local/store/web/index.d.ts.map +1 -0
- package/dist/local/store/web/index.js +8 -0
- package/dist/local/store/web/index.js.map +1 -0
- package/dist/local/vault/expo-secure-store.d.ts +10 -0
- package/dist/local/vault/expo-secure-store.d.ts.map +1 -0
- package/dist/local/vault/expo-secure-store.js +23 -0
- package/dist/local/vault/expo-secure-store.js.map +1 -0
- package/dist/local/vault/index.d.ts +7 -0
- package/dist/local/vault/index.d.ts.map +1 -0
- package/dist/local/vault/index.js +2 -0
- package/dist/local/vault/index.js.map +1 -0
- package/dist/logger.d.ts +18 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/logger.js +71 -0
- package/dist/logger.js.map +1 -0
- package/dist/media/index.d.ts +524 -0
- package/dist/media/index.d.ts.map +1 -0
- package/dist/media/index.js +2053 -0
- package/dist/media/index.js.map +1 -0
- package/dist/profile/cipher.d.ts +125 -0
- package/dist/profile/cipher.d.ts.map +1 -0
- package/dist/profile/cipher.js +197 -0
- package/dist/profile/cipher.js.map +1 -0
- package/dist/profile/contact-state.d.ts +33 -0
- package/dist/profile/contact-state.d.ts.map +1 -0
- package/dist/profile/contact-state.js +77 -0
- package/dist/profile/contact-state.js.map +1 -0
- package/dist/profile/crypto.d.ts +65 -0
- package/dist/profile/crypto.d.ts.map +1 -0
- package/dist/profile/crypto.js +93 -0
- package/dist/profile/crypto.js.map +1 -0
- package/dist/profile/index.d.ts +26 -0
- package/dist/profile/index.d.ts.map +1 -0
- package/dist/profile/index.js +30 -0
- package/dist/profile/index.js.map +1 -0
- package/dist/profile/profile-key.d.ts +102 -0
- package/dist/profile/profile-key.d.ts.map +1 -0
- package/dist/profile/profile-key.js +229 -0
- package/dist/profile/profile-key.js.map +1 -0
- package/dist/profile/storage.d.ts +61 -0
- package/dist/profile/storage.d.ts.map +1 -0
- package/dist/profile/storage.js +145 -0
- package/dist/profile/storage.js.map +1 -0
- package/dist/profile/update-service.d.ts +53 -0
- package/dist/profile/update-service.d.ts.map +1 -0
- package/dist/profile/update-service.js +67 -0
- package/dist/profile/update-service.js.map +1 -0
- package/dist/remote/object-store/convex-r2/index.d.ts +11 -0
- package/dist/remote/object-store/convex-r2/index.d.ts.map +1 -0
- package/dist/remote/object-store/convex-r2/index.js +13 -0
- package/dist/remote/object-store/convex-r2/index.js.map +1 -0
- package/dist/remote/object-store/convex-r2/server/index.d.ts +2 -0
- package/dist/remote/object-store/convex-r2/server/index.d.ts.map +1 -0
- package/dist/remote/object-store/convex-r2/server/index.js +2 -0
- package/dist/remote/object-store/convex-r2/server/index.js.map +1 -0
- package/dist/remote/object-store/convex-r2/server.d.ts +126 -0
- package/dist/remote/object-store/convex-r2/server.d.ts.map +1 -0
- package/dist/remote/object-store/convex-r2/server.js +232 -0
- package/dist/remote/object-store/convex-r2/server.js.map +1 -0
- package/dist/remote/object-store/convex-r2/storage.d.ts +47 -0
- package/dist/remote/object-store/convex-r2/storage.d.ts.map +1 -0
- package/dist/remote/object-store/convex-r2/storage.js +55 -0
- package/dist/remote/object-store/convex-r2/storage.js.map +1 -0
- package/dist/remote/object-store/index.d.ts +8 -0
- package/dist/remote/object-store/index.d.ts.map +1 -0
- package/dist/remote/object-store/index.js +2 -0
- package/dist/remote/object-store/index.js.map +1 -0
- package/dist/remote/object-store/s3/index.d.ts +8 -0
- package/dist/remote/object-store/s3/index.d.ts.map +1 -0
- package/dist/remote/object-store/s3/index.js +10 -0
- package/dist/remote/object-store/s3/index.js.map +1 -0
- package/dist/remote/object-store/s3/storage.d.ts +44 -0
- package/dist/remote/object-store/s3/storage.d.ts.map +1 -0
- package/dist/remote/object-store/s3/storage.js +41 -0
- package/dist/remote/object-store/s3/storage.js.map +1 -0
- package/dist/remote/object-store/types.d.ts +80 -0
- package/dist/remote/object-store/types.d.ts.map +1 -0
- package/dist/remote/object-store/types.js +2 -0
- package/dist/remote/object-store/types.js.map +1 -0
- package/dist/remote/object-store/validation.d.ts +6 -0
- package/dist/remote/object-store/validation.d.ts.map +1 -0
- package/dist/remote/object-store/validation.js +93 -0
- package/dist/remote/object-store/validation.js.map +1 -0
- package/dist/remote/relay/convex/group-server.d.ts +118 -0
- package/dist/remote/relay/convex/group-server.d.ts.map +1 -0
- package/dist/remote/relay/convex/group-server.js +150 -0
- package/dist/remote/relay/convex/group-server.js.map +1 -0
- package/dist/remote/relay/convex/index.d.ts +39 -0
- package/dist/remote/relay/convex/index.d.ts.map +1 -0
- package/dist/remote/relay/convex/index.js +36 -0
- package/dist/remote/relay/convex/index.js.map +1 -0
- package/dist/remote/relay/convex/relay.d.ts +339 -0
- package/dist/remote/relay/convex/relay.d.ts.map +1 -0
- package/dist/remote/relay/convex/relay.js +1086 -0
- package/dist/remote/relay/convex/relay.js.map +1 -0
- package/dist/remote/relay/convex/types.d.ts +111 -0
- package/dist/remote/relay/convex/types.d.ts.map +1 -0
- package/dist/remote/relay/convex/types.js +19 -0
- package/dist/remote/relay/convex/types.js.map +1 -0
- package/dist/remote/relay/index.d.ts +34 -0
- package/dist/remote/relay/index.d.ts.map +1 -0
- package/dist/remote/relay/index.js +28 -0
- package/dist/remote/relay/index.js.map +1 -0
- package/dist/remote/relay/mock/adapter.d.ts +237 -0
- package/dist/remote/relay/mock/adapter.d.ts.map +1 -0
- package/dist/remote/relay/mock/adapter.js +939 -0
- package/dist/remote/relay/mock/adapter.js.map +1 -0
- package/dist/remote/relay/mock/index.d.ts +10 -0
- package/dist/remote/relay/mock/index.d.ts.map +1 -0
- package/dist/remote/relay/mock/index.js +6 -0
- package/dist/remote/relay/mock/index.js.map +1 -0
- package/dist/remote/relay/types.d.ts +756 -0
- package/dist/remote/relay/types.d.ts.map +1 -0
- package/dist/remote/relay/types.js +11 -0
- package/dist/remote/relay/types.js.map +1 -0
- package/dist/safety/core.d.ts +108 -0
- package/dist/safety/core.d.ts.map +1 -0
- package/dist/safety/core.js +299 -0
- package/dist/safety/core.js.map +1 -0
- package/dist/safety/fingerprint.d.ts +277 -0
- package/dist/safety/fingerprint.d.ts.map +1 -0
- package/dist/safety/fingerprint.js +339 -0
- package/dist/safety/fingerprint.js.map +1 -0
- package/dist/safety/index.d.ts +141 -0
- package/dist/safety/index.d.ts.map +1 -0
- package/dist/safety/index.js +230 -0
- package/dist/safety/index.js.map +1 -0
- package/dist/safety/protobuf.d.ts +34 -0
- package/dist/safety/protobuf.d.ts.map +1 -0
- package/dist/safety/protobuf.js +142 -0
- package/dist/safety/protobuf.js.map +1 -0
- package/dist/safety/url.d.ts +133 -0
- package/dist/safety/url.d.ts.map +1 -0
- package/dist/safety/url.js +242 -0
- package/dist/safety/url.js.map +1 -0
- package/dist/sealed-sender/index.d.ts +7 -0
- package/dist/sealed-sender/index.d.ts.map +1 -0
- package/dist/sealed-sender/index.js +6 -0
- package/dist/sealed-sender/index.js.map +1 -0
- package/dist/server-clock.d.ts +10 -0
- package/dist/server-clock.d.ts.map +1 -0
- package/dist/server-clock.js +27 -0
- package/dist/server-clock.js.map +1 -0
- package/dist/types/address.d.ts +171 -0
- package/dist/types/address.d.ts.map +1 -0
- package/dist/types/address.js +241 -0
- package/dist/types/address.js.map +1 -0
- package/dist/types/api.d.ts +1222 -0
- package/dist/types/api.d.ts.map +1 -0
- package/dist/types/api.js +5 -0
- package/dist/types/api.js.map +1 -0
- package/dist/types/errors.d.ts +772 -0
- package/dist/types/errors.d.ts.map +1 -0
- package/dist/types/errors.js +937 -0
- package/dist/types/errors.js.map +1 -0
- package/dist/types/index.d.ts +20 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +33 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/messages.d.ts +257 -0
- package/dist/types/messages.d.ts.map +1 -0
- package/dist/types/messages.js +96 -0
- package/dist/types/messages.js.map +1 -0
- package/dist/types/protocol-config.d.ts +337 -0
- package/dist/types/protocol-config.d.ts.map +1 -0
- package/dist/types/protocol-config.js +178 -0
- package/dist/types/protocol-config.js.map +1 -0
- package/dist/types/protocol-constants.d.ts +122 -0
- package/dist/types/protocol-constants.d.ts.map +1 -0
- package/dist/types/protocol-constants.js +115 -0
- package/dist/types/protocol-constants.js.map +1 -0
- package/dist/types/session.d.ts +721 -0
- package/dist/types/session.d.ts.map +1 -0
- package/dist/types/session.js +340 -0
- package/dist/types/session.js.map +1 -0
- package/dist/types/trust.d.ts +168 -0
- package/dist/types/trust.d.ts.map +1 -0
- package/dist/types/trust.js +84 -0
- package/dist/types/trust.js.map +1 -0
- package/dist/types/utils.d.ts +93 -0
- package/dist/types/utils.d.ts.map +1 -0
- package/dist/types/utils.js +89 -0
- package/dist/types/utils.js.map +1 -0
- package/dist/username/index.d.ts +12 -0
- package/dist/username/index.d.ts.map +1 -0
- package/dist/username/index.js +11 -0
- package/dist/username/index.js.map +1 -0
- package/dist/username/link.d.ts +52 -0
- package/dist/username/link.d.ts.map +1 -0
- package/dist/username/link.js +87 -0
- package/dist/username/link.js.map +1 -0
- package/dist/utils/binary-transfer.d.ts +18 -0
- package/dist/utils/binary-transfer.d.ts.map +1 -0
- package/dist/utils/binary-transfer.js +27 -0
- package/dist/utils/binary-transfer.js.map +1 -0
- package/dist/utils/errors.d.ts +9 -0
- package/dist/utils/errors.d.ts.map +1 -0
- package/dist/utils/errors.js +15 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/retry.d.ts +59 -0
- package/dist/utils/retry.d.ts.map +1 -0
- package/dist/utils/retry.js +136 -0
- package/dist/utils/retry.js.map +1 -0
- package/dist/versions.d.ts +62 -0
- package/dist/versions.d.ts.map +1 -0
- package/dist/versions.js +78 -0
- package/dist/versions.js.map +1 -0
- package/dist/zk/credentials.d.ts +10 -0
- package/dist/zk/credentials.d.ts.map +1 -0
- package/dist/zk/credentials.js +9 -0
- package/dist/zk/credentials.js.map +1 -0
- package/dist/zk/groups.d.ts +12 -0
- package/dist/zk/groups.d.ts.map +1 -0
- package/dist/zk/groups.js +11 -0
- package/dist/zk/groups.js.map +1 -0
- package/docs/ASSURANCE.md +102 -0
- package/docs/CLIENT_COMPOSITION.md +189 -0
- package/docs/DOCUMENTATION_STANDARDS.md +107 -0
- package/docs/E2EE.md +35 -0
- package/docs/ERROR_HANDLING.md +396 -0
- package/docs/GETTING_STARTED.md +714 -0
- package/docs/INTERFACES.md +187 -0
- package/docs/PACKAGE_SURFACE.md +235 -0
- package/docs/PROTOCOL_POLICY.md +109 -0
- package/docs/RECIPES.md +389 -0
- package/docs/SECURITY.md +199 -0
- package/docs/api/README.md +471 -0
- package/docs/api/classes/EncryptionError.md +112 -0
- package/docs/api/classes/EndorsementManager.md +307 -0
- package/docs/api/classes/SealedSenderAuthError.md +127 -0
- package/docs/api/classes/ServerDerivedKeyPair.md +68 -0
- package/docs/api/classes/ServerDerivedPublicKey.md +33 -0
- package/docs/api/classes/ServerRootKeyPair.md +94 -0
- package/docs/api/classes/ServerRootPublicKey.md +72 -0
- package/docs/api/classes/SignalBlockingManager.md +106 -0
- package/docs/api/classes/SignalProtocolClient.md +2651 -0
- package/docs/api/classes/VerificationFailure.md +25 -0
- package/docs/api/enumerations/ContentHint.md +63 -0
- package/docs/api/enumerations/EncryptionErrorCode.md +488 -0
- package/docs/api/enumerations/IdentityKeyChange.md +65 -0
- package/docs/api/enumerations/MessageType.md +29 -0
- package/docs/api/enumerations/TrustDirection.md +33 -0
- package/docs/api/enumerations/TypingAction.md +31 -0
- package/docs/api/functions/createDefaultSignalContentAdapter.md +13 -0
- package/docs/api/functions/createDefaultSignalLogger.md +36 -0
- package/docs/api/functions/createGroupId.md +32 -0
- package/docs/api/functions/createSignalProtocolClient.md +36 -0
- package/docs/api/functions/createSignalProtocolClientConfig.md +24 -0
- package/docs/api/functions/extractGroupId.md +32 -0
- package/docs/api/functions/formatVersion.md +25 -0
- package/docs/api/functions/isCompatible.md +31 -0
- package/docs/api/functions/isGroupId.md +37 -0
- package/docs/api/functions/isSealedSenderAuthError.md +25 -0
- package/docs/api/functions/parseVersion.md +29 -0
- package/docs/api/functions/resolveSPQRLimits.md +21 -0
- package/docs/api/functions/resolveSignalLogger.md +42 -0
- package/docs/api/interfaces/AccountIdentityProvisioning.md +43 -0
- package/docs/api/interfaces/AccountIdentityRotation.md +69 -0
- package/docs/api/interfaces/AttachmentTransferOptions.md +49 -0
- package/docs/api/interfaces/BlockedRecipientEntry.md +25 -0
- package/docs/api/interfaces/BlockedRecipientsSyncInput.md +27 -0
- package/docs/api/interfaces/ConfigurationSyncInput.md +19 -0
- package/docs/api/interfaces/CredentialPublicKey.md +25 -0
- package/docs/api/interfaces/DataMessageInput.md +21 -0
- package/docs/api/interfaces/DecryptedEnvelope.md +95 -0
- package/docs/api/interfaces/DecryptedGroup.md +86 -0
- package/docs/api/interfaces/DeviceInfo.md +79 -0
- package/docs/api/interfaces/DeviceRecord.md +87 -0
- package/docs/api/interfaces/DeviceRegistration.md +27 -0
- package/docs/api/interfaces/DoubleRatchetConfig.md +36 -0
- package/docs/api/interfaces/EcOneTimePreKey.md +27 -0
- package/docs/api/interfaces/EcSignedPreKey.md +39 -0
- package/docs/api/interfaces/EcSignedPreKeyUpload.md +50 -0
- package/docs/api/interfaces/EncryptionErrorContext.md +51 -0
- package/docs/api/interfaces/Envelope.md +154 -0
- package/docs/api/interfaces/ForceKeyResetResult.md +37 -0
- package/docs/api/interfaces/GroupAuthorization.md +23 -0
- package/docs/api/interfaces/GroupChangeEntry.md +42 -0
- package/docs/api/interfaces/GroupMemberDevice.md +26 -0
- package/docs/api/interfaces/IEcOneTimePreKeyStore.md +86 -0
- package/docs/api/interfaces/IEcSignedPreKeyStore.md +132 -0
- package/docs/api/interfaces/IGroupServer.md +120 -0
- package/docs/api/interfaces/IGroupStateStore.md +128 -0
- package/docs/api/interfaces/IIdentityKeyStore.md +312 -0
- package/docs/api/interfaces/IKemPreKeyStore.md +144 -0
- package/docs/api/interfaces/IKyberLastResortPreKeyStore.md +111 -0
- package/docs/api/interfaces/ILogger.md +117 -0
- package/docs/api/interfaces/IProtocolStore.md +1033 -0
- package/docs/api/interfaces/ISenderKeyStore.md +417 -0
- package/docs/api/interfaces/ISesameStore.md +249 -0
- package/docs/api/interfaces/ISessionStore.md +178 -0
- package/docs/api/interfaces/ISignalLocalSecretVault.md +71 -0
- package/docs/api/interfaces/ISignalLocalStore.md +2053 -0
- package/docs/api/interfaces/ISignalProtocolClient.md +1183 -0
- package/docs/api/interfaces/ISignalProtocolManager.md +272 -0
- package/docs/api/interfaces/ISignalRelayServer.md +1329 -0
- package/docs/api/interfaces/IdentityKeyPair.md +49 -0
- package/docs/api/interfaces/IncomingEnvelope.md +91 -0
- package/docs/api/interfaces/InspectedSignalContent.md +43 -0
- package/docs/api/interfaces/KDFChain.md +31 -0
- package/docs/api/interfaces/KemLastResortPreKeyUpload.md +50 -0
- package/docs/api/interfaces/KeyPair.md +23 -0
- package/docs/api/interfaces/KyberPreKey.md +42 -0
- package/docs/api/interfaces/MLKEMBraidAgentState.md +191 -0
- package/docs/api/interfaces/MLKEMBraidMessage.md +49 -0
- package/docs/api/interfaces/MediaAttachmentDeleteSyncInput.md +31 -0
- package/docs/api/interfaces/MessageHeader.md +49 -0
- package/docs/api/interfaces/MessageRecord.md +86 -0
- package/docs/api/interfaces/ParsedReceiptContent.md +19 -0
- package/docs/api/interfaces/ParsedTypingContent.md +19 -0
- package/docs/api/interfaces/PreKeyMaintenanceStore.md +87 -0
- package/docs/api/interfaces/PreKeyMessage.md +159 -0
- package/docs/api/interfaces/PreKeyStatusResult.md +21 -0
- package/docs/api/interfaces/PreKeyUpload.md +42 -0
- package/docs/api/interfaces/ProcessEnvelopeOptions.md +72 -0
- package/docs/api/interfaces/ProtocolAddress.md +38 -0
- package/docs/api/interfaces/ProtocolStrategyConfig.md +91 -0
- package/docs/api/interfaces/RatchetMessage.md +96 -0
- package/docs/api/interfaces/ReadSyncEntryInput.md +19 -0
- package/docs/api/interfaces/ReceiverChain.md +43 -0
- package/docs/api/interfaces/RecipientUsernameSyncInput.md +31 -0
- package/docs/api/interfaces/RelayPreKeyBundle.md +254 -0
- package/docs/api/interfaces/RemoteObjectDownload.md +33 -0
- package/docs/api/interfaces/RemoteObjectUpload.md +49 -0
- package/docs/api/interfaces/ResolvedSPQRInfoStrings.md +27 -0
- package/docs/api/interfaces/ResolvedSPQRLimits.md +37 -0
- package/docs/api/interfaces/RetryRequest.md +80 -0
- package/docs/api/interfaces/SCKAState.md +65 -0
- package/docs/api/interfaces/SPQRLimits.md +40 -0
- package/docs/api/interfaces/SPQRState.md +191 -0
- package/docs/api/interfaces/SafetyNumber.md +60 -0
- package/docs/api/interfaces/SafetyNumberConfirmation.md +46 -0
- package/docs/api/interfaces/SealedSenderConfig.md +70 -0
- package/docs/api/interfaces/SendOptions.md +191 -0
- package/docs/api/interfaces/SendResult.md +93 -0
- package/docs/api/interfaces/SenderKeyDistributionMessage.md +43 -0
- package/docs/api/interfaces/SenderKeyState.md +76 -0
- package/docs/api/interfaces/SenderKeysConfig.md +65 -0
- package/docs/api/interfaces/SentSyncTranscriptInput.md +31 -0
- package/docs/api/interfaces/ServiceId.md +19 -0
- package/docs/api/interfaces/SesameMessage.md +84 -0
- package/docs/api/interfaces/SesameStats.md +57 -0
- package/docs/api/interfaces/SessionHealthResult.md +120 -0
- package/docs/api/interfaces/SessionRecord.md +80 -0
- package/docs/api/interfaces/SessionRecordMetadata.md +109 -0
- package/docs/api/interfaces/SessionState.md +368 -0
- package/docs/api/interfaces/SessionTrustCommit.md +58 -0
- package/docs/api/interfaces/SignalBlockingHooks.md +44 -0
- package/docs/api/interfaces/SignalBlockingManagerOptions.md +31 -0
- package/docs/api/interfaces/SignalBlockingMirror.md +30 -0
- package/docs/api/interfaces/SignalBlockingStore.md +83 -0
- package/docs/api/interfaces/SignalContentAdapter.md +325 -0
- package/docs/api/interfaces/SignalProtocolClientAdapterConfig.md +44 -0
- package/docs/api/interfaces/SignalProtocolClientCompositionOptions.md +693 -0
- package/docs/api/interfaces/SignalProtocolClientConfig.md +839 -0
- package/docs/api/interfaces/SignalProtocolClientDeleteLocalAttachmentInput.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientHooks.md +506 -0
- package/docs/api/interfaces/SignalProtocolClientIdentityConfig.md +35 -0
- package/docs/api/interfaces/SignalProtocolClientLoadLocalAttachmentInput.md +187 -0
- package/docs/api/interfaces/SignalProtocolClientLoadedLocalAttachment.md +19 -0
- package/docs/api/interfaces/SignalProtocolClientMedia.md +83 -0
- package/docs/api/interfaces/SignalProtocolClientMediaCompletedResult.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientMediaConfig.md +157 -0
- package/docs/api/interfaces/SignalProtocolClientMediaDownloadCompletedResult.md +37 -0
- package/docs/api/interfaces/SignalProtocolClientMediaDownloadNotNeededResult.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientMediaFailedResult.md +19 -0
- package/docs/api/interfaces/SignalProtocolClientMediaOperationOptions.md +53 -0
- package/docs/api/interfaces/SignalProtocolClientMediaPendingResult.md +19 -0
- package/docs/api/interfaces/SignalProtocolClientMediaProcessResult.md +43 -0
- package/docs/api/interfaces/SignalProtocolClientMediaSkippedResult.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientMediaUploadCompletedResult.md +31 -0
- package/docs/api/interfaces/SignalProtocolClientProcessPendingMediaOptions.md +87 -0
- package/docs/api/interfaces/SignalProtocolClientSaveDownloadedAttachmentInput.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientSaveUploadedAttachmentInput.md +25 -0
- package/docs/api/interfaces/SignalProtocolClientSyncDeleteInput.md +19 -0
- package/docs/api/interfaces/SignalProtocolConfig.md +50 -0
- package/docs/api/interfaces/SignalRemoteObjectStore.md +88 -0
- package/docs/api/interfaces/SkippedSenderMessageKey.md +26 -0
- package/docs/api/interfaces/TaskNotificationAckSyncInput.md +31 -0
- package/docs/api/interfaces/TripleRatchetState.md +64 -0
- package/docs/api/interfaces/UserRecord.md +71 -0
- package/docs/api/interfaces/UsernameStateSyncInput.md +19 -0
- package/docs/api/interfaces/VerificationStateSyncInput.md +31 -0
- package/docs/api/interfaces/VersionNegotiationState.md +84 -0
- package/docs/api/interfaces/ViewOnceOpenSyncInput.md +19 -0
- package/docs/api/namespaces/ProtocolAddress/README.md +33 -0
- package/docs/api/namespaces/ProtocolAddress/functions/create.md +41 -0
- package/docs/api/namespaces/ProtocolAddress/functions/equals.md +39 -0
- package/docs/api/namespaces/ProtocolAddress/functions/fromStorageKey.md +36 -0
- package/docs/api/namespaces/ProtocolAddress/functions/isUser.md +39 -0
- package/docs/api/namespaces/ProtocolAddress/functions/isValid.md +34 -0
- package/docs/api/namespaces/ProtocolAddress/functions/parse.md +41 -0
- package/docs/api/namespaces/ProtocolAddress/functions/toStorageKey.md +38 -0
- package/docs/api/namespaces/ProtocolAddress/functions/toString.md +34 -0
- package/docs/api/namespaces/SessionRecord/README.md +30 -0
- package/docs/api/namespaces/SessionRecord/functions/archiveCurrent.md +40 -0
- package/docs/api/namespaces/SessionRecord/functions/archiveCurrentState.md +34 -0
- package/docs/api/namespaces/SessionRecord/functions/create.md +25 -0
- package/docs/api/namespaces/SessionRecord/functions/deserialize.md +29 -0
- package/docs/api/namespaces/SessionRecord/functions/findSession.md +34 -0
- package/docs/api/namespaces/SessionRecord/functions/getAllSessions.md +25 -0
- package/docs/api/namespaces/SessionRecord/functions/getArchivedCount.md +25 -0
- package/docs/api/namespaces/SessionRecord/functions/hasCurrentSession.md +25 -0
- package/docs/api/namespaces/SessionRecord/functions/hasUsableSenderChain.md +36 -0
- package/docs/api/namespaces/SessionRecord/functions/promoteSession.md +34 -0
- package/docs/api/namespaces/SessionRecord/functions/serialize.md +28 -0
- package/docs/api/namespaces/SessionRecord/variables/MAX_ARCHIVED_SESSIONS.md +14 -0
- package/docs/api/namespaces/SessionState/README.md +15 -0
- package/docs/api/namespaces/SessionState/functions/getSessionId.md +32 -0
- package/docs/api/namespaces/blocking/README.md +43 -0
- package/docs/api/namespaces/encoding/README.md +33 -0
- package/docs/api/namespaces/encoding/functions/base64ToUrlSafe.md +28 -0
- package/docs/api/namespaces/encoding/functions/bytesToBase64.md +21 -0
- package/docs/api/namespaces/encoding/functions/bytesToString.md +21 -0
- package/docs/api/namespaces/encoding/functions/bytesToUrlSafeBase64.md +33 -0
- package/docs/api/namespaces/encoding/functions/concatBytes.md +21 -0
- package/docs/api/namespaces/encoding/functions/stringToBytes.md +21 -0
- package/docs/api/namespaces/encoding/functions/urlSafeToBase64.md +27 -0
- package/docs/api/namespaces/keys/README.md +126 -0
- package/docs/api/namespaces/keys/functions/acceptContactIdentityRotation.md +33 -0
- package/docs/api/namespaces/keys/functions/assertIdentityCommitment.md +25 -0
- package/docs/api/namespaces/keys/functions/compositeIdentitiesEqual.md +23 -0
- package/docs/api/namespaces/keys/functions/createCompositeIdentityV1.md +19 -0
- package/docs/api/namespaces/keys/functions/createPreKeySignatureContext.md +31 -0
- package/docs/api/namespaces/keys/functions/createUnverifiedContactIdentityRecord.md +23 -0
- package/docs/api/namespaces/keys/functions/decodeCompositeIdentityV1.md +19 -0
- package/docs/api/namespaces/keys/functions/deriveIdentityCommitment.md +19 -0
- package/docs/api/namespaces/keys/functions/encodeCompositeIdentityV1.md +19 -0
- package/docs/api/namespaces/keys/functions/evaluateContactIdentityCandidate.md +27 -0
- package/docs/api/namespaces/keys/functions/generateEcOneTimePreKeys.md +37 -0
- package/docs/api/namespaces/keys/functions/generateEcSignedPreKey.md +39 -0
- package/docs/api/namespaces/keys/functions/generateEcSignedPreKeyId.md +21 -0
- package/docs/api/namespaces/keys/functions/generateIdentityKeyPair.md +24 -0
- package/docs/api/namespaces/keys/functions/generateKemOneTimePreKeys.md +47 -0
- package/docs/api/namespaces/keys/functions/generateKyberLastResortPreKey.md +37 -0
- package/docs/api/namespaces/keys/functions/generateRegistrationId.md +13 -0
- package/docs/api/namespaces/keys/functions/signMlKem1024PreKey.md +29 -0
- package/docs/api/namespaces/keys/functions/signPreKey.md +31 -0
- package/docs/api/namespaces/keys/functions/validateContactIdentityRecord.md +19 -0
- package/docs/api/namespaces/keys/functions/verifyContactIdentityRecord.md +31 -0
- package/docs/api/namespaces/keys/functions/verifyMlKem1024PreKey.md +33 -0
- package/docs/api/namespaces/keys/functions/verifyPreKeySignature.md +35 -0
- package/docs/api/namespaces/keys/interfaces/CompositeIdentityV1.md +33 -0
- package/docs/api/namespaces/keys/interfaces/ContactIdentityRecord.md +53 -0
- package/docs/api/namespaces/keys/interfaces/KemOneTimePreKey.md +43 -0
- package/docs/api/namespaces/keys/type-aliases/IdentityCandidateStatus.md +9 -0
- package/docs/api/namespaces/keys/type-aliases/IdentityTrustState.md +9 -0
- package/docs/api/namespaces/keys/type-aliases/IdentityType.md +9 -0
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_ED25519_TAG.md +9 -0
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_LENGTH.md +9 -0
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_VERSION.md +9 -0
- package/docs/api/namespaces/keys/variables/COMPOSITE_IDENTITY_V1_X25519_TAG.md +9 -0
- package/docs/api/namespaces/keys/variables/IDENTITY_COMMITMENT_V1_DOMAIN.md +9 -0
- package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_ML_KEM_1024.md +9 -0
- package/docs/api/namespaces/keys/variables/PREKEY_ALGORITHM_X25519.md +9 -0
- package/docs/api/namespaces/keys/variables/PREKEY_SIGNATURE_V1_DOMAIN.md +9 -0
- package/docs/api/namespaces/media/README.md +105 -0
- package/docs/api/namespaces/media/classes/MediaAttachmentError.md +57 -0
- package/docs/api/namespaces/media/functions/createByteRangeMediaAttachmentTransfer.md +19 -0
- package/docs/api/namespaces/media/functions/createMediaAttachmentDeliveryId.md +29 -0
- package/docs/api/namespaces/media/functions/createMediaAttachmentId.md +19 -0
- package/docs/api/namespaces/media/functions/createMediaAttachmentMessage.md +25 -0
- package/docs/api/namespaces/media/functions/createMediaAttachmentPointer.md +19 -0
- package/docs/api/namespaces/media/functions/createTusMediaAttachmentTransfer.md +19 -0
- package/docs/api/namespaces/media/functions/deleteMediaAttachment.md +23 -0
- package/docs/api/namespaces/media/functions/executeMediaAttachmentJob.md +23 -0
- package/docs/api/namespaces/media/functions/isMediaAttachmentFlagSet.md +19 -0
- package/docs/api/namespaces/media/functions/parseMediaAttachmentMessage.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentCleanup.md +23 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentCleanupJobs.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentDeleteSync.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentDownloadJob.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentOpen.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentProcessing.md +19 -0
- package/docs/api/namespaces/media/functions/planMediaAttachmentUploadJob.md +19 -0
- package/docs/api/namespaces/media/functions/prepareMediaAttachmentUpload.md +30 -0
- package/docs/api/namespaces/media/functions/resolveMediaAttachment.md +30 -0
- package/docs/api/namespaces/media/functions/serializeMediaAttachmentMessage.md +25 -0
- package/docs/api/namespaces/media/functions/validateMediaAttachmentPolicy.md +23 -0
- package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentPartialStore.md +68 -0
- package/docs/api/namespaces/media/interfaces/ByteRangeMediaAttachmentTransferOptions.md +91 -0
- package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentOptions.md +25 -0
- package/docs/api/namespaces/media/interfaces/DeleteMediaAttachmentResult.md +19 -0
- package/docs/api/namespaces/media/interfaces/ExecuteMediaAttachmentJobOptions.md +157 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentBackgroundJob.md +85 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentCleanupPlan.md +37 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentJobExecutionResult.md +55 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentMessage.md +31 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentOpenDecision.md +31 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentPointer.md +133 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentPolicy.md +67 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentProcessingPlan.md +73 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentProgress.md +69 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentResumeState.md +37 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentRetryOptions.md +31 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransfer.md +51 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferCheckpoint.md +69 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentTransferOptions.md +67 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadJobData.md +19 -0
- package/docs/api/namespaces/media/interfaces/MediaAttachmentUploadResponse.md +25 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentCleanupJobsInput.md +61 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDeleteSyncInput.md +25 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentDownloadJobInput.md +161 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentOpenInput.md +25 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentProcessingInput.md +83 -0
- package/docs/api/namespaces/media/interfaces/PlanMediaAttachmentUploadJobInput.md +147 -0
- package/docs/api/namespaces/media/interfaces/PrepareMediaAttachmentUploadOptions.md +144 -0
- package/docs/api/namespaces/media/interfaces/ResolveMediaAttachmentOptions.md +55 -0
- package/docs/api/namespaces/media/interfaces/ResolvedMediaAttachment.md +109 -0
- package/docs/api/namespaces/media/interfaces/TusMediaAttachmentTransferOptions.md +85 -0
- package/docs/api/namespaces/media/type-aliases/CreateMediaAttachmentPointerInput.md +15 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentCheckpointCallback.md +19 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentCleanupReason.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentErrorCode.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentFlag.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobExecutionStatus.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobOperation.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobPriority.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSkipReason.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentJobSource.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentKnownIds.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentMessageType.md +9 -0
- package/docs/api/namespaces/media/type-aliases/MediaAttachmentProgressCallback.md +19 -0
- package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_DEFAULTS.md +47 -0
- package/docs/api/namespaces/media/variables/MEDIA_ATTACHMENT_POLICY_PRESETS.md +95 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentCleanupReason.md +27 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentErrorCode.md +75 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentFlag.md +23 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentJobExecutionStatus.md +19 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentJobOperation.md +31 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentJobPriority.md +23 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentJobSource.md +51 -0
- package/docs/api/namespaces/media/variables/MediaAttachmentMessageType.md +15 -0
- package/docs/api/namespaces/media/variables/downloadMediaAttachment.md +30 -0
- package/docs/api/namespaces/safety/README.md +61 -0
- package/docs/api/namespaces/safety/classes/DisplayableFingerprint.md +108 -0
- package/docs/api/namespaces/safety/classes/Fingerprint.md +104 -0
- package/docs/api/namespaces/safety/classes/ScannableFingerprint.md +209 -0
- package/docs/api/namespaces/safety/functions/base64ToBytes.md +21 -0
- package/docs/api/namespaces/safety/functions/clearFingerprintCache.md +15 -0
- package/docs/api/namespaces/safety/functions/compareSafetyNumbers.md +25 -0
- package/docs/api/namespaces/safety/functions/createFingerprintData.md +60 -0
- package/docs/api/namespaces/safety/functions/extractQrData.md +34 -0
- package/docs/api/namespaces/safety/functions/generateCompositeSafetyNumber.md +39 -0
- package/docs/api/namespaces/safety/functions/generateEmojiFingerprint.md +24 -0
- package/docs/api/namespaces/safety/functions/generateSingleKeyReferenceSafetyNumber.md +51 -0
- package/docs/api/namespaces/safety/functions/generateVerifySchemeUrl.md +32 -0
- package/docs/api/namespaces/safety/functions/generateVerifyUrl.md +49 -0
- package/docs/api/namespaces/safety/functions/isValidSafetyNumber.md +21 -0
- package/docs/api/namespaces/safety/functions/isVerifyUrl.md +45 -0
- package/docs/api/namespaces/safety/functions/parseVerifyUrl.md +31 -0
- package/docs/api/namespaces/safety/interfaces/FingerprintData.md +52 -0
- package/docs/api/namespaces/safety/interfaces/SafetyNumber.md +49 -0
- package/docs/api/namespaces/safety/interfaces/VerifyLinkConfig.md +28 -0
- package/docs/api/namespaces/safety/interfaces/VerifyUrlParams.md +49 -0
- package/docs/api/namespaces/safety/type-aliases/CompareResult.md +21 -0
- package/docs/api/namespaces/safety/variables/DEFAULT_VERIFY_LINK_CONFIG.md +12 -0
- package/docs/api/namespaces/safety/variables/FINGERPRINT_ITERATIONS.md +12 -0
- package/docs/api/namespaces/safety/variables/FINGERPRINT_VERSION.md +12 -0
- package/docs/api/namespaces/safety/variables/VERIFY_BASE_URL.md +11 -0
- package/docs/api/namespaces/safety/variables/VERIFY_SCHEME_URL.md +11 -0
- package/docs/api/type-aliases/Base64.md +20 -0
- package/docs/api/type-aliases/BraidPolicy.md +11 -0
- package/docs/api/type-aliases/Bytes.md +20 -0
- package/docs/api/type-aliases/Ciphertext.md +21 -0
- package/docs/api/type-aliases/DeviceType.md +11 -0
- package/docs/api/type-aliases/DownloadedAttachment.md +11 -0
- package/docs/api/type-aliases/GroupId.md +27 -0
- package/docs/api/type-aliases/Hex.md +20 -0
- package/docs/api/type-aliases/HookName.md +11 -0
- package/docs/api/type-aliases/PostQuantumPolicy.md +11 -0
- package/docs/api/type-aliases/PreparedAttachmentUpload.md +14 -0
- package/docs/api/type-aliases/PrivateKey.md +22 -0
- package/docs/api/type-aliases/ProgressCallback.md +45 -0
- package/docs/api/type-aliases/PublicKey.md +22 -0
- package/docs/api/type-aliases/RemoteObjectCompleteUploadRequest.md +19 -0
- package/docs/api/type-aliases/RemoteObjectDeleteRequest.md +19 -0
- package/docs/api/type-aliases/RemoteObjectDownloadRequest.md +19 -0
- package/docs/api/type-aliases/RemoteObjectUploadRequest.md +42 -0
- package/docs/api/type-aliases/SCKAMode.md +11 -0
- package/docs/api/type-aliases/SealedSenderAuth.md +15 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaCleanupInput.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaCleanupResult.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaDownloadInput.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaDownloadResult.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaOperationResult.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaUploadInput.md +9 -0
- package/docs/api/type-aliases/SignalProtocolClientMediaUploadResult.md +9 -0
- package/docs/api/type-aliases/Signature.md +21 -0
- package/docs/api/type-aliases/Unsubscribe.md +15 -0
- package/docs/api/variables/BraidPolicy.md +21 -0
- package/docs/api/variables/DEFAULT_DEVICE_ID.md +12 -0
- package/docs/api/variables/DOUBLE_RATCHET_SPEC.md +11 -0
- package/docs/api/variables/GROUP_V2_PREFIX.md +11 -0
- package/docs/api/variables/KEY_REFRESH_INTERVAL_MS_DEFAULT.md +11 -0
- package/docs/api/variables/MAX_MESSAGE_KEYS.md +14 -0
- package/docs/api/variables/MAX_PREKEY_AGE_MS_DEFAULT.md +11 -0
- package/docs/api/variables/MAX_RECEIVER_CHAINS.md +14 -0
- package/docs/api/variables/MAX_REGISTRATION_ID.md +16 -0
- package/docs/api/variables/MAX_SKIP.md +11 -0
- package/docs/api/variables/MESSAGE_FORMAT.md +11 -0
- package/docs/api/variables/MIN_REGISTRATION_ID.md +16 -0
- package/docs/api/variables/ML_KEM_BRAID_SPEC.md +11 -0
- package/docs/api/variables/ONE_TIME_PREKEY_BATCH_SIZE.md +21 -0
- package/docs/api/variables/PQXDH_SPEC.md +11 -0
- package/docs/api/variables/PostQuantumPolicy.md +21 -0
- package/docs/api/variables/SENDER_KEY_FORMAT.md +11 -0
- package/docs/api/variables/SENDER_KEY_SPEC.md +11 -0
- package/docs/api/variables/SESAME_SPEC.md +11 -0
- package/docs/api/variables/SESSION_FORMAT.md +11 -0
- package/docs/api/variables/SPQR_LIMITS_DEFAULTS.md +11 -0
- package/docs/api/variables/X3DH_SPEC.md +9 -0
- package/docs/api/variables/defaultSignalLogger.md +32 -0
- package/encoding/README.md +32 -0
- package/files/README.md +37 -0
- package/groups/README.md +42 -0
- package/hooks/README.md +40 -0
- package/keys/README.md +121 -0
- package/local/store/README.md +120 -0
- package/local/store/expo/README.md +73 -0
- package/local/store/mock/README.md +27 -0
- package/local/store/node/README.md +35 -0
- package/local/store/react-native/README.md +39 -0
- package/local/store/web/README.md +65 -0
- package/local/vault/README.md +32 -0
- package/media/README.md +73 -0
- package/package.json +436 -0
- package/profile/README.md +44 -0
- package/remote/README.md +219 -0
- package/remote/object-store/README.md +45 -0
- package/remote/object-store/convex-r2/README.md +85 -0
- package/remote/object-store/s3/README.md +35 -0
- package/remote/relay/README.md +38 -0
- package/remote/relay/convex/README.md +54 -0
- package/remote/relay/mock/README.md +32 -0
- package/safety/README.md +42 -0
- package/sealed-sender/README.md +32 -0
- package/types/README.md +36 -0
- package/username/README.md +37 -0
- package/utils/README.md +37 -0
- package/zk/README.md +36 -0
|
@@ -0,0 +1,1222 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session Cipher - Signal Protocol Encrypt/Decrypt Operations
|
|
3
|
+
*
|
|
4
|
+
* @module session/cipher
|
|
5
|
+
*
|
|
6
|
+
* Implements Signal Protocol Double Ratchet encryption and decryption while
|
|
7
|
+
* keeping message processing separate from session establishment.
|
|
8
|
+
*
|
|
9
|
+
* ## Overview
|
|
10
|
+
*
|
|
11
|
+
* SessionCipher handles the core encrypt/decrypt operations for an established
|
|
12
|
+
* Signal Protocol session. It implements:
|
|
13
|
+
*
|
|
14
|
+
* - **RatchetEncrypt** (Section 3.4): Encrypt messages with Double Ratchet
|
|
15
|
+
* - **RatchetDecrypt** (Section 3.5): Decrypt messages with Double Ratchet
|
|
16
|
+
* - **Plaintext Headers + MAC** (Section 3): Identity-bound MAC authentication
|
|
17
|
+
* - **Out-of-Order Handling**: Store/retrieve skipped message keys (receiverChains)
|
|
18
|
+
* - **Triple Ratchet Integration**: Combined EC + PQ key derivation when SPQR enabled
|
|
19
|
+
*
|
|
20
|
+
* ## Message Flow
|
|
21
|
+
*
|
|
22
|
+
* ### Encryption (RatchetEncrypt)
|
|
23
|
+
* ```
|
|
24
|
+
* 1. Derive message key from sending chain (CKs)
|
|
25
|
+
* 2. Expand key to 80 bytes: 32 enc + 32 auth + 16 IV
|
|
26
|
+
* 3. Encrypt plaintext with AES-CBC
|
|
27
|
+
* 4. Compute identity-bound MAC: HMAC(auth_key, version || sender_id || receiver_id || header || ciphertext)
|
|
28
|
+
* 5. Advance sending chain: CKs, Ns++
|
|
29
|
+
* 6. First message? → Send as PreKeyMessage with X3DH info
|
|
30
|
+
* ```
|
|
31
|
+
*
|
|
32
|
+
* ### Decryption (RatchetDecrypt)
|
|
33
|
+
* ```
|
|
34
|
+
* 1. Try skipped message keys (receiverChains) first
|
|
35
|
+
* 2. Check if DH public key changed → DH ratchet needed
|
|
36
|
+
* 3. Parse plaintext header (ratchetKey, counter, previousCounter)
|
|
37
|
+
* 4. Perform DH ratchet step if needed
|
|
38
|
+
* 5. Skip/store any missed message keys
|
|
39
|
+
* 6. Derive message key from receiving chain (CKr)
|
|
40
|
+
* 7. Verify identity-bound MAC, then decrypt
|
|
41
|
+
* 8. Advance receiving chain: CKr, Nr++
|
|
42
|
+
* ```
|
|
43
|
+
*
|
|
44
|
+
* ## Security Properties
|
|
45
|
+
*
|
|
46
|
+
* - **Forward Secrecy**: Message keys are derived then deleted
|
|
47
|
+
* - **Break-in Recovery**: DH ratchet restores security after compromise
|
|
48
|
+
* - **Session Binding**: Identity keys in MAC prevent cross-session attacks
|
|
49
|
+
* - **Replay Protection**: Message numbers prevent replay attacks
|
|
50
|
+
* - **Out-of-Order Support**: receiverChains allows delayed message delivery
|
|
51
|
+
*
|
|
52
|
+
* ## Concurrency Safety
|
|
53
|
+
*
|
|
54
|
+
* All operations are protected by per-session AsyncLock to prevent race
|
|
55
|
+
* conditions when multiple encrypt/decrypt operations occur simultaneously.
|
|
56
|
+
*
|
|
57
|
+
* ## Specification References
|
|
58
|
+
*
|
|
59
|
+
* @see https://signal.org/docs/specifications/doubleratchet/#encrypting-messages - Section 3.4
|
|
60
|
+
* @see https://signal.org/docs/specifications/doubleratchet/#decrypting-messages - Section 3.5
|
|
61
|
+
* @see https://signal.org/docs/specifications/doubleratchet/#handling-missing-messages - Skipped keys
|
|
62
|
+
*
|
|
63
|
+
* @internal This module is INTERNAL. Use SignalProtocolClient for public encryption API.
|
|
64
|
+
*
|
|
65
|
+
* @example Basic usage (internal)
|
|
66
|
+
* ```typescript
|
|
67
|
+
* import { SessionCipher } from './/index.js';
|
|
68
|
+
*
|
|
69
|
+
* const cipher = new SessionCipher(storage, establishCallback, lock, { maxSkip: 1000 });
|
|
70
|
+
*
|
|
71
|
+
* // Encrypt message
|
|
72
|
+
* const ciphertext = await cipher.encrypt('session-123', 'Hello, world!');
|
|
73
|
+
*
|
|
74
|
+
* // Decrypt message
|
|
75
|
+
* const plaintext = await cipher.decrypt('session-123', ciphertext);
|
|
76
|
+
* ```
|
|
77
|
+
*/
|
|
78
|
+
import { defaultSignalLogger } from '../../logger.js';
|
|
79
|
+
import { MAX_UNACKNOWLEDGED_SESSION_AGE_MS } from '../../types/protocol-config.js';
|
|
80
|
+
import { compositeIdentitiesEqual, decodeCompositeIdentityV1, encodeCompositeIdentityV1, } from '../../keys/identity.js';
|
|
81
|
+
import { CURRENT_SESSION_RECORD_VERSION, SessionRecord as SessionRecordNS, } from '../../types/session.js';
|
|
82
|
+
import { EncryptionError, EncryptionErrorCode, MessageType, DuplicatedMessageError, UntrustedIdentityError, TrustDirection, } from '../../types/index.js';
|
|
83
|
+
import { ProtocolAddress } from '../../types/address.js';
|
|
84
|
+
import { MESSAGE_FORMAT } from '../../versions.js';
|
|
85
|
+
import * as CryptoUtils from '../crypto/index.js';
|
|
86
|
+
import { deriveSendingKey as moduleDeriveKey, deriveReceivingKey as moduleReceiveKey, storeMessageKeyInChain, DEFAULT_RATCHET_CONFIG, } from '../protocol/double-ratchet/index.js';
|
|
87
|
+
import { asBase64 } from '../../types/utils.js';
|
|
88
|
+
// Black-box SPQR API
|
|
89
|
+
// DH ratchet is purely classical; ALL PQ work happens inside spqrSend/spqrRecv
|
|
90
|
+
import { spqrSend, spqrRecv } from '../protocol/spqr/index.js';
|
|
91
|
+
import { assertValidatedSession, performDHRatchetStep, storeSkippedMessageKeys, cleanupExpiredMessageKeys, } from './ratchet.js';
|
|
92
|
+
import { trySkippedMessageKeys, decryptWithKey, performReplayRejectionWork, createProtobufMacContext, } from './decryption.js';
|
|
93
|
+
import { validateSessionKeyOwnership, validateSessionStateIntegrity, getMaxSkipForSession, } from './validation.js';
|
|
94
|
+
import { SessionResolver } from './session-resolver.js';
|
|
95
|
+
import { encodeSignalMessage, decodeSignalMessage, encodePreKeySignalMessage, decodePreKeySignalMessage, frameSignalMessage, parseSignalMessageEnvelope, framePreKeySignalMessage, parsePreKeySignalMessageEnvelope, makeVersionByte, serializeSignalMessageAddresses, } from '../encoding/proto/index.js';
|
|
96
|
+
import { computeCompositeIdentityMessageMac } from './identity-binding.js';
|
|
97
|
+
function identityTypeToWire(identityType) {
|
|
98
|
+
return identityType === 'aci' ? 1 : 2;
|
|
99
|
+
}
|
|
100
|
+
function identityTypeFromWire(value) {
|
|
101
|
+
if (value === 1)
|
|
102
|
+
return 'aci';
|
|
103
|
+
if (value === 2)
|
|
104
|
+
return 'pni';
|
|
105
|
+
throw new Error('Recipient identity type must be ACI=1 or PNI=2');
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Clone session state for a single decrypt attempt.
|
|
109
|
+
*
|
|
110
|
+
* Decryption operates on a clone and persists it only after authentication and
|
|
111
|
+
* plaintext recovery succeed.
|
|
112
|
+
*/
|
|
113
|
+
function cloneSessionStateForDecryptAttempt(session) {
|
|
114
|
+
return CryptoUtils.cloneProtocolState(session);
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* If a retried PreKeyMessage references an existing base key, decrypt with the
|
|
118
|
+
* matching session. Re-running X3DH/PQXDH could require one-time prekeys that
|
|
119
|
+
* the first attempt already consumed.
|
|
120
|
+
*/
|
|
121
|
+
function findMatchingPreKeySession(record, prekeyMessage) {
|
|
122
|
+
if (!record) {
|
|
123
|
+
return null;
|
|
124
|
+
}
|
|
125
|
+
const baseKey = prekeyMessage.senderEphemeralKey;
|
|
126
|
+
const matchingSession = SessionRecordNS.findSession(record, baseKey);
|
|
127
|
+
if (!matchingSession ||
|
|
128
|
+
!compositeIdentitiesEqual(matchingSession.remoteIdentity, prekeyMessage.senderIdentity)) {
|
|
129
|
+
return null;
|
|
130
|
+
}
|
|
131
|
+
return {
|
|
132
|
+
session: matchingSession,
|
|
133
|
+
archivedBaseKey: record.currentSession?.baseKey === baseKey ? null : baseKey,
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
export class SessionCipher {
|
|
137
|
+
/**
|
|
138
|
+
* Maximum number of message keys to skip in a single receiving chain.
|
|
139
|
+
* The 25,000-key limit bounds adversarial key derivation and storage.
|
|
140
|
+
*/
|
|
141
|
+
static DEFAULT_MAX_SKIP = 25000;
|
|
142
|
+
/** Storage adapter for session state and keys */
|
|
143
|
+
keyStorage;
|
|
144
|
+
logger;
|
|
145
|
+
/** Callback to establish new sessions from PreKeyMessages */
|
|
146
|
+
establishSession;
|
|
147
|
+
/** Per-session lock for concurrency safety */
|
|
148
|
+
lock;
|
|
149
|
+
/** Maximum message keys to skip in one chain (DoS protection) */
|
|
150
|
+
maxSkip;
|
|
151
|
+
/**
|
|
152
|
+
* Create a new SessionCipher instance
|
|
153
|
+
*
|
|
154
|
+
* @param keyStorage - Storage adapter for session state, identity keys, prekeys
|
|
155
|
+
* @param establishSession - Callback invoked when a PreKeyMessage is received
|
|
156
|
+
* and a new session needs to be established. The callback should perform
|
|
157
|
+
* X3DH key agreement and return initialized session state.
|
|
158
|
+
* @param lock - AsyncLock instance for per-session concurrency control.
|
|
159
|
+
* Sessions are locked by ID to prevent race conditions.
|
|
160
|
+
* @param config - Optional configuration
|
|
161
|
+
* @param config.maxSkip - Maximum message keys to skip (default: 1000).
|
|
162
|
+
* Higher values allow more out-of-order messages but increase memory/CPU.
|
|
163
|
+
*/
|
|
164
|
+
constructor(keyStorage, establishSession, lock, config = {}, logger = defaultSignalLogger) {
|
|
165
|
+
this.keyStorage = keyStorage;
|
|
166
|
+
this.establishSession = establishSession;
|
|
167
|
+
this.lock = lock;
|
|
168
|
+
this.maxSkip = config.maxSkip ?? SessionCipher.DEFAULT_MAX_SKIP;
|
|
169
|
+
this.logger = logger;
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* Get lock key for a specific session
|
|
173
|
+
* Each session has its own lock to prevent cross-conversation blocking
|
|
174
|
+
*/
|
|
175
|
+
getLockKey(address) {
|
|
176
|
+
return `session:${ProtocolAddress.toString(address)}`;
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* Create a SessionRecord wrapper for storage
|
|
180
|
+
*/
|
|
181
|
+
wrapSession(session) {
|
|
182
|
+
return {
|
|
183
|
+
currentSession: session,
|
|
184
|
+
archivedSessions: {},
|
|
185
|
+
version: CURRENT_SESSION_RECORD_VERSION,
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
markSessionAcknowledged(session) {
|
|
189
|
+
session.hasReceivedMessage = true;
|
|
190
|
+
session.unacknowledgedPreKeyMessage = false;
|
|
191
|
+
delete session.kyberCiphertext;
|
|
192
|
+
delete session.kemOneTimePreKeyCiphertext;
|
|
193
|
+
}
|
|
194
|
+
// ============================================================================
|
|
195
|
+
// Encryption
|
|
196
|
+
// ============================================================================
|
|
197
|
+
/**
|
|
198
|
+
* Encrypt a message using Full Double Ratchet
|
|
199
|
+
*
|
|
200
|
+
* Implements Signal Protocol Section 3.4 RatchetEncrypt.
|
|
201
|
+
* Encrypts plaintext using the sending chain key, advances the sending chain,
|
|
202
|
+
* and includes the DH ratchet public key and message counter in the header.
|
|
203
|
+
*
|
|
204
|
+
* ## Algorithm Steps
|
|
205
|
+
*
|
|
206
|
+
* 1. Load and validate session state
|
|
207
|
+
* 2. Derive message key (Triple Ratchet if SPQR enabled, else Double Ratchet)
|
|
208
|
+
* 3. Expand to 80-byte key material (32 enc + 32 auth + 16 IV)
|
|
209
|
+
* 4. Encrypt message counters with header key (AES-256-CTR)
|
|
210
|
+
* 5. Encrypt plaintext (AES-256-CBC + HMAC-SHA256)
|
|
211
|
+
* 6. Package as RatchetMessage or PreKeyMessage (first message)
|
|
212
|
+
* 7. Advance sending chain (CKs, Ns++)
|
|
213
|
+
* 8. Best-effort overwrite owned temporary key arrays
|
|
214
|
+
*
|
|
215
|
+
* ## Message Types
|
|
216
|
+
*
|
|
217
|
+
* - **PreKeyMessage**: First message from session initiator, includes X3DH info
|
|
218
|
+
* - **RatchetMessage**: All subsequent messages with Double Ratchet header
|
|
219
|
+
*
|
|
220
|
+
* ## Concurrency
|
|
221
|
+
*
|
|
222
|
+
* Protected by per-session lock to prevent race conditions when multiple
|
|
223
|
+
* messages are encrypted simultaneously for the same conversation.
|
|
224
|
+
*
|
|
225
|
+
* @param remoteAddress - Protocol address for the session (userId:deviceId)
|
|
226
|
+
* @param plaintext - Message content to encrypt (UTF-8 string)
|
|
227
|
+
* @returns JSON-serialized ciphertext (PreKeyMessage or RatchetMessage)
|
|
228
|
+
* @throws {EncryptionError} SESSION_NOT_FOUND if no session exists
|
|
229
|
+
* @throws {EncryptionError} ENCRYPTION_FAILED on any encryption error
|
|
230
|
+
*
|
|
231
|
+
* @see https://signal.org/docs/specifications/doubleratchet/#encrypting-messages
|
|
232
|
+
*/
|
|
233
|
+
async encrypt(remoteAddress, plaintext) {
|
|
234
|
+
return await this.lock.acquire(this.getLockKey(remoteAddress), async () => {
|
|
235
|
+
try {
|
|
236
|
+
const record = await this.keyStorage.getSessionRecord(remoteAddress);
|
|
237
|
+
if (record && record.version !== CURRENT_SESSION_RECORD_VERSION) {
|
|
238
|
+
await this.keyStorage.deleteSessionRecord(remoteAddress);
|
|
239
|
+
throw new EncryptionError(`Unsupported session record version ${record.version}; session was reset`, EncryptionErrorCode.SESSION_NOT_FOUND);
|
|
240
|
+
}
|
|
241
|
+
const session = record?.currentSession
|
|
242
|
+
? cloneSessionStateForDecryptAttempt(record.currentSession)
|
|
243
|
+
: null;
|
|
244
|
+
if (!session) {
|
|
245
|
+
throw new EncryptionError(`No session found for ${ProtocolAddress.toString(remoteAddress)}`, EncryptionErrorCode.SESSION_NOT_FOUND);
|
|
246
|
+
}
|
|
247
|
+
validateSessionStateIntegrity(session, this.logger);
|
|
248
|
+
// Validate session has required DH keys (narrows type for structural typing)
|
|
249
|
+
assertValidatedSession(session, 'encrypt');
|
|
250
|
+
// Reject untrusted identities before advancing the send chain.
|
|
251
|
+
const isTrusted = await this.keyStorage.isTrustedIdentity(remoteAddress, session.remoteIdentity, TrustDirection.SENDING, session.remoteIdentityType);
|
|
252
|
+
if (!isTrusted) {
|
|
253
|
+
throw new UntrustedIdentityError(remoteAddress, session.remoteIdentity);
|
|
254
|
+
}
|
|
255
|
+
// Reject expired, unacknowledged PreKey sessions.
|
|
256
|
+
// PreKey sessions that haven't received a reply within 30 days are rejected
|
|
257
|
+
if (session.hasReceivedMessage === false) {
|
|
258
|
+
const sessionAge = Date.now() - session.createdAt;
|
|
259
|
+
if (sessionAge > MAX_UNACKNOWLEDGED_SESSION_AGE_MS) {
|
|
260
|
+
throw new EncryptionError('Unacknowledged session expired (no reply received within 30 days)', EncryptionErrorCode.SESSION_NOT_FOUND, {
|
|
261
|
+
sessionAge: Math.floor(sessionAge / (24 * 60 * 60 * 1000)),
|
|
262
|
+
maxAge: 30,
|
|
263
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
264
|
+
});
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
// Validate session key ownership to detect corrupted sessions BEFORE encrypting
|
|
268
|
+
// This prevents sending messages that the recipient cannot decrypt
|
|
269
|
+
const signedPreKey = await this.keyStorage.getEcSignedPreKey();
|
|
270
|
+
if (signedPreKey) {
|
|
271
|
+
validateSessionKeyOwnership(session, signedPreKey.publicKey, this.logger);
|
|
272
|
+
}
|
|
273
|
+
// Cleanup expired message keys before encryption (Section 8.4)
|
|
274
|
+
cleanupExpiredMessageKeys(session, undefined, this.logger);
|
|
275
|
+
// Step 1: Derive message key using ratchet (Triple or Double)
|
|
276
|
+
// Session is now validated - passes directly to double-ratchet via structural typing
|
|
277
|
+
const originalNs = session.Ns;
|
|
278
|
+
let finalMessageKey;
|
|
279
|
+
let pqMessageKeySalt;
|
|
280
|
+
let pqRatchetBytes;
|
|
281
|
+
if (session.tripleRatchet?.enabled && session.tripleRatchet.spqrState) {
|
|
282
|
+
// Triple Ratchet: Combined EC + PQ key derivation (Section 6)
|
|
283
|
+
this.logger.debug('Triple Ratchet: Deriving combined EC + PQ message key', {
|
|
284
|
+
category: 'E2EE',
|
|
285
|
+
data: {
|
|
286
|
+
operation: 'triple-ratchet-encrypt',
|
|
287
|
+
counter: session.Ns,
|
|
288
|
+
spqrEpoch: session.tripleRatchet.spqrState.epoch,
|
|
289
|
+
},
|
|
290
|
+
});
|
|
291
|
+
// Step A: EC message key from Double Ratchet
|
|
292
|
+
const ecResult = await moduleDeriveKey(session, this.logger);
|
|
293
|
+
// Step B: PQ message key + opaque bytes from black-box SPQR
|
|
294
|
+
// spqrSend handles ALL PQ: lazy KEM, version capability, key derivation
|
|
295
|
+
const spqrResult = await spqrSend(session.tripleRatchet.spqrState, this.logger);
|
|
296
|
+
if (spqrResult.msgBytes.length > 0) {
|
|
297
|
+
pqRatchetBytes = spqrResult.msgBytes;
|
|
298
|
+
}
|
|
299
|
+
// Step C: Use profile key expansion:
|
|
300
|
+
// EC message key as input key material + PQ message key as optional HKDF salt.
|
|
301
|
+
if (spqrResult.messageKey) {
|
|
302
|
+
finalMessageKey = ecResult.messageKey;
|
|
303
|
+
pqMessageKeySalt = spqrResult.messageKey;
|
|
304
|
+
}
|
|
305
|
+
else {
|
|
306
|
+
finalMessageKey = ecResult.messageKey;
|
|
307
|
+
}
|
|
308
|
+
this.logger.breadcrumb('Triple Ratchet: Combined EC + PQ message keys', {
|
|
309
|
+
category: 'E2EE',
|
|
310
|
+
level: 'debug',
|
|
311
|
+
data: {
|
|
312
|
+
operation: 'triple-ratchet-encrypt',
|
|
313
|
+
ecMessageNumber: session.Ns - 1,
|
|
314
|
+
hasPqRatchet: !!pqRatchetBytes,
|
|
315
|
+
hasPqKey: !!pqMessageKeySalt,
|
|
316
|
+
},
|
|
317
|
+
});
|
|
318
|
+
}
|
|
319
|
+
else {
|
|
320
|
+
// Double Ratchet only: EC key derivation
|
|
321
|
+
this.logger.debug('Double Ratchet: Deriving EC message key', {
|
|
322
|
+
category: 'E2EE',
|
|
323
|
+
data: {
|
|
324
|
+
operation: 'encrypt',
|
|
325
|
+
counter: session.Ns,
|
|
326
|
+
hasChainKey: !!session.CKs,
|
|
327
|
+
},
|
|
328
|
+
});
|
|
329
|
+
// Pass session directly - mutations happen in place
|
|
330
|
+
const doubleResult = await moduleDeriveKey(session, this.logger);
|
|
331
|
+
finalMessageKey = doubleResult.messageKey;
|
|
332
|
+
}
|
|
333
|
+
// No applyRatchetState needed - mutations happened directly on session
|
|
334
|
+
// Step 2: Expand message key to 80 bytes (32 enc + 32 auth + 16 IV)
|
|
335
|
+
// using profile optional salt for Triple Ratchet.
|
|
336
|
+
let encryptionKey;
|
|
337
|
+
let authKey;
|
|
338
|
+
let iv;
|
|
339
|
+
let protobufFramedSignalMsg;
|
|
340
|
+
let authenticatedRecipientIdentityType;
|
|
341
|
+
try {
|
|
342
|
+
({ encryptionKey, authKey, iv } = await CryptoUtils.expandMessageKey(finalMessageKey, pqMessageKeySalt));
|
|
343
|
+
// Step 3: Prepare plaintext header components (Section 3 variant)
|
|
344
|
+
const ratchetKey = session.DHs.publicKey;
|
|
345
|
+
const previousCounter = session.PN;
|
|
346
|
+
const counter = originalNs;
|
|
347
|
+
this.logger.debug('Preparing plaintext message header', {
|
|
348
|
+
category: 'E2EE',
|
|
349
|
+
data: {
|
|
350
|
+
operation: 'encrypt',
|
|
351
|
+
counter,
|
|
352
|
+
previousCounter,
|
|
353
|
+
},
|
|
354
|
+
});
|
|
355
|
+
// Step 4: Pad and encrypt plaintext with AES-256-CBC (encrypt-only, MAC computed separately)
|
|
356
|
+
// ISO/IEC 7816-4 padding reduces plaintext-length disclosure.
|
|
357
|
+
const plaintextBytes = CryptoUtils.stringToBytes(plaintext);
|
|
358
|
+
const paddedPlaintext = CryptoUtils.padMessage(plaintextBytes);
|
|
359
|
+
const ciphertextBase64 = await CryptoUtils.aesCbcEncrypt(encryptionKey, iv, paddedPlaintext);
|
|
360
|
+
// Step 5: Compute identity-bound MAC (Section 3 variant)
|
|
361
|
+
// MAC input: MESSAGE_VERSION_BYTE || sender_identity_key || receiver_identity_key || serialized_header || ciphertext
|
|
362
|
+
// Per Signal Protocol Section 3 - "associated_data SHOULD contain sender's and receiver's identity public keys"
|
|
363
|
+
{
|
|
364
|
+
// Protobuf wire format: encode SignalMessage, compute the pinned-reference MAC shape.
|
|
365
|
+
const ratchetKeyBytes33 = CryptoUtils.ensureSerializedPublicKey(CryptoUtils.base64ToBytes(ratchetKey));
|
|
366
|
+
const ciphertextBytes = CryptoUtils.base64ToBytes(ciphertextBase64);
|
|
367
|
+
// pqRatchetBytes is already opaque bytes from spqrSend() above
|
|
368
|
+
if (session.unacknowledgedPreKeyMessage === true) {
|
|
369
|
+
if (!session.recipientIdentityType) {
|
|
370
|
+
throw new EncryptionError('Initiator session is missing its recipient identity namespace', EncryptionErrorCode.SESSION_CORRUPTED);
|
|
371
|
+
}
|
|
372
|
+
authenticatedRecipientIdentityType = identityTypeToWire(session.recipientIdentityType);
|
|
373
|
+
}
|
|
374
|
+
// Encode SignalMessage protobuf (no version byte or MAC yet)
|
|
375
|
+
const protobufBytes = encodeSignalMessage({
|
|
376
|
+
ratchetKey: ratchetKeyBytes33,
|
|
377
|
+
counter,
|
|
378
|
+
previousCounter,
|
|
379
|
+
ciphertext: ciphertextBytes,
|
|
380
|
+
pqRatchet: pqRatchetBytes,
|
|
381
|
+
addresses: serializeSignalMessageAddresses(session.localAddress, remoteAddress),
|
|
382
|
+
recipientIdentityType: authenticatedRecipientIdentityType,
|
|
383
|
+
});
|
|
384
|
+
// Build serializedForMac: version_byte + protobuf_bytes (everything except trailing MAC)
|
|
385
|
+
const serializedForMac = new Uint8Array(1 + protobufBytes.length);
|
|
386
|
+
serializedForMac[0] = makeVersionByte();
|
|
387
|
+
serializedForMac.set(protobufBytes, 1);
|
|
388
|
+
// Bind both locally-derived composite identity commitments.
|
|
389
|
+
const macBytes = computeCompositeIdentityMessageMac(authKey, session.localIdentity, session.remoteIdentity, serializedForMac);
|
|
390
|
+
// Frame: [version_byte][protobuf_bytes][MAC(8)]
|
|
391
|
+
protobufFramedSignalMsg = frameSignalMessage(protobufBytes, macBytes);
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
finally {
|
|
395
|
+
if (pqMessageKeySalt) {
|
|
396
|
+
CryptoUtils.secureZeroBytes(pqMessageKeySalt);
|
|
397
|
+
pqMessageKeySalt = undefined;
|
|
398
|
+
}
|
|
399
|
+
// Best-effort overwrite owned message-key bytes after use.
|
|
400
|
+
CryptoUtils.secureZeroBytes(finalMessageKey);
|
|
401
|
+
if (encryptionKey)
|
|
402
|
+
CryptoUtils.secureZeroBytes(encryptionKey);
|
|
403
|
+
if (authKey)
|
|
404
|
+
CryptoUtils.secureZeroBytes(authKey);
|
|
405
|
+
if (iv)
|
|
406
|
+
CryptoUtils.secureZeroBytes(iv);
|
|
407
|
+
}
|
|
408
|
+
// Step 6: Check if this should be a PreKeyMessage
|
|
409
|
+
// Uses persistent flag so that if the first PreKeyMessage is lost,
|
|
410
|
+
// subsequent messages are still sent as PreKeyMessages until acknowledged
|
|
411
|
+
const shouldSendPreKeyMessage = session.unacknowledgedPreKeyMessage === true;
|
|
412
|
+
if (shouldSendPreKeyMessage) {
|
|
413
|
+
this.logger.breadcrumb('Created PreKeyMessage for session establishment (initiator first message)', {
|
|
414
|
+
category: 'E2EE',
|
|
415
|
+
level: 'info',
|
|
416
|
+
data: {
|
|
417
|
+
messageType: 'PreKeyMessage',
|
|
418
|
+
role: 'initiator',
|
|
419
|
+
// Diagnostic: KEM one-time prekey fields for debugging IKM mismatch
|
|
420
|
+
usedKemOneTimePreKeyId: session.usedKemOneTimePreKeyId,
|
|
421
|
+
hasKemOneTimeCiphertext: !!session.kemOneTimePreKeyCiphertext,
|
|
422
|
+
kemOneTimeCiphertextLen: session.kemOneTimePreKeyCiphertext?.length,
|
|
423
|
+
},
|
|
424
|
+
});
|
|
425
|
+
}
|
|
426
|
+
else if (session.Ns === 0) {
|
|
427
|
+
this.logger.breadcrumb('Sending regular RatchetMessage (responder first send, Ns=0)', {
|
|
428
|
+
category: 'E2EE',
|
|
429
|
+
level: 'info',
|
|
430
|
+
data: { messageType: 'RatchetMessage', role: 'responder', Ns: 0 },
|
|
431
|
+
});
|
|
432
|
+
}
|
|
433
|
+
// Step 8: Update session state
|
|
434
|
+
session.lastUsedAt = Date.now();
|
|
435
|
+
// Snapshot PQXDH fields for protobuf PreKeySignalMessage encoding.
|
|
436
|
+
// Retain the complete PreKeySignalMessage material until the session is
|
|
437
|
+
// acknowledged so a lost first message can be retried.
|
|
438
|
+
const kyberCiphertextForPreKey = session.kyberCiphertext;
|
|
439
|
+
const kemOneTimeCiphertextForPreKey = session.kemOneTimePreKeyCiphertext;
|
|
440
|
+
// Note: spqrSend() already clears pending Kyber data and marks version capability sent
|
|
441
|
+
// Serialize: protobuf binary transport format
|
|
442
|
+
let encodedCiphertext;
|
|
443
|
+
if (shouldSendPreKeyMessage) {
|
|
444
|
+
// Wrap inner framed SignalMessage in PreKeySignalMessage protobuf
|
|
445
|
+
const identityKeyForPreKey = await this.keyStorage.getIdentityKey();
|
|
446
|
+
if (!identityKeyForPreKey) {
|
|
447
|
+
throw new EncryptionError('Identity key not found for PreKeySignalMessage encoding', EncryptionErrorCode.INITIALIZATION_FAILED);
|
|
448
|
+
}
|
|
449
|
+
const preKeyProtobuf = encodePreKeySignalMessage({
|
|
450
|
+
ecOneTimePreKeyId: session.usedOneTimePreKeyId,
|
|
451
|
+
baseKey: CryptoUtils.ensureSerializedPublicKey(CryptoUtils.base64ToBytes(session.DHs.publicKey)),
|
|
452
|
+
identityKey: encodeCompositeIdentityV1(session.localIdentity),
|
|
453
|
+
message: protobufFramedSignalMsg, // field 4 = complete framed inner SignalMessage
|
|
454
|
+
registrationId: session.localRegistrationId,
|
|
455
|
+
ecSignedPreKeyId: session.usedSignedPreKeyId,
|
|
456
|
+
recipientIdentityType: authenticatedRecipientIdentityType,
|
|
457
|
+
kemLastResortPreKeyId: session.usedKyberPreKeyId,
|
|
458
|
+
kemLastResortCiphertext: kyberCiphertextForPreKey
|
|
459
|
+
? CryptoUtils.base64ToBytes(kyberCiphertextForPreKey)
|
|
460
|
+
: undefined,
|
|
461
|
+
kemOneTimePreKeyId: session.usedKemOneTimePreKeyId,
|
|
462
|
+
kemOneTimeCiphertext: kemOneTimeCiphertextForPreKey
|
|
463
|
+
? CryptoUtils.base64ToBytes(kemOneTimeCiphertextForPreKey)
|
|
464
|
+
: undefined,
|
|
465
|
+
});
|
|
466
|
+
encodedCiphertext = CryptoUtils.bytesToBase64(framePreKeySignalMessage(preKeyProtobuf));
|
|
467
|
+
}
|
|
468
|
+
else {
|
|
469
|
+
encodedCiphertext = CryptoUtils.bytesToBase64(protobufFramedSignalMsg);
|
|
470
|
+
}
|
|
471
|
+
// Preserve archivedSessions from existing record (same pattern as decrypt)
|
|
472
|
+
const recordToStore = record
|
|
473
|
+
? { ...record, currentSession: session }
|
|
474
|
+
: this.wrapSession(session);
|
|
475
|
+
// Commit the matched/pinned TOFU identity and advanced send state
|
|
476
|
+
// together, after the outgoing ciphertext has been fully constructed.
|
|
477
|
+
await this.keyStorage.commitSessionTrust({
|
|
478
|
+
address: remoteAddress,
|
|
479
|
+
record: recordToStore,
|
|
480
|
+
contactIdentity: session.remoteIdentity,
|
|
481
|
+
contactIdentityType: session.remoteIdentityType,
|
|
482
|
+
localIdentityType: session.localIdentityType,
|
|
483
|
+
});
|
|
484
|
+
return encodedCiphertext;
|
|
485
|
+
}
|
|
486
|
+
catch (error) {
|
|
487
|
+
// Preserve specific error codes (e.g., SESSION_CORRUPTED from validation)
|
|
488
|
+
if (error instanceof EncryptionError) {
|
|
489
|
+
throw error;
|
|
490
|
+
}
|
|
491
|
+
throw new EncryptionError('Failed to encrypt message', EncryptionErrorCode.ENCRYPTION_FAILED, { originalError: error });
|
|
492
|
+
}
|
|
493
|
+
});
|
|
494
|
+
}
|
|
495
|
+
// ============================================================================
|
|
496
|
+
// Decryption
|
|
497
|
+
// ============================================================================
|
|
498
|
+
/**
|
|
499
|
+
* Decrypt a message using Full Double Ratchet
|
|
500
|
+
*
|
|
501
|
+
* Implements Signal Protocol Section 3.5 RatchetDecrypt.
|
|
502
|
+
* Handles out-of-order messages, DH ratchet steps, and header encryption.
|
|
503
|
+
*
|
|
504
|
+
* ## Algorithm Steps
|
|
505
|
+
*
|
|
506
|
+
* 1. Parse message (validate required fields)
|
|
507
|
+
* 2. Try skipped message keys first (receiverChains for out-of-order)
|
|
508
|
+
* 3. Check if DH public key changed → DH ratchet needed
|
|
509
|
+
* 4. Decrypt message header to get counters
|
|
510
|
+
* 5. Perform DH ratchet step if needed (with PQ if SPQR enabled)
|
|
511
|
+
* 6. Store any skipped message keys
|
|
512
|
+
* 7. Derive message key (Triple or Double Ratchet)
|
|
513
|
+
* 8. Decrypt and verify MAC
|
|
514
|
+
* 9. Advance receiving chain (CKr, Nr++)
|
|
515
|
+
* 10. Update next receiving header key (NHKr)
|
|
516
|
+
* 11. Best-effort overwrite owned temporary key arrays
|
|
517
|
+
*
|
|
518
|
+
* ## Session Establishment
|
|
519
|
+
*
|
|
520
|
+
* If the session doesn't exist and the message is a PreKeyMessage, this method
|
|
521
|
+
* will establish the session as the responder by calling the establishSession
|
|
522
|
+
* callback to perform X3DH key agreement.
|
|
523
|
+
*
|
|
524
|
+
* ## Out-of-Order Handling
|
|
525
|
+
*
|
|
526
|
+
* Messages can arrive out of order due to network conditions. The algorithm
|
|
527
|
+
* handles this by:
|
|
528
|
+
* - Trying all stored skipped keys (receiverChains) first
|
|
529
|
+
* - Storing keys for skipped messages when receiving a message with higher number
|
|
530
|
+
* - Cleaning up expired skipped keys (Section 8.4)
|
|
531
|
+
*
|
|
532
|
+
* ## Concurrency
|
|
533
|
+
*
|
|
534
|
+
* Protected by per-session lock to prevent race conditions when multiple
|
|
535
|
+
* messages are decrypted simultaneously for the same conversation.
|
|
536
|
+
*
|
|
537
|
+
* @param remoteAddress - Protocol address for the session (userId:deviceId)
|
|
538
|
+
* @param ciphertext - JSON-serialized PreKeyMessage or RatchetMessage
|
|
539
|
+
* @returns Decrypted plaintext (UTF-8 string)
|
|
540
|
+
* @throws {EncryptionError} SESSION_NOT_FOUND if no session and not PreKeyMessage
|
|
541
|
+
* @throws {EncryptionError} INVALID_CIPHERTEXT if message format is invalid
|
|
542
|
+
* @throws {EncryptionError} DECRYPTION_FAILED on MAC failure or other error
|
|
543
|
+
*
|
|
544
|
+
* @see https://signal.org/docs/specifications/doubleratchet/#decrypting-messages
|
|
545
|
+
*/
|
|
546
|
+
async decrypt(remoteAddress, ciphertext) {
|
|
547
|
+
return await this.lock.acquire(this.getLockKey(remoteAddress), async () => {
|
|
548
|
+
try {
|
|
549
|
+
// Parse message FIRST (before loading session)
|
|
550
|
+
// Detect format and parse: protobuf binary (base64) or JSON
|
|
551
|
+
let message;
|
|
552
|
+
let protobufMacContext;
|
|
553
|
+
let receivedPqRatchetBytes;
|
|
554
|
+
{
|
|
555
|
+
// Binary protobuf format (base64-encoded)
|
|
556
|
+
const framedBytes = CryptoUtils.base64ToBytes(ciphertext);
|
|
557
|
+
// Detect message type from first protobuf tag (after version byte)
|
|
558
|
+
// SignalMessage field 1 (bytes) -> tag 0x0A
|
|
559
|
+
// PreKeySignalMessage field 1 (uint32) -> tag 0x08, or field 2 (bytes) -> tag 0x12
|
|
560
|
+
const firstProtoTag = framedBytes[1];
|
|
561
|
+
const isBinaryPreKey = firstProtoTag === 0x08 || firstProtoTag === 0x12;
|
|
562
|
+
if (isBinaryPreKey) {
|
|
563
|
+
// PreKeySignalMessage: [version_byte][protobuf] (no MAC)
|
|
564
|
+
const { protobufBytes: outerProtobuf } = parsePreKeySignalMessageEnvelope(framedBytes);
|
|
565
|
+
const preKeyFields = decodePreKeySignalMessage(outerProtobuf);
|
|
566
|
+
// Inner framed SignalMessage from field 4
|
|
567
|
+
const innerFramed = preKeyFields.message;
|
|
568
|
+
const { protobufBytes: innerProtobuf, mac: innerMac } = parseSignalMessageEnvelope(innerFramed);
|
|
569
|
+
const signalFields = decodeSignalMessage(innerProtobuf);
|
|
570
|
+
// The outer field selects the local key namespace before MAC
|
|
571
|
+
// verification. Requiring an identical value inside the MACed
|
|
572
|
+
// SignalMessage prevents an attacker from switching that choice.
|
|
573
|
+
if (signalFields.recipientIdentityType !== preKeyFields.recipientIdentityType) {
|
|
574
|
+
throw new EncryptionError('PreKeySignalMessage recipient identity namespace is not MAC-bound', EncryptionErrorCode.INVALID_CIPHERTEXT);
|
|
575
|
+
}
|
|
576
|
+
const recipientIdentityType = identityTypeFromWire(preKeyFields.recipientIdentityType);
|
|
577
|
+
protobufMacContext = createProtobufMacContext(innerFramed, innerMac, signalFields.addresses);
|
|
578
|
+
// Keep raw pqRatchet bytes (opaque — decoded by spqrRecv later)
|
|
579
|
+
const pqRatchetRaw = signalFields.pqRatchet;
|
|
580
|
+
// Convert protobuf fields back to PreKeyMessage JS object
|
|
581
|
+
// ratchetKey: strip 0x05 prefix (33->32 bytes), convert to base64
|
|
582
|
+
// The ratchet key is a public header field, so its length check does
|
|
583
|
+
// not depend on secret data.
|
|
584
|
+
const ratchetKeyRaw = signalFields.ratchetKey.length === 33
|
|
585
|
+
? CryptoUtils.deserializePublicKey(signalFields.ratchetKey)
|
|
586
|
+
: signalFields.ratchetKey;
|
|
587
|
+
const baseKeyRaw = preKeyFields.baseKey.length === 33
|
|
588
|
+
? CryptoUtils.deserializePublicKey(preKeyFields.baseKey)
|
|
589
|
+
: preKeyFields.baseKey;
|
|
590
|
+
const senderIdentity = decodeCompositeIdentityV1(preKeyFields.identityKey);
|
|
591
|
+
message = {
|
|
592
|
+
type: MessageType.PREKEY,
|
|
593
|
+
messageVersion: MESSAGE_FORMAT,
|
|
594
|
+
ratchetKey: CryptoUtils.bytesToBase64(ratchetKeyRaw),
|
|
595
|
+
counter: signalFields.counter,
|
|
596
|
+
previousCounter: signalFields.previousCounter,
|
|
597
|
+
ciphertext: CryptoUtils.bytesToBase64(signalFields.ciphertext),
|
|
598
|
+
mac: CryptoUtils.bytesToBase64(innerMac), // Store envelope MAC for reference
|
|
599
|
+
senderId: remoteAddress.userId,
|
|
600
|
+
senderDeviceId: remoteAddress.deviceId,
|
|
601
|
+
senderIdentity,
|
|
602
|
+
senderEphemeralKey: CryptoUtils.bytesToBase64(baseKeyRaw),
|
|
603
|
+
senderRegistrationId: preKeyFields.registrationId,
|
|
604
|
+
recipientIdentityType,
|
|
605
|
+
usedSignedPreKeyId: preKeyFields.ecSignedPreKeyId,
|
|
606
|
+
usedOneTimePreKeyId: preKeyFields.ecOneTimePreKeyId,
|
|
607
|
+
usedKyberPreKeyId: preKeyFields.kemLastResortPreKeyId,
|
|
608
|
+
kyberCiphertext: preKeyFields.kemLastResortCiphertext?.length
|
|
609
|
+
? CryptoUtils.bytesToBase64(preKeyFields.kemLastResortCiphertext)
|
|
610
|
+
: undefined,
|
|
611
|
+
usedKemOneTimePreKeyId: preKeyFields.kemOneTimePreKeyId,
|
|
612
|
+
kemOneTimePreKeyCiphertext: preKeyFields.kemOneTimeCiphertext?.length
|
|
613
|
+
? CryptoUtils.bytesToBase64(preKeyFields.kemOneTimeCiphertext)
|
|
614
|
+
: undefined,
|
|
615
|
+
};
|
|
616
|
+
// Store raw pqRatchet bytes for opaque processing by spqrRecv
|
|
617
|
+
receivedPqRatchetBytes = pqRatchetRaw;
|
|
618
|
+
}
|
|
619
|
+
else {
|
|
620
|
+
// SignalMessage: [version_byte][protobuf][MAC(8)]
|
|
621
|
+
const { protobufBytes, mac: envelopeMac } = parseSignalMessageEnvelope(framedBytes);
|
|
622
|
+
const signalFields = decodeSignalMessage(protobufBytes);
|
|
623
|
+
protobufMacContext = createProtobufMacContext(framedBytes, envelopeMac, signalFields.addresses);
|
|
624
|
+
// Keep raw pqRatchet bytes (opaque — decoded by spqrRecv later)
|
|
625
|
+
const pqRatchetRaw = signalFields.pqRatchet;
|
|
626
|
+
const ratchetKeyRaw = signalFields.ratchetKey.length === 33
|
|
627
|
+
? CryptoUtils.deserializePublicKey(signalFields.ratchetKey)
|
|
628
|
+
: signalFields.ratchetKey;
|
|
629
|
+
message = {
|
|
630
|
+
type: MessageType.RATCHET,
|
|
631
|
+
messageVersion: MESSAGE_FORMAT,
|
|
632
|
+
ratchetKey: CryptoUtils.bytesToBase64(ratchetKeyRaw),
|
|
633
|
+
counter: signalFields.counter,
|
|
634
|
+
previousCounter: signalFields.previousCounter,
|
|
635
|
+
ciphertext: CryptoUtils.bytesToBase64(signalFields.ciphertext),
|
|
636
|
+
mac: CryptoUtils.bytesToBase64(envelopeMac),
|
|
637
|
+
};
|
|
638
|
+
// Store raw pqRatchet bytes for opaque processing by spqrRecv
|
|
639
|
+
receivedPqRatchetBytes = pqRatchetRaw;
|
|
640
|
+
}
|
|
641
|
+
}
|
|
642
|
+
const ratchetKeyFromMessage = message.ratchetKey;
|
|
643
|
+
const previousCounterFromMessage = message.previousCounter;
|
|
644
|
+
const counterFromMessage = message.counter;
|
|
645
|
+
// Check if this is a PreKeyMessage (first message from initiator)
|
|
646
|
+
const isPreKeyMessage = message.type === MessageType.PREKEY;
|
|
647
|
+
// A PreKeyMessage can legitimately arrive before a session exists.
|
|
648
|
+
let existingRecord = await this.keyStorage.getSessionRecord(remoteAddress);
|
|
649
|
+
if (existingRecord && existingRecord.version !== CURRENT_SESSION_RECORD_VERSION) {
|
|
650
|
+
await this.keyStorage.deleteSessionRecord(remoteAddress);
|
|
651
|
+
existingRecord = null;
|
|
652
|
+
}
|
|
653
|
+
let session = existingRecord?.currentSession
|
|
654
|
+
? cloneSessionStateForDecryptAttempt(existingRecord.currentSession)
|
|
655
|
+
: null;
|
|
656
|
+
// SESAME §3.2 & §3.4: For RatchetMessages, get ALL session candidates (current + archived)
|
|
657
|
+
// This supports decryption of delayed messages using archived sessions.
|
|
658
|
+
// PreKeyMessages either use an existing matching base-key session or establish a new one.
|
|
659
|
+
const sessionCandidates = !isPreKeyMessage && existingRecord
|
|
660
|
+
? SessionResolver.findDecryptingSessions(existingRecord)
|
|
661
|
+
: [];
|
|
662
|
+
// Track which candidate index to try next on failure.
|
|
663
|
+
// If we already have a current session, we've effectively "used" index 0 (the current session),
|
|
664
|
+
// so on failure we should start from index 1 (archived sessions).
|
|
665
|
+
let currentCandidateIndex = session ? 1 : 0;
|
|
666
|
+
let usedArchivedCandidate = null;
|
|
667
|
+
// If no current session but have archived candidates, try first archived
|
|
668
|
+
// This handles the case where currentSession is null but archived sessions exist
|
|
669
|
+
if (!isPreKeyMessage && !session && sessionCandidates.length > 0) {
|
|
670
|
+
const firstCandidate = sessionCandidates[currentCandidateIndex++];
|
|
671
|
+
session = cloneSessionStateForDecryptAttempt(firstCandidate.session);
|
|
672
|
+
if (!firstCandidate.isActive && firstCandidate.baseKey) {
|
|
673
|
+
usedArchivedCandidate = { baseKey: firstCandidate.baseKey };
|
|
674
|
+
}
|
|
675
|
+
this.logger.debug('Using archived session candidate (no current session)', {
|
|
676
|
+
category: 'E2EE',
|
|
677
|
+
data: {
|
|
678
|
+
operation: 'decrypt',
|
|
679
|
+
isActive: firstCandidate.isActive,
|
|
680
|
+
candidateIndex: currentCandidateIndex - 1,
|
|
681
|
+
totalCandidates: sessionCandidates.length,
|
|
682
|
+
},
|
|
683
|
+
});
|
|
684
|
+
}
|
|
685
|
+
// DIAGNOSTIC: Log session state on load to detect key corruption
|
|
686
|
+
if (session) {
|
|
687
|
+
this.logger.breadcrumb('decrypt: Loaded existing session', {
|
|
688
|
+
category: 'E2EE',
|
|
689
|
+
level: 'debug',
|
|
690
|
+
data: {
|
|
691
|
+
operation: 'session-load',
|
|
692
|
+
isInitiator: session.isInitiator,
|
|
693
|
+
DHsPublicKey: session.DHs?.publicKey?.substring(0, 20) ?? 'undefined',
|
|
694
|
+
DHr: session.DHr?.substring(0, 20) ?? 'undefined',
|
|
695
|
+
hasCKs: !!session.CKs,
|
|
696
|
+
hasCKr: !!session.CKr,
|
|
697
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
698
|
+
},
|
|
699
|
+
});
|
|
700
|
+
}
|
|
701
|
+
let retriedAfterArchive = false;
|
|
702
|
+
let preKeyMatchedExistingSession = false;
|
|
703
|
+
const prekeyMessage = isPreKeyMessage ? message : null;
|
|
704
|
+
let prekeyRemoteProtocolAddress = null;
|
|
705
|
+
if (prekeyMessage) {
|
|
706
|
+
if (prekeyMessage.senderDeviceId === undefined) {
|
|
707
|
+
throw new EncryptionError('PreKeyMessage missing senderDeviceId - multi-device protocol requires explicit device ID', EncryptionErrorCode.INVALID_CIPHERTEXT);
|
|
708
|
+
}
|
|
709
|
+
prekeyRemoteProtocolAddress = ProtocolAddress.create(prekeyMessage.senderId, prekeyMessage.senderDeviceId);
|
|
710
|
+
// SECURITY: Validate sender matches expected address for every PreKeyMessage.
|
|
711
|
+
// This prevents session hijacking even when a current session already exists.
|
|
712
|
+
if (!ProtocolAddress.equals(prekeyRemoteProtocolAddress, remoteAddress)) {
|
|
713
|
+
throw new EncryptionError(`Sender identity mismatch: message from ${ProtocolAddress.toString(prekeyRemoteProtocolAddress)} ` +
|
|
714
|
+
`but expected ${ProtocolAddress.toString(remoteAddress)}. ` +
|
|
715
|
+
'This may indicate a session hijacking attempt.', EncryptionErrorCode.IDENTITY_MISMATCH);
|
|
716
|
+
}
|
|
717
|
+
}
|
|
718
|
+
// CRITICAL: Check for identity key change when receiving PreKeyMessage with existing session
|
|
719
|
+
// This handles the device reset scenario where the sender has reinstalled their app
|
|
720
|
+
// and generated a new identity key, but we have an old session that can't decrypt.
|
|
721
|
+
if (session && prekeyMessage) {
|
|
722
|
+
const storedIdentity = session.remoteIdentity;
|
|
723
|
+
const incomingIdentity = prekeyMessage.senderIdentity;
|
|
724
|
+
// Compare identity keys (both are base64 PublicKey strings)
|
|
725
|
+
if (!compositeIdentitiesEqual(storedIdentity, incomingIdentity)) {
|
|
726
|
+
// Sender matches expected address - this is a legitimate identity key change (device reset)
|
|
727
|
+
this.logger.warn('Identity key changed detected - sender may have reinstalled', {
|
|
728
|
+
category: 'SECURITY',
|
|
729
|
+
data: {
|
|
730
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
731
|
+
event: 'identity_key_changed',
|
|
732
|
+
},
|
|
733
|
+
});
|
|
734
|
+
// Discard old session (it's useless now - different identity key)
|
|
735
|
+
// Set session to null to trigger new session establishment below
|
|
736
|
+
session = null;
|
|
737
|
+
this.logger.info('Old session discarded, establishing new session from PreKeyMessage', {
|
|
738
|
+
category: 'E2EE',
|
|
739
|
+
data: { remoteAddress: ProtocolAddress.toString(remoteAddress) },
|
|
740
|
+
});
|
|
741
|
+
}
|
|
742
|
+
}
|
|
743
|
+
if (prekeyMessage) {
|
|
744
|
+
const isTrustedPreKeyIdentity = await this.keyStorage.isTrustedIdentity(remoteAddress, prekeyMessage.senderIdentity, TrustDirection.RECEIVING, 'aci');
|
|
745
|
+
if (!isTrustedPreKeyIdentity) {
|
|
746
|
+
throw new UntrustedIdentityError(remoteAddress, prekeyMessage.senderIdentity);
|
|
747
|
+
}
|
|
748
|
+
const matchingPreKeySession = findMatchingPreKeySession(existingRecord, prekeyMessage);
|
|
749
|
+
if (matchingPreKeySession) {
|
|
750
|
+
session = cloneSessionStateForDecryptAttempt(matchingPreKeySession.session);
|
|
751
|
+
preKeyMatchedExistingSession = true;
|
|
752
|
+
usedArchivedCandidate = matchingPreKeySession.archivedBaseKey
|
|
753
|
+
? { baseKey: matchingPreKeySession.archivedBaseKey }
|
|
754
|
+
: null;
|
|
755
|
+
this.logger.debug('PreKeyMessage matched existing base-key session; skipping X3DH/PQXDH establishment', {
|
|
756
|
+
category: 'E2EE',
|
|
757
|
+
data: {
|
|
758
|
+
operation: 'prekey-existing-session',
|
|
759
|
+
archived: matchingPreKeySession.archivedBaseKey !== null,
|
|
760
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
761
|
+
},
|
|
762
|
+
});
|
|
763
|
+
}
|
|
764
|
+
}
|
|
765
|
+
// Track for auto-recovery: if PreKeyMessage decryption fails on an existing session,
|
|
766
|
+
// we archive the corrupted session and retry with fresh establishment.
|
|
767
|
+
const hadExistingSession = session !== null;
|
|
768
|
+
// Auto-recovery retry loop for:
|
|
769
|
+
// 1. PreKeyMessage failures on existing sessions (archive and retry once) - needs max 2 attempts
|
|
770
|
+
// 2. RatchetMessage failures (try all archived session candidates per SESAME §3.2)
|
|
771
|
+
// For RatchetMessages, we only need sessionCandidates.length attempts (or 1 if empty).
|
|
772
|
+
// For PreKeyMessages, we need at least 2 for the archive-and-retry pattern.
|
|
773
|
+
const maxAttempts = isPreKeyMessage ? 2 : Math.max(1, sessionCandidates.length);
|
|
774
|
+
for (let attempt = 0; attempt < maxAttempts; attempt++) {
|
|
775
|
+
try {
|
|
776
|
+
// On retry: archive corrupted session and reset for fresh establishment
|
|
777
|
+
if (retriedAfterArchive) {
|
|
778
|
+
if (existingRecord) {
|
|
779
|
+
// Stage recovery against a deep clone. Persisting (or mutating an
|
|
780
|
+
// adapter-owned object) here would let a message that ultimately
|
|
781
|
+
// fails authentication archive a valid durable session.
|
|
782
|
+
const candidateRecord = CryptoUtils.cloneProtocolState(existingRecord);
|
|
783
|
+
const archivedRecord = SessionRecordNS.archiveCurrentState(candidateRecord);
|
|
784
|
+
existingRecord = archivedRecord;
|
|
785
|
+
}
|
|
786
|
+
session = null;
|
|
787
|
+
retriedAfterArchive = false; // Reset flag after archiving
|
|
788
|
+
this.logger.info('Staged corrupted-session archive; retrying PreKeyMessage establishment', {
|
|
789
|
+
category: 'E2EE',
|
|
790
|
+
data: { remoteAddress: ProtocolAddress.toString(remoteAddress), attempt },
|
|
791
|
+
});
|
|
792
|
+
}
|
|
793
|
+
// If no session exists AND this is a PreKeyMessage, establish session as responder
|
|
794
|
+
if (!session && isPreKeyMessage) {
|
|
795
|
+
this.logger.breadcrumb('Received PreKeyMessage - establishing session as responder', {
|
|
796
|
+
category: 'E2EE',
|
|
797
|
+
level: 'info',
|
|
798
|
+
data: { messageType: 'PreKeyMessage', role: 'responder' },
|
|
799
|
+
});
|
|
800
|
+
if (!prekeyMessage || !prekeyRemoteProtocolAddress) {
|
|
801
|
+
throw new EncryptionError('PreKeyMessage missing establishment metadata', EncryptionErrorCode.INVALID_CIPHERTEXT);
|
|
802
|
+
}
|
|
803
|
+
this.logger.breadcrumb('Establishing session as responder', {
|
|
804
|
+
category: 'E2EE',
|
|
805
|
+
level: 'info',
|
|
806
|
+
data: {
|
|
807
|
+
remoteAddress: ProtocolAddress.toString(prekeyRemoteProtocolAddress),
|
|
808
|
+
role: 'responder',
|
|
809
|
+
},
|
|
810
|
+
});
|
|
811
|
+
// Delegate session establishment to callback (handled by manager)
|
|
812
|
+
session = await this.establishSession(prekeyRemoteProtocolAddress, prekeyMessage);
|
|
813
|
+
// Note: Session is stored at line 1053 AFTER successful decryption.
|
|
814
|
+
// This ensures partial/incomplete sessions from failed decrypts don't pollute storage.
|
|
815
|
+
this.logger.breadcrumb('Session established from PreKeyMessage - ready to decrypt', {
|
|
816
|
+
category: 'E2EE',
|
|
817
|
+
level: 'info',
|
|
818
|
+
data: { messageType: 'PreKeyMessage', role: 'responder' },
|
|
819
|
+
});
|
|
820
|
+
// DIAGNOSTIC: Log newly established session keys to detect corruption
|
|
821
|
+
this.logger.breadcrumb('decrypt: Newly established session keys', {
|
|
822
|
+
category: 'E2EE',
|
|
823
|
+
level: 'debug',
|
|
824
|
+
data: {
|
|
825
|
+
operation: 'session-established',
|
|
826
|
+
isInitiator: session.isInitiator,
|
|
827
|
+
DHsPublicKey: session.DHs?.publicKey?.substring(0, 20) ?? 'undefined',
|
|
828
|
+
DHr: session.DHr?.substring(0, 20) ?? 'undefined',
|
|
829
|
+
hasCKs: !!session.CKs,
|
|
830
|
+
hasCKr: !!session.CKr,
|
|
831
|
+
baseKey: session.baseKey?.substring(0, 20) ?? 'undefined',
|
|
832
|
+
},
|
|
833
|
+
});
|
|
834
|
+
}
|
|
835
|
+
else if (!session) {
|
|
836
|
+
throw new EncryptionError(`No session found for ${ProtocolAddress.toString(remoteAddress)}`, EncryptionErrorCode.SESSION_NOT_FOUND);
|
|
837
|
+
}
|
|
838
|
+
// Validate session state integrity FIRST (receiverChains, etc.)
|
|
839
|
+
// This catches corruption that would cause runtime errors in subsequent operations
|
|
840
|
+
// MUST run before cleanupExpiredMessageKeys which accesses receiverChains
|
|
841
|
+
validateSessionStateIntegrity(session, this.logger);
|
|
842
|
+
// Cleanup expired message keys before decryption (Section 8.4)
|
|
843
|
+
cleanupExpiredMessageKeys(session, undefined, this.logger);
|
|
844
|
+
// Validate session key ownership to detect corrupted sessions
|
|
845
|
+
// This catches the "swapped keys" bug where DHr equals our own signed prekey
|
|
846
|
+
const signedPreKey = await this.keyStorage.getEcSignedPreKey();
|
|
847
|
+
if (signedPreKey) {
|
|
848
|
+
validateSessionKeyOwnership(session, signedPreKey.publicKey, this.logger);
|
|
849
|
+
}
|
|
850
|
+
// Plaintext counters from message (Section 3 variant - no header decryption needed)
|
|
851
|
+
const counters = {
|
|
852
|
+
previousCounter: previousCounterFromMessage,
|
|
853
|
+
counter: counterFromMessage,
|
|
854
|
+
};
|
|
855
|
+
this.logger.debug('Processing message with plaintext header', {
|
|
856
|
+
category: 'E2EE',
|
|
857
|
+
data: {
|
|
858
|
+
operation: 'decrypt',
|
|
859
|
+
counter: counters.counter,
|
|
860
|
+
previousCounter: counters.previousCounter,
|
|
861
|
+
ratchetKeyPreview: ratchetKeyFromMessage?.substring(0, 20),
|
|
862
|
+
},
|
|
863
|
+
});
|
|
864
|
+
// Step 1: Try all skipped message keys first (using DHr:N key format)
|
|
865
|
+
// Pass pqRatchetBytes so skipped key path can decode SPQR epoch/messageNumber
|
|
866
|
+
// for PQ key combination (without advancing the main SPQR receive chain)
|
|
867
|
+
const skippedPlaintext = await trySkippedMessageKeys(session, ratchetKeyFromMessage, counters.counter, message, protobufMacContext, receivedPqRatchetBytes, this.logger);
|
|
868
|
+
if (skippedPlaintext !== null) {
|
|
869
|
+
const isTrustedReceivingIdentity = await this.keyStorage.isTrustedIdentity(remoteAddress, session.remoteIdentity, TrustDirection.RECEIVING, session.remoteIdentityType);
|
|
870
|
+
if (!isTrustedReceivingIdentity) {
|
|
871
|
+
throw new UntrustedIdentityError(remoteAddress, session.remoteIdentity);
|
|
872
|
+
}
|
|
873
|
+
// H3: Mark session as acknowledged and clear unacknowledged PreKey items.
|
|
874
|
+
this.markSessionAcknowledged(session);
|
|
875
|
+
// Preserve archivedSessions when storing after skipped key decryption
|
|
876
|
+
const recordToStore = existingRecord
|
|
877
|
+
? { ...existingRecord, currentSession: session }
|
|
878
|
+
: this.wrapSession(session);
|
|
879
|
+
const pendingDeletion = session.pendingPreKeyDeletion;
|
|
880
|
+
if (isPreKeyMessage) {
|
|
881
|
+
delete session.pendingPreKeyDeletion;
|
|
882
|
+
await this.keyStorage.commitSessionTrust({
|
|
883
|
+
address: remoteAddress,
|
|
884
|
+
record: recordToStore,
|
|
885
|
+
contactIdentity: session.remoteIdentity,
|
|
886
|
+
contactIdentityType: session.remoteIdentityType,
|
|
887
|
+
localIdentityType: pendingDeletion?.identityType ?? session.localIdentityType,
|
|
888
|
+
oneTimePreKeyId: pendingDeletion?.oneTimePreKeyId,
|
|
889
|
+
kemOneTimePreKeyId: pendingDeletion?.kemOneTimePreKeyId,
|
|
890
|
+
});
|
|
891
|
+
}
|
|
892
|
+
else {
|
|
893
|
+
await this.keyStorage.commitSessionTrust({
|
|
894
|
+
address: remoteAddress,
|
|
895
|
+
record: recordToStore,
|
|
896
|
+
contactIdentity: session.remoteIdentity,
|
|
897
|
+
contactIdentityType: session.remoteIdentityType,
|
|
898
|
+
localIdentityType: session.localIdentityType,
|
|
899
|
+
});
|
|
900
|
+
}
|
|
901
|
+
return skippedPlaintext;
|
|
902
|
+
}
|
|
903
|
+
// Step 2: Check if DH ratchet is needed
|
|
904
|
+
// Per Signal Protocol Section 3.3 - DH ratchet is triggered when:
|
|
905
|
+
// - DHr is undefined (lazy initialization - responder's first message)
|
|
906
|
+
// - DHr differs from message's ratchet key (sender ratcheted)
|
|
907
|
+
// String equality is fine here — DHr is transmitted in plaintext message
|
|
908
|
+
// headers and is not secret.
|
|
909
|
+
//
|
|
910
|
+
const isLazyInit = session.DHr === undefined;
|
|
911
|
+
const dhChanged = !isLazyInit && ratchetKeyFromMessage !== session.DHr;
|
|
912
|
+
// SECURITY: Check if this is a replay from an old chain
|
|
913
|
+
// If ratchetKey is in processedChains but NOT in receiverChains, it's a replay attack
|
|
914
|
+
// (The message was already processed or all keys from that chain were consumed)
|
|
915
|
+
if (dhChanged) {
|
|
916
|
+
// Initialize processedChains if not present
|
|
917
|
+
if (!session.processedChains) {
|
|
918
|
+
session.processedChains = {};
|
|
919
|
+
}
|
|
920
|
+
// Check if this ratchet key was from a previous chain that we've already processed
|
|
921
|
+
const previousChainInfo = session.processedChains[ratchetKeyFromMessage];
|
|
922
|
+
if (previousChainInfo) {
|
|
923
|
+
// This is an old chain - if not in receiverChains, it's a replay
|
|
924
|
+
// (trySkippedMessageKeys already checked receiverChains and returned null)
|
|
925
|
+
this.logger.warn('Replay attack detected: message from processed chain', {
|
|
926
|
+
category: 'E2EE',
|
|
927
|
+
data: {
|
|
928
|
+
operation: 'replay-detected-old-chain',
|
|
929
|
+
counter: counters.counter,
|
|
930
|
+
ratchetKeyPreview: ratchetKeyFromMessage?.substring(0, 20),
|
|
931
|
+
lastNrOnChain: previousChainInfo.lastNr,
|
|
932
|
+
},
|
|
933
|
+
});
|
|
934
|
+
// Reduce gross replay-vs-decrypt path differences without a
|
|
935
|
+
// JavaScript constant-time or timing-equivalence claim.
|
|
936
|
+
await performReplayRejectionWork();
|
|
937
|
+
throw new EncryptionError(`Message replay detected: ratchet key from processed chain (message ${counters.counter} on chain processed up to Nr=${previousChainInfo.lastNr})`, EncryptionErrorCode.MESSAGE_DUPLICATE, { counter: counters.counter });
|
|
938
|
+
}
|
|
939
|
+
}
|
|
940
|
+
const needsDHRatchet = isLazyInit || dhChanged;
|
|
941
|
+
if (needsDHRatchet) {
|
|
942
|
+
this.logger.debug('DH ratchet needed', {
|
|
943
|
+
category: 'E2EE',
|
|
944
|
+
data: {
|
|
945
|
+
operation: 'decrypt',
|
|
946
|
+
isLazyInit,
|
|
947
|
+
dhChanged,
|
|
948
|
+
ratchetKeyPreview: ratchetKeyFromMessage?.substring(0, 20),
|
|
949
|
+
sessionDHrPreview: session.DHr?.substring(0, 20),
|
|
950
|
+
},
|
|
951
|
+
});
|
|
952
|
+
// Step 3: Skip keys from old receiving chain before DH ratchet
|
|
953
|
+
// (only if not lazy init - Bob's first message has no old chain)
|
|
954
|
+
if (!isLazyInit && counters.previousCounter > 0 && session.CKr && session.DHr) {
|
|
955
|
+
const oldDHr = session.DHr;
|
|
956
|
+
const oldNr = session.Nr;
|
|
957
|
+
let currentChainKey = CryptoUtils.base64ToBytes(session.CKr);
|
|
958
|
+
this.logger.debug('Skipping keys from old receiving chain before DH ratchet', {
|
|
959
|
+
category: 'E2EE',
|
|
960
|
+
data: {
|
|
961
|
+
operation: 'decrypt',
|
|
962
|
+
previousCounter: counters.previousCounter,
|
|
963
|
+
oldNr,
|
|
964
|
+
},
|
|
965
|
+
});
|
|
966
|
+
// Initialize receiverChains if not present
|
|
967
|
+
if (!session.receiverChains) {
|
|
968
|
+
session.receiverChains = [];
|
|
969
|
+
}
|
|
970
|
+
for (let i = oldNr; i < counters.previousCounter; i++) {
|
|
971
|
+
const { chainKey: newChainKey, messageKey } = CryptoUtils.kdfChainKey(currentChainKey);
|
|
972
|
+
// Store skipped key in receiverChains structure (v3 protobuf-compatible)
|
|
973
|
+
storeMessageKeyInChain(session, asBase64(oldDHr), i, messageKey, undefined, this.logger);
|
|
974
|
+
CryptoUtils.secureZeroBytes(messageKey);
|
|
975
|
+
CryptoUtils.secureZeroBytes(currentChainKey);
|
|
976
|
+
currentChainKey = newChainKey;
|
|
977
|
+
}
|
|
978
|
+
CryptoUtils.secureZeroBytes(currentChainKey);
|
|
979
|
+
// Store this chain as processed for replay detection
|
|
980
|
+
// Initialize processedChains if not present
|
|
981
|
+
if (!session.processedChains) {
|
|
982
|
+
session.processedChains = {};
|
|
983
|
+
}
|
|
984
|
+
session.processedChains[oldDHr] = {
|
|
985
|
+
lastNr: counters.previousCounter,
|
|
986
|
+
timestamp: Date.now(),
|
|
987
|
+
};
|
|
988
|
+
this.logger.debug('Stored processed chain for replay detection', {
|
|
989
|
+
category: 'E2EE',
|
|
990
|
+
data: {
|
|
991
|
+
operation: 'store-processed-chain',
|
|
992
|
+
oldDHrPreview: oldDHr.substring(0, 20),
|
|
993
|
+
lastNr: counters.previousCounter,
|
|
994
|
+
},
|
|
995
|
+
});
|
|
996
|
+
}
|
|
997
|
+
// Step 4: perform the classical DH ratchet without touching SPQR.
|
|
998
|
+
await performDHRatchetStep(session, ratchetKeyFromMessage, this.logger);
|
|
999
|
+
this.logger.debug('DH ratchet completed', {
|
|
1000
|
+
category: 'E2EE',
|
|
1001
|
+
data: { operation: 'decrypt', newDHr: ratchetKeyFromMessage?.substring(0, 20) },
|
|
1002
|
+
});
|
|
1003
|
+
}
|
|
1004
|
+
// Self-sessions use the larger Note-to-Self skip limit.
|
|
1005
|
+
const maxSkippedMessages = getMaxSkipForSession(session, this.maxSkip);
|
|
1006
|
+
await storeSkippedMessageKeys(session, counters.counter, {
|
|
1007
|
+
...DEFAULT_RATCHET_CONFIG,
|
|
1008
|
+
maxSkippedMessages,
|
|
1009
|
+
}, this.logger);
|
|
1010
|
+
// Process SPQR after the DH ratchet. The SPQR boundary owns:
|
|
1011
|
+
// version negotiation, kyber key storage, decapsulation, epoch advancement, key derivation
|
|
1012
|
+
let spqrRecvResult;
|
|
1013
|
+
if (session.tripleRatchet?.enabled && session.tripleRatchet.spqrState) {
|
|
1014
|
+
spqrRecvResult = await spqrRecv(session.tripleRatchet.spqrState, receivedPqRatchetBytes, this.logger);
|
|
1015
|
+
}
|
|
1016
|
+
// Step 7: Derive message key using ratchet (Triple or Double)
|
|
1017
|
+
// Session was validated earlier (via storeSkippedMessageKeys) - pass directly
|
|
1018
|
+
let finalMessageKey;
|
|
1019
|
+
let pqMessageKeySalt;
|
|
1020
|
+
if (spqrRecvResult?.messageKey) {
|
|
1021
|
+
// Triple Ratchet: profile message key derivation (Section 6)
|
|
1022
|
+
this.logger.debug('Triple Ratchet: Deriving combined EC + PQ message key', {
|
|
1023
|
+
category: 'E2EE',
|
|
1024
|
+
data: {
|
|
1025
|
+
operation: 'triple-ratchet-decrypt',
|
|
1026
|
+
counter: counters.counter,
|
|
1027
|
+
},
|
|
1028
|
+
});
|
|
1029
|
+
// Step A: EC message key from Double Ratchet
|
|
1030
|
+
const ecResult = await moduleReceiveKey(session, this.logger);
|
|
1031
|
+
// Step B: Expand with EC input key + PQ optional salt
|
|
1032
|
+
finalMessageKey = ecResult.messageKey;
|
|
1033
|
+
pqMessageKeySalt = spqrRecvResult.messageKey;
|
|
1034
|
+
this.logger.breadcrumb('Triple Ratchet: Combined EC + PQ message keys', {
|
|
1035
|
+
category: 'E2EE',
|
|
1036
|
+
level: 'debug',
|
|
1037
|
+
data: {
|
|
1038
|
+
operation: 'triple-ratchet-decrypt',
|
|
1039
|
+
ecMessageNumber: session.Nr - 1,
|
|
1040
|
+
},
|
|
1041
|
+
});
|
|
1042
|
+
}
|
|
1043
|
+
else {
|
|
1044
|
+
this.logger.debug('Double Ratchet: Deriving EC message key', {
|
|
1045
|
+
category: 'E2EE',
|
|
1046
|
+
data: { operation: 'decrypt', counter: counters.counter },
|
|
1047
|
+
});
|
|
1048
|
+
// Pass session directly - mutations happen in place
|
|
1049
|
+
const doubleResult = await moduleReceiveKey(session, this.logger);
|
|
1050
|
+
finalMessageKey = doubleResult.messageKey;
|
|
1051
|
+
}
|
|
1052
|
+
// No applyRatchetState needed - mutations happened directly on session
|
|
1053
|
+
// Step 7: Decrypt message with MAC verification
|
|
1054
|
+
let plaintext;
|
|
1055
|
+
try {
|
|
1056
|
+
plaintext = await decryptWithKey(finalMessageKey, message, session, protobufMacContext, pqMessageKeySalt, this.logger);
|
|
1057
|
+
}
|
|
1058
|
+
finally {
|
|
1059
|
+
// Best-effort overwrite owned message-key bytes after use.
|
|
1060
|
+
CryptoUtils.secureZeroBytes(finalMessageKey);
|
|
1061
|
+
if (pqMessageKeySalt) {
|
|
1062
|
+
CryptoUtils.secureZeroBytes(pqMessageKeySalt);
|
|
1063
|
+
pqMessageKeySalt = undefined;
|
|
1064
|
+
}
|
|
1065
|
+
}
|
|
1066
|
+
session.lastUsedAt = Date.now();
|
|
1067
|
+
// H2: Authenticate before checking receiving trust. PreKey identity
|
|
1068
|
+
// persistence is deferred into the atomic responder commit below.
|
|
1069
|
+
const isTrustedReceivingIdentity = await this.keyStorage.isTrustedIdentity(remoteAddress, session.remoteIdentity, TrustDirection.RECEIVING, session.remoteIdentityType);
|
|
1070
|
+
if (!isTrustedReceivingIdentity) {
|
|
1071
|
+
throw new UntrustedIdentityError(remoteAddress, session.remoteIdentity);
|
|
1072
|
+
}
|
|
1073
|
+
// SESAME §3.4: Session Convergence - promote archived session to active if used
|
|
1074
|
+
// This ensures both parties converge to the same session for future messages
|
|
1075
|
+
let recordToStore;
|
|
1076
|
+
if (usedArchivedCandidate && existingRecord) {
|
|
1077
|
+
const promotedRecord = SessionResolver.promoteSession(existingRecord, usedArchivedCandidate.baseKey);
|
|
1078
|
+
if (promotedRecord) {
|
|
1079
|
+
// Update the promoted session with latest state
|
|
1080
|
+
promotedRecord.currentSession = session;
|
|
1081
|
+
recordToStore = promotedRecord;
|
|
1082
|
+
this.logger.info('SESAME: Promoted archived session after successful decrypt (convergence)', {
|
|
1083
|
+
category: 'E2EE',
|
|
1084
|
+
data: {
|
|
1085
|
+
operation: 'session-convergence',
|
|
1086
|
+
baseKey: usedArchivedCandidate.baseKey.substring(0, 20) + '...',
|
|
1087
|
+
},
|
|
1088
|
+
});
|
|
1089
|
+
}
|
|
1090
|
+
else {
|
|
1091
|
+
// Fallback if promotion fails (shouldn't happen)
|
|
1092
|
+
recordToStore = { ...existingRecord, currentSession: session };
|
|
1093
|
+
this.logger.warn('SESAME: Failed to promote archived session, using as-is', {
|
|
1094
|
+
category: 'E2EE',
|
|
1095
|
+
data: { baseKey: usedArchivedCandidate.baseKey.substring(0, 20) + '...' },
|
|
1096
|
+
});
|
|
1097
|
+
}
|
|
1098
|
+
}
|
|
1099
|
+
else {
|
|
1100
|
+
// Use existingRecord if available to preserve archivedSessions (from auto-recovery)
|
|
1101
|
+
// Otherwise create fresh wrapper for new sessions
|
|
1102
|
+
recordToStore = existingRecord
|
|
1103
|
+
? { ...existingRecord, currentSession: session }
|
|
1104
|
+
: this.wrapSession(session);
|
|
1105
|
+
}
|
|
1106
|
+
// H3: Mark session as acknowledged and clear unacknowledged PreKey items.
|
|
1107
|
+
// This prevents unacknowledged session timeout from blocking future sends.
|
|
1108
|
+
this.markSessionAcknowledged(session);
|
|
1109
|
+
const pendingDeletion = session.pendingPreKeyDeletion;
|
|
1110
|
+
if (isPreKeyMessage) {
|
|
1111
|
+
delete session.pendingPreKeyDeletion;
|
|
1112
|
+
await this.keyStorage.commitSessionTrust({
|
|
1113
|
+
address: remoteAddress,
|
|
1114
|
+
record: recordToStore,
|
|
1115
|
+
contactIdentity: session.remoteIdentity,
|
|
1116
|
+
contactIdentityType: session.remoteIdentityType,
|
|
1117
|
+
localIdentityType: pendingDeletion?.identityType ?? session.localIdentityType,
|
|
1118
|
+
oneTimePreKeyId: pendingDeletion?.oneTimePreKeyId,
|
|
1119
|
+
kemOneTimePreKeyId: pendingDeletion?.kemOneTimePreKeyId,
|
|
1120
|
+
});
|
|
1121
|
+
}
|
|
1122
|
+
else {
|
|
1123
|
+
await this.keyStorage.commitSessionTrust({
|
|
1124
|
+
address: remoteAddress,
|
|
1125
|
+
record: recordToStore,
|
|
1126
|
+
contactIdentity: session.remoteIdentity,
|
|
1127
|
+
contactIdentityType: session.remoteIdentityType,
|
|
1128
|
+
localIdentityType: session.localIdentityType,
|
|
1129
|
+
});
|
|
1130
|
+
}
|
|
1131
|
+
this.logger.debug('Session saved after message decryption', {
|
|
1132
|
+
category: 'E2EE',
|
|
1133
|
+
data: { operation: 'decrypt', Nr: session.Nr },
|
|
1134
|
+
});
|
|
1135
|
+
return plaintext;
|
|
1136
|
+
}
|
|
1137
|
+
catch (innerError) {
|
|
1138
|
+
// SECURITY: Never auto-recover from replay attacks (MESSAGE_DUPLICATE)
|
|
1139
|
+
// Replaying a PreKeyMessage could allow an attacker to bypass fingerprint checks
|
|
1140
|
+
// PREKEY_NOT_FOUND: Sender has stale bundle (e.g., Kyber prekey ID mismatch) - recovery via SESAME retry
|
|
1141
|
+
if (innerError instanceof EncryptionError &&
|
|
1142
|
+
(innerError.code === EncryptionErrorCode.MESSAGE_DUPLICATE ||
|
|
1143
|
+
innerError.code === EncryptionErrorCode.PREKEY_NOT_FOUND)) {
|
|
1144
|
+
throw innerError;
|
|
1145
|
+
}
|
|
1146
|
+
// Auto-recovery: if PreKeyMessage fails on existing session, archive and retry once
|
|
1147
|
+
// This handles legitimate cases like key rotation or device reset, NOT replays
|
|
1148
|
+
if (isPreKeyMessage &&
|
|
1149
|
+
hadExistingSession &&
|
|
1150
|
+
!preKeyMatchedExistingSession &&
|
|
1151
|
+
!retriedAfterArchive) {
|
|
1152
|
+
retriedAfterArchive = true;
|
|
1153
|
+
this.logger.warn('PreKeyMessage decryption failed on existing session - will archive and retry', {
|
|
1154
|
+
category: 'E2EE',
|
|
1155
|
+
data: {
|
|
1156
|
+
error: innerError instanceof Error ? innerError.message : String(innerError),
|
|
1157
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
1158
|
+
},
|
|
1159
|
+
});
|
|
1160
|
+
continue; // Try again with archived session
|
|
1161
|
+
}
|
|
1162
|
+
// SESAME §3.2: For RatchetMessages, try next archived session candidate
|
|
1163
|
+
// This supports decryption of delayed messages that were encrypted with a now-archived session
|
|
1164
|
+
if (!isPreKeyMessage && currentCandidateIndex < sessionCandidates.length) {
|
|
1165
|
+
const nextCandidate = sessionCandidates[currentCandidateIndex++];
|
|
1166
|
+
session = cloneSessionStateForDecryptAttempt(nextCandidate.session);
|
|
1167
|
+
usedArchivedCandidate =
|
|
1168
|
+
!nextCandidate.isActive && nextCandidate.baseKey
|
|
1169
|
+
? { baseKey: nextCandidate.baseKey }
|
|
1170
|
+
: null;
|
|
1171
|
+
this.logger.debug('Trying next archived session candidate after decryption failure', {
|
|
1172
|
+
category: 'E2EE',
|
|
1173
|
+
data: {
|
|
1174
|
+
operation: 'decrypt-retry',
|
|
1175
|
+
candidateIndex: currentCandidateIndex - 1,
|
|
1176
|
+
totalCandidates: sessionCandidates.length,
|
|
1177
|
+
isActive: nextCandidate.isActive,
|
|
1178
|
+
error: innerError instanceof Error ? innerError.message : String(innerError),
|
|
1179
|
+
},
|
|
1180
|
+
});
|
|
1181
|
+
// Retry decryption with the newly assigned archived session candidate
|
|
1182
|
+
// Note: existingRecord is preserved to maintain archivedSessions
|
|
1183
|
+
continue;
|
|
1184
|
+
}
|
|
1185
|
+
throw innerError; // Re-throw if not recoverable
|
|
1186
|
+
}
|
|
1187
|
+
} // End of retry loop
|
|
1188
|
+
// Should never reach here - loop always returns or throws
|
|
1189
|
+
throw new EncryptionError('Unexpected end of decrypt retry loop', EncryptionErrorCode.DECRYPTION_FAILED);
|
|
1190
|
+
}
|
|
1191
|
+
catch (error) {
|
|
1192
|
+
// Enhance MESSAGE_DUPLICATE errors with address context for better debugging
|
|
1193
|
+
if (error instanceof EncryptionError &&
|
|
1194
|
+
error.code === EncryptionErrorCode.MESSAGE_DUPLICATE) {
|
|
1195
|
+
throw new DuplicatedMessageError(remoteAddress, {
|
|
1196
|
+
counter: error.context?.counter,
|
|
1197
|
+
epoch: error.context?.epoch,
|
|
1198
|
+
});
|
|
1199
|
+
}
|
|
1200
|
+
// L7: Comprehensive decryption failure diagnostics
|
|
1201
|
+
// Log error details for debugging (variables in this outer scope only)
|
|
1202
|
+
this.logger.error('Decryption failed - diagnostic summary', {
|
|
1203
|
+
category: 'E2EE',
|
|
1204
|
+
data: {
|
|
1205
|
+
operation: 'decrypt-failed',
|
|
1206
|
+
remoteAddress: ProtocolAddress.toString(remoteAddress),
|
|
1207
|
+
errorCode: error instanceof EncryptionError ? error.code : 'UNKNOWN',
|
|
1208
|
+
errorMessage: error instanceof Error ? error.message : String(error),
|
|
1209
|
+
// Include context from inner EncryptionError if available
|
|
1210
|
+
errorContext: error instanceof EncryptionError ? error.context : undefined,
|
|
1211
|
+
},
|
|
1212
|
+
});
|
|
1213
|
+
// Preserve other specific EncryptionError codes
|
|
1214
|
+
if (error instanceof EncryptionError) {
|
|
1215
|
+
throw error;
|
|
1216
|
+
}
|
|
1217
|
+
throw new EncryptionError('Failed to decrypt message', EncryptionErrorCode.DECRYPTION_FAILED, { originalError: error });
|
|
1218
|
+
}
|
|
1219
|
+
});
|
|
1220
|
+
}
|
|
1221
|
+
}
|
|
1222
|
+
//# sourceMappingURL=cipher.js.map
|