Interface CryptoStore

Abstraction of things that can store data required for end-to-end encryption

Hierarchy

CryptoStore

Implemented by

Index

Methods

Methods

addEndToEndInboundGroupSession

addEndToEndInboundGroupSession(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: InboundGroupSessionData
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:160

addParkedSharedHistory

addParkedSharedHistory(roomId, data, txn?): void
Parameters
- roomId: string
- data: ParkedSharedHistory
- Optional txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:217

addSharedHistoryInboundGroupSession

addSharedHistoryInboundGroupSession(roomId, senderKey, sessionId, txn?): void
Parameters
- roomId: string
- senderKey: string
- sessionId: string
- Optional txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:212

containsData

containsData(): Promise<boolean>
Internal
Returns true if this CryptoStore has ever been initialised (ie, it might contain data).

Unlike the rest of the methods in this interface, can be called before startup.

Returns Promise<boolean>
- Defined in src/crypto/store/base.ts:56

countEndToEndInboundGroupSessions

countEndToEndInboundGroupSessions(): Promise<number>
Internal
Count the number of Megolm sessions in the database.

Returns Promise<number>
- Defined in src/crypto/store/base.ts:184

countEndToEndSessions

countEndToEndSessions(txn, func): void
Parameters
- txn: unknown
- func: ((count) => void)
  - - (count): void
    - Parameters
      
      count: number
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:117

countSessionsNeedingBackup

countSessionsNeedingBackup(txn?): Promise<number>
Parameters
- Optional txn: unknown
Returns Promise<number>
- Defined in src/crypto/store/base.ts:209

deleteAllData

deleteAllData(): Promise<void>
Returns Promise<void>
- Defined in src/crypto/store/base.ts:68

deleteEndToEndInboundGroupSessionsBatch

deleteEndToEndInboundGroupSessionsBatch(sessions): Promise<void>
Internal
Delete a batch of Megolm sessions from the database.

Any sessions in the list which are not found are silently ignored.
Parameters
- sessions: {
  senderKey: string;
  sessionId: string;
  }[]
Returns Promise<void>
- Defined in src/crypto/store/base.ts:201

deleteEndToEndSessionsBatch

deleteEndToEndSessionsBatch(sessions): Promise<void>
Internal
Delete a batch of end-to-end sessions from the database.

Any sessions in the list which are not found are silently ignored.
Parameters
- sessions: {
  deviceKey?: string;
  sessionId?: string;
  }[]
Returns Promise<void>
- Defined in src/crypto/store/base.ts:150

deleteOutgoingRoomKeyRequest

deleteOutgoingRoomKeyRequest(requestId, expectedState): Promise<null | OutgoingRoomKeyRequest>
Parameters
- requestId: string
- expectedState: number
Returns Promise<null | OutgoingRoomKeyRequest>
- Defined in src/crypto/store/base.ts:98

doTxn

doTxn<T>(mode, stores, func, log?): Promise<T>
Type Parameters
- T
Parameters
- mode: Mode
- stores: Iterable<string>
- func: ((txn) => T)
  - - (txn): T
    - Parameters
      
      txn: unknown
      
      Returns T
- Optional log: Logger
Returns Promise<T>
- Defined in src/crypto/store/base.ts:221

filterOutNotifiedErrorDevices

filterOutNotifiedErrorDevices(devices): Promise<IOlmDevice<DeviceInfo>[]>
Parameters
- devices: IOlmDevice<DeviceInfo>[]
Returns Promise<IOlmDevice<DeviceInfo>[]>
- Defined in src/crypto/store/base.ts:133

getAccount

getAccount(txn, func): void
Parameters
- txn: unknown
- func: ((accountPickle) => void)
  - - (accountPickle): void
    - Parameters
      
      accountPickle: null | string
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:101

getAllEndToEndInboundGroupSessions

getAllEndToEndInboundGroupSessions(txn, func): void
Parameters
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: null | ISession
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:159

getAllEndToEndSessions

getAllEndToEndSessions(txn, func): void
Parameters
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: null | ISessionInfo
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:129

getAllOutgoingRoomKeyRequestsByState

getAllOutgoingRoomKeyRequestsByState(wantedState): Promise<OutgoingRoomKeyRequest[]>
Parameters
- wantedState: number
Returns Promise<OutgoingRoomKeyRequest[]>
- Defined in src/crypto/store/base.ts:87

getCrossSigningKeys

getCrossSigningKeys(txn, func): void
Parameters
- txn: unknown
- func: ((keys) => void)
  - - (keys): void
    - Parameters
      
      keys: null | Record<string, CrossSigningKeyInfo>
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:103

getEndToEndDeviceData

getEndToEndDeviceData(txn, func): void
Parameters
- txn: unknown
- func: ((deviceData) => void)
  - - (deviceData): void
    - Parameters
      
      deviceData: null | IDeviceData
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:204

getEndToEndInboundGroupSession

getEndToEndInboundGroupSession(senderCurve25519Key, sessionId, txn, func): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- txn: unknown
- func: ((groupSession, groupSessionWithheld) => void)
  - - (groupSession, groupSessionWithheld): void
    - Parameters
      
      groupSession: null | InboundGroupSessionData
      
      groupSessionWithheld: null | IWithheld
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:153

getEndToEndInboundGroupSessionsBatch

getEndToEndInboundGroupSessionsBatch(): Promise<null | SessionExtended[]>
Internal
Get a batch of Megolm sessions from the database.

Returns Promise<null | SessionExtended[]>
A batch of Megolm Sessions, or null if no sessions are left.
- Defined in src/crypto/store/base.ts:192

getEndToEndRooms

getEndToEndRooms(txn, func): void
Parameters
- txn: unknown
- func: ((rooms) => void)
  - - (rooms): void
    - Parameters
      
      rooms: Record<string, IRoomEncryption>
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:207

getEndToEndSession

getEndToEndSession(deviceKey, sessionId, txn, func): void
Parameters
- deviceKey: string
- sessionId: string
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: null | ISessionInfo
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:118

getEndToEndSessionProblem

getEndToEndSessionProblem(deviceKey, timestamp): Promise<null | IProblem>
Parameters
- deviceKey: string
- timestamp: number
Returns Promise<null | IProblem>
- Defined in src/crypto/store/base.ts:132

getEndToEndSessions

getEndToEndSessions(deviceKey, txn, func): void
Parameters
- deviceKey: string
- txn: unknown
- func: ((sessions) => void)
  - - (sessions): void
    - Parameters
      
      sessions: {
      [sessionId: string]: ISessionInfo;
      }
      
      [sessionId: string]: ISessionInfo
      
      Returns void
Returns void
- Defined in src/crypto/store/base.ts:124

getEndToEndSessionsBatch

getEndToEndSessionsBatch(): Promise<null | ISessionInfo[]>
Internal
Get a batch of end-to-end sessions from the database.

Returns Promise<null | ISessionInfo[]>
A batch of Olm Sessions, or null if no sessions are left.
- Defined in src/crypto/store/base.ts:141

getMigrationState

getMigrationState(): Promise<MigrationState>
Internal
Get data on how much of the libolm to Rust Crypto migration has been done.

Returns Promise<MigrationState>
- Defined in src/crypto/store/base.ts:75

getOrAddOutgoingRoomKeyRequest

getOrAddOutgoingRoomKeyRequest(request): Promise<OutgoingRoomKeyRequest>
Parameters
- request: OutgoingRoomKeyRequest
Returns Promise<OutgoingRoomKeyRequest>
- Defined in src/crypto/store/base.ts:84

getOutgoingRoomKeyRequest

getOutgoingRoomKeyRequest(requestBody): Promise<null | OutgoingRoomKeyRequest>
Parameters
- requestBody: IRoomKeyRequestBody
Returns Promise<null | OutgoingRoomKeyRequest>
- Defined in src/crypto/store/base.ts:85

getOutgoingRoomKeyRequestByState

getOutgoingRoomKeyRequestByState(wantedStates): Promise<null | OutgoingRoomKeyRequest>
Parameters
- wantedStates: number[]
Returns Promise<null | OutgoingRoomKeyRequest>
- Defined in src/crypto/store/base.ts:86

getOutgoingRoomKeyRequestsByTarget

getOutgoingRoomKeyRequestsByTarget(userId, deviceId, wantedStates): Promise<OutgoingRoomKeyRequest[]>
Parameters
- userId: string
- deviceId: string
- wantedStates: number[]
Returns Promise<OutgoingRoomKeyRequest[]>
- Defined in src/crypto/store/base.ts:88

getSecretStorePrivateKey

getSecretStorePrivateKey<K>(txn, func, type): void
Type Parameters
- K extends keyof SecretStorePrivateKeys
Parameters
- txn: unknown
- func: ((key) => void)
  - - (key): void
    - Parameters
      
      key: null | SecretStorePrivateKeys[K]
      
      Returns void
- type: K
Returns void
- Defined in src/crypto/store/base.ts:104

getSessionsNeedingBackup

getSessionsNeedingBackup(limit): Promise<ISession[]>
Parameters
- limit: number
Returns Promise<ISession[]>
- Defined in src/crypto/store/base.ts:208

getSharedHistoryInboundGroupSessions

getSharedHistoryInboundGroupSessions(roomId, txn?): Promise<[senderKey: string, sessionId: string][]>
Parameters
- roomId: string
- Optional txn: unknown
Returns Promise<[senderKey: string, sessionId: string][]>
- Defined in src/crypto/store/base.ts:213

markSessionsNeedingBackup

markSessionsNeedingBackup(sessions, txn?): Promise<void>
Parameters
- sessions: ISession[]
- Optional txn: unknown
Returns Promise<void>
- Defined in src/crypto/store/base.ts:211

setMigrationState

setMigrationState(migrationState): Promise<void>
Internal
Set data on how much of the libolm to Rust Crypto migration has been done.
Parameters
- migrationState: MigrationState
Returns Promise<void>
- Defined in src/crypto/store/base.ts:82

startup

startup(): Promise<CryptoStore>
Initialise this crypto store.

Typically, this involves provisioning storage, and migrating any existing data to the current version of the storage schema where appropriate.

Must be called before any of the rest of the methods in this interface.

Returns Promise<CryptoStore>
- Defined in src/crypto/store/base.ts:66

storeAccount

storeAccount(txn, accountPickle): void
Parameters
- txn: unknown
- accountPickle: string
Returns void
- Defined in src/crypto/store/base.ts:102

storeCrossSigningKeys

storeCrossSigningKeys(txn, keys): void
Parameters
- txn: unknown
- keys: Record<string, CrossSigningKeyInfo>
Returns void
- Defined in src/crypto/store/base.ts:109

storeEndToEndDeviceData

storeEndToEndDeviceData(deviceData, txn): void
Parameters
- deviceData: IDeviceData
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:205

storeEndToEndInboundGroupSession

storeEndToEndInboundGroupSession(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: InboundGroupSessionData
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:166

storeEndToEndInboundGroupSessionWithheld

storeEndToEndInboundGroupSessionWithheld(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: IWithheld
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:172

storeEndToEndRoom

storeEndToEndRoom(roomId, roomInfo, txn): void
Parameters
- roomId: string
- roomInfo: IRoomEncryption
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:206

storeEndToEndSession

storeEndToEndSession(deviceKey, sessionId, sessionInfo, txn): void
Parameters
- deviceKey: string
- sessionId: string
- sessionInfo: ISessionInfo
- txn: unknown
Returns void
- Defined in src/crypto/store/base.ts:130

storeEndToEndSessionProblem

storeEndToEndSessionProblem(deviceKey, type, fixed): Promise<void>
Parameters
- deviceKey: string
- type: string
- fixed: boolean
Returns Promise<void>
- Defined in src/crypto/store/base.ts:131

storeSecretStorePrivateKey

storeSecretStorePrivateKey<K>(txn, type, key): void
Type Parameters
- K extends keyof SecretStorePrivateKeys
Parameters
- txn: unknown
- type: K
- key: SecretStorePrivateKeys[K]
Returns void
- Defined in src/crypto/store/base.ts:110

takeParkedSharedHistory

takeParkedSharedHistory(roomId, txn?): Promise<ParkedSharedHistory[]>
Parameters
- roomId: string
- Optional txn: unknown
Returns Promise<ParkedSharedHistory[]>
- Defined in src/crypto/store/base.ts:218

unmarkSessionsNeedingBackup

unmarkSessionsNeedingBackup(sessions, txn?): Promise<void>
Parameters
- sessions: ISession[]
- Optional txn: unknown
Returns Promise<void>
- Defined in src/crypto/store/base.ts:210

updateOutgoingRoomKeyRequest

updateOutgoingRoomKeyRequest(requestId, expectedState, updates): Promise<null | OutgoingRoomKeyRequest>
Parameters
- requestId: string
- expectedState: number
- updates: Partial<OutgoingRoomKeyRequest>
Returns Promise<null | OutgoingRoomKeyRequest>
- Defined in src/crypto/store/base.ts:93

Interface CryptoStore

Hierarchy

Implemented by

Index

Methods

Methods

addEndToEndInboundGroupSession

Parameters

senderCurve25519Key: string

sessionId: string

sessionData: InboundGroupSessionData

txn: unknown

Returns void

addParkedSharedHistory

Parameters

roomId: string

data: ParkedSharedHistory

Optional txn: unknown

Returns void

addSharedHistoryInboundGroupSession

Parameters

roomId: string

senderKey: string

sessionId: string

Optional txn: unknown

Returns void

containsData

Returns Promise<boolean>

countEndToEndInboundGroupSessions

Returns Promise<number>

countEndToEndSessions

Parameters

txn: unknown

func: ((count) => void)

Parameters

count: number

Returns void

Returns void

countSessionsNeedingBackup

Parameters

Optional txn: unknown

Returns Promise<number>

deleteAllData

Returns Promise<void>

deleteEndToEndInboundGroupSessionsBatch

Parameters

sessions: { senderKey: string; sessionId: string; }[]

Returns Promise<void>

deleteEndToEndSessionsBatch

Parameters

sessions: { deviceKey?: string; sessionId?: string; }[]

Returns Promise<void>

deleteOutgoingRoomKeyRequest

Parameters

requestId: string

expectedState: number

Returns Promise<null | OutgoingRoomKeyRequest>

doTxn

Type Parameters

T

Parameters

mode: Mode

stores: Iterable<string>

func: ((txn) => T)

Parameters

txn: unknown

Returns T

Optional log: Logger

Returns Promise<T>

filterOutNotifiedErrorDevices

Parameters

devices: IOlmDevice<DeviceInfo>[]

Returns Promise<IOlmDevice<DeviceInfo>[]>

getAccount

Parameters

txn: unknown

func: ((accountPickle) => void)

Parameters

accountPickle: null | string

Returns void

`Optional` txn: unknown

`Optional` txn: unknown

`Optional` txn: unknown

sessions: {
senderKey: string;
sessionId: string;
}[]

sessions: {
deviceKey?: string;
sessionId?: string;
}[]

`Optional` log: Logger