feat(wallet): add wallet address book

applications/tari_walletd/Cargo.toml

@@ -14,6 +14,7 @@ tari_crypto = { workspace = true }
 tari_ootle_app_utilities = { workspace = true }
 tari_shutdown = { workspace = true }
 tari_ootle_wallet_crypto = { workspace = true, features = ["mmap-value-lookup"] }
+tari_ootle_address = { workspace = true }
 tari_ootle_wallet_sdk = { workspace = true }
 tari_ootle_wallet_sdk_services = { workspace = true, features = ["indexer_client"] }
 tari_ootle_wallet_storage_sqlite = { workspace = true }

applications/tari_walletd/src/handlers/address_book.rs

@@ -0,0 +1,109 @@
+//   Copyright 2026 The Tari Project
+//   SPDX-License-Identifier: BSD-3-Clause
+
+use std::str::FromStr;
+
+use anyhow::anyhow;
+use axum_extra::headers::authorization::Bearer;
+use tari_ootle_address::OotleAddress;
+use tari_ootle_walletd_client::{
+    permissions::JrpcPermission,
+    types::{
+        AddressBookAddRequest,
+        AddressBookAddResponse,
+        AddressBookDeleteRequest,
+        AddressBookDeleteResponse,
+        AddressBookGetRequest,
+        AddressBookGetResponse,
+        AddressBookListRequest,
+        AddressBookListResponse,
+        AddressBookUpdateRequest,
+        AddressBookUpdateResponse,
+    },
+};
+
+use crate::handlers::HandlerContext;
+
+fn validate_address(address: &str) -> Result<(), anyhow::Error> {
+    OotleAddress::from_str(address)
+        .map_err(|e| anyhow!("Invalid Ootle address '{address}': {e}"))?;
+    Ok(())
+}
+
+pub async fn handle_add(
+    context: &HandlerContext,
+    token: Option<&Bearer>,
+    req: AddressBookAddRequest,
+) -> Result<AddressBookAddResponse, anyhow::Error> {
+    let sdk = context.wallet_sdk();
+    context.check_auth(token, &[JrpcPermission::Admin])?;
+
+    validate_address(&req.address)?;
+
+    let entry = sdk
+        .address_book_api()
+        .add(&req.name, &req.address, req.memo.as_deref())?;
+
+    Ok(AddressBookAddResponse { entry })
+}
+
+pub async fn handle_list(
+    context: &HandlerContext,
+    token: Option<&Bearer>,
+    _req: AddressBookListRequest,
+) -> Result<AddressBookListResponse, anyhow::Error> {
+    let sdk = context.wallet_sdk();
+    context.check_auth(token, &[JrpcPermission::Admin])?;
+
+    let entries = sdk.address_book_api().list()?;
+
+    Ok(AddressBookListResponse { entries })
+}
+
+pub async fn handle_get(
+    context: &HandlerContext,
+    token: Option<&Bearer>,
+    req: AddressBookGetRequest,
+) -> Result<AddressBookGetResponse, anyhow::Error> {
+    let sdk = context.wallet_sdk();
+    context.check_auth(token, &[JrpcPermission::Admin])?;
+
+    let entry = sdk.address_book_api().get(&req.name)?;
+
+    Ok(AddressBookGetResponse { entry })
+}
+
+pub async fn handle_update(
+    context: &HandlerContext,
+    token: Option<&Bearer>,
+    req: AddressBookUpdateRequest,
+) -> Result<AddressBookUpdateResponse, anyhow::Error> {
+    let sdk = context.wallet_sdk();
+    context.check_auth(token, &[JrpcPermission::Admin])?;
+
+    if let Some(ref address) = req.address {
+        validate_address(address)?;
+    }
+
+    let entry = sdk.address_book_api().update(
+        &req.name,
+        req.new_name.as_deref(),
+        req.address.as_deref(),
+        req.memo.as_deref(),
+    )?;
+
+    Ok(AddressBookUpdateResponse { entry })
+}
+
+pub async fn handle_delete(
+    context: &HandlerContext,
+    token: Option<&Bearer>,
+    req: AddressBookDeleteRequest,
+) -> Result<AddressBookDeleteResponse, anyhow::Error> {
+    let sdk = context.wallet_sdk();
+    context.check_auth(token, &[JrpcPermission::Admin])?;
+
+    sdk.address_book_api().delete(&req.name)?;
+
+    Ok(AddressBookDeleteResponse {})
+}

