This repository has been archived on 2022-08-19. You can view files and clone it, but cannot push or open issues or pull requests.
hydrogen-web/src/matrix/e2ee
Bruno Windels f16c08f13e remove room from all user identities when leaving
and delete identity as well as all device identities if no rooms left
2021-05-06 15:24:52 +02:00
..
megolm WIP to add logging to decryption and fetching key backups 2021-03-15 14:39:42 +01:00
olm oops, missing await to store new olm sessions! 2021-03-08 16:19:28 +01:00
Account.js on fill server OTKs up to max/2 2021-03-09 12:33:31 +01:00
attachment.js move base64/58 encoding into platform 2021-02-12 16:01:54 +01:00
common.js createEnum does not take an array 2020-09-18 13:08:35 +02:00
DecryptionResult.js make decryption algorithms return DecryptionResult 2020-09-08 10:48:11 +02:00
DeviceTracker.js remove room from all user identities when leaving 2021-05-06 15:24:52 +02:00
OlmWorker.js provide random value for IE11 2020-11-10 18:31:18 +01:00
README.md WIP to store missing session event ids 2021-03-03 14:03:50 +01:00
RoomEncryption.js remove room from all user identities when leaving 2021-05-06 15:24:52 +02:00

Integratation within the sync lifetime cycle

session.prepareSync

Decrypt any device messages, and turn them into RoomKey instances. Any rooms that are not in the sync response but for which we receive keys will be included in the rooms to sync.

Runs before any room.prepareSync, so the new room keys can be passed to each room prepareSync to use in decryption.

room.prepareSync

The session can start its own read/write transactions here, rooms only read from a shared transaction

- rooms (with shared read txn)
    - megolm decryption read using any new keys decrypted by the session.

room.afterPrepareSync

- rooms    
    - megolm async decryption   
        - dispatch to worker

room.writeSync

- rooms (with shared readwrite txn)
    - megolm decryption write, yielding decrypted events
    - use decrypted events to write room summary

session.writeSync

  • writes any room keys that were received

room.afterSync

- rooms
    - emit changes

room.afterSyncCompleted

- session
    - e2ee account
        - generate more otks if needed
        - upload new otks if needed or device keys if not uploaded before
- rooms
    - share new room keys if needed