@open-e2ee/signal-protocol-sdk 0.3.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ADAPTERS.md +7 -0
- package/ARCHITECTURE.md +2 -0
- package/CHANGELOG.md +96 -5
- package/README.md +67 -102
- package/SECURITY.md +2 -2
- package/THIRD_PARTY_NOTICES.md +1 -1
- package/TROUBLESHOOTING.md +7 -0
- package/blocking/README.md +1 -0
- package/client/README.md +10 -0
- package/device/README.md +12 -5
- package/dist/client/client.d.ts +3 -2
- package/dist/client/client.d.ts.map +1 -1
- package/dist/client/client.js +58 -25
- package/dist/client/client.js.map +1 -1
- package/dist/client/config.d.ts +46 -7
- package/dist/client/config.d.ts.map +1 -1
- package/dist/client/config.js +2 -2
- package/dist/client/config.js.map +1 -1
- package/dist/client/group-outbox.d.ts +38 -0
- package/dist/client/group-outbox.d.ts.map +1 -0
- package/dist/client/group-outbox.js +221 -0
- package/dist/client/group-outbox.js.map +1 -0
- package/dist/client/group-sealed-sender.d.ts +28 -0
- package/dist/client/group-sealed-sender.d.ts.map +1 -0
- package/dist/client/group-sealed-sender.js +74 -0
- package/dist/client/group-sealed-sender.js.map +1 -0
- package/dist/client/groups.d.ts.map +1 -1
- package/dist/client/groups.js +14 -4
- package/dist/client/groups.js.map +1 -1
- package/dist/client/hosted-push.d.ts +77 -0
- package/dist/client/hosted-push.d.ts.map +1 -0
- package/dist/client/hosted-push.js +90 -0
- package/dist/client/hosted-push.js.map +1 -0
- package/dist/client/hosted.d.ts +207 -0
- package/dist/client/hosted.d.ts.map +1 -0
- package/dist/client/hosted.js +505 -0
- package/dist/client/hosted.js.map +1 -0
- package/dist/client/index.d.ts +4 -2
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/relay-subscription.d.ts.map +1 -1
- package/dist/client/relay-subscription.js +34 -7
- package/dist/client/relay-subscription.js.map +1 -1
- package/dist/client/{sealed-sender-ops.d.ts → sealed-sender.d.ts} +39 -22
- package/dist/client/sealed-sender.d.ts.map +1 -0
- package/dist/client/sealed-sender.js +296 -0
- package/dist/client/sealed-sender.js.map +1 -0
- package/dist/client/signal-service-cipher.d.ts +23 -26
- package/dist/client/signal-service-cipher.d.ts.map +1 -1
- package/dist/client/signal-service-cipher.js +465 -706
- package/dist/client/signal-service-cipher.js.map +1 -1
- package/dist/client/types.d.ts +18 -3
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js +6 -0
- package/dist/client/types.js.map +1 -1
- package/dist/device/index.d.ts +2 -2
- package/dist/device/index.d.ts.map +1 -1
- package/dist/device/index.js +1 -1
- package/dist/device/index.js.map +1 -1
- package/dist/device/transfer.d.ts +7 -43
- package/dist/device/transfer.d.ts.map +1 -1
- package/dist/device/transfer.js +31 -150
- package/dist/device/transfer.js.map +1 -1
- package/dist/device/types.d.ts +6 -47
- package/dist/device/types.d.ts.map +1 -1
- package/dist/device/types.js +1 -1
- package/dist/device/types.js.map +1 -1
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -5
- package/dist/index.js.map +1 -1
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js +1 -1
- package/dist/internal/encoding/proto/pq-ratchet-serialize.js.map +1 -1
- package/dist/internal/encoding/proto/primitives.js +1 -1
- package/dist/internal/encoding/proto/primitives.js.map +1 -1
- package/dist/internal/groups/manager.d.ts +3 -3
- package/dist/internal/groups/manager.d.ts.map +1 -1
- package/dist/internal/groups/manager.js +5 -4
- package/dist/internal/groups/manager.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/certificate.d.ts +10 -4
- package/dist/internal/protocol/sealed-sender/certificate.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/certificate.js +64 -7
- package/dist/internal/protocol/sealed-sender/certificate.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption.d.ts +34 -47
- package/dist/internal/protocol/sealed-sender/decryption.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/decryption.js +95 -182
- package/dist/internal/protocol/sealed-sender/decryption.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption.d.ts +49 -64
- package/dist/internal/protocol/sealed-sender/encryption.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/encryption.js +120 -123
- package/dist/internal/protocol/sealed-sender/encryption.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/index.d.ts +5 -7
- package/dist/internal/protocol/sealed-sender/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/index.js +4 -12
- package/dist/internal/protocol/sealed-sender/index.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/{v2-helpers.d.ts → multi-recipient-crypto.d.ts} +1 -1
- package/dist/internal/protocol/sealed-sender/multi-recipient-crypto.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/{v2-helpers.js → multi-recipient-crypto.js} +1 -1
- package/dist/internal/protocol/sealed-sender/multi-recipient-crypto.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/{v2-binary.d.ts → multi-recipient-message.d.ts} +3 -2
- package/dist/internal/protocol/sealed-sender/multi-recipient-message.d.ts.map +1 -0
- package/dist/internal/protocol/sealed-sender/{v2-binary.js → multi-recipient-message.js} +16 -8
- package/dist/internal/protocol/sealed-sender/multi-recipient-message.js.map +1 -0
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts +3 -0
- package/dist/internal/protocol/sealed-sender/proto/index.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/proto/index.js +25 -2
- package/dist/internal/protocol/sealed-sender/proto/index.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts +11 -1
- package/dist/internal/protocol/sealed-sender/trust-root.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/trust-root.js +13 -1
- package/dist/internal/protocol/sealed-sender/trust-root.js.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.d.ts +20 -135
- package/dist/internal/protocol/sealed-sender/types.d.ts.map +1 -1
- package/dist/internal/protocol/sealed-sender/types.js +15 -6
- package/dist/internal/protocol/sealed-sender/types.js.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts +22 -1
- package/dist/internal/protocol/sender-keys/manager.d.ts.map +1 -1
- package/dist/internal/protocol/sender-keys/manager.js +39 -4
- package/dist/internal/protocol/sender-keys/manager.js.map +1 -1
- package/dist/internal/protocol/spqr/braid-serialize.js +1 -1
- package/dist/internal/protocol/spqr/braid-serialize.js.map +1 -1
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js +4 -4
- package/dist/internal/protocol/spqr/ml-kem-braid/state-machine.js.map +1 -1
- package/dist/internal/protocol/zk/groups/index.d.ts +1 -1
- package/dist/internal/protocol/zk/groups/index.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/index.js +1 -1
- package/dist/internal/protocol/zk/groups/index.js.map +1 -1
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts +37 -12
- package/dist/internal/protocol/zk/groups/profile-key-credential.d.ts.map +1 -1
- package/dist/internal/protocol/zk/groups/profile-key-credential.js +104 -31
- package/dist/internal/protocol/zk/groups/profile-key-credential.js.map +1 -1
- package/dist/internal/sesame/types.d.ts +0 -2
- package/dist/internal/sesame/types.d.ts.map +1 -1
- package/dist/internal/sesame/types.js +0 -2
- package/dist/internal/sesame/types.js.map +1 -1
- package/dist/local/store/expo/adapter.d.ts +1 -0
- package/dist/local/store/expo/adapter.d.ts.map +1 -1
- package/dist/local/store/expo/adapter.js +3 -0
- package/dist/local/store/expo/adapter.js.map +1 -1
- package/dist/local/store/expo/key-storage.d.ts +1 -0
- package/dist/local/store/expo/key-storage.d.ts.map +1 -1
- package/dist/local/store/expo/key-storage.js +4 -0
- package/dist/local/store/expo/key-storage.js.map +1 -1
- package/dist/local/store/memory/adapter.d.ts +1 -0
- package/dist/local/store/memory/adapter.d.ts.map +1 -1
- package/dist/local/store/memory/adapter.js +4 -0
- package/dist/local/store/memory/adapter.js.map +1 -1
- package/dist/local/store/node/adapter.d.ts +1 -0
- package/dist/local/store/node/adapter.d.ts.map +1 -1
- package/dist/local/store/node/adapter.js +3 -0
- package/dist/local/store/node/adapter.js.map +1 -1
- package/dist/local/store/node/database.d.ts +1 -0
- package/dist/local/store/node/database.d.ts.map +1 -1
- package/dist/local/store/node/database.js +5 -0
- package/dist/local/store/node/database.js.map +1 -1
- package/dist/local/store/react-native/adapter.d.ts +1 -0
- package/dist/local/store/react-native/adapter.d.ts.map +1 -1
- package/dist/local/store/react-native/adapter.js +4 -0
- package/dist/local/store/react-native/adapter.js.map +1 -1
- package/dist/local/store/react-native/reference-backend.js +1 -1
- package/dist/local/store/react-native/reference-backend.js.map +1 -1
- package/dist/local/store/reliability.d.ts +63 -0
- package/dist/local/store/reliability.d.ts.map +1 -0
- package/dist/local/store/reliability.js +219 -0
- package/dist/local/store/reliability.js.map +1 -0
- package/dist/local/store/web/adapter.d.ts +1 -0
- package/dist/local/store/web/adapter.d.ts.map +1 -1
- package/dist/local/store/web/adapter.js +5 -0
- package/dist/local/store/web/adapter.js.map +1 -1
- package/dist/media/index.d.ts +0 -1
- package/dist/media/index.d.ts.map +1 -1
- package/dist/media/index.js +0 -1
- package/dist/media/index.js.map +1 -1
- package/dist/remote/relay/convex/backend.d.ts +6 -16
- package/dist/remote/relay/convex/backend.d.ts.map +1 -1
- package/dist/remote/relay/convex/backend.js +12 -21
- package/dist/remote/relay/convex/backend.js.map +1 -1
- package/dist/remote/relay/convex/component/_generated/component.d.ts +9 -16
- package/dist/remote/relay/convex/component/_generated/component.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/certificates.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/certificates.js +14 -5
- package/dist/remote/relay/convex/component/certificates.js.map +1 -1
- package/dist/remote/relay/convex/component/messages.d.ts +2 -15
- package/dist/remote/relay/convex/component/messages.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/messages.js +14 -48
- package/dist/remote/relay/convex/component/messages.js.map +1 -1
- package/dist/remote/relay/convex/component/schema.d.ts +5 -3
- package/dist/remote/relay/convex/component/schema.js +2 -1
- package/dist/remote/relay/convex/component/schema.js.map +1 -1
- package/dist/remote/relay/convex/component/zkAuth.d.ts +7 -1
- package/dist/remote/relay/convex/component/zkAuth.d.ts.map +1 -1
- package/dist/remote/relay/convex/component/zkAuth.js +29 -14
- package/dist/remote/relay/convex/component/zkAuth.js.map +1 -1
- package/dist/remote/relay/convex/relay.d.ts +2 -5
- package/dist/remote/relay/convex/relay.d.ts.map +1 -1
- package/dist/remote/relay/convex/relay.js +17 -47
- package/dist/remote/relay/convex/relay.js.map +1 -1
- package/dist/remote/relay/memory/adapter.d.ts +4 -10
- package/dist/remote/relay/memory/adapter.d.ts.map +1 -1
- package/dist/remote/relay/memory/adapter.js +31 -34
- package/dist/remote/relay/memory/adapter.js.map +1 -1
- package/dist/remote/relay/types.d.ts +6 -19
- package/dist/remote/relay/types.d.ts.map +1 -1
- package/dist/types/api.d.ts +2 -0
- package/dist/types/api.d.ts.map +1 -1
- package/dist/types/errors.d.ts +3 -1
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +4 -2
- package/dist/types/errors.js.map +1 -1
- package/dist/types/protocol-config.d.ts +1 -1
- package/dist/username/link.d.ts.map +1 -1
- package/dist/username/link.js +1 -1
- package/dist/username/link.js.map +1 -1
- package/dist/utils/retry.d.ts +2 -1
- package/dist/utils/retry.d.ts.map +1 -1
- package/dist/utils/retry.js +2 -1
- package/dist/utils/retry.js.map +1 -1
- package/docs/ASSURANCE.md +16 -10
- package/docs/CLIENT_COMPOSITION.md +3 -0
- package/docs/DEVIATIONS.md +32 -61
- package/docs/DOCUMENTATION_STANDARDS.md +28 -0
- package/docs/ERROR_HANDLING.md +91 -60
- package/docs/GETTING_STARTED.md +27 -1
- package/docs/INTERFACES.md +5 -0
- package/docs/PACKAGE_SURFACE.md +1 -0
- package/docs/PROTOCOL_POLICY.md +6 -0
- package/docs/RECIPES.md +9 -0
- package/docs/SECURITY.md +6 -0
- package/encoding/README.md +1 -0
- package/files/README.md +1 -0
- package/groups/README.md +1 -0
- package/keys/README.md +2 -0
- package/local/store/README.md +2 -0
- package/local/store/expo/README.md +2 -0
- package/local/store/memory/README.md +2 -0
- package/local/store/node/README.md +1 -0
- package/local/store/react-native/README.md +2 -0
- package/local/store/web/README.md +1 -0
- package/local/vault/README.md +1 -0
- package/media/README.md +2 -0
- package/package.json +4 -2
- package/profile/README.md +1 -0
- package/remote/README.md +6 -0
- package/remote/object-store/README.md +1 -0
- package/remote/object-store/convex-r2/README.md +2 -0
- package/remote/object-store/s3/README.md +1 -0
- package/remote/relay/README.md +2 -0
- package/remote/relay/convex/README.md +1 -0
- package/remote/relay/convex/component/README.md +29 -14
- package/remote/relay/memory/README.md +2 -0
- package/safety/README.md +1 -0
- package/scripts/oe-groups.mjs +5 -1
- package/sealed-sender/README.md +1 -0
- package/types/README.md +1 -0
- package/username/README.md +1 -0
- package/utils/README.md +1 -0
- package/zk/README.md +1 -0
- package/dist/client/sealed-sender-ops.d.ts.map +0 -1
- package/dist/client/sealed-sender-ops.js +0 -203
- package/dist/client/sealed-sender-ops.js.map +0 -1
- package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts +0 -46
- package/dist/internal/protocol/sealed-sender/decryption-v2.d.ts.map +0 -1
- package/dist/internal/protocol/sealed-sender/decryption-v2.js +0 -198
- package/dist/internal/protocol/sealed-sender/decryption-v2.js.map +0 -1
- package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts +0 -56
- package/dist/internal/protocol/sealed-sender/encryption-v2.d.ts.map +0 -1
- package/dist/internal/protocol/sealed-sender/encryption-v2.js +0 -163
- package/dist/internal/protocol/sealed-sender/encryption-v2.js.map +0 -1
- package/dist/internal/protocol/sealed-sender/v2-binary.d.ts.map +0 -1
- package/dist/internal/protocol/sealed-sender/v2-binary.js.map +0 -1
- package/dist/internal/protocol/sealed-sender/v2-helpers.d.ts.map +0 -1
- package/dist/internal/protocol/sealed-sender/v2-helpers.js.map +0 -1
|
@@ -1,203 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Sealed Sender Operations
|
|
3
|
-
*
|
|
4
|
-
* Provides seal/unseal wrapping for the message send/receive pipeline.
|
|
5
|
-
* Called by SignalProtocolServiceCipher when sealed sender is enabled.
|
|
6
|
-
*
|
|
7
|
-
* @see https://signal.org/blog/sealed-sender/
|
|
8
|
-
*/
|
|
9
|
-
import { resolveSignalProtocolLogger } from '../logger.js';
|
|
10
|
-
import { SealedSenderContentType, SEALED_SENDER_V2_SERVICE_ID_VERSION, SEALED_SENDER_V2_UUID_VERSION, } from '../internal/protocol/sealed-sender/types.js';
|
|
11
|
-
export async function sealMessage(ciphertextBase64, senderCertificateBase64, senderIdentityPrivate, recipientIdentityPublic, _config, _providedLogger, contentType) {
|
|
12
|
-
const { seal, deserializeSenderCertificate, encodeUnidentifiedSenderMessage } = await import('../internal/protocol/sealed-sender/index.js');
|
|
13
|
-
const { base64ToBytes, bytesToBase64 } = await import('../internal/crypto/index.js');
|
|
14
|
-
// Deserialize the sender certificate
|
|
15
|
-
const certBytes = base64ToBytes(senderCertificateBase64);
|
|
16
|
-
const senderCertificate = deserializeSenderCertificate(certBytes);
|
|
17
|
-
// Convert ciphertext to bytes for seal()
|
|
18
|
-
const signalProtocolMessage = base64ToBytes(ciphertextBase64);
|
|
19
|
-
// Seal the message
|
|
20
|
-
const sealed = await seal({
|
|
21
|
-
senderCertificate,
|
|
22
|
-
senderIdentityPrivate,
|
|
23
|
-
recipientIdentityPublic,
|
|
24
|
-
signalProtocolMessage,
|
|
25
|
-
contentType,
|
|
26
|
-
});
|
|
27
|
-
// Serialize: version byte + protobuf-encoded message (Sealed Sender wire format)
|
|
28
|
-
const protoBytes = encodeUnidentifiedSenderMessage({
|
|
29
|
-
ephemeralPublic: base64ToBytes(sealed.ephemeralPublic),
|
|
30
|
-
encryptedStatic: base64ToBytes(sealed.encryptedStatic),
|
|
31
|
-
encryptedMessage: base64ToBytes(sealed.encryptedMessage),
|
|
32
|
-
});
|
|
33
|
-
// Prepend version byte
|
|
34
|
-
const sealedBytes = new Uint8Array(1 + protoBytes.length);
|
|
35
|
-
sealedBytes[0] = sealed.version;
|
|
36
|
-
sealedBytes.set(protoBytes, 1);
|
|
37
|
-
return bytesToBase64(sealedBytes);
|
|
38
|
-
}
|
|
39
|
-
/**
|
|
40
|
-
* Unseal a sealed sender message to reveal the sender and inner ciphertext.
|
|
41
|
-
*
|
|
42
|
-
* Called when an incoming envelope has messageType === 'unidentified_sender'.
|
|
43
|
-
* Validates the certificate chain, reveals sender identity, and returns
|
|
44
|
-
* the inner Signal Protocol ciphertext for normal decryption.
|
|
45
|
-
*
|
|
46
|
-
* @param sealedCiphertextBase64 - Base64-encoded sealed sender message
|
|
47
|
-
* @param recipientIdentityPrivate - Recipient's X25519 identity private key
|
|
48
|
-
* @param recipientUuid - Recipient's user ID (for self-send detection)
|
|
49
|
-
* @param recipientDeviceId - Recipient's device ID
|
|
50
|
-
* @param config - Sealed sender config with trust roots
|
|
51
|
-
* @returns Unsealed envelope info with sender identity and inner ciphertext
|
|
52
|
-
*/
|
|
53
|
-
export async function unsealMessage(sealedCiphertextBase64, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, providedLogger) {
|
|
54
|
-
const logger = resolveSignalProtocolLogger(providedLogger);
|
|
55
|
-
const { base64ToBytes, bytesToBase64 } = await import('../internal/crypto/index.js');
|
|
56
|
-
// Decode sealed bytes and check version byte for V1 vs V2 dispatch
|
|
57
|
-
const sealedBytes = base64ToBytes(sealedCiphertextBase64);
|
|
58
|
-
const versionByte = sealedBytes[0];
|
|
59
|
-
// V2 detection: 0x22 = UUID version (ReceivedMessage), 0x23 = ServiceId version
|
|
60
|
-
if (versionByte === SEALED_SENDER_V2_UUID_VERSION ||
|
|
61
|
-
versionByte === SEALED_SENDER_V2_SERVICE_ID_VERSION) {
|
|
62
|
-
return unsealV2Message(sealedBytes, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, logger);
|
|
63
|
-
}
|
|
64
|
-
// V1 path (0x11). Existing code
|
|
65
|
-
const { unseal, decodeUnidentifiedSenderMessage } = await import('../internal/protocol/sealed-sender/index.js');
|
|
66
|
-
const version = versionByte;
|
|
67
|
-
const sealedProto = decodeUnidentifiedSenderMessage(sealedBytes.subarray(1));
|
|
68
|
-
// Build the UnidentifiedSenderMessage structure
|
|
69
|
-
const sealedMessage = {
|
|
70
|
-
version,
|
|
71
|
-
ephemeralPublic: bytesToBase64(sealedProto.ephemeralPublic),
|
|
72
|
-
encryptedStatic: bytesToBase64(sealedProto.encryptedStatic),
|
|
73
|
-
encryptedMessage: bytesToBase64(sealedProto.encryptedMessage),
|
|
74
|
-
};
|
|
75
|
-
// Build trust roots as base64 strings
|
|
76
|
-
const trustRoots = config.trustRoots.map((root) => bytesToBase64(root));
|
|
77
|
-
// Unseal the message
|
|
78
|
-
const content = await unseal({
|
|
79
|
-
sealedMessage,
|
|
80
|
-
recipientIdentityPrivate,
|
|
81
|
-
trustRoots,
|
|
82
|
-
recipientUuid,
|
|
83
|
-
recipientDeviceId,
|
|
84
|
-
});
|
|
85
|
-
logger.debug('Sealed sender message unsealed', {
|
|
86
|
-
category: 'E2EE',
|
|
87
|
-
data: {
|
|
88
|
-
senderUuid: content.senderCertificate.senderUuid,
|
|
89
|
-
senderDeviceId: content.senderCertificate.senderDeviceId,
|
|
90
|
-
},
|
|
91
|
-
});
|
|
92
|
-
return {
|
|
93
|
-
senderUserId: content.senderCertificate.senderUuid,
|
|
94
|
-
senderDeviceId: content.senderCertificate.senderDeviceId,
|
|
95
|
-
innerCiphertextBase64: content.signalProtocolMessage,
|
|
96
|
-
contentType: content.contentType,
|
|
97
|
-
};
|
|
98
|
-
}
|
|
99
|
-
/**
|
|
100
|
-
* Unseal a V2 multi-recipient sealed sender message (per-device view).
|
|
101
|
-
*
|
|
102
|
-
* The server constructs a per-device view: [0x22][C_i(32)][AT_i(16)][e_pub(32)][ciphertext]
|
|
103
|
-
* We deserialize this, build a SealedSenderV2Message, and call unsealV2().
|
|
104
|
-
*/
|
|
105
|
-
async function unsealV2Message(sealedBytes, recipientIdentityPrivate, recipientUuid, recipientDeviceId, config, logger) {
|
|
106
|
-
const { deserializeReceivedMessage } = await import('../internal/protocol/sealed-sender/v2-binary.js');
|
|
107
|
-
const { unsealV2 } = await import('../internal/protocol/sealed-sender/decryption-v2.js');
|
|
108
|
-
const { bytesToBase64 } = await import('../internal/crypto/index.js');
|
|
109
|
-
const { x25519 } = await import('@noble/curves/ed25519.js');
|
|
110
|
-
// 1. Deserialize per-device ReceivedMessage
|
|
111
|
-
const deserialized = deserializeReceivedMessage(sealedBytes);
|
|
112
|
-
// 2. Derive recipient public key from private
|
|
113
|
-
const recipientIdentityPublic = x25519.getPublicKey(recipientIdentityPrivate);
|
|
114
|
-
// 3. Build SealedSenderV2Message with single recipient entry
|
|
115
|
-
const message = {
|
|
116
|
-
version: SEALED_SENDER_V2_UUID_VERSION,
|
|
117
|
-
ephemeralPublic: bytesToBase64(deserialized.ephemeralPublic),
|
|
118
|
-
recipients: [
|
|
119
|
-
{
|
|
120
|
-
serviceId: recipientUuid,
|
|
121
|
-
deviceId: recipientDeviceId,
|
|
122
|
-
registrationId: 0, // Not needed for unseal. Only used in send path
|
|
123
|
-
encryptedMessageKey: bytesToBase64(deserialized.encryptedMessageKey),
|
|
124
|
-
authenticationTag: bytesToBase64(deserialized.authenticationTag),
|
|
125
|
-
},
|
|
126
|
-
],
|
|
127
|
-
messageCiphertext: bytesToBase64(deserialized.messageCiphertext),
|
|
128
|
-
};
|
|
129
|
-
// 4. Build trust roots as Base64 strings
|
|
130
|
-
const trustRoots = config.trustRoots.map((root) => bytesToBase64(root));
|
|
131
|
-
// 5. Call unsealV2
|
|
132
|
-
const content = await unsealV2({
|
|
133
|
-
sealedMessage: message,
|
|
134
|
-
recipientIdentityPrivate,
|
|
135
|
-
recipientIdentityPublic,
|
|
136
|
-
recipientServiceId: recipientUuid,
|
|
137
|
-
recipientDeviceId,
|
|
138
|
-
trustRoots,
|
|
139
|
-
});
|
|
140
|
-
logger.debug('V2 sealed sender message unsealed', {
|
|
141
|
-
category: 'E2EE',
|
|
142
|
-
data: {
|
|
143
|
-
senderUuid: content.senderCertificate.senderUuid,
|
|
144
|
-
senderDeviceId: content.senderCertificate.senderDeviceId,
|
|
145
|
-
},
|
|
146
|
-
});
|
|
147
|
-
return {
|
|
148
|
-
senderUserId: content.senderCertificate.senderUuid,
|
|
149
|
-
senderDeviceId: content.senderCertificate.senderDeviceId,
|
|
150
|
-
innerCiphertextBase64: content.signalProtocolMessage,
|
|
151
|
-
contentType: content.contentType,
|
|
152
|
-
};
|
|
153
|
-
}
|
|
154
|
-
/**
|
|
155
|
-
* Reconstruct an Envelope from an unsealed message.
|
|
156
|
-
*
|
|
157
|
-
* Takes the original sealed sender envelope (with empty sender fields)
|
|
158
|
-
* and fills in the sender identity revealed by unsealing.
|
|
159
|
-
*
|
|
160
|
-
* @param originalEnvelope - The incoming envelope with messageType 'unidentified_sender'
|
|
161
|
-
* @param unsealed - The unsealed sender info and inner ciphertext
|
|
162
|
-
* @returns A new envelope with real sender info and the inner ciphertext
|
|
163
|
-
*/
|
|
164
|
-
export function reconstructEnvelope(originalEnvelope, unsealed) {
|
|
165
|
-
return {
|
|
166
|
-
...originalEnvelope,
|
|
167
|
-
senderUserId: unsealed.senderUserId,
|
|
168
|
-
senderDeviceId: unsealed.senderDeviceId,
|
|
169
|
-
ciphertext: unsealed.innerCiphertextBase64,
|
|
170
|
-
messageType: envelopeTypeForContent(unsealed.contentType),
|
|
171
|
-
};
|
|
172
|
-
}
|
|
173
|
-
/**
|
|
174
|
-
* Map a sealed envelope's content type onto the envelope type the decrypt
|
|
175
|
-
* path routes on.
|
|
176
|
-
*
|
|
177
|
-
* Exported because both receive paths need it. `SignalProtocolServiceCipher`
|
|
178
|
-
* via `reconstructEnvelope`, and `SignalProtocolClient.processIncomingEnvelope`
|
|
179
|
-
* directly. Two copies of this mapping would drift.
|
|
180
|
-
*
|
|
181
|
-
* `SENDERKEY_MESSAGE` is the only case that matters here. It is what keeps
|
|
182
|
-
* group routing working now that no group identifier travels on an envelope,
|
|
183
|
-
* sealed or otherwise. Both `PREKEY_MESSAGE` and `MESSAGE` decrypt as pairwise
|
|
184
|
-
* ratchet messages, and the ratchet distinguishes them from the payload
|
|
185
|
-
* itself.
|
|
186
|
-
*
|
|
187
|
-
* The default is unreachable: `isSealedSenderContentType` rejects every other
|
|
188
|
-
* value at the parse, so nothing arrives here that this function cannot map.
|
|
189
|
-
* It exists so that adding an enum member without a route fails loudly rather
|
|
190
|
-
* than silently decrypting as something it is not.
|
|
191
|
-
*/
|
|
192
|
-
export function envelopeTypeForContent(contentType) {
|
|
193
|
-
switch (contentType) {
|
|
194
|
-
case SealedSenderContentType.SENDERKEY_MESSAGE:
|
|
195
|
-
return 'sender_key';
|
|
196
|
-
case SealedSenderContentType.PREKEY_MESSAGE:
|
|
197
|
-
case SealedSenderContentType.MESSAGE:
|
|
198
|
-
return 'ciphertext';
|
|
199
|
-
default:
|
|
200
|
-
throw new Error('Unsupported sealed sender content type');
|
|
201
|
-
}
|
|
202
|
-
}
|
|
203
|
-
//# sourceMappingURL=sealed-sender-ops.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"sealed-sender-ops.js","sourceRoot":"","sources":["../../client/sealed-sender-ops.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Sealed Sender V2 Multi-Recipient Decryption
|
|
3
|
-
*
|
|
4
|
-
* Implements V2 multi-recipient sealed-sender decryption.
|
|
5
|
-
*
|
|
6
|
-
* Algorithm:
|
|
7
|
-
* 1. Parse version, find my recipient entry by serviceId
|
|
8
|
-
* 2. M = apply_agreement_xor(recipient_identity, ephemeral_pub, encrypted_key)
|
|
9
|
-
* 3. Verify E_pub matches X25519(derive_private_from_M(M)) - authenticates XOR decryption
|
|
10
|
-
* 4. K = HKDF(M, LABEL_K)
|
|
11
|
-
* 5. usmc = AES-GCM-SIV.Decrypt(K, nonce=zeros, ciphertext) - authenticated decryption
|
|
12
|
-
* 6. Parse certificate from usmc to get sender identity
|
|
13
|
-
* 7. Verify auth_tag using identity-to-identity ECDH (binds sender to message)
|
|
14
|
-
* 8. Validate sender certificate, return content
|
|
15
|
-
*
|
|
16
|
-
* IMPORTANT: Auth tag is verified AFTER decryption because it requires sender identity
|
|
17
|
-
* from the certificate. This is safe because:
|
|
18
|
-
* - AES-GCM-SIV provides authenticated encryption
|
|
19
|
-
* - Ephemeral key consistency check authenticates the XOR decryption
|
|
20
|
-
* - Auth tag binds the sender's identity to the message
|
|
21
|
-
*
|
|
22
|
-
*/
|
|
23
|
-
import type { UnsealV2Options, UnidentifiedSenderMessageContent } from './types.js';
|
|
24
|
-
/** Generic error message for all unseal failures */
|
|
25
|
-
export {};
|
|
26
|
-
/**
|
|
27
|
-
* Unseal a V2 multi-recipient Sealed Sender message.
|
|
28
|
-
*
|
|
29
|
-
* @param options V2 unsealing options
|
|
30
|
-
* @returns Decrypted content with validated sender certificate
|
|
31
|
-
* @throws Error (generic) if any validation fails
|
|
32
|
-
*
|
|
33
|
-
* @example
|
|
34
|
-
* ```typescript
|
|
35
|
-
* const content = await unsealV2({
|
|
36
|
-
* sealedMessage: receivedMessage,
|
|
37
|
-
* recipientIdentityPrivate: myPrivateKey,
|
|
38
|
-
* recipientIdentityPublic: myPublicKey,
|
|
39
|
-
* recipientServiceId: 'my-user-id',
|
|
40
|
-
* recipientDeviceId: 1,
|
|
41
|
-
* trustRoots: [trustRootPublicKey],
|
|
42
|
-
* });
|
|
43
|
-
* ```
|
|
44
|
-
*/
|
|
45
|
-
export declare function unsealV2(options: UnsealV2Options): Promise<UnidentifiedSenderMessageContent>;
|
|
46
|
-
//# sourceMappingURL=decryption-v2.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"decryption-v2.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/decryption-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAgC,EAAqB,MAAM,SAAS,CAAC;AA2BpG,oDAAoD;AACpD,OAAO,EAAE,CAAC;AA6EV;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gCAAgC,CAAC,CAuI3C"}
|
|
@@ -1,198 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Sealed Sender V2 Multi-Recipient Decryption
|
|
3
|
-
*
|
|
4
|
-
* Implements V2 multi-recipient sealed-sender decryption.
|
|
5
|
-
*
|
|
6
|
-
* Algorithm:
|
|
7
|
-
* 1. Parse version, find my recipient entry by serviceId
|
|
8
|
-
* 2. M = apply_agreement_xor(recipient_identity, ephemeral_pub, encrypted_key)
|
|
9
|
-
* 3. Verify E_pub matches X25519(derive_private_from_M(M)) - authenticates XOR decryption
|
|
10
|
-
* 4. K = HKDF(M, LABEL_K)
|
|
11
|
-
* 5. usmc = AES-GCM-SIV.Decrypt(K, nonce=zeros, ciphertext) - authenticated decryption
|
|
12
|
-
* 6. Parse certificate from usmc to get sender identity
|
|
13
|
-
* 7. Verify auth_tag using identity-to-identity ECDH (binds sender to message)
|
|
14
|
-
* 8. Validate sender certificate, return content
|
|
15
|
-
*
|
|
16
|
-
* IMPORTANT: Auth tag is verified AFTER decryption because it requires sender identity
|
|
17
|
-
* from the certificate. This is safe because:
|
|
18
|
-
* - AES-GCM-SIV provides authenticated encryption
|
|
19
|
-
* - Ephemeral key consistency check authenticates the XOR decryption
|
|
20
|
-
* - Auth tag binds the sender's identity to the message
|
|
21
|
-
*
|
|
22
|
-
*/
|
|
23
|
-
import { SEALED_SENDER_V2_UUID_VERSION, SEALED_SENDER_V2_SERVICE_ID_VERSION, isSealedSenderContentType, } from './types.js';
|
|
24
|
-
import { deserializeSenderCertificate, validateSenderCertificate } from './certificate.js';
|
|
25
|
-
import { deriveEphemeralPrivateFromM, deriveCipherKeyFromM, applyAgreementXor, computeAuthenticationTag, verifyAuthenticationTag, } from './v2-helpers.js';
|
|
26
|
-
import { bytesToBase64, base64ToBytes, constantTimeEqual, secureZeroBytes, aesGcmSivDecryptZeroNonce, } from '../../crypto/index.js';
|
|
27
|
-
import { decodeVarint } from '../../encoding/proto/primitives.js';
|
|
28
|
-
import { x25519 } from '@noble/curves/ed25519.js';
|
|
29
|
-
const GENERIC_ERROR = 'Sealed sender verification failed';
|
|
30
|
-
/** contentType(1) + certLen varint(1) + msgLen varint(1) + contentHint(1). */
|
|
31
|
-
const MIN_ENVELOPE_BYTES = 4;
|
|
32
|
-
/**
|
|
33
|
-
* Parse decrypted envelope to extract certificate and message.
|
|
34
|
-
*/
|
|
35
|
-
function parseEnvelope(envelope) {
|
|
36
|
-
// Smallest well-formed envelope: type, two zero-length varints, hint.
|
|
37
|
-
if (envelope.length < MIN_ENVELOPE_BYTES) {
|
|
38
|
-
throw new Error(GENERIC_ERROR);
|
|
39
|
-
}
|
|
40
|
-
// Read content type (1 byte)
|
|
41
|
-
const contentType = envelope[0];
|
|
42
|
-
if (!isSealedSenderContentType(contentType)) {
|
|
43
|
-
throw new Error(GENERIC_ERROR);
|
|
44
|
-
}
|
|
45
|
-
let offset = 1;
|
|
46
|
-
// Read certificate length
|
|
47
|
-
const { value: certLen, bytesRead: certLenBytes } = decodeVarint(envelope, offset);
|
|
48
|
-
if (certLenBytes === 0) {
|
|
49
|
-
throw new Error(GENERIC_ERROR);
|
|
50
|
-
}
|
|
51
|
-
offset += certLenBytes;
|
|
52
|
-
if (offset + certLen > envelope.length) {
|
|
53
|
-
throw new Error(GENERIC_ERROR);
|
|
54
|
-
}
|
|
55
|
-
// Read certificate bytes
|
|
56
|
-
const certBytes = envelope.slice(offset, offset + certLen);
|
|
57
|
-
offset += certLen;
|
|
58
|
-
// Read message length
|
|
59
|
-
const { value: msgLen, bytesRead: msgLenBytes } = decodeVarint(envelope, offset);
|
|
60
|
-
if (msgLenBytes === 0) {
|
|
61
|
-
throw new Error(GENERIC_ERROR);
|
|
62
|
-
}
|
|
63
|
-
offset += msgLenBytes;
|
|
64
|
-
if (offset + msgLen > envelope.length) {
|
|
65
|
-
throw new Error(GENERIC_ERROR);
|
|
66
|
-
}
|
|
67
|
-
// Read message bytes
|
|
68
|
-
const message = envelope.slice(offset, offset + msgLen);
|
|
69
|
-
offset += msgLen;
|
|
70
|
-
// Read content hint. The serializer always writes it, and nothing follows
|
|
71
|
-
// it any more, so it is required rather than optional.
|
|
72
|
-
if (offset >= envelope.length) {
|
|
73
|
-
throw new Error(GENERIC_ERROR);
|
|
74
|
-
}
|
|
75
|
-
const contentHint = envelope[offset];
|
|
76
|
-
offset += 1;
|
|
77
|
-
// The envelope is exactly its fields. Trailing bytes would make the format
|
|
78
|
-
// non-canonical. Two distinct envelopes parsing to the same content.
|
|
79
|
-
if (offset !== envelope.length) {
|
|
80
|
-
throw new Error(GENERIC_ERROR);
|
|
81
|
-
}
|
|
82
|
-
// Deserialize certificate
|
|
83
|
-
const certificate = deserializeSenderCertificate(certBytes);
|
|
84
|
-
return { certificate, message, contentType, contentHint };
|
|
85
|
-
}
|
|
86
|
-
/**
|
|
87
|
-
* Unseal a V2 multi-recipient Sealed Sender message.
|
|
88
|
-
*
|
|
89
|
-
* @param options V2 unsealing options
|
|
90
|
-
* @returns Decrypted content with validated sender certificate
|
|
91
|
-
* @throws Error (generic) if any validation fails
|
|
92
|
-
*
|
|
93
|
-
* @example
|
|
94
|
-
* ```typescript
|
|
95
|
-
* const content = await unsealV2({
|
|
96
|
-
* sealedMessage: receivedMessage,
|
|
97
|
-
* recipientIdentityPrivate: myPrivateKey,
|
|
98
|
-
* recipientIdentityPublic: myPublicKey,
|
|
99
|
-
* recipientServiceId: 'my-user-id',
|
|
100
|
-
* recipientDeviceId: 1,
|
|
101
|
-
* trustRoots: [trustRootPublicKey],
|
|
102
|
-
* });
|
|
103
|
-
* ```
|
|
104
|
-
*/
|
|
105
|
-
export async function unsealV2(options) {
|
|
106
|
-
const { sealedMessage, recipientIdentityPrivate, recipientIdentityPublic, recipientServiceId, recipientDeviceId, trustRoots, currentTime, } = options;
|
|
107
|
-
// Track sensitive material for secure zeroing
|
|
108
|
-
const toZero = [];
|
|
109
|
-
// ========================================================================
|
|
110
|
-
// Step 1: Validate version and find my recipient entry
|
|
111
|
-
// ========================================================================
|
|
112
|
-
const version = sealedMessage.version;
|
|
113
|
-
if (version !== SEALED_SENDER_V2_UUID_VERSION &&
|
|
114
|
-
version !== SEALED_SENDER_V2_SERVICE_ID_VERSION) {
|
|
115
|
-
throw new Error(GENERIC_ERROR);
|
|
116
|
-
}
|
|
117
|
-
// Find my recipient entry
|
|
118
|
-
const myRecipient = sealedMessage.recipients.find((r) => r.serviceId === recipientServiceId && r.deviceId === recipientDeviceId);
|
|
119
|
-
if (!myRecipient) {
|
|
120
|
-
throw new Error(GENERIC_ERROR);
|
|
121
|
-
}
|
|
122
|
-
try {
|
|
123
|
-
const ephemeralPublic = base64ToBytes(sealedMessage.ephemeralPublic);
|
|
124
|
-
const encryptedMessageKey = base64ToBytes(myRecipient.encryptedMessageKey);
|
|
125
|
-
const receivedAuthTag = base64ToBytes(myRecipient.authenticationTag);
|
|
126
|
-
const messageCiphertext = base64ToBytes(sealedMessage.messageCiphertext);
|
|
127
|
-
if (ephemeralPublic.length !== 32) {
|
|
128
|
-
throw new Error(GENERIC_ERROR);
|
|
129
|
-
}
|
|
130
|
-
// ========================================================================
|
|
131
|
-
// Step 2: Decrypt M using XOR (ephemeral-to-identity ECDH)
|
|
132
|
-
// ========================================================================
|
|
133
|
-
const M = await applyAgreementXor(recipientIdentityPrivate, ephemeralPublic, ephemeralPublic, // For receiving: both ECDH target and IKM are the ephemeral key
|
|
134
|
-
'receiving', encryptedMessageKey);
|
|
135
|
-
toZero.push(M);
|
|
136
|
-
// ========================================================================
|
|
137
|
-
// Step 3: Verify ephemeral public key consistency
|
|
138
|
-
// This authenticates the XOR decryption - if M was wrong, derived key will not match
|
|
139
|
-
// ========================================================================
|
|
140
|
-
const derivedEphemeralPrivate = await deriveEphemeralPrivateFromM(M);
|
|
141
|
-
toZero.push(derivedEphemeralPrivate);
|
|
142
|
-
const derivedEphemeralPublic = x25519.getPublicKey(derivedEphemeralPrivate);
|
|
143
|
-
if (!constantTimeEqual(ephemeralPublic, derivedEphemeralPublic)) {
|
|
144
|
-
throw new Error(GENERIC_ERROR);
|
|
145
|
-
}
|
|
146
|
-
// ========================================================================
|
|
147
|
-
// Step 4: Derive cipher key K from M
|
|
148
|
-
// ========================================================================
|
|
149
|
-
const cipherKey = await deriveCipherKeyFromM(M);
|
|
150
|
-
toZero.push(cipherKey);
|
|
151
|
-
// ========================================================================
|
|
152
|
-
// Step 5: Decrypt message with AES-GCM-SIV (provides authenticated decryption)
|
|
153
|
-
// ========================================================================
|
|
154
|
-
let envelope;
|
|
155
|
-
try {
|
|
156
|
-
envelope = aesGcmSivDecryptZeroNonce(cipherKey, messageCiphertext);
|
|
157
|
-
}
|
|
158
|
-
catch {
|
|
159
|
-
throw new Error(GENERIC_ERROR);
|
|
160
|
-
}
|
|
161
|
-
// ========================================================================
|
|
162
|
-
// Step 6: Parse envelope to get sender certificate
|
|
163
|
-
// ========================================================================
|
|
164
|
-
const { certificate, message, contentType, contentHint } = parseEnvelope(envelope);
|
|
165
|
-
// ========================================================================
|
|
166
|
-
// Step 7: Verify authentication tag (identity-to-identity ECDH).
|
|
167
|
-
// Now that we have the sender's identity from the certificate, verify the
|
|
168
|
-
// auth tag. This binds the sender's identity to the message.
|
|
169
|
-
// ========================================================================
|
|
170
|
-
const senderIdentityPublic = base64ToBytes(certificate.senderIdentityKey);
|
|
171
|
-
const expectedAuthTag = await computeAuthenticationTag(recipientIdentityPrivate, recipientIdentityPublic, senderIdentityPublic, ephemeralPublic, encryptedMessageKey, 'receiving');
|
|
172
|
-
if (!verifyAuthenticationTag(expectedAuthTag, receivedAuthTag)) {
|
|
173
|
-
throw new Error(GENERIC_ERROR);
|
|
174
|
-
}
|
|
175
|
-
// ========================================================================
|
|
176
|
-
// Step 8: Validate sender certificate
|
|
177
|
-
// ========================================================================
|
|
178
|
-
await validateSenderCertificate(certificate, trustRoots, currentTime);
|
|
179
|
-
// Self-send detection
|
|
180
|
-
if (certificate.senderUuid === recipientServiceId &&
|
|
181
|
-
certificate.senderDeviceId === recipientDeviceId) {
|
|
182
|
-
throw new Error(GENERIC_ERROR);
|
|
183
|
-
}
|
|
184
|
-
return {
|
|
185
|
-
senderCertificate: certificate,
|
|
186
|
-
signalProtocolMessage: bytesToBase64(message),
|
|
187
|
-
contentHint,
|
|
188
|
-
contentType,
|
|
189
|
-
};
|
|
190
|
-
}
|
|
191
|
-
finally {
|
|
192
|
-
// Security: Zero all sensitive key material
|
|
193
|
-
for (const arr of toZero) {
|
|
194
|
-
secureZeroBytes(arr);
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
//# sourceMappingURL=decryption-v2.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"decryption-v2.js","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/decryption-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EAEnC,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIlD,MAAM,aAAa,GAAG,mCAAmC,CAAC;AAE1D,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;GAEG;AACH,SAAS,aAAa,CAAC,QAAoB;IAMzC,sEAAsE;IACtE,IAAI,QAAQ,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,0BAA0B;IAC1B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnF,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,YAAY,CAAC;IAEvB,IAAI,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,yBAAyB;IACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC3D,MAAM,IAAI,OAAO,CAAC;IAElB,sBAAsB;IACtB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjF,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,WAAW,CAAC;IAEtB,IAAI,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACxD,MAAM,IAAI,MAAM,CAAC;IAEjB,0EAA0E;IAC1E,uDAAuD;IACvD,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAgB,CAAC;IACpD,MAAM,IAAI,CAAC,CAAC;IAEZ,2EAA2E;IAC3E,qEAAqE;IACrE,IAAI,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,0BAA0B;IAC1B,MAAM,WAAW,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAE5D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB;IAExB,MAAM,EACJ,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,GAAG,OAAO,CAAC;IAEZ,8CAA8C;IAC9C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,2EAA2E;IAC3E,uDAAuD;IACvD,2EAA2E;IAC3E,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IACtC,IACE,OAAO,KAAK,6BAA6B;QACzC,OAAO,KAAK,mCAAmC,EAC/C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,0BAA0B;IAC1B,MAAM,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,kBAAkB,IAAI,CAAC,CAAC,QAAQ,KAAK,iBAAiB,CAC9E,CAAC;IAEF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,aAAa,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QACrE,MAAM,mBAAmB,GAAG,aAAa,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;QAC3E,MAAM,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACrE,MAAM,iBAAiB,GAAG,aAAa,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QAEzE,IAAI,eAAe,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC;QAED,2EAA2E;QAC3E,2DAA2D;QAC3D,2EAA2E;QAC3E,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAC/B,wBAAwB,EACxB,eAAe,EACf,eAAe,EAAE,gEAAgE;QACjF,WAAW,EACX,mBAAmB,CACpB,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEf,2EAA2E;QAC3E,kDAAkD;QAClD,qFAAqF;QACrF,2EAA2E;QAC3E,MAAM,uBAAuB,GAAG,MAAM,2BAA2B,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAErC,MAAM,sBAAsB,GAAG,MAAM,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;QAE5E,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,sBAAsB,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC;QAED,2EAA2E;QAC3E,qCAAqC;QACrC,2EAA2E;QAC3E,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvB,2EAA2E;QAC3E,+EAA+E;QAC/E,2EAA2E;QAC3E,IAAI,QAAoB,CAAC;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC;QAED,2EAA2E;QAC3E,mDAAmD;QACnD,2EAA2E;QAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEnF,2EAA2E;QAC3E,iEAAiE;QACjE,0EAA0E;QAC1E,6DAA6D;QAC7D,2EAA2E;QAC3E,MAAM,oBAAoB,GAAG,aAAa,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAE1E,MAAM,eAAe,GAAG,MAAM,wBAAwB,CACpD,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,uBAAuB,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC;QAED,2EAA2E;QAC3E,sCAAsC;QACtC,2EAA2E;QAC3E,MAAM,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAEtE,sBAAsB;QACtB,IACE,WAAW,CAAC,UAAU,KAAK,kBAAkB;YAC7C,WAAW,CAAC,cAAc,KAAK,iBAAiB,EAChD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,iBAAiB,EAAE,WAAW;YAC9B,qBAAqB,EAAE,aAAa,CAAC,OAAO,CAAW;YACvD,WAAW;YACX,WAAW;SACZ,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,4CAA4C;QAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}
|
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Sealed Sender V2 Multi-Recipient Encryption
|
|
3
|
-
*
|
|
4
|
-
* Implements V2 multi-recipient sealed sender based on
|
|
5
|
-
* Barbosa & Farshim's randomness reuse technique (IMA 2007).
|
|
6
|
-
*
|
|
7
|
-
* Key efficiency gain: A single ephemeral key and message ciphertext
|
|
8
|
-
* is shared across all recipients, with per-recipient key encapsulation.
|
|
9
|
-
*
|
|
10
|
-
* Algorithm:
|
|
11
|
-
* 1. Generate random M (32 bytes)
|
|
12
|
-
* 2. Derive ephemeral keypair E from M via HKDF(LABEL_R)
|
|
13
|
-
* 3. Derive symmetric key K from M via HKDF(LABEL_K)
|
|
14
|
-
* 4. Encrypt USMC with AES-GCM-SIV(K, nonce=zeros, plaintext=usmc)
|
|
15
|
-
* 5. For each recipient i:
|
|
16
|
-
* a. ikm = X25519(E_private, recipient_pub[i]) || E_pub || recipient_pub[i]
|
|
17
|
-
* b. xor_key = HKDF(ikm, info=LABEL_DH)
|
|
18
|
-
* c. encrypted_key[i] = M XOR xor_key
|
|
19
|
-
* d. auth_ikm = X25519(sender_identity, recipient_pub[i]) || E_pub || encrypted_key[i] || sender_id_pub || recipient_pub[i]
|
|
20
|
-
* e. auth_tag[i] = HKDF(auth_ikm, info=LABEL_DH_S) (16 bytes)
|
|
21
|
-
* 6. Return { version, E_pub, recipients[], ciphertext }
|
|
22
|
-
*
|
|
23
|
-
*/
|
|
24
|
-
import type { SealMultiRecipientOptions, SealedSenderV2Message } from './types.js';
|
|
25
|
-
/** Generic error message for all seal failures */
|
|
26
|
-
export {};
|
|
27
|
-
/**
|
|
28
|
-
* Seal a Signal Protocol message for multiple recipients using V2 format.
|
|
29
|
-
*
|
|
30
|
-
* Uses randomness reuse (Barbosa & Farshim 2007) for efficiency:
|
|
31
|
-
* - Single ephemeral key shared across all recipients
|
|
32
|
-
* - Single message ciphertext shared across all recipients
|
|
33
|
-
* - Per-recipient key encapsulation via XOR with HKDF-derived key
|
|
34
|
-
* - Per-recipient auth tag using identity-to-identity ECDH
|
|
35
|
-
*
|
|
36
|
-
* @param options Multi-recipient sealing options
|
|
37
|
-
* @returns V2 sealed sender message
|
|
38
|
-
* @throws Error (generic) if any validation fails
|
|
39
|
-
*
|
|
40
|
-
* @example
|
|
41
|
-
* ```typescript
|
|
42
|
-
* const sealed = await sealMultiRecipient({
|
|
43
|
-
* senderCertificate: cert,
|
|
44
|
-
* senderIdentityPrivate: myPrivateKey,
|
|
45
|
-
* senderIdentityPublic: myPublicKey,
|
|
46
|
-
* recipients: [
|
|
47
|
-
* { serviceId: 'user1', deviceId: 1, registrationId: 12345, identityPublic: user1Pub },
|
|
48
|
-
* { serviceId: 'user2', deviceId: 1, registrationId: 23456, identityPublic: user2Pub },
|
|
49
|
-
* ],
|
|
50
|
-
* signalProtocolMessage: encryptedMessage,
|
|
51
|
-
* });
|
|
52
|
-
* ```
|
|
53
|
-
*/
|
|
54
|
-
export declare function sealMultiRecipient(options: SealMultiRecipientOptions): Promise<SealedSenderV2Message>;
|
|
55
|
-
export { deriveEphemeralFromM, deriveCipherKeyFromM, applyAgreementXor, computeAuthenticationTag, } from './v2-helpers.js';
|
|
56
|
-
//# sourceMappingURL=encryption-v2.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"encryption-v2.d.ts","sourceRoot":"","sources":["../../../../internal/protocol/sealed-sender/encryption-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAuBjB,kDAAkD;AAClD,OAAO,EAAE,CAAC;AAkCV;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CA0HhC;AAGD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}
|