Restore Wallet from Seed Phrase (Private Key)

If you already have a wallet seed phrase (mnemonic phrase) and want to restore it, you can do so using the --restore-deterministic-wallet option. This is useful if you:

• Lost your wallet file but have your seed phrase

• Want to restore your wallet on a different computer

• Need to recover your wallet after reinstalling

Important: Make sure your service node is running before restoring the wallet!

Windows (PowerShell)

Step 1: Open PowerShell and navigate to your testnet folder

cd C:\Users\YourUsername\Desktop\xeq-testnet

(Replace YourUsername with your Windows username and adjust the path if your testnet folder is in a different location)

Step 2: Stop and remove the old wallet container (if it exists) If you have an old wallet file you want to replace:

docker stop sn01
docker rm sn01

Note: Only do this if you want to start fresh. If you just want to restore to a new wallet file, skip this step and use a different wallet filename in Step 3.

Step 3: Restore your wallet from seed phrase

docker exec -it sn01 /usr/local/bin/xeq-wallet-cli --testnet --restore-deterministic-wallet --wallet-file=/data/sn01 --password=my_password --daemon-address=127.0.0.1:18091

Replace:

• my_password with the password you want to use for this wallet

• /data/sn01 with a different path if you want to create a new wallet file (e.g., /data/sn01-restored)

Step 4: Enter your seed phrase

• The wallet CLI will prompt you: Enter mnemonic phrase:

• Type your seed phrase (the 25 words separated by spaces)

• Press Enter

Step 5: Enter restore height (optional)

• The wallet will ask: Enter restore height (optional, default 0):

• Press Enter to use default (0) - this will restore from the beginning

• Or enter a specific block height if you know when your wallet was created (this speeds up restoration)

Step 6: Wait for restoration

• The wallet will restore and start syncing

• This may take some time depending on the restore height

Step 7: Verify your wallet Once restored, type:

address

This should show your wallet address. Verify it matches the address you expect.

Linux (Terminal)

Step 1: Open Terminal and navigate to your testnet folder

cd ~/Desktop/xeq-testnet

(Replace with your actual testnet folder path if different)

Step 2: Stop and remove the old wallet container (if it exists) If you have an old wallet file you want to replace:

docker stop sn01
docker rm sn01

Note: Only do this if you want to start fresh. If you just want to restore to a new wallet file, skip this step and use a different wallet filename in Step 3.

Step 3: Restore your wallet from seed phrase

docker exec -it sn01 /usr/local/bin/xeq-wallet-cli --testnet --restore-deterministic-wallet --wallet-file=/data/sn01 --password=my_password --daemon-address=127.0.0.1:18091

Replace:

• my_password with the password you want to use for this wallet

• /data/sn01 with a different path if you want to create a new wallet file (e.g., /data/sn01-restored)

Step 4: Enter your seed phrase

• The wallet CLI will prompt you: Enter mnemonic phrase:

• Type your seed phrase (the 25 words separated by spaces)

• Press Enter

Step 5: Enter restore height (optional)

• The wallet will ask: Enter restore height (optional, default 0):

• Press Enter to use default (0) - this will restore from the beginning

• Or enter a specific block height if you know when your wallet was created (this speeds up restoration)

Step 6: Wait for restoration

• The wallet will restore and start syncing

• This may take some time depending on the restore height

Step 7: Verify your wallet Once restored, type:

address

This should show your wallet address. Verify it matches the address you expect.

Important Notes

• Keep your seed phrase safe! Never share it with anyone. Anyone with your seed phrase can access your funds.

• Restore height: If you know approximately when your wallet was created (block height), entering it will speed up the restoration process. Otherwise, use 0 to restore from the beginning.

• Wallet file location: The wallet file will be saved at /data/sn01.keys inside the Docker container (or whatever path you specified with --wallet-file).

• Password: You'll need to remember the password you set during restoration to open the wallet in the future.

• Service node registration: If you're restoring a wallet that was used for a service node, make sure the wallet address matches your registered service node address.