archetech / archon / 38458411066

93%

push

github

docs: add an animated walkthrough of dmail (#1398)

* docs: add an animated walkthrough of dmail

"Letters in a Vault": a canvas walkthrough of Archon's encrypted mail
between DIDs. It covers writing a dmail and resolving its recipients,
sealing the message and attachments in a vault whose key is wrapped for
the sender and each recipient, sending with an expiring Hyperswarm
notice, how a wallet finds, opens and files its mail, wallet-local
folders and threaded replies, Herald's bridge to and from email, and
what stays public or private. Linked from the docs index between the
assets and DIDComm walkthroughs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: describe dmail notice delivery as gossip, not guaranteed

Review follow-up for #1398. The walkthrough said every node receives a
notice and any node can answer the search. Hyperswarm relays to
connected nodes, and a node that connects later receives the notice
when it syncs, since sync exports every non-local DID; a node that never
does has nothing to answer with. Say so in the canvas and captions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

3578 of 3995 branches covered (89.56%)

Branch coverage included in aggregate %.

9864 of 10151 relevant lines covered (97.17%)

22048.35 hits per line