0xMiden · 0xnullifier · Mar 5, 2026 · Mar 11, 2026 · Mar 12, 2026 · Mar 13, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,7 @@
 * [FIX][all] Removed stale "Download Generated Files" button and output notes storage. The `useExportNotes` hook, `registerOutputNote`, and related storage key were unused dead code. Simplifies the transaction completion screen and its auto-close logic. (#160)
 * [FIX][all] Removed the "Upload File" button and drag-and-drop note import from the Receive page. The freed space is now used by the notes list, making it taller. (#161)
 * [FEATURE][all] Complete UI revamp across the wallet.
+* [FEATURE][all] Integrate gaurdian for private state management for the wallet.
 
 ---
 

diff --git a/package.json b/package.json
@@ -83,6 +83,8 @@
     "@miden-sdk/miden-sdk": "^0.13.0",
     "@newhighsco/storybook-addon-svgr": "^2.0.7",
     "@noble/hashes": "^1.4.0",
+    "@openzeppelin/guardian-client": "^0.13.4",
+    "@openzeppelin/miden-multisig-client": "^0.13.4",
     "@peculiar/webcrypto": "1.1.6",
     "@radix-ui/react-slot": "^1.2.3",
     "@segment/analytics-node": "^2.3.0",

diff --git a/public/_locales/de/messages.json b/public/_locales/de/messages.json
@@ -1779,6 +1779,42 @@
     "message": "Sie können später im Wallet mehrere Kontotypen hinzufügen und verwalten.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Richten Sie die Kontowiederherstellung ein",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Wählen Sie aus, wie Sie Ihr Konto wiederherstellen möchten, wenn Sie den Zugriff verlieren.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Wächter",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Empfohlen. Wächterbasierte Wiederherstellung für Ihr Konto, aber der Wächterbetreiber kann Ihren Status sehen.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Völlig privat",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Nur lokal, niemand außer Ihnen sieht Ihren Status, aber keine Wiederherstellung. Der Verlust Ihres Geräts führt zum dauerhaften Verlust Ihres Geldes.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Öffentlich",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Stellen Sie ein öffentliches On-Chain-Konto wieder her.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Standard",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "Transaktionsdatei",
     "englishSource": "Transaction file"

diff --git a/public/_locales/en/en.json b/public/_locales/en/en.json
@@ -410,6 +410,15 @@
   "chooseYourAccountType": "Choose Your Account Type",
   "chooseAccountTypeDescription": "Select how you want to interact with the blockchain -- on-chain or off-chain.",
   "canAddMultipleAccountsLater": "You can add and manage multiple account types later within the wallet.",
+  "chooseRecoveryMethod": "Set Up Account Recovery",
+  "chooseRecoveryMethodDescription": "Choose how you want to recover your account if you lose access.",
+  "guardianRecovery": "Guardian",
+  "guardianRecoveryDescription": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state.",
+  "fullyPrivateRecovery": "Fully Private",
+  "fullyPrivateRecoveryDescription": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds.",
+  "publicAccountRecovery": "Public",
+  "publicAccountRecoveryDescription": "Recover a public on-chain account.",
+  "default": "Default",
   "transactionFile": "Transaction file",
   "verificationFailed": "Verification Failed",
   "transactionVerifiedSuccessfully": "The transaction has been successfully verified. You can now claim your tokens.",

diff --git a/public/_locales/en/messages.json b/public/_locales/en/messages.json
@@ -1743,6 +1743,42 @@
     "message": "You can add and manage multiple account types later within the wallet.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Set Up Account Recovery",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Choose how you want to recover your account if you lose access.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Guardian",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Fully Private",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Public",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Recover a public on-chain account.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Default",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "Transaction file",
     "englishSource": "Transaction file"

diff --git a/public/_locales/en_GB/messages.json b/public/_locales/en_GB/messages.json
@@ -1807,6 +1807,42 @@
     "message": "You can add and manage multiple account types later within the wallet.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Set Up Account Recovery",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Choose how you want to recover your account if you lose access.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Guardian",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Fully Private",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Public",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Recover a public on-chain account.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Default",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "Transaction file",
     "englishSource": "Transaction file"

diff --git a/public/_locales/es/messages.json b/public/_locales/es/messages.json
@@ -1716,6 +1716,42 @@
     "message": "Puede agregar y administrar varios tipos de cuentas más adelante dentro de la billetera.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Configurar la recuperación de la cuenta",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Elija cómo desea recuperar su cuenta si pierde el acceso.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Guardián",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Recomendado. Recuperación basada en Guardian para su cuenta, pero el operador Gaurdian puede ver su estado.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Totalmente privado",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Solo local, nadie ve su estado excepto usted, pero no hay recuperación; perder su dispositivo resultará en la pérdida permanente de sus fondos.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Público",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Recuperar una cuenta pública en cadena.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Por defecto",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "archivo de transacción",
     "englishSource": "Transaction file"

diff --git a/public/_locales/fr/messages.json b/public/_locales/fr/messages.json
@@ -1778,6 +1778,42 @@
     "message": "Vous pouvez ajouter et gérer plusieurs types de comptes ultérieurement dans le portefeuille.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Configurer la récupération de compte",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Choisissez comment vous souhaitez récupérer votre compte si vous perdez l'accès.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Tuteur",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Recommandé. Récupération basée sur le tuteur pour votre compte, mais l'opérateur gardien peut voir votre état.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Entièrement privé",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Local uniquement, personne ne voit votre état sauf vous mais pas de récupération, la perte de votre appareil entraînera une perte permanente de vos fonds.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Publique",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Récupérez un compte public en chaîne.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Défaut",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "Fichier de transactions",
     "englishSource": "Transaction file"

diff --git a/public/_locales/ja/messages.json b/public/_locales/ja/messages.json
@@ -1779,6 +1779,42 @@
     "message": "後からウォレット内で複数のアカウント タイプを追加および管理できます。",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "アカウント回復のセットアップ",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "アクセスできなくなった場合にアカウントを回復する方法を選択します。",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "ガーディアン",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "推奨。アカウントは Guardian ベースで回復されますが、Guurdian オペレーターはお客様の状態を確認できます。",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "完全プライベート",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "ローカルのみ、あなた以外の誰もあなたの状態を見ることはできませんが、回復はできません。デバイスを失うと資金が永久に失われます。",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "公共",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "公開オンチェーン アカウントを回復します。",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "デフォルト",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "トランザクションファイル",
     "englishSource": "Transaction file"

diff --git a/public/_locales/ko/messages.json b/public/_locales/ko/messages.json
@@ -1779,6 +1779,42 @@
     "message": "나중에 지갑 내에서 여러 계정 유형을 추가하고 관리할 수 있습니다.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "계정 복구 설정",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "액세스 권한을 상실한 경우 계정을 복구할 방법을 선택하세요.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "보호자",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "추천합니다. 귀하의 계정에 대한 보호자 기반 복구가 가능하지만 보호자 운영자는 귀하의 상태를 볼 수 있습니다.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "완전 비공개",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "로컬에서만 가능하며 귀하 외에는 누구도 귀하의 상태를 볼 수 없지만 복구할 수는 없습니다. 장치를 분실하면 자금이 영구적으로 손실됩니다.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "공공의",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "공개 온체인 계정을 복구하세요.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "기본",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "거래 파일",
     "englishSource": "Transaction file"

diff --git a/public/_locales/pl/messages.json b/public/_locales/pl/messages.json
@@ -1716,6 +1716,42 @@
     "message": "Możesz później dodać wiele typów kont i zarządzać nimi w portfelu.",
     "englishSource": "You can add and manage multiple account types later within the wallet."
   },
+  "chooseRecoveryMethod": {
+    "message": "Skonfiguruj odzyskiwanie konta",
+    "englishSource": "Set Up Account Recovery"
+  },
+  "chooseRecoveryMethodDescription": {
+    "message": "Wybierz sposób odzyskania konta w przypadku utraty dostępu.",
+    "englishSource": "Choose how you want to recover your account if you lose access."
+  },
+  "guardianRecovery": {
+    "message": "Opiekun",
+    "englishSource": "Guardian"
+  },
+  "guardianRecoveryDescription": {
+    "message": "Zalecony. Odzyskiwanie konta na podstawie opiekuna, ale operator strażnika może zobaczyć Twój stan.",
+    "englishSource": "Recommended. Guardian-based recovery for your account but gaurdian operator can see your state."
+  },
+  "fullyPrivateRecovery": {
+    "message": "Całkowicie prywatny",
+    "englishSource": "Fully Private"
+  },
+  "fullyPrivateRecoveryDescription": {
+    "message": "Tylko lokalnie, nikt poza Tobą nie widzi Twojego stanu, ale nie ma możliwości odzyskania urządzenia. Utrata urządzenia spowoduje trwałą utratę środków.",
+    "englishSource": "Local only, no one sees your state except you but no recovery, losing your device will result in permanent loss of your funds."
+  },
+  "publicAccountRecovery": {
+    "message": "Publiczny",
+    "englishSource": "Public"
+  },
+  "publicAccountRecoveryDescription": {
+    "message": "Odzyskaj publiczne konto w sieci.",
+    "englishSource": "Recover a public on-chain account."
+  },
+  "default": {
+    "message": "Domyślny",
+    "englishSource": "Default"
+  },
   "transactionFile": {
     "message": "Plik transakcyjny",
     "englishSource": "Transaction file"