message saved if client crashes on retreival

This commit is contained in:
yves committed 2026-11-20 22:00:54 +01:00
1 parent 6d3ea3e2a6
commit 006bedc728
11 files changed
+591 -72

No files matched your search

+38 -7
View File
@@ -160,13 +160,42 @@ sautées sont bornées (`MAX_SKIP = 1000`). Le chiffrement des en-têtes est pr
### 3.5 Authentification des pulls
```
MailboxAuth { mailbox, timestamp, signature }
MailboxAuth { mailbox, timestamp, signature, acks[] }
signature = Ed25519_sign(mailbox_sk,
"meow/v2/pull" ‖ server_sign_pk ‖ mailbox ‖ timestamp ‖ request_id)
"meow/v2/pull" ‖ server_sign_pk ‖ mailbox ‖ timestamp
‖ SHA-256(acks, préfixés par leur longueur) ‖ request_id)
```
Le serveur rejette si `|now - timestamp| > 300 s`, si la signature est invalide ou si
`request_id` a déjà été vu (cache anti-rejeu avec TTL de 600 s).
`request_id` a déjà été vu (cache anti-rejeu avec TTL de 600 s). Les `acks` étant signés, seul
le propriétaire d'une mailbox peut en supprimer les messages.
### 3.6 Livraison au moins une fois
Un pull **ne supprime rien**. Chaque `StoredMessage` porte un `id` attribué par le serveur, et
reste stocké jusqu'à ce qu'un pull ultérieur l'acquitte dans `MailboxAuth.acks`.
```
client serveur
Pull{auths(acks=[])} ─────▶ fetch (sans supprimer)
◀───── PullResult{messages[id], more}
traitement, puis enregistrement de
l'état ET des acks en attente
Pull{auths(acks=[ids]), wait=0} ─────▶ ack(ids), puis fetch
◀───── PullResult{…}
```
* Côté client, les acks en attente (`PendingAck {server, mailbox, id}`) sont enregistrés
**dans la même sauvegarde** que l'état du ratchet. Un message redélivré dont l'id est encore
en attente n'est donc pas retraité : il est simplement acquitté de nouveau.
* `sync(wait)` relance un tour sans attente tant qu'il reçoit du nouveau ou que le serveur
signale `more` (limites de 256 messages et 16 Mio par pull). Un `sync` se termine donc avec
ses acks envoyés.
* Une mailbox qui disparaît alors qu'elle a encore des acks en attente (boîte de réponse
temporaire d'une invitation, contact supprimé) est « mise en retraite » : sa clé est conservée
le temps d'envoyer ces acks.
* Effacer les acks envoyés ne demande pas de sauvegarde, car un ack est idempotent : au pire,
il est renvoyé.
---
@@ -183,16 +212,18 @@ Les opérations (`oneof` de `Request`) :
| Requête | Effet |
|---|---|
| `Post { deposits[] }` | Stocke chaque payload dans `mailbox`, avec un TTL. Retourne les ids serveur. |
| `Pull { auths[], wait_seconds }` | Vide les mailbox authentifiées. Long-poll si elles sont vides (≤ 120 s). |
| `Pull { auths[], wait_seconds }` | Supprime d'abord les messages acquittés (`auths[].acks`), puis renvoie sans les supprimer les messages restants des mailbox authentifiées (`more` si limité). Long-poll si elles sont vides (≤ 120 s). Voir §3.6. |
| `InvitationPublish { payload, ttl, shortcode_len, password }` | Retourne `shortcode` et `expiry`. |
| `InvitationFetch { shortcode, password }` | 3 échecs → invitation détruite. Comparaison en temps constant. |
| `Ping` | Retourne l'heure du serveur (synchronisation des horodatages). |
Stockage (`ServerStore`, trait asynchrone) :
* `MemoryStore` : `HashMap` + `tokio::sync::Notify`, pour le dev et les tests.
* `RedisStore` : `LIST mb:{hex}` (avec `EXPIRE`), `PUBLISH mbch:{hex}`, `SET inv:{code} EX`,
`SET invpw:{code}`, `INCR invfa:{code}`, `SET replay:{id} NX EX`.
* `MemoryStore` : `HashMap` + canal `broadcast`, pour le dev et les tests.
* `RedisStore` (Redis ≥ 5) : `meow:v2:mb:{hex}` est un **stream** (`XADD MAXLEN`, `XRANGE` pour
lire, `XDEL` pour acquitter ; l'id du stream sert d'id de message) avec `EXPIRE`,
`PUBLISH meow:v2:new`, `SET inv:{code} EX`, `SET invpw:{code}`, `INCR invfa:{code}`,
`SET rq:{id} NX EX`.
---