applications/tari_walletd/src/handlers/mod.rs

@@ -2,6 +2,7 @@
 //   SPDX-License-Identifier: BSD-3-Clause
 
 pub mod accounts;
+pub mod address_book;
 pub mod auth;
 pub mod burn_proofs;
 pub mod confidential;

applications/tari_walletd/src/server.rs

@@ -27,6 +27,7 @@ use super::handlers::{HandlerContext, HandlerWithCookie, auth, stealth_utxos, su
 use crate::handlers::{
     Handler,
     accounts,
+    address_book,
     auth::jwt::JwtApiError,
     burn_proofs,
     confidential,
@@ -220,6 +221,14 @@ async fn handler(
             "get" => call_handler(context, value, token, burn_proofs::handle_get).await,
             _ => value.method_not_found(&value.method).into_response(),
         },
+        Some(("address_book", method)) => match method {
+            "add" => call_handler(context, value, token, address_book::handle_add).await,
+            "list" => call_handler(context, value, token, address_book::handle_list).await,
+            "get" => call_handler(context, value, token, address_book::handle_get).await,
+            "update" => call_handler(context, value, token, address_book::handle_update).await,
+            "delete" => call_handler(context, value, token, address_book::handle_delete).await,
+            _ => value.method_not_found(&value.method).into_response(),
+        },
         Some(("wallet", "get_info")) => call_handler(context, value, token, wallet::handle_get_info).await,
         _ => value.method_not_found(&value.method).into_response(),
     }

applications/tari_walletd/web_ui/src/App.tsx

@@ -27,6 +27,7 @@ import Loading from "@components/Loading";
 import AccessTokensLayout from "@routes/AccessTokens/AccessTokens";
 import AccountDetails from "@routes/AccountDetails/AccountDetails";
 import Accounts from "@routes/Accounts/Accounts";
+import AddressBookPage from "@routes/AddressBook/AddressBookPage";
 import MyAssets from "@routes/AssetVault/Components/MyAssets";
 import ErrorPage from "@routes/ErrorPage";
 import Keys from "@routes/Keys/Keys";
@@ -115,6 +116,11 @@ export const breadcrumbRoutes = [
     path: "/manifest",
     dynamic: false,
   },
+  {
+    label: "Address Book",
+    path: "/address-book",
+    dynamic: false,
+  },
   // {
   //   label: "Flow Editor",
   //   path: "/flow-editor",
@@ -225,6 +231,7 @@ function App() {
           <Route path="settings" element={<GuardedRoute redirect="/settings" component={SettingsPage} />} />
           <Route path="templates" element={<GuardedRoute redirect="/templates" component={Templates} />} />
           <Route path="manifest" element={<GuardedRoute redirect="/manifest" component={Manifest} />} />
+          <Route path="address-book" element={<GuardedRoute redirect="/address-book" component={AddressBookPage} />} />
           {/*<Route path="flow-editor" element={<GuardedRoute redirect="/flow-editor" component={FlowEditor} />} />*/}
           <Route
             path="stealth-utxos/:resource_address"

applications/tari_walletd/web_ui/src/components/MenuItems.tsx

@@ -30,7 +30,7 @@ import { useTheme } from "@mui/material/styles";
 import Tooltip from "@mui/material/Tooltip";
 import useSettingsStore from "@store/settingsStore";
 import { IoHome, IoHomeOutline, IoSettings, IoSettingsOutline, IoTerminal, IoTerminalOutline } from "react-icons/io5";
-import { LuLayoutTemplate } from "react-icons/lu";
+import { LuBookOpen, LuLayoutTemplate } from "react-icons/lu";
 import { NavLink } from "react-router";
 
 function MainListItems() {
@@ -62,6 +62,12 @@ function MainListItems() {
       link: "templates",
     },
 
+    {
+      title: "Address Book",
+      icon: <LuBookOpen style={iconStyle} />,
+      activeIcon: <LuBookOpen style={activeIconStyle} />,
+      link: "address-book",
+    },
     {
       title: "Settings",
       icon: <IoSettingsOutline style={iconStyle} />,