instructions

Restoring a backed-up wallet

Introduction

If, for whatever reason, your Golem wallet is destroyed or corrupted e.g. you moved on to a new machine and forgot to take Golem's installation with it, you'll be faced with the necessity to recover your wallet from your previously backed-up keystore file.

To restore your wallet, first start with a fresh yagna install:

curl -sSf https://join.golem.network/as-requestor | bash -
warning

The above line assumes you're a requestor on a Unix-like platform (Linux or Mac). If that's not the case, you should use an installation procedure appropriate for your platform. Please refer to the Yagna installation instructions for requestors or the analogous instructions for providers.

Once Yagna is installed, run it with:

yagna service run

Now, as usual, leave the service running in the background and proceed with the rest of the process in another terminal window.

Retrieve your keystore

Here you'll need the key.json file you had previously backed up. Do whatever you need to restore it - e.g. decrypt it if you previously encrypted it. For the process to work, it must be the same plain-text JSON file that Yagna originally exported.

Be sure that your key.json file is in your current working directory and run:

yagna id create --from-keystore ./key.json

This should create a new identity in Yagna based on your backed-up wallet. If the private key that you just imported is password-protected, the message that you receive on a successful import will include isLocked: true which means that you'll need to unlock the key later on before it can be used by Yagna.

On the other hand, if the message reads: isLocked: false, it means that you're using an unprotected keystore file.

Set the new identity as Yagna's default

1. Using the Ethereum address of your backed-up wallet, run:

yagna id update --set-default 0x-the-address

2. Stop your Yagna service

(Just press Ctrl-C in the console that's running yagna service run and wait for the service to exit)

3. Remove yagna's accounts configuration file

rm $HOME/.local/share/yagna/accounts.json

4. Start your yagna service again (as usual, do it in a separate command line terminal and allow it to run in the background)

yagna service run

5. Ensure Yagna is using your newly restored wallet

yagna id show

The nodeId property should display the Ethereum address of your backed-up wallet.

warning

If your key is password-protected, you'll need to unlock it before it can be used for payments. In such a case, yagna id show command above will report:

isLocked: true

To unlock your key, you can use:

yagna id unlock

and supply the key's password.

This will unlock your key and yagna will be able to use it for outgoing payments. You can confirm that the operation succeeded by verifying that the output now reports:

isLocked: false

You'll need to unlock your key each time you start your Yagna service because, for security reasons, Yagna does not save your passphrase anywhere.

Make sure your Yagna application key is bound to the correct account

If you have used yagna before, you have probably already created an application key (the key that the requestor agent uses to connect to the yagna service).

In that case, after you import your Ethereum mainnet key, you need to re-create Yagna's application key, as the previous one is now bound to your old key:

yagna app-key create requestor-mainnet

The name (requestor-mainnetabove) is not important as long as it doesn't collide with the existing one (assuming it was just requestor).

After you have done that, run:

yagna app-key list

and verify that, in the table like the one below, your new app-key is bound to your mainnet Ethereum address

┌─────────────────────┬────────────────┬───────────────────────────┬───────────┬──────────────────────────────┐
│  name               │  key           │  id                       │  role     │  created                     │
├─────────────────────┼────────────────┼───────────────────────────┼───────────┼──────────────────────────────┤
│  requestor-mainnet  │  your-app-key  │  0x-your-mainnet-address  │  manager  │  2021-07-06T11:41:52.252257  │
└─────────────────────┴────────────────┴───────────────────────────┴───────────┴──────────────────────────────┘

Lastly, remember to set the new app-key in your environment (or in another way you supply the app key to your requestor agent app).