feat: export wallet seed words

closes #28

adds a button to "Export Wallet Seed" to the Addresses screen.

Clicking it opens a modal dialog with instructions, and a second button
makes the seed words appear, after which the modal can be closed.

Author: dan-da

Cargo.lock

@@ -13,7 +13,7 @@ twenty-first = "1.0"
 dioxus = { version = "0.7.1", features = ["router", "logger"] }
 dioxus-logger = "0.7.1"
 getrandom = { version = "0.3", features = ["wasm_js"] }
-neptune-types = {git = "https://github.com/Neptune-Crypto/neptune-types.git", rev = "cb240441ec07b91f4dffaa8099895a62210f7220"}
+neptune-types = {git = "https://github.com/Neptune-Crypto/neptune-types.git", rev = "7175bf047067134a8383b689f0b3f8fe110086fb"}
 thiserror = "1.0"
 serde_json = "1.0.145"
 serde = { version = "1.0", features = ["derive"] }

Cargo.toml

@@ -32,6 +32,10 @@ use neptune_types::transaction_details::TransactionDetails;
 use neptune_types::transaction_kernel::TransactionKernel;
 use neptune_types::transaction_kernel_id::TransactionKernelId;
 use neptune_types::ui_utxo::UiUtxo;
+use neptune_types::wallet_file::WalletFile;
+use neptune_types::wallet_file_context::WalletFileContext;
+use neptune_types::secret_key_material::SecretKeyMaterial;
+
 use prefs::user_prefs::UserPrefs;
 use price_map::PriceMap;
 use twenty_first::tip5::Digest;
@@ -49,50 +53,9 @@ pub async fn get_user_prefs() -> Result<UserPrefs, ApiError> {
 
 #[post("/api/network")]
 pub async fn network() -> Result<Network, ApiError> {
-    println!("DEBUG: [network] Called");
-
-    // 1. Connection
-    println!("DEBUG: [network] calling rpc_client()...");
-    let client_res = neptune_rpc::rpc_client().await;
-
-    let client = match client_res {
-        Ok(c) => {
-            println!("DEBUG: [network] rpc_client obtained successfully");
-            c
-        }
-        Err(e) => {
-            println!("DEBUG: [network] rpc_client failed: {:?}", e);
-            // If this prints and then the frontend says "Shutdown",
-            // it confirms the crash happens when returning this error.
-            return Err(e);
-        }
-    };
-
-    // 2. Execution
-    println!("DEBUG: [network] calling client.network(context)...");
-    let result = client.network(tarpc::context::current()).await;
-
-    match result {
-        Ok(Ok(n)) => {
-            println!("DEBUG: [network] Success: {:?}", n);
-            Ok(n)
-        }
-        Ok(Err(e)) => {
-            println!("DEBUG: [network] Logic Error from Core: {:?}", e);
-            Err(e.into())
-        }
-        Err(e) => {
-            // This is the Tarpc Transport error (Shutdown/BrokenPipe)
-            println!("DEBUG: [network] Transport Error: {:?}", e);
-            Err(e.into())
-        }
-    }
+    neptune_rpc::network().await
 }
 
-// pub async fn network() -> Result<Network, ApiError> {
-//     neptune_rpc::network().await
-// }
-
 #[post("/api/wallet_balance")]
 pub async fn wallet_balance() -> Result<NativeCurrencyAmount, ApiError> {
     let client = neptune_rpc::rpc_client().await?;
@@ -264,6 +227,40 @@ pub async fn neptune_core_rpc_socket_addr() -> Result<SocketAddr, ApiError> {
     ))
 }
 
+/// Asynchronously retrieves the SecretKeyMaterial by reading the wallet.dat file.
+#[post("/api/get_wallet_secret_key")]
+pub async fn get_wallet_secret_key() -> Result<SecretKeyMaterial, ApiError> {
+    use anyhow::Context;
+
+    let cookie_hint = neptune_rpc::cookie_hint().await?;
+
+    // Note: We use tokio::task::spawn_blocking for file I/O as it blocks the thread.
+    // This is required for non-async I/O operations like WalletFile::read_from_file.
+    tokio::task::spawn_blocking(move || {
+        // 1. Get the wallet directory path
+        let wallet_dir = cookie_hint.data_directory.wallet_directory_path();
+
+        // 2. Determine wallet file path and check existence
+        let wallet_file = WalletFileContext::wallet_secret_path(&wallet_dir);
+
+        if !wallet_file.exists() {
+            anyhow::bail!(
+                "Wallet file not found at: {}. Please generate or import a wallet first.",
+                wallet_file.display()
+            );
+        }
+
+        // 3. Read the WalletFile and extract the secret key
+        let wallet_secret = WalletFile::read_from_file(&wallet_file)
+            .context(format!(
+                "Could not read WalletFile from disk at {}",
+                wallet_file.display()
+            ))?;
+
+        Ok(wallet_secret.secret_key())
+    }).await?
+}
+
 #[cfg(not(target_arch = "wasm32"))]
 #[allow(dead_code)]
 mod neptune_rpc {

api/src/lib.rs

@@ -80,7 +80,7 @@ pub fn EmptyState(props: EmptyStateProps) -> Element {
                         color: var(--pico-primary-background); 
                         opacity: 0.8;                            
                             ",
-                            
+
                             {icon}
                         }
                     }

ui/src/components/empty_state.rs

@@ -0,0 +1,139 @@
+//=============================================================================
+// File: src/components/export_seed_phrase_modal.rs
+//=============================================================================
+use dioxus::prelude::*;
+use neptune_types::secret_key_material::SecretKeyMaterial;
+
+use crate::components::pico::Button;
+use crate::components::pico::ButtonType;
+use crate::components::pico::NoTitleModal;
+
+#[derive(Clone, Copy, Debug, PartialEq)]
+enum BackupStage {
+    Instructions,
+    DisplayingSeed,
+}
+
+#[component]
+pub fn ExportSeedPhraseModal(is_open: Signal<bool>) -> Element {
+    let mut stage = use_signal(|| BackupStage::Instructions);
+
+    // Resource to fetch the seed phrase.
+    // This automatically re-runs when 'stage' changes because stage() is read inside.
+    let mut seed_words_resource = use_resource(move || async move {
+        if stage() == BackupStage::Instructions {
+            return Ok(None::<SecretKeyMaterial>);
+        }
+
+        match api::get_wallet_secret_key().await {
+            Ok(secret) => Ok(Some(secret)),
+            Err(e) => Err(e),
+        }
+    });
+
+    // Reset the stage automatically whenever the modal closes.
+    // This catches "Esc" keys and backdrop clicks handled by NoTitleModal.
+    use_effect(move || {
+        if !is_open() {
+            stage.set(BackupStage::Instructions);
+        }
+    });
+
+    let mut close_modal = move || {
+        is_open.set(false);
+    };
+
+    rsx! {
+        NoTitleModal {
+            is_open: is_open,
+
+            h5 {
+                "⚠️ Export Seed Phrase"
+            },
+
+            match stage() {
+                BackupStage::Instructions => rsx! {
+                    div {
+                        p { "Your **Secret Recovery Phrase** is the master key to your funds." }
+                        p {
+                            strong { "1. Prepare: " }
+                            "Find a private location and something non-digital to write on (e.g., paper or metal)."
+                        }
+                        p {
+                            strong { "2. Write Down: " }
+                            "Write down the words in the exact order. Never type them into a computer."
+                        }
+                        p {
+                            strong { "3. Security: " }
+                            "Never share these words with anyone."
+                        }
+                    }
+                },
+                BackupStage::DisplayingSeed => rsx! {
+                    match &*seed_words_resource.read() {
+                        Some(Ok(Some(secret))) => rsx! {
+                            div {
+                                // card with 3 columns of seed words
+                                style: "display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; padding: 1rem; border-radius: var(--pico-border-radius); background: var(--pico-card-background-color); color: var(--pico-color); box-shadow: var(--pico-card-box-shadow);",
+                                {
+                                    secret.to_phrase().into_iter().enumerate().map(|(i, word)| {
+                                        rsx! {
+                                            div {
+                                                key: "{i}",
+                                                style: "text-align: left;",
+                                                strong { "{i + 1}. " }
+                                                "{word}"
+                                            }
+                                        }
+                                    })
+                                }
+                            }
+                            small {
+                                style: "display: block; margin-top: 1rem; text-align: center; color: var(--pico-color-red-500); font-weight: bold;",
+                                "🚨 VIEW IN PRIVATE! WRITE DOWN AND CLOSE IMMEDIATELY! 🚨"
+                            }
+                        },
+                        Some(Err(e)) => rsx! {
+                            div {
+                                style: "color: var(--pico-color-red-500);",
+                                p { "Error retrieving wallet secret:" }
+                                pre { "{e}" }
+                            }
+                        },
+                        _ => rsx! {
+                            div {
+                                style: "text-align: center;",
+                                p { "Loading seed words..." }
+                                progress {}
+                            }
+                        }
+                    }
+                }
+            },
+
+            footer {
+                div {
+                    style: "display: flex; justify-content: flex-end; gap: 1rem; margin-top: 1rem;",
+
+                    Button {
+                        button_type: ButtonType::Secondary,
+                        outline: true,
+                        on_click: move |_| close_modal(),
+                        "Close"
+                    }
+
+                    if stage() == BackupStage::Instructions {
+                        Button {
+                            button_type: ButtonType::Primary,
+                            on_click: move |_| {
+                                stage.set(BackupStage::DisplayingSeed);
+                                // The resource restart is triggered automatically because stage() is a dependency
+                            },
+                            "Display Seed Words"
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

ui/src/components/export_seed_phrase_modal.rs

@@ -9,6 +9,7 @@ pub mod currency_amount_input;
 pub mod currency_chooser;
 pub mod digest_display;
 pub mod empty_state;
+pub mod export_seed_phrase_modal;
 pub mod pico;
 pub mod qr_code;
 pub mod qr_processor;