Skip to content

MSC4195: LiveKit transport for MatrixRTC #4195

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
hughns wants to merge 121 commits into
base: main
Choose a base branch
from
+785 −0
Open

MSC4195: LiveKit transport for MatrixRTC #4195

Changes from 47 commits
Commits
Show all changes
121 commits
Select commit Hold shift + click to select a range
e5cd38e
Placeholder
hughns Sep 16, 2024
9fcfe3e
Allocate MSC number
hughns Sep 16, 2024
6072744
Latest
hughns Dec 17, 2024
d93480c
rewrite addressing a lot of feedback from offline discussions.
fkwp Oct 14, 2025
394d044
Address concern wrt. reliance of this MSC on the LiveKit protocol
fkwp Oct 21, 2025
02e0783
add section about error responses
fkwp Oct 21, 2025
d93eb77
address: error handling and information disclosure
fkwp Oct 21, 2025
1567fd4
cleanup structure
fkwp Oct 21, 2025
59af163
Add short intro
fkwp Nov 7, 2025
1509c49
simplify livekit_alias section
fkwp Nov 7, 2025
04fa36c
typo
fkwp Nov 7, 2025
087515c
add high level diagram to show the auth process
fkwp Nov 7, 2025
9ed3677
rename /sfu/get to more descriptive /get_token
fkwp Nov 7, 2025
3aca20e
Add section about the delegation of delayed events
fkwp Nov 7, 2025
68f8868
M_INVALID_PARAM -> M_BAD_JSON
fkwp Nov 7, 2025
fb0c402
fix example JSON snippets
fkwp Nov 7, 2025
b3b1688
"Pseudonymous livekit_alias" --> "Source of `truly_random_bits` for …
fkwp Nov 7, 2025
5ee153a
make clear its the matrix room
fkwp Nov 7, 2025
870337b
remove alternative section as the topic is already handled in the sec…
fkwp Nov 7, 2025
a584a9e
add information about delegation of delayed events
fkwp Dec 8, 2025
ad88a5a
namespace the pseudonymous LiveKit participant identity to prevent co…
fkwp Dec 11, 2025
a9fa009
Specify the encoding of participant identities
robintown Jan 8, 2026
156da9d
Encode all hashes as unpadded base64
robintown Jan 9, 2026
d5ef7e1
Update transport type to match current implementations
robintown Mar 11, 2026
673a33e
Stop using '|' delimiters in hashes; use JSON arrays + canonical JSON…
fkwp Apr 14, 2026
cd797a9
Apply suggestions from code review
fkwp Apr 14, 2026
91ea153
Fix typo
Johennes Jun 8, 2026
d2bf394
Add delay_cs_api_url parameter in example
Johennes Jun 8, 2026
923bfeb
User "LiveKit" to label the service in the chart
Johennes Jun 8, 2026
a99151a
Clarify choice of canonical JSON
Johennes Jun 9, 2026
18aee18
Split endpoint and clarify why we need to pass the CS API location
Johennes Jun 9, 2026
160b144
Add OpenID steps to delegation chart
Johennes Jun 9, 2026
a670fb0
Add alternative of joining both endpoints
Johennes Jun 9, 2026
1f97f4b
Apply suggestion from @Johennes
Johennes Jun 9, 2026
3327a89
Add lack of HKDF in SDKs as potential issue
Johennes Jun 9, 2026
050858e
Add highlander principle for delegations
Johennes Jun 10, 2026
e5d1909
Change example to silence spell checker
Johennes Jun 10, 2026
935b0f1
Kill blank lines
Johennes Jun 10, 2026
a7252d5
Clarify retry behaviour
Johennes Jun 11, 2026
7ccda7d
Recommend delay timeout
Johennes Jun 11, 2026
ca058dd
A joint endpoint complicates error handling
Johennes Jun 12, 2026
a9c98da
Detail OpenID verification
Johennes Jun 12, 2026
4f1dca4
Use restart rather than reset
Johennes Jun 19, 2026
30ea61c
Remove delay_cs_api_url in favour of server discovery
Johennes Jun 24, 2026
5e21431
Add error behaviour for server resolution
Johennes Jun 25, 2026
a8464ae
Add missing well-known link
Johennes Jul 14, 2026
afdcf27
First stab at eliminating the service in favor of CS/SS endpoints
Johennes Jul 21, 2026
bc196ac
Refer to MSC4519
Johennes Aug 19, 2026
d425395
List MSC4519 as a dependency
Johennes Aug 19, 2026
87c20ba
Add url parameter to be able to distinguish multiple SFUs per homeserver
Johennes Aug 24, 2026
72ded0d
Switch to 403 / M_FORBIDDEN
Johennes Aug 24, 2026
7be5ed2
Add unstable prefixes for new endpoints
Johennes Aug 24, 2026
2d5aac1
Clarify what happens when url doesn't match an SFU
Johennes Aug 24, 2026
8c760dc
Remove url from response
Johennes Aug 24, 2026
170a9c9
Improve introduction
Johennes Aug 27, 2026
cabb4b5
Fix typo
Johennes Aug 27, 2026
d5cbf6b
Drag up and clean-up transport discovery and announcement
Johennes Aug 27, 2026
4cbea03
Clean-up LiveKit primitive mapping and /get_token endpoint descriptions
Johennes Aug 28, 2026
b61f655
Clean up delegation section
Johennes Aug 28, 2026
334d65a
Clean up token properties section
Johennes Aug 28, 2026
99a70de
Fix typos
Johennes Aug 28, 2026
8173d48
Clean-up encryption section
Johennes Aug 31, 2026
0380a01
Add token dance chart and apply minor fixes
Johennes Aug 31, 2026
51d0977
Clean up potential issues
Johennes Aug 31, 2026
269eb45
Clean up alternatives section
Johennes Aug 31, 2026
b8331e9
Remaining clean-up
Johennes Aug 31, 2026
48dc692
Fix typo
Johennes Aug 31, 2026
29643a5
Add rate limiting
Johennes Aug 31, 2026
b14f6ee
Flesh out security considerations
Johennes Aug 31, 2026
35301ec
Add link
Johennes Aug 31, 2026
faba651
Further security details
Johennes Aug 31, 2026
5ffa2d3
Fix typo
Johennes Aug 31, 2026
259a3d7
Add missing quotes
Johennes Aug 31, 2026
246ef3b
Further fixes from code review
Johennes Aug 31, 2026
e2955da
Highlight lack of authentication
Johennes Aug 31, 2026
7d0913c
ws -> wss
Johennes Aug 31, 2026
e9d8fd5
transports -> transports.published
Johennes Aug 31, 2026
2b2396a
Mention WebRTC connection
Johennes Aug 31, 2026
e0b9740
Emphasize that it's two connections
Johennes Aug 31, 2026
ee6b171
Remove WebSocket
Johennes Aug 31, 2026
fac2da6
Link to MSC4140
Johennes Aug 31, 2026
20c9d55
New paragraph
Johennes Aug 31, 2026
a836184
Fix typo
Johennes Aug 31, 2026
ee2ba76
Add Matrix room
Johennes Aug 31, 2026
d080c8b
Include bans
Johennes Sep 1, 2026
9bc663d
Eliminate dependency on MSC4519 and make the transport optional
Johennes Sep 2, 2026
e54229f
Fix typo.
Johennes Sep 2, 2026
99c54ad
Remove leftover device ID in test vectors
Johennes Sep 2, 2026
aed4751
Correct token request input parameters
Johennes Sep 2, 2026
2b9c2b6
Clarify that sub holds the requesting user's identity
Johennes Sep 2, 2026
3a80046
Add missing user_id parameter on SS request
Johennes Sep 2, 2026
03a0ee9
Fix typo
Johennes Sep 2, 2026
92bb579
Be slightly more verbose to improve legibility
Johennes Sep 2, 2026
daec541
Also reject requests when the server doesn't know the room
Johennes Sep 2, 2026
508e8ca
member -> member_id
Johennes Sep 2, 2026
2b215b5
Extend note across other home server
Johennes Sep 2, 2026
bf19f89
Add sender
Johennes Sep 2, 2026
a71afab
Fix broken WebSocket link
Johennes Sep 2, 2026
4dbe315
Clarify local
Johennes Sep 2, 2026
a5c8db2
Member IDs are non-deterministic
Johennes Sep 2, 2026
d2ab562
Clarify forwarding of federation errors
Johennes Sep 2, 2026
c6e6e05
Deny room creation by clients
Johennes Sep 2, 2026
e6857a2
Specify requirements for exp and nbf
Johennes Sep 2, 2026
566a9eb
Clarify how to obtain the MXID
Johennes Sep 2, 2026
53ab213
Clarify delegation request parameter validation
Johennes Sep 2, 2026
051f12b
Remove expiration time recommendation for LiveKit Cloud
Johennes Sep 2, 2026
2954f3e
Clarify derivation process
Johennes Sep 2, 2026
f241dd7
Add resource abuse section
Johennes Sep 2, 2026
7e005c2
Rearrange kicking section
Johennes Sep 2, 2026
fcba454
Fix typos
Johennes Sep 2, 2026
80370c2
Be more precise about who can publish
Johennes Sep 3, 2026
1cf693b
Add section about side stepping RTC membership
Johennes Sep 3, 2026
4e7863c
The SS endpoint MUST also check if the user is joined
Johennes Sep 3, 2026
a60ca88
Add missing url parameter on delegation endpoint
Johennes Sep 3, 2026
183c568
Mention power levels check
Johennes Sep 3, 2026
b7401db
Reiterate optionality
Johennes Sep 8, 2026
a314bc2
Clarify that the endpoints are mandatory when supporting m.livekit
Johennes Sep 8, 2026
17a8d49
The delegation endpoint is required when a server supports the transport
Johennes Sep 8, 2026
4b472c7
/get_token is available to guests
Johennes Sep 8, 2026
6572c14
/delegate_delayed_leave is accessible to guests
Johennes Sep 8, 2026
94ba07e
Use stable link
Johennes Sep 8, 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
Loading