diff --git a/docs/guides/observer-wallet-guide.md b/docs/guides/observer-wallet-guide.md index 25f6933778..8a98cff94c 100644 --- a/docs/guides/observer-wallet-guide.md +++ b/docs/guides/observer-wallet-guide.md @@ -12,6 +12,12 @@ import TabItem from '@theme/TabItem'; An observer wallet is a wallet that cannot be used for sending transactions. In other words, it is a read-only wallet. This is a powerful concept for HODLers and farmers alike. +:::info + +Currently, you need to understand how to use a command line interface (CLI) in order to set up an observer wallet. Eventually, we will make this setup easier for GUI users. + +::: + Until the introduction of observer wallets, the Chia reference wallet always stored each public/private key pair locally. It was possible to maintain an offline key, for example in order to receive farmer rewards, but checking the balance required using a blockchain explorer. However, as a privacy feature, Chia wallets generate a new address each time they receive money. A blockchain explorer is therefore not always able to provide an accurate view of a wallet's history. With an observer wallet, you can view your wallet's history and balance without the risk of funds being stolen by someone who gains access to your computer. @@ -24,68 +30,30 @@ Eventually, we will add the ability to sign transactions using an external signe ## Set up -In order to set up an observer wallet, you need to know the wallet's public key. This guide will demonstrate one technique to obtain this information. - -If you don't have an existing wallet that you would like to convert to an observer wallet, then you will need to create one. From the "Chia Wallet Keys" screen, click `ADD WALLET` and `Create New`: - -

- observer wallet -

-
- -You will be shown a 24-word seed phrase. Write down these words, and store them in a secure place. As with all wallets that use a seed phrase, if a malicious actor obtains these words, they can steal all of your funds. - -:::warning important - -To load an observer wallet, the seed phrase is not required. However, in order to spend the funds in an observer wallet later, the seed phrase **is** required. It is critically important to securely save this seed phrase, just as you would with a non-observer wallet. If you do not save a copy of the seed phrase, you will never be able to spend this wallet's funds. +This guide assumes you have a wallet set up in non-observer mode, and that you want to set up the same wallet in observer mode on a new computer where Chia is also installed. -::: - -After securely copying the seed phrase, enter a name for the wallet and click `NEXT`: - -

- observer wallet -

-
- -Your new wallet will be created as a normal, non-observer wallet. At this point, you can exit the wallet (we will return to it shortly): - -

- observer wallet -

-
+The first step is to obtain the wallet's master public key from the original computer. Open a command prompt or terminal window, and enter the following: -From the `Chia Wallet Keys` screen, click the three dots associated with your wallet, and click `Details`: - -

- observer wallet -

-
- -Copy the value of `Public Key`, which has been removed from the following image, but is the long string below the red circle. When you have safely stored your wallet's public key (it can be stored along with the seed phrase), click `CLOSE`: - -

- observer wallet -

-
- -Now that you have saved a copy of your wallet's public key, you can delete your wallet. From the `Chia Wallet Keys` screen, click the three dots associated with your wallet, and click `Delete`: - -

- observer wallet -

-
+```bash +chia keys show +``` -You will need to enter your wallet's fingerprint, and click `DELETE`: +Locate your wallet's fingerprint. You will see something like the following: -

- observer wallet -

-
+```bash +Showing all public keys derived from your master key: + +Label: Testnet11 Small +Fingerprint: +Master public key (m): +Farmer public key (m/12381/8444/0/0): +Pool public key (m/12381/8444/1/0): +First wallet address:
+``` -Next, you can re-add your wallet using its public key. To do this, first save your wallet's public key in a text file. This file must only contain the public key, and it must be on a single line. +Save a copy of the key shown with `Master public key (m):` in a text file. This file must only contain the public key, and it must be on a single line. Copy this file to the computer on which you want to load the wallet in observer mode. -Open a command prompt or terminal window, and enter the following: +From your second computer, run the following command to add your wallet in observer mode: ```bash chia keys add -f -l "" @@ -94,7 +62,7 @@ chia keys add -f -l "" Be sure to enter the actual file path, as well as whatever name you want to call your observer wallet. The output will look something like the following: ```bash -Added public key with fingerprint +Added public key with fingerprint ``` You may also see a warning such as the following, which can be safely ignored: @@ -142,5 +110,3 @@ This should result in an error: observer wallet


- -When you need to spend the wallet's funds, delete the observer wallet, and re-add it using the seed phrase.