Skip to content

Commit

Permalink
Create Using the Sui Wallet Browser Extension page under Explore (Mys…
Browse files Browse the repository at this point in the history
…tenLabs#2988)

* Create wallet-browser.md

* Build out wallet browser page with image references
  • Loading branch information
Clay-Mysten authored Jul 5, 2022
1 parent 43d92dd commit 344cb5c
Showing 1 changed file with 78 additions and 0 deletions.
78 changes: 78 additions & 0 deletions doc/src/explore/wallet-browser.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
title: Using the Sui Wallet Browser Extension
---

Welcome to the [Sui Wallet Browser Chrome Extension](https://chrome.google.com/webstore/detail/sui-wallet/albddfdbohgeonpapellnjadnddglhgn?hl=en&authuser=0) covering its installation and use. The Sui Wallet Browser Extension acts as your portal to the Web3 world.

## Features

The Sui Wallet Browser Extension offers these features:

* Create, import, and persistently store the mnemonics and the derived private key
* Transfer coins
* See owned fungible tokens and NFTs
* Display recent transactions
* Go directly to the successful/failed transaction in the Sui Explorer

Note, the wallet will auto split/merge coins if the address does not have a Coin object with the exact transfer amount. See the [Use](#use) section for guidance on employing these features.

## Purpose

Initially, the Sui Wallet Browser Extension is aimed at Sui developers for testing purposes. As such, the tokens are of no value (just like the rest of [DevNet](https://github.com/MystenLabs/sui/blob/main/doc/src/explore/devnet.md)) and will disappear each time we reset the network. In time, the Sui Wallet Browser Extension will be production ready for real tokens.

This browser extension is a pared-down version of the [Sui Wallet command line interface (CLI)](https://github.com/MystenLabs/sui/blob/main/doc/src/build/wallet.md) that provides greater ease of use for the most commonly used features. If you need more advanced features, such as merge/split coins or make arbitrary [Move](https://github.com/MystenLabs/sui/blob/main/doc/src/build/move.md) calls, instead use the [Wallet CLI](https://github.com/MystenLabs/sui/blob/main/doc/src/build/wallet.md).


## Install

To install the Sui Wallet Browser Extension:
1. Visit its [link in the Chrome Webstore](https://chrome.google.com/webstore/detail/sui-wallet/albddfdbohgeonpapellnjadnddglhgn?hl=en&authuser=0).
1. Click **Install**.
1. Optionally, [pin the extension](https://www.howtogeek.com/683099/how-to-pin-and-unpin-extensions-from-the-chrome-toolbar/) to add it to your toolbar for easy access.

## Start up

To begin using the Sui Wallet Browser Extension:
1. Open the extension and click **Get Started**:
![Start up Sui Wallet](../../static/Sui-wallet-get-started.png "Start up Sui Wallet")
*Start up Sui Wallet Browser Extension*
1. Click **Create new wallet**:
![Create new Sui Wallet](../../static/Sui-wallet-new-account.png "Create new Sui Wallet")
*Create new wallet with Sui Wallet Browser Extension*
1. Accept the terms of service and click **Create**:
![Accept the terms of service for Sui Wallet](../../static/Sui-wallet-ToS.png "Accept ToS")
*Accept the terms of service for Sui Wallet Browser Extension*
1. View and capture the distinct Backup Recovery Passphrase (mnemonic) for the new wallet.
1. Click **Done**.

## Configure

In the Wallet home page, you will see the message _No Tokens Found_:
![No tokens found](../../static/Sui-wallet-no-tokens.png.png "[No tokens found")
*Time to populate your wallet*

To finish setting up the Sui Wallet Browser Extension for testing:
1. From the _Active Account_ in your wallet, copy your **address**:
![Copy address from Sui Wallet](../../static/Sui-wallet-copy-address.png "Copy address")
*Copy your address from the Sui Wallet Browser Extension*
1. Join [Discord](https://discord.gg/sui) If you haven’t already.
1. Request tokens in the [#devnet-faucet](https://discord.com/channels/916379725201563759/971488439931392130)
channel per the [SUI tokens](../build/install.md#sui-tokens) install documentation.
1. Optionally, confirm the transaction in Sui Explorer:
![See transfer in Sui Explorer](../../static/Sui-explorer-token-transfer.png "See Sui Explorer")
*See transfer in Sui Explorer*

## Use

The Sui Wallet Browser Extension lets you:

* See your account balance by clicking the **Tokens ($)** icon.
* Send coins by clicking **Send** in the _Tokens_ tab.
* Transfer NFTs by clicking **Send NFT** on the _NFT_ tab.
* Go to the [Sui Explorer](https://explorer.devnet.sui.io/) view of the current transaction by clicking the external link icon at the bottom right.
* See _recent transactions_ by clicking the **Arrow** icon at the top.
* From the **Settings (gear)** menu, you may:
* View your account on the Sui Explorer
* Mint Demo NFTs
* See the Sui terms of service
* Log out of the Wallet

0 comments on commit 344cb5c

Please sign in to comment.