Skip to content

Commit

Permalink
docs: add 'pcli migrate balance' explainer
Browse files Browse the repository at this point in the history
Adds a short explainer for how the `pcli migrate balance` functionality
works. Refs:

* penumbra-zone/penumbra#4831
* penumbra-zone/penumbra#4849
  • Loading branch information
conorsch committed Sep 10, 2024
1 parent f97ca53 commit 40e8b61
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 2 deletions.
5 changes: 3 additions & 2 deletions pages/pcli/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,6 @@
"wallet": "Generating a Wallet",
"balance": "Viewing Balances",
"transaction": "Sending Transactions",
"governance": "Using Governance"
}
"governance": "Using Governance",
"migrating": "Migrating wallets"
}
18 changes: 18 additions & 0 deletions pages/pcli/migrating.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Migrating wallets

In order to transfer all assets in your wallet to a new wallet,
first [generate a new wallet](wallet.md). After doing so, inspect the generated `config.toml`
file for the `full_viewing_key` (FVK) field. You'll need this value to designate
the new wallet, to which funds will be transferred.

Then, run the migrate balance command from the first wallet, the one you want to empty of funds:

```bash
pcli migrate balance
```

That command will prompt for the FVK of the destination wallet.
Paste in the FVK, and hit enter to build and submit the transaction.
After sending, the source wallet should be completely empty, and the destination wallet
should have all assets, minus any gas fees that were paid for the transaction.
Assets will be preserved in their numbered accounts across source and destination wallets.

0 comments on commit 40e8b61

Please sign in to comment.