Class MemoryCryptoStore

Internal module. in-memory storage for e2e.

Hierarchy

MemoryCryptoStore

Implements

CryptoStore

Index

Constructors

constructor

new MemoryCryptoStore(): MemoryCryptoStore
Returns MemoryCryptoStore

Properties

`Private` account

account: null | string = null

`Private` crossSigningKeys

crossSigningKeys: null | Record<string, ICrossSigningKey> = null

`Private` deviceData

deviceData: null | IDeviceData = null

`Private` inboundGroupSessions

inboundGroupSessions: {
[sessionKey: string]: InboundGroupSessionData;
} = {}

Type declaration

[sessionKey: string]: InboundGroupSessionData

`Private` inboundGroupSessionsWithheld

inboundGroupSessionsWithheld: Record<string, IWithheld> = {}

`Private` notifiedErrorDevices

notifiedErrorDevices: {
    [userId: string]: {
        [deviceId: string]: boolean;
    };
} = {}

Type declaration

[userId: string]: {
[deviceId: string]: boolean;
}
- [deviceId: string]: boolean

`Private` outgoingRoomKeyRequests

outgoingRoomKeyRequests: OutgoingRoomKeyRequest[] = []

`Private` parkedSharedHistory

parkedSharedHistory: Map<string, ParkedSharedHistory[]> = ...

`Private` privateKeys

privateKeys: Partial<SecretStorePrivateKeys> = {}

`Private` rooms

rooms: {
[roomId: string]: IRoomEncryption;
} = {}

Type declaration

[roomId: string]: IRoomEncryption

`Private` sessionProblems

sessionProblems: {
[deviceKey: string]: IProblem[];
} = {}

Type declaration

[deviceKey: string]: IProblem[]

`Private` sessions

sessions: {
    [deviceKey: string]: {
        [sessionId: string]: ISessionInfo;
    };
} = {}

Type declaration

[deviceKey: string]: {
[sessionId: string]: ISessionInfo;
}
- [sessionId: string]: ISessionInfo

`Private` sessionsNeedingBackup

sessionsNeedingBackup: {
[sessionKey: string]: boolean;
} = {}

Type declaration

[sessionKey: string]: boolean

`Private` sharedHistoryInboundGroupSessions

sharedHistoryInboundGroupSessions: {
[roomId: string]: [senderKey: string, sessionId: string][];
} = {}

Type declaration

[roomId: string]: [senderKey: string, sessionId: string][]

Methods

`Private` _getOutgoingRoomKeyRequest

_getOutgoingRoomKeyRequest(requestBody): null | OutgoingRoomKeyRequest
Internal
Looks for existing room key request, and returns the result synchronously.
Parameters
- requestBody: IRoomKeyRequestBody
  
  existing request to look for
Returns null | OutgoingRoomKeyRequest
the matching request, or null if not found
- Defined in src/crypto/store/memory-crypto-store.ts:138

addEndToEndInboundGroupSession

addEndToEndInboundGroupSession(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: InboundGroupSessionData
- txn: unknown
Returns void
Implementation of CryptoStore.addEndToEndInboundGroupSession
- Defined in src/crypto/store/memory-crypto-store.ts:417

addParkedSharedHistory

addParkedSharedHistory(roomId, parkedData): void
Parameters
- roomId: string
- parkedData: ParkedSharedHistory
Returns void
Implementation of CryptoStore.addParkedSharedHistory
- Defined in src/crypto/store/memory-crypto-store.ts:515

addSharedHistoryInboundGroupSession

addSharedHistoryInboundGroupSession(roomId, senderKey, sessionId): void
Parameters
- roomId: string
- senderKey: string
- sessionId: string
Returns void
Implementation of CryptoStore.addSharedHistoryInboundGroupSession
- Defined in src/crypto/store/memory-crypto-store.ts:505

countEndToEndSessions

countEndToEndSessions(txn, func): void
Parameters
- txn: unknown
- func: ((count) => void)
  - - (count): void
    - Parameters
      
      count: number
      
      Returns void
Returns void
Implementation of CryptoStore.countEndToEndSessions
- Defined in src/crypto/store/memory-crypto-store.ts:300

countSessionsNeedingBackup

countSessionsNeedingBackup(): Promise<number>
Returns Promise<number>
Implementation of CryptoStore.countSessionsNeedingBackup
- Defined in src/crypto/store/memory-crypto-store.ts:485

deleteAllData

deleteAllData(): Promise<void>
Delete all data from this store.

Returns Promise<void>
Promise which resolves when the store has been cleared.
Implementation of CryptoStore.deleteAllData
- Defined in src/crypto/store/memory-crypto-store.ts:76

deleteOutgoingRoomKeyRequest

deleteOutgoingRoomKeyRequest(requestId, expectedState): Promise<null | OutgoingRoomKeyRequest>
Look for an existing room key request by id and state, and delete it if found
Parameters
- requestId: string
  
  ID of request to update
- expectedState: number
  
  state we expect to find the request in
Returns Promise<null | OutgoingRoomKeyRequest>
resolves once the operation is completed
Implementation of CryptoStore.deleteOutgoingRoomKeyRequest
- Defined in src/crypto/store/memory-crypto-store.ts:240

doTxn

doTxn<T>(mode, stores, func): Promise<T>
Type Parameters
- T
Parameters
- mode: Mode
- stores: Iterable<string>
- func: ((txn?) => T)
  - - (txn?): T
    - Parameters
      
      Optional txn: unknown
      
      Returns T
Returns Promise<T>
Implementation of CryptoStore.doTxn
- Defined in src/crypto/store/memory-crypto-store.ts:529

filterOutNotifiedErrorDevices

filterOutNotifiedErrorDevices(devices): Promise<IOlmDevice<DeviceInfo>[]>
Parameters
- devices: IOlmDevice<DeviceInfo>[]
Returns Promise<IOlmDevice<DeviceInfo>[]>
Implementation of CryptoStore.filterOutNotifiedErrorDevices
- Defined in src/crypto/store/memory-crypto-store.ts:369

getAccount

getAccount(txn, func): void
Parameters
- txn: unknown
- func: ((accountPickle) => void)
  - - (accountPickle): void
    - Parameters
      
      accountPickle: null | string
      
      Returns void
Returns void
Implementation of CryptoStore.getAccount
- Defined in src/crypto/store/memory-crypto-store.ts:265

getAllEndToEndInboundGroupSessions

getAllEndToEndInboundGroupSessions(txn, func): void
Parameters
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: null | ISession
      
      Returns void
Returns void
Implementation of CryptoStore.getAllEndToEndInboundGroupSessions
- Defined in src/crypto/store/memory-crypto-store.ts:401

getAllEndToEndSessions

getAllEndToEndSessions(txn, func): void
Parameters
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: ISessionInfo
      
      Returns void
Returns void
Implementation of CryptoStore.getAllEndToEndSessions
- Defined in src/crypto/store/memory-crypto-store.ts:322

getAllOutgoingRoomKeyRequestsByState

getAllOutgoingRoomKeyRequestsByState(wantedState): Promise<OutgoingRoomKeyRequest[]>
Parameters
- wantedState: number
Returns Promise<OutgoingRoomKeyRequest[]>
All OutgoingRoomKeyRequests in state
Implementation of CryptoStore.getAllOutgoingRoomKeyRequestsByState
- Defined in src/crypto/store/memory-crypto-store.ts:171

getCrossSigningKeys

getCrossSigningKeys(txn, func): void
Parameters
- txn: unknown
- func: ((keys) => void)
  - - (keys): void
    - Parameters
      
      keys: null | Record<string, ICrossSigningKey>
      
      Returns void
Returns void
Implementation of CryptoStore.getCrossSigningKeys
- Defined in src/crypto/store/memory-crypto-store.ts:273

getEndToEndDeviceData

getEndToEndDeviceData(txn, func): void
Parameters
- txn: unknown
- func: ((deviceData) => void)
  - - (deviceData): void
    - Parameters
      
      deviceData: null | IDeviceData
      
      Returns void
Returns void
Implementation of CryptoStore.getEndToEndDeviceData
- Defined in src/crypto/store/memory-crypto-store.ts:450

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
Implementation of CryptoStore.getEndToEndInboundGroupSession
- Defined in src/crypto/store/memory-crypto-store.ts:391

getEndToEndRooms

getEndToEndRooms(txn, func): void
Parameters
- txn: unknown
- func: ((rooms) => void)
  - - (rooms): void
    - Parameters
      
      rooms: Record<string, IRoomEncryption>
      
      Returns void
Returns void
Implementation of CryptoStore.getEndToEndRooms
- Defined in src/crypto/store/memory-crypto-store.ts:464

getEndToEndSession

getEndToEndSession(deviceKey, sessionId, txn, func): void
Parameters
- deviceKey: string
- sessionId: string
- txn: unknown
- func: ((session) => void)
  - - (session): void
    - Parameters
      
      session: ISessionInfo
      
      Returns void
Returns void
Implementation of CryptoStore.getEndToEndSession
- Defined in src/crypto/store/memory-crypto-store.ts:304

getEndToEndSessionProblem

getEndToEndSessionProblem(deviceKey, timestamp): Promise<null | IProblem>
Parameters
- deviceKey: string
- timestamp: number
Returns Promise<null | IProblem>
Implementation of CryptoStore.getEndToEndSessionProblem
- Defined in src/crypto/store/memory-crypto-store.ts:351

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
Implementation of CryptoStore.getEndToEndSessions
- Defined in src/crypto/store/memory-crypto-store.ts:314

getOrAddOutgoingRoomKeyRequest

getOrAddOutgoingRoomKeyRequest(request): Promise<OutgoingRoomKeyRequest>
Look for an existing outgoing room key request, and if none is found, add a new one
Parameters
- request: OutgoingRoomKeyRequest
Returns Promise<OutgoingRoomKeyRequest>
resolves to OutgoingRoomKeyRequest: either the same instance as passed in, or the existing one.
Implementation of CryptoStore.getOrAddOutgoingRoomKeyRequest
- Defined in src/crypto/store/memory-crypto-store.ts:89

getOutgoingRoomKeyRequest

getOutgoingRoomKeyRequest(requestBody): Promise<null | OutgoingRoomKeyRequest>
Look for an existing room key request
Parameters
- requestBody: IRoomKeyRequestBody
  
  existing request to look for
Returns Promise<null | OutgoingRoomKeyRequest>
resolves to the matching OutgoingRoomKeyRequest, or null if not found
Implementation of CryptoStore.getOutgoingRoomKeyRequest
- Defined in src/crypto/store/memory-crypto-store.ts:123

getOutgoingRoomKeyRequestByState

getOutgoingRoomKeyRequestByState(wantedStates): Promise<null | OutgoingRoomKeyRequest>
Look for room key requests by state
Parameters
- wantedStates: number[]
  
  list of acceptable states
Returns Promise<null | OutgoingRoomKeyRequest>
resolves to the a OutgoingRoomKeyRequest, or null if there are no pending requests in those states
Implementation of CryptoStore.getOutgoingRoomKeyRequestByState
- Defined in src/crypto/store/memory-crypto-store.ts:156

getOutgoingRoomKeyRequestsByTarget

getOutgoingRoomKeyRequestsByTarget(userId, deviceId, wantedStates): Promise<OutgoingRoomKeyRequest[]>
Parameters
- userId: string
- deviceId: string
- wantedStates: number[]
Returns Promise<OutgoingRoomKeyRequest[]>
Implementation of CryptoStore.getOutgoingRoomKeyRequestsByTarget
- Defined in src/crypto/store/memory-crypto-store.ts:175

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
Implementation of CryptoStore.getSecretStorePrivateKey
- Defined in src/crypto/store/memory-crypto-store.ts:277

getSessionsNeedingBackup

getSessionsNeedingBackup(limit): Promise<ISession[]>
Parameters
- limit: number
Returns Promise<ISession[]>
Implementation of CryptoStore.getSessionsNeedingBackup
- Defined in src/crypto/store/memory-crypto-store.ts:468

getSharedHistoryInboundGroupSessions

getSharedHistoryInboundGroupSessions(roomId): Promise<[senderKey: string, sessionId: string][]>
Parameters
- roomId: string
Returns Promise<[senderKey: string, sessionId: string][]>
Implementation of CryptoStore.getSharedHistoryInboundGroupSessions
- Defined in src/crypto/store/memory-crypto-store.ts:511

markSessionsNeedingBackup

markSessionsNeedingBackup(sessions): Promise<void>
Parameters
- sessions: ISession[]
Returns Promise<void>
Implementation of CryptoStore.markSessionsNeedingBackup
- Defined in src/crypto/store/memory-crypto-store.ts:497

startup

startup(): Promise<CryptoStore>
Ensure the database exists and is up-to-date.

This must be called before the store can be used.

Returns Promise<CryptoStore>
resolves to the store.
Implementation of CryptoStore.startup
- Defined in src/crypto/store/memory-crypto-store.ts:66

storeAccount

storeAccount(txn, accountPickle): void
Parameters
- txn: unknown
- accountPickle: string
Returns void
Implementation of CryptoStore.storeAccount
- Defined in src/crypto/store/memory-crypto-store.ts:269

storeCrossSigningKeys

storeCrossSigningKeys(txn, keys): void
Parameters
- txn: unknown
- keys: Record<string, ICrossSigningKey>
Returns void
Implementation of CryptoStore.storeCrossSigningKeys
- Defined in src/crypto/store/memory-crypto-store.ts:286

storeEndToEndDeviceData

storeEndToEndDeviceData(deviceData, txn): void
Parameters
- deviceData: IDeviceData
- txn: unknown
Returns void
Implementation of CryptoStore.storeEndToEndDeviceData
- Defined in src/crypto/store/memory-crypto-store.ts:454

storeEndToEndInboundGroupSession

storeEndToEndInboundGroupSession(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: InboundGroupSessionData
- txn: unknown
Returns void
Implementation of CryptoStore.storeEndToEndInboundGroupSession
- Defined in src/crypto/store/memory-crypto-store.ts:429

storeEndToEndInboundGroupSessionWithheld

storeEndToEndInboundGroupSessionWithheld(senderCurve25519Key, sessionId, sessionData, txn): void
Parameters
- senderCurve25519Key: string
- sessionId: string
- sessionData: IWithheld
- txn: unknown
Returns void
Implementation of CryptoStore.storeEndToEndInboundGroupSessionWithheld
- Defined in src/crypto/store/memory-crypto-store.ts:438

storeEndToEndRoom

storeEndToEndRoom(roomId, roomInfo, txn): void
Parameters
- roomId: string
- roomInfo: IRoomEncryption
- txn: unknown
Returns void
Implementation of CryptoStore.storeEndToEndRoom
- Defined in src/crypto/store/memory-crypto-store.ts:460

storeEndToEndSession

storeEndToEndSession(deviceKey, sessionId, sessionInfo, txn): void
Parameters
- deviceKey: string
- sessionId: string
- sessionInfo: ISessionInfo
- txn: unknown
Returns void
Implementation of CryptoStore.storeEndToEndSession
- Defined in src/crypto/store/memory-crypto-store.ts:334

storeEndToEndSessionProblem

storeEndToEndSessionProblem(deviceKey, type, fixed): Promise<void>
Parameters
- deviceKey: string
- type: string
- fixed: boolean
Returns Promise<void>
Implementation of CryptoStore.storeEndToEndSessionProblem
- Defined in src/crypto/store/memory-crypto-store.ts:343

storeSecretStorePrivateKey

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

takeParkedSharedHistory

takeParkedSharedHistory(roomId): Promise<ParkedSharedHistory[]>
Parameters
- roomId: string
Returns Promise<ParkedSharedHistory[]>
Implementation of CryptoStore.takeParkedSharedHistory
- Defined in src/crypto/store/memory-crypto-store.ts:521

unmarkSessionsNeedingBackup

unmarkSessionsNeedingBackup(sessions): Promise<void>
Parameters
- sessions: ISession[]
Returns Promise<void>
Implementation of CryptoStore.unmarkSessionsNeedingBackup
- Defined in src/crypto/store/memory-crypto-store.ts:489

updateOutgoingRoomKeyRequest

updateOutgoingRoomKeyRequest(requestId, expectedState, updates): Promise<null | OutgoingRoomKeyRequest>
Look for an existing room key request by id and state, and update it if found
Parameters
- requestId: string
  
  ID of request to update
- expectedState: number
  
  state we expect to find the request in
- updates: Partial<OutgoingRoomKeyRequest>
  
  name/value map of updates to apply
Returns Promise<null | OutgoingRoomKeyRequest>
resolves to OutgoingRoomKeyRequest updated request, or null if no matching row was found
Implementation of CryptoStore.updateOutgoingRoomKeyRequest
- Defined in src/crypto/store/memory-crypto-store.ts:207

Class MemoryCryptoStore

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Returns MemoryCryptoStore

Properties

Private account

Private crossSigningKeys

Private deviceData

Private inboundGroupSessions

Type declaration

[sessionKey: string]: InboundGroupSessionData

Private inboundGroupSessionsWithheld

Private notifiedErrorDevices

Type declaration

[userId: string]: { [deviceId: string]: boolean; }

[deviceId: string]: boolean

Private outgoingRoomKeyRequests

Private parkedSharedHistory

Private privateKeys

Private rooms

Type declaration

[roomId: string]: IRoomEncryption

Private sessionProblems

Type declaration

[deviceKey: string]: IProblem[]

Private sessions

Type declaration

[deviceKey: string]: { [sessionId: string]: ISessionInfo; }

[sessionId: string]: ISessionInfo

Private sessionsNeedingBackup

Type declaration

[sessionKey: string]: boolean

Private sharedHistoryInboundGroupSessions

Type declaration

[roomId: string]: [senderKey: string, sessionId: string][]

Methods

Private _getOutgoingRoomKeyRequest

Parameters

requestBody: IRoomKeyRequestBody

Returns null | OutgoingRoomKeyRequest

addEndToEndInboundGroupSession

Parameters

senderCurve25519Key: string

sessionId: string

sessionData: InboundGroupSessionData

txn: unknown

Returns void

addParkedSharedHistory

Parameters

roomId: string

parkedData: ParkedSharedHistory

Returns void

addSharedHistoryInboundGroupSession

Parameters

roomId: string

senderKey: string

sessionId: string

Returns void

countEndToEndSessions

Parameters

txn: unknown

func: ((count) => void)

Parameters

count: number

Returns void

Returns void

countSessionsNeedingBackup

Returns Promise<number>

deleteAllData

Returns Promise<void>

deleteOutgoingRoomKeyRequest

Parameters

requestId: string

expectedState: number

`Private` account

`Private` crossSigningKeys

`Private` deviceData

`Private` inboundGroupSessions

`Private` inboundGroupSessionsWithheld

`Private` notifiedErrorDevices

[userId: string]: {
[deviceId: string]: boolean;
}

`Private` outgoingRoomKeyRequests

`Private` parkedSharedHistory

`Private` privateKeys

`Private` rooms

`Private` sessionProblems

`Private` sessions

[deviceKey: string]: {
[sessionId: string]: ISessionInfo;
}

`Private` sessionsNeedingBackup

`Private` sharedHistoryInboundGroupSessions

`Private` _getOutgoingRoomKeyRequest

`Optional` txn: unknown