Skip to content

Commit

Permalink
guide: improve web section documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
aubrika committed Jul 26, 2024
1 parent aca2220 commit c43cfc1
Show file tree
Hide file tree
Showing 2 changed files with 76 additions and 1 deletion.
66 changes: 65 additions & 1 deletion pages/web/prax.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,65 @@
# Prax wallet
# Prax Wallet

This section describes how to use the Prax Wallet web extension, an official GUI client for Penumbra.

Currently, the web extension only supports a subset of functionality of the
command-line client, [`pcli`](./pcli.md).

## Installing the extension

The Penumbra Wallet web extension only supports the Google Chrome browser.
You must run Chrome in order to follow the instructions below.

Visit the Web Store page to download the [Prax Wallet](https://chromewebstore.google.com/detail/prax-wallet/lkpmkhpnhknhmibgnmmhdhgdilepfghe), and click **Add to Chrome** to install it.

## Generating a wallet

When you first open the extension, you'll be offered to import a pre-existing wallet. If you don't already have one, choose **Create a new wallet**.
During the guided tutorial, you'll need to set a passphrase to protect your wallet. The passphrase
is *not* the same as the recovery phrase. The passphrase is used to restrict access to the web wallet
on your computer. The recovery phrase can be used to import your wallet on a fresh installation, or
on a different machine. Make sure to store both the passphrase and the recovery phrase
securely, for example in a password manager.

Re-enter portions of the recovery phrase when prompted, to confirm that you've saved it properly.
Then you'll be taken to a screen that shows an initial synchronization process with the selected network:

<!--
Do we want to maintain screenshots inside the web extension docs?
The image files will become out of data quickly, requiring maintenance, and bloat the repo.
-->

<picture>
<source srcset="images/web-extension-sync-progress.png" media="(prefers-color-scheme: dark)" />
<img src="images/web-extension-sync-progress.png" />
</picture>

## Select your preferred RPC endpoint

Once you import or generate a wallet, you will be prompted to select an RPC endpoint, which is the URL the extension uses to sync with the network.
These are hosted by the community (including yourself, if you like), and those provided in the UI are typically offered by known validators.
You may also provide your own custom endpoint, whether that is a community provider not provided as a default option, or hosted on a node you run yourself.

## Select your preferred frontend app

The extension will prompt you to select a frontend app to use with the wallet. This is a web interface that you will use to interact with the blockchain.
The provided options are community hosted frontends, and you may also provide your own custom frontend URL.
Connecting a frontend to your wallet grants the frontend provider a full viewing key for your wallet in order to decrypt and display relevant information, such as your wallet balance.
*This means that the front-end provider has read access (only) to your wallet and all of its activity.* This is necessary for the encrypted data on-chain to be parsed and rendered in a human-readable format.
However, this means that you should only connect to frontend providers that you trust, because they can see any actions taken by the connected wallet by using the full viewing key.
If you desire greater privacy, you can always run your own frontend, or utilize the command-line client, `pcli`, to interact with the blockchain directly.

## Updating to a new version of the extension

The extension should be automatically updated every time a new version is released.
You can view the latest version of the extension on the [Prax Wallet] page at the
Chrome Web Store. To force a check for updates:

1. Click the three-dot icon in the top right corner of the browser.
2. From the drop-down menu, choose **Extensions -> Manage Extensions**.
3. Select **Update** on the top panel.

After updating the extension manually, it may be helpful to clear the local cache,
as described above.

[Prax Wallet]: https://chromewebstore.google.com/detail/prax-wallet/lkpmkhpnhknhmibgnmmhdhgdilepfghe
11 changes: 11 additions & 0 deletions pages/web/send.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,12 @@
# Sending Funds


## Creating transactions

Once you have the web wallet configured, you can use it to send transactions.

Navigate to the dApp website:
[https://app.testnet.penumbra.zone/](https://app.testnet.penumbra.zone/) and
click **Connect**, then authorize the extension to work with the site. After
doing so, you'll see buttons for actions such as **Receive**, **Send**, and
**Exchange**.

0 comments on commit c43cfc1

Please sign in to comment.