From 3f161df2f3153681273fe73611f84ffd1d82605d Mon Sep 17 00:00:00 2001
From: Devon Hudson <devonhudson@librem.one>
Date: Tue, 21 Nov 2023 18:12:07 -0700
Subject: [PATCH] Add diagram for federated invite

---
 proposals/4080-cryptographic-identities.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/proposals/4080-cryptographic-identities.md b/proposals/4080-cryptographic-identities.md
index 655559f702d..d940ed1ce0c 100644
--- a/proposals/4080-cryptographic-identities.md
+++ b/proposals/4080-cryptographic-identities.md
@@ -146,6 +146,25 @@ the event to the invited user’s homeserver.
 
 **TODO**: document /make_invite & /send_invite endpoints
 
+```mermaid
+sequenceDiagram
+participant Alice
+participant Alice HS
+participant Bob HS
+participant Bob
+Bob ->> Bob HS: /keys_upload (one-time cryptoID)
+Note over Bob, Bob HS: Occurs separately, when one-time<br/>cryptoID count is low.
+Alice ->> Alice HS: /invite:@bob:bob_hs
+Alice HS ->> Bob HS: /make_invite
+Bob HS ->> Bob HS: Claim one-time cryptoID
+Note right of Bob HS: A valid one-time cryptoID is required<br/>to create the full invite event.
+Bob HS ->> Alice HS: (proto pdu)
+Alice HS ->> Alice: (proto pdu)
+Alice ->> Alice: Sign PDU
+Alice ->> Alice HS: /send_pdus
+Alice HS ->> Bob HS: /send_invite
+```
+
 200 OK Response:
 ```
 {