From 5b4daa23b6d1eb4b8a902ba19794becee7a21e7d Mon Sep 17 00:00:00 2001 From: Tommy Verrall Date: Wed, 27 Mar 2024 11:20:37 +0100 Subject: [PATCH 1/2] adding recovery docs --- .../WALLET_RECOVERY.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md diff --git a/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md b/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md new file mode 100644 index 0000000000..2798d955c8 --- /dev/null +++ b/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md @@ -0,0 +1,55 @@ +# Wallet CLI Recovery Tool Guide + +This guide provides instructions on how to use the Wallet CLI recovery tool to recover your mnemonic phrase using your password, especially useful if you're unable to access your wallet in the usual way. + +## Step 1: Install the CLI Tool + +1. Change directory `cd /nym-wallet/nym-wallet-recovery-cli` from root Nym repository +2. Have rust installed `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh` +3. Once the installation is complete run `cargo build --release` +4. The binary should live here: `nym/nym-wallet/nym-wallet-recovery-cli)` + +## Step 2: Prepare Your Command + +The tool requires specific command-line arguments to specify the password(s) and the file path to your wallet file. The basic structure of the command is as follows: + +```plaintext +nym-recovery-cli --password --file [OPTIONS] +``` + +- Replace `` with your wallet password. +- Replace `` with the path to your wallet file, where your encrypted mnemonic is stored. + +## Step 3: Running the Tool + +1. Open your terminal or command prompt. +2. Navigate to the directory where the `nym-recovery-cli` tool is located. +3. Execute the command prepared in Step 2. + +Example: + +```bash +./nym-recovery-cli --password "mySecurePassword123" --file "/path/to/mywallet.json" +``` + +To try multiple passwords: + +```bash +./nym-recovery-cli --password "myFirstPassword" --password "mySecondPassword" --file "/path/to/mywallet.json" +``` + +## Step 4: Understanding the Output + +The tool will attempt to decrypt the wallet file. If successful, it will print the decrypted content, including your mnemonic phrase. + +## Step 5: If You Encounter Issues + +- Verify the accuracy of the passwords and file path. +- Ensure there are no typos in the command. +- Make sure the wallet file's path is correctly specified. + +## Additional Options + +- `--raw`: Skips trying to parse the decrypted content, showing raw output instead. + +This guide should help you safely recover your mnemonic phrase. Remember to keep it secure once retrieved. From a04c5c7e920043ad93f765318cad923e2bb5343a Mon Sep 17 00:00:00 2001 From: Tommy Verrall Date: Wed, 27 Mar 2024 11:25:57 +0100 Subject: [PATCH 2/2] typos --- nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md b/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md index 2798d955c8..0fa2a6bd0e 100644 --- a/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md +++ b/nym-wallet/nym-wallet-recovery-cli/WALLET_RECOVERY.md @@ -13,7 +13,7 @@ This guide provides instructions on how to use the Wallet CLI recovery tool to r The tool requires specific command-line arguments to specify the password(s) and the file path to your wallet file. The basic structure of the command is as follows: -```plaintext +``` nym-recovery-cli --password --file [OPTIONS] ``` @@ -28,13 +28,13 @@ nym-recovery-cli --password --file [O Example: -```bash +``` ./nym-recovery-cli --password "mySecurePassword123" --file "/path/to/mywallet.json" ``` To try multiple passwords: -```bash +``` ./nym-recovery-cli --password "myFirstPassword" --password "mySecondPassword" --file "/path/to/mywallet.json" ```