Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-23 19:44:09 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Be specific about encoding of QR codes

Browse source
This commit is contained in:
Hugh Nimmo-Smith 2024-06-03 09:29:58 +01:00
parent a17550648c
commit ad81d0efa3
1 changed files with 10 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
content/client-server-api/modules/end_to_end_encryption.md
View file

@ -1179,10 +1179,16 @@ The process between Alice and Bob verifying each other would be:
###### QR code format ###### QR code format
The QR codes to be displayed and scanned using this format will encode binary The QR codes to be displayed and scanned must be
strings in the general form: [ISO/IEC 18004:2015](https://www.iso.org/standard/62021.html) compatible and
contain a single segment that uses the byte mode encoding.
- the ASCII string `MATRIX` The error correction level can be chosen by the device displaying the QR code.
The binary segment must be of the following form:
- the string `MATRIX` encoded as one ASCII byte per character (i.e. `0x4D`,
`0x41`, `0x54`, `0x52`, `0x49`, `0x58`)
- one byte indicating the QR code version (must be `0x02`) - one byte indicating the QR code version (must be `0x02`)
- one byte indicating the QR code verification mode. Should be one of the - one byte indicating the QR code verification mode. Should be one of the
following values: following values:
@ -1210,7 +1216,7 @@ strings in the general form:
secret, and it is not a fixed size, clients will just use the remainder of secret, and it is not a fixed size, clients will just use the remainder of
binary string as the shared secret. binary string as the shared secret.
For example, if Alice displays a QR code encoding the following binary string: For example, if Alice displays a QR code encoding the following binary data:
``` ```
"MATRIX" |ver|mode| len | event ID "MATRIX" |ver|mode| len | event ID