From cc84287424d1f661701f9118fb5efc3cff45ee9d Mon Sep 17 00:00:00 2001 From: Ignacio Duart Date: Wed, 20 May 2026 14:04:35 +0200 Subject: [PATCH] docs: soften delegate backup/replica claim, link to #3050 The use-cases section previously stated that delegates 'act as backups and replicas of each other' across devices. This is aspirational: no cross-device sync exists today. PR #4034 added local snapshot history but not cross-device synchronization. Replace the inaccurate sentence with an accurate description: - delegates store state encrypted on the local device - recent snapshots allow recovery from accidental overwrites - cross-device sync is not yet implemented Link to freenet-core#3050 (vault-delegate primitive) for the planned implementation. Fixes freenet/freenet-core#4037. --- hugo-site/content/build/manual/components/delegates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo-site/content/build/manual/components/delegates.md b/hugo-site/content/build/manual/components/delegates.md index 8e849b1f..711e53f1 100644 --- a/hugo-site/content/build/manual/components/delegates.md +++ b/hugo-site/content/build/manual/components/delegates.md @@ -79,7 +79,7 @@ Beyond handling messages, delegates can create, read, and modify contracts; crea A **key manager delegate** stores private keys and signs data on request, possibly prompting the user for permission. An **inbox delegate** monitors an inbox contract, downloads new messages, decrypts them, and stores them privately for UIs to display. A **contacts delegate** stores and retrieves contact information. An **alerts delegate** watches for events (like mentions in a discussion) and notifies the user. -Delegates can also synchronize with identical delegate instances running on other devices the user controls. With an appropriate shared secret, they communicate securely via Freenet and act as backups and replicas of each other. +Delegates store their state encrypted on the local device. Recent prior values are kept as snapshots so accidental overwrites can be recovered. Cross-device synchronization is not yet implemented — see [issue #3050](https://github.com/freenet/freenet-core/issues/3050) for the planned vault-delegate primitive. For a real-world example, River's [chat delegate](https://github.com/freenet/river/tree/main/delegates/chat-delegate) stores per-room signing keys and signs messages, invitations, and room configurations on behalf of the UI, without ever exposing the keys.