status-go/protocol/encryption
Patryk Osmaczko 1d3c618fb4 feat: encrypt `CommunityDescription` fields
Extended `CommunityDescription` with a `privateData` map. This map
associates each hash ratchet `key_id` and `seq_no` with an encrypted
`CommunityDescription`. Each encrypted instance includes only data
requiring encryption.

closes: status-im/status-desktop#12851
closes: status-im/status-desktop#12852
closes: status-im/status-desktop#12853
2023-12-22 18:17:06 +01:00
..
github.com/protocol/encryption feat: display name 2022-03-14 13:48:34 -04:00
migrations
multidevice
publisher
sharedsecret
README.md
encryption_multi_device_test.go
encryption_test.go
encryptor.go feat: encrypt `CommunityDescription` fields 2023-12-22 18:17:06 +01:00
helpers.go
persistence.go feat: encrypt `CommunityDescription` fields 2023-12-22 18:17:06 +01:00
persistence_keys_storage_test.go
persistence_test.go feat: encrypt `CommunityDescription` fields 2023-12-22 18:17:06 +01:00
protocol.go feat: encrypt `CommunityDescription` fields 2023-12-22 18:17:06 +01:00
protocol_message.pb.go
protocol_message.proto
protocol_test.go
x3dh.go
x3dh_test.go

README.md

protocol/encryption package

Hash ratchet encryption

encryptor.GenerateHashRatchetKey() generates a hash ratchet key and stores it in in the DB. There, 2 new tables are created: hash_ratchet_encryption and hash_ratchet_encryption_cache. Each hash ratchet key is uniquely identified by the (groupId, keyId) pair, where keyId is derived from a clock value.

protocol.BuildHashRatchetKeyExchangeMessage builds an 1-on-1 message containing the hash ratchet key, given it's ID.

protocol.BuildHashRatchetMessage builds a hash ratchet message with arbitrary payload, given groupId. It will use the latest hash ratchet key available. encryptor.encryptWithHR encrypts the payload using Hash Ratchet algorithms. Intermediate hashes are stored in hash_ratchet_encryption_cache table.

protocol.HandleMessage uses encryptor.decryptWithHR fn for decryption.