From 5d061c6f21818a2b2e30a2a92d82fc208f63ffce Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Sat, 13 Jun 2026 21:15:25 +0200
Subject: [PATCH] docs(storage): document plaintext save caveat on
 WalletStore.Save

The password parameter accepts null, which saves the wallet in plaintext.
The XML doc comment now makes explicit that this is only acceptable when
the user has explicitly opted out of encryption with a UI warning shown.
---
 src/Core/Storage/WalletStore.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Core/Storage/WalletStore.cs b/src/Core/Storage/WalletStore.cs
index 1264e1b..b2d7aef 100644
--- a/src/Core/Storage/WalletStore.cs
+++ b/src/Core/Storage/WalletStore.cs
@@ -25,6 +25,8 @@ public static class WalletStore
         return WalletDocument.FromJson(content);
     }
 
+    /// <param name="password">Null saves in plaintext. Only omit when the user has
+    /// explicitly opted out of encryption (UI must show a clear warning).</param>
     public static void Save(WalletDocument doc, string path, string? password = null)
     {
         var content = doc.ToJson();