Skip to content

MSC4143: MatrixRTC – Real-time communication over Matrix #4143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
toger5 wants to merge 167 commits into
base: main
Choose a base branch
from
+743 −0
Open

MSC4143: MatrixRTC – Real-time communication over Matrix #4143

Changes from 24 commits
Commits
Show all changes
167 commits
Select commit Hold shift + click to select a range
9cbe448
draft
toger5 May 10, 2024
b2b4e5e
lowercase filename
toger5 May 13, 2024
8c1340a
add note about this relying on MSC3757
toger5 May 14, 2024
8c800a6
remove the m.prefix from fields.
toger5 May 17, 2024
1dcbfce
update
toger5 Jun 5, 2024
813a21a
add foci_preferred well known section
toger5 Jun 6, 2024
d65e42e
update to reference to msc [MSC4158](https://github.com/matrix-org/ma…
toger5 Jun 20, 2024
4ab679a
add a "Reliability requirements for the room state" section
toger5 Jul 2, 2024
6d84256
use current state key format
toger5 Sep 11, 2024
d68e942
add `expires_after`
toger5 Sep 11, 2024
3b19b49
add section about send order (delayed leave event -> join event)
toger5 Sep 11, 2024
a278ff8
language fixes
ara4n Nov 25, 2024
f97e4e6
clarify that non-empty delayed membership events are invalid
ara4n Nov 25, 2024
b626d51
Latest
hughns Dec 17, 2024
ec9fa8b
json5 for legibility
hughns Dec 17, 2024
50db42a
be more specific on `member.id`
toger5 Jul 30, 2025
9bc444c
add id to session
toger5 Jul 31, 2025
33231dc
calrify that the state key cannot be used as the source of truth for …
toger5 Jul 31, 2025
cea4cdd
Update proposals/4143-matrix-rtc.md
toger5 Aug 8, 2025
d61969a
clarify what is part of this MSC and what can be found in other MSC's
toger5 Aug 26, 2025
4ad3961
major rewrite addressing a lot of feedback from offline discussions.
fkwp Oct 14, 2025
1fbd843
json5 code block formats
toger5 Oct 14, 2025
60e23d9
add unstable m.rtc.slot prefix.
toger5 Oct 14, 2025
680ef7d
fix grammar & link the MSC
ara4n Oct 14, 2025
b62f75b
more informatino on the purpose of `member.id`
fkwp Dec 12, 2025
50f8331
markdown cleanup
fkwp Dec 12, 2025
d53175b
Remove stray . from slot ID
robintown Jan 23, 2026
dc605bf
cleanup field description for to-device message
fkwp Jan 23, 2026
7907635
minor changes to the m.rtc.encryption_key to-device format
fkwp Jan 23, 2026
c032f03
Update transport type to match latest MSC4195 revision
robintown Mar 11, 2026
866ca09
Require authentication for MatrixRTC transport discovery endpoint
fkwp Apr 15, 2026
3855617
Fix [!NOTE] syntax
Johennes Jun 5, 2026
be629da
Use "power level" rather than "`power_level`" to avoid ambiguity
Johennes Jun 5, 2026
9c17cc6
Avoid using MUST with respect to creating MSCs per application
Johennes Jun 8, 2026
29a3f30
Remove recommendation to provide widget implementations for applicati…
Johennes Jun 8, 2026
e3083de
Clarify that RTC member refers to m.rtc.member events
Johennes Jun 8, 2026
f928273
Fix number of states
Johennes Jun 8, 2026
730296f
Downgrade UX description to examples
Johennes Jun 8, 2026
c7fcea0
Remove duplicate paragraph
Johennes Jun 8, 2026
72f3c4c
Linkify
Johennes Jun 8, 2026
6dd4f50
Fix property name
Johennes Jun 8, 2026
73efe93
Fix bullets
Johennes Jun 8, 2026
d840122
Relocate slot ID grammar
Johennes Jun 8, 2026
535138a
Avoid "slot name" term
Johennes Jun 9, 2026
118c9db
Clarify common namespaced identifier requirements
Johennes Jun 15, 2026
9852003
Clarify why we require stickyness to consider a member connected
Johennes Jun 15, 2026
3ccd90b
Remove vulnerable hashing example
Johennes Jun 15, 2026
8587297
Fix spelling
Johennes Jun 16, 2026
d597297
Clarify origin of disconnect_reason design and remove examples as the…
Johennes Jun 16, 2026
37ded3e
Fix typo
Johennes Jun 16, 2026
e5e135a
Clarify that we're using unpadded base64
Johennes Jun 16, 2026
8235365
Clarify delegation requirements
Johennes Jun 16, 2026
6bc4ff0
Add unstable version flag
Johennes Jun 16, 2026
6bf733f
Cross-link MSC4075
Johennes Jun 16, 2026
eac1005
Add .well-known alternative
Johennes Jun 17, 2026
57c8cbe
Explain why we use the claimed_ prefixes
Johennes Jun 17, 2026
5bcd4f0
Some clarifications around encryption
Johennes Jun 17, 2026
0229f89
Move future ratcheting extension to potential issues
Johennes Jun 17, 2026
0a78a66
Merge content 'Scope and Responsibilities of MatrixRTC Applications' …
Johennes Jun 18, 2026
a5bef33
Remove relations
Johennes Jul 6, 2026
98bd92d
Blend part of the beginning of the proposal into the introduction to …
Johennes Jul 6, 2026
01abcd6
Update slot description and include encryption setting
Johennes Jul 7, 2026
b63210a
Update membership section
Johennes Jul 9, 2026
9e07f16
Fix typos
Johennes Jul 9, 2026
9409b17
Clarify SHOULD'ness of disconnect_reason
Johennes Jul 9, 2026
48645d4
Update sessions section
Johennes Jul 9, 2026
234a4b1
Update transports section
Johennes Jul 9, 2026
3c98456
Remove shared key encryption
Johennes Jul 9, 2026
82f5e57
Remove delegation of delayed event management
Johennes Jul 10, 2026
af4c337
Update encryption section
Johennes Jul 10, 2026
e4f3693
Highlight that member events must be encrypted
Johennes Jul 14, 2026
cbab20d
Update potential issues section
Johennes Jul 15, 2026
396c61b
Slightly adapt wording in key traffic discussion now that per-partici…
Johennes Jul 15, 2026
164f804
Update alternatives section
Johennes Jul 15, 2026
79db42b
Update security considerations and the rest
Johennes Jul 15, 2026
2231bad
Fix typo
Johennes Jul 15, 2026
807199f
Fix links and styling
Johennes Jul 15, 2026
f23d415
Add decline MSC reference
Johennes Jul 15, 2026
720aeee
Shorten slot/member consideration
Johennes Jul 15, 2026
98c59df
Add space
Johennes Jul 15, 2026
27854d4
Remove duplicate footnote
Johennes Jul 15, 2026
9bd7142
Fix typos
Johennes Jul 15, 2026
d1363e3
Shorten link
Johennes Jul 15, 2026
ae98f71
Add CNIG restriction
Johennes Jul 15, 2026
a58efb9
Only remove app obj
Johennes Jul 15, 2026
ecb695a
Remove claimed useer ID
Johennes Jul 15, 2026
98aa57a
Improve wording
Johennes Jul 15, 2026
ff3810b
Avoid SFU ref
Johennes Jul 15, 2026
a7e7e35
Fix typos
Johennes Jul 15, 2026
b304723
Improve wording
Johennes Jul 15, 2026
55d36f8
Improve wording
Johennes Jul 15, 2026
8685d8d
Improve wording
Johennes Jul 15, 2026
d5a758c
Improve wording
Johennes Jul 15, 2026
903ae32
Improve wording
Johennes Jul 15, 2026
a6be849
Improve wording
Johennes Jul 15, 2026
ebf0ee2
Improve wording
Johennes Jul 15, 2026
0bc3a1d
Improve wording
Johennes Jul 15, 2026
dcc1e1e
Improve wording
Johennes Jul 15, 2026
6786235
Improve wording
Johennes Jul 15, 2026
20265cb
Improve wording
Johennes Jul 15, 2026
b7f8568
Add missing prefix
Johennes Jul 15, 2026
de35d8b
Fix typo
Johennes Jul 15, 2026
8fafc5b
reason/description -> code/reason
Johennes Jul 15, 2026
0a158a0
Switch to 32 bytes
Johennes Jul 15, 2026
adba11b
version -> format
Johennes Jul 15, 2026
c87b1ee
Improve wording
Johennes Jul 15, 2026
b98cb2f
Improve wording
Johennes Jul 15, 2026
8297dcc
Add encryption requirement
Johennes Jul 15, 2026
04ee51b
Small clarity and style fixes to MSC4143 (#4510)
robintown Jul 16, 2026
0e7bd82
Clarify that slot participation might also require higher power levels
Johennes Jul 16, 2026
272cc47
Introduce slot status and consider encryption downgrade security impact
Johennes Jul 16, 2026
9d621d4
Clarify can_subscribe
Johennes Jul 16, 2026
3cddce3
Shorten explanation of why membership is bounded by stickiness
Johennes Jul 16, 2026
25a4a61
m.per_participant -> m.per_member
Johennes Jul 16, 2026
7f1185d
Remove interoperation potential issue as it should be covered by can_…
Johennes Jul 16, 2026
eb8f21f
Clarify key traffic issue
Johennes Jul 16, 2026
cd6c615
Use uniform language for members, joining, leaving, rename disconnect…
Johennes Jul 16, 2026
55bebd6
Remove note about canonical member id
Johennes Jul 16, 2026
79fefa5
Fix typo
Johennes Jul 16, 2026
0c5f187
Specify generic leave codes
Johennes Jul 16, 2026
dab1eeb
Clarify slot<>room relationship
Johennes Jul 22, 2026
492e69f
Improve line wrapping
Johennes Jul 22, 2026
6d5f4ea
Spell out that the `encryption` object en-/disables encryption
Johennes Jul 22, 2026
d45bf23
Make the required relation between application.type and state_key exp…
Johennes Jul 22, 2026
e127b34
Spell out that application is required for open slots
Johennes Jul 22, 2026
4602646
member.id is only unique for the same user
Johennes Jul 22, 2026
3e3df5a
Tighten join requirements
Johennes Jul 22, 2026
2c1ed9e
Tighten leave requirements
Johennes Jul 22, 2026
ecd40da
Fix position of leave marker in chart
Johennes Jul 22, 2026
3e265cf
Clarify that the JSON is an OlmPlaintext
Johennes Jul 22, 2026
5b13400
Also mention the former name OlmPayload
Johennes Jul 22, 2026
d5366ab
Tighten wording around open and closed slots
Johennes Jul 22, 2026
cedd4a9
Add shadow sessions consideration
Johennes Jul 22, 2026
0eb3656
Adapt MatrixRTC encryption to latest agreements (#4516)
Johennes Jul 24, 2026
4b8c6ea
Move transport types out of MSC4143 and into MSC4519
turt2live Jul 28, 2026
694b4e4
Provide an application example
robintown Jul 30, 2026
e830685
Describe slots more concisely
robintown Jul 30, 2026
00c0b07
Provide a transport example
robintown Jul 30, 2026
aa2d746
Clarify why we proscribe a deterministic slot ID grammar
robintown Jul 30, 2026
3236b00
Merge branch 'toger5/matrixRTC' into travis/msc4143/rtc-registry
robintown Jul 30, 2026
595ef84
Fix typo
Johennes Aug 17, 2026
2a45b77
Link to MSC4531 for deprecating legacy VoIP
Johennes Aug 18, 2026
adb8fa5
Remove transport provisioning alternatives now that transport discove…
Johennes Aug 18, 2026
cea5014
Clarify that m.per_member is defined in the text following
Johennes Aug 18, 2026
5495f4b
Clarify that cross-signing refers to the owner
Johennes Aug 18, 2026
a67a217
Fix to-device message snippet
Johennes Aug 18, 2026
44caf05
Move format inside of media_key object
Johennes Aug 18, 2026
e2a64eb
Clarify what cryptographically secure means
Johennes Aug 18, 2026
98e5783
Clarify why encryption in unencrypted rooms is disallowed
Johennes Aug 18, 2026
39c144d
Clarify that slots MUST be considered closed
Johennes Aug 18, 2026
6b414dd
format=0 -> format=m.base64
Johennes Aug 19, 2026
6c054fb
Fix typo
Johennes Aug 19, 2026
95f8be6
Clarify coalescing key rotations on leaves
Johennes Aug 25, 2026
3e3d084
Stress that the member ID must be unique across devices
Johennes Aug 26, 2026
1e41430
Clients should store keys even if the membership event is not yet known
Johennes Aug 26, 2026
59c3f98
Recommend one hour of stickyness
Johennes Aug 27, 2026
0e473cb
Membership events can be redacted to kick members
Johennes Aug 27, 2026
d6133e4
Agreeing on transports is out of scope
Johennes Aug 27, 2026
c3d05cf
PRNG -> RNG + notes on why we use a transport agnostic key agreement …
Johennes Aug 28, 2026
51c8dfe
livekit -> m.livekit
Johennes Aug 31, 2026
af59d73
Ignore unencrypted streams in encrypted slots; call out unmappable st…
Johennes Sep 1, 2026
db289df
Fix typo
Johennes Sep 1, 2026
99bb791
m.call#ROOM -> m.call#room
Johennes Sep 1, 2026
c194030
Eliminate dependency on MSC4519 and move transport discovery back int…
Johennes Sep 2, 2026
d544107
Clarify that member IDs must be unique across rooms and slots as well
Johennes Sep 2, 2026
8f8601f
Member IDs must be non-deterministic
Johennes Sep 2, 2026
fda56fc
Replicate slots on room upgrades
Johennes Sep 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading