Class InRoomChannel

constructor

• new InRoomChannel(client, roomId, userId?): InRoomChannel

• Parameters

  • client: MatrixClient

    the matrix client, to send messages with and get current user & device from.

  • roomId: string

    id of the room where verification events should be posted in, should be a DM with the given user.

  • Optional userId: string

    id of user that the verification request is directed at, should be present in the room.

  Returns InRoomChannel

Readonly roomId

Optional userId

receiveStartFromOtherDevices

• get receiveStartFromOtherDevices(): boolean

• Returns boolean

transactionId

• get transactionId(): undefined | string

• The transaction id generated/used by this verification channel

  Returns undefined | string

canCreateRequest

• canCreateRequest(type): boolean

• Parameters

  • type: string

  Returns boolean

completeContent

• completeContent(type, content): Record<string, any>

• Add all the fields to content needed for sending it over this channel. This is public so verification methods (SAS uses this) can get the exact content that will be sent independent of the used channel, as they need to calculate the hash of it.

  Parameters

  • type: string

    the event type

  • content: Record<string, any>

    the (incomplete) content

  Returns Record<string, any>

  the complete content, as it will be sent.

completedContentFromEvent

• completedContentFromEvent(event): Record<string, any>

• Adds the transaction id (relation) back to a received event so it has the same format as returned by completeContent before sending. The relation can not appear on the event content because of encryption, relations are excluded from encryption.

  Parameters

  • event: MatrixEvent

    the received event

  Returns Record<string, any>

  the content object with the relation added again

getTimestamp

• getTimestamp(event): number

• Parameters

  • event: MatrixEvent

    the event to get the timestamp of

  Returns number

  the timestamp when the event was sent

handleEvent

• handleEvent(event, request, isLiveEvent?): Promise<void>

• Changes the state of the channel, request, and verifier in response to a key verification event.

  Parameters

  • event: MatrixEvent

    to handle

  • request: VerificationRequest<IVerificationChannel>

    the request to forward handling to

  • isLiveEvent: boolean = false

    whether this is an even received through sync or not

  Returns Promise<void>

  a promise that resolves when any requests as an answer to the passed-in event are sent.

send

• send(type, uncompletedContent): Promise<void>

• Send an event over the channel with the content not having gone through completeContent.

  Parameters

  • type: string

    the event type

  • uncompletedContent: Record<string, any>

    the (incomplete) content

  Returns Promise<void>

  the promise of the request

sendCompleted

• sendCompleted(type, content): Promise<void>

• Send an event over the channel with the content having gone through completeContent already.

  Parameters

  • type: string

    the event type

  • content: Record<string, any>

  Returns Promise<void>

  the promise of the request

Static canCreateRequest

• canCreateRequest(type): boolean

• Checks whether the given event type should be allowed to initiate a new VerificationRequest over this channel

  Parameters

  • type: string

    the event type to check

  Returns boolean

  boolean flag

Static getEventType

• getEventType(event): string

• As m.key.verification.request events are as m.room.message events with the InRoomChannel to have a fallback message in non-supporting clients, we map the real event type to the symbolic one to keep things in unison with ToDeviceChannel

  Parameters

  • event: MatrixEvent

    the event to get the type of

  Returns string

  the "symbolic" event type

Static getOtherPartyUserId

• getOtherPartyUserId(event, client): undefined | string

• Parameters

  • event: MatrixEvent

  • client: MatrixClient

  Returns undefined | string

Static getTransactionId

• getTransactionId(event): undefined | string

• Extract the transaction id used by a given key verification event, if any

  Parameters

  • event: MatrixEvent

    the event

  Returns undefined | string

  the transaction id

Static validateEvent

• validateEvent(event, client): boolean

• Checks whether this event is a well-formed key verification event. This only does checks that don't rely on the current state of a potentially already channel so we can prevent channels being created by invalid events. handleEvent can do more checks and choose to ignore invalid events.

  Parameters

  • event: MatrixEvent

    the event to validate

  • client: MatrixClient

    the client to get the current user and device id from

  Returns boolean

  whether the event is valid and should be passed to handleEvent