-
Notifications
You must be signed in to change notification settings - Fork 11.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Update wallet-browser.md Updates for the pending release this week. * Update wallet-browser.md * Update wallet-browser.md * Update wallet-browser.md * Update wallet-browser.md
- Loading branch information
1 parent
71a96f6
commit 110dd6d
Showing
1 changed file
with
110 additions
and
105 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,137 +1,142 @@ | ||
| --- | ||
| title: Using the Sui Wallet Browser Extension | ||
| title: Sui Wallet | ||
| --- | ||
|
|
||
| Welcome to the [Sui Wallet Browser Chrome Extension](https://chrome.google.com/webstore/detail/sui-wallet/opcgpfmipidbgpenhmajoajpbobppdil). The Sui Wallet Browser Extension acts as your portal to the Web3 world. Follow this guide to install and use the extension. | ||
| This topic describes how to install and use the [Sui Wallet Browser Extension](https://chrome.google.com/webstore/detail/sui-wallet/opcgpfmipidbgpenhmajoajpbobppdil). You can use the Sui Wallet to create an address and complete transactions, mint NFTs, view and manage assets on the Sui network, and connect with blockchain dApps on Web3. | ||
|
|
||
| ## Purpose | ||
| The early versions of the Sui Wallet let you experiment with the Sui network for testing. The Sui network is still in development, and the tokens have no real value. Accounts reset with each deployment of a new version of the network. View the [devnet-updates](https://discord.com/channels/916379725201563759/1004638487078772736) channel in Discord for updates about the network. | ||
|
|
||
| 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](../build/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. | ||
| To test more advanced features not available in Sui Wallet, see [Sui CLI client](../build/cli-client.md). | ||
|
|
||
| This browser extension is a pared-down version of the [Sui CLI client](../build/cli-client.md) that provides greater ease of use for the most commonly used features. If you need more advanced features, such as merging/splitting coins and making arbitrary [Move](../build/move/index.md) calls, instead use the [Sui CLI client](../build/cli-client.md). | ||
| ## Sui Wallet features | ||
|
|
||
| ## Features | ||
| You can use the Sui Wallet to: | ||
|
|
||
| The Sui Wallet Browser Extension offers these features: | ||
| * Mint NFTs | ||
| * Transfer coins and NFTs to another address | ||
| * View your coins, tokens, and NFTs | ||
| * View recent transactions | ||
| * Auto split/merge coins to the exact transfer amount | ||
| * Easily access transaction history in the [Sui Explorer](https://explorer.devnet.sui.io/) | ||
|
|
||
| * Create, import, and persistently store the backup recovery passphrases (mnemonics) and the derived private key | ||
| * Create NFTs | ||
| * Transfer coins | ||
| * See owned fungible tokens and NFTs | ||
| * Display recent transactions | ||
| * Auto split/merge coins if the address does not have a Coin object with the exact transfer amount | ||
| * Go directly to the successful/failed transaction in the [Sui Explorer](https://explorer.devnet.sui.io/) | ||
| * A demonstration [NFT dApp](https://github.com/MystenLabs/sui/tree/main/wallet/examples/demo-nft-dapp) available [in the Cloud](http://sui-wallet-demo.s3-website-us-east-1.amazonaws.com/) | ||
| Note that in the current release, the wallet includes buttons to **Buy**, **Swap**, and **Stake & Earn SUI**. These are placeholders for functionality included in future versions of the Sui Wallet. | ||
|
|
||
| See [Demos](#demos) for depictions of these features in play and [Use](#use) to find these features in navigation. | ||
| ## Install the Sui Wallet Chrome Browser Extension | ||
|
|
||
| ## Demos | ||
| To use the Sui Wallet you must install a Chrome browser extension. You can use the extension with any browser that supports Chrome extensions from the Google Chrome Store. | ||
|
|
||
| The following animated GIFs walk you through some of the most common workflows in the Sui Wallet Browser Extension. | ||
| 1. Open the [Sui Wallet](https://chrome.google.com/webstore/detail/sui-wallet/opcgpfmipidbgpenhmajoajpbobppdil) page on the Google Chrome Store. | ||
| 1. Click **Add to Chrome**. | ||
| 1. Acknowledge the message about permissions for the extension, and then click **Add Extension**. | ||
|
|
||
| ### Set up Wallet | ||
| ## Create a new wallet | ||
|
|
||
| Install and configure the Sui Wallet Browser Extension (covered in detail starting with [Install](#install)): | ||
| If you don't yet have a Sui Wallet, create a new one. To import an existing wallet, see [Import an existing Sui Wallet](#import-an-existing-sui-wallet). | ||
|
|
||
|  | ||
| *Set up the Sui Wallet Browser Extension* | ||
| 1. Open the Sui Wallet extension in your browser and then click **Get Started**. | ||
| 1. Click **Create new wallet**. | ||
| 1. Click the checkbox to accept the Terms of Service. | ||
| 1. Click **Create Wallet Now**. | ||
| 1. Copy the Recovery passphrase and store it in a safe location. | ||
| 1. Click **Done**. | ||
|
|
||
| ### Create NFT | ||
| If you lose access to your wallet, you can recover it only with the recovery passphrase. If you lose the passphrase, you lose access to your wallet and any coins or NFTs stored in it. | ||
|
|
||
| From a demo decentralized site, such as our demonstration [NFT dApp](https://github.com/MystenLabs/sui/tree/main/wallet/examples/demo-nft-dapp) available [in the Cloud](http://sui-wallet-demo.s3-website-us-east-1.amazonaws.com/), you can connect to your wallet and create a custom NFT: | ||
| ## Import an existing Sui Wallet | ||
|
|
||
|  | ||
| *Create an NFT in Sui Wallet by connecting to an external site* | ||
| You can use your Sui Wallet on multiple devices and browsers. After you create a Sui Wallet, use the 12-word recovery passphrase to import your wallet to a new browser or device. | ||
|
|
||
| ### Transfer NFT | ||
| 1. Open the Sui Wallet extension in your browser and then click **Get Started**. | ||
| 1. Click **Import a wallet**. | ||
| 1. Enter your 12-word recovery passphrase, and then click **Import Wallet Now**. | ||
|
|
||
| Transfer your NFT to another address using the Sui Wallet Browser Extension: | ||
| ## Add Sui tokens to your Sui Wallet | ||
|
|
||
|  | ||
| *Transfer your NFT to another address* | ||
| When you first open the wallet you have no coins in it. You can add tokens to your wallet through Discord. You need an active Discord account to access the Sui channels. | ||
|
|
||
| ### Transfer token | ||
| 1. Click **Coins**. | ||
| 1. Click the small clipboard icon next to your address to copy it. | ||
| It's near the top of the wallet and starts with 0x. | ||
| 1. Open the Sui [devnet-faucet](https://discord.com/channels/916379725201563759/971488439931392130) channel in Discord. | ||
| 1. Use the `!faucet` command with your wallet address to request tokens: | ||
| `!faucet 0x6c04ed5110554acf59ff1b535129548dd9a0c741` | ||
| Replace the address in the command with your wallet address. | ||
|
|
||
| Transfer your token to another address on the Sui network using the Sui Wallet Browser Extension: | ||
| The channel bot displays a message that "5 test SUI objects are heading to your wallet". You can then see 250,000 SUI tokens in your wallet, nice! | ||
|
|
||
|  | ||
| *Transfer tokens to another address* | ||
| ## View your account balance | ||
|
|
||
| ### View transaction history | ||
| To view your account balance, click **Coins**. The wallet shows your SUI balance and lists the other coins in your wallet, if any. | ||
|
|
||
| View your recent transactions and visit [Sui Explorer](https://explorer.devnet.sui.io/), where you can see more details about the corresponding transaction: | ||
|
|
||
|  | ||
| *Under the *Settings* tab, view your account on Sui Explorer* | ||
| ## Send coins | ||
|
|
||
| ## Install | ||
| You can send coins from your wallet to another address. | ||
|
|
||
| 1. Open the Sui Wallet extension in your browser. | ||
| 1. Click **Coins** and then click **Send**. | ||
| 1. In the **Amount** field, enter the number of SUI tokens to send, and then click **Continue**. | ||
| 1. Enter the recipient's address, then click **Send Coins Now**. | ||
|
|
||
|
|
||
| ## View recent transaction details | ||
|
|
||
| The wallet displays the recent transactions to and from your wallet on the **Activity** tab. Click on any transaction to view transaction details. | ||
|
|
||
|
|
||
| ## View all transactions in Sui Explorer | ||
|
|
||
| You can view all transactions for your address in [Sui Explorer](https://explorer.devnet.sui.io/). | ||
|
|
||
| To view all of the transactions for your address, click **Apps** and then click **View account on Sui Explorer**. | ||
|
|
||
| Sui Explorer opens with the details for your wallet address displayed. | ||
|
|
||
|
|
||
| ## Mint an NFT | ||
|
|
||
| You can mint your own NFTs directly from the Sui Wallet. | ||
|
|
||
| Click **Apps**, then click **Mint NFT**. In the current version you can mint only example NFTs. | ||
|
|
||
|
|
||
| ## View your NFTs | ||
|
|
||
| Click the **NFTs** tab to view all of the NFTS that you mint, purchase, or receive in your wallet. This includes any NFTs that you obtain from connected apps. Click on an NFT to view additional details about it, view a larger NFT image, or send the NFT to another address. | ||
|
|
||
|
|
||
| ## Send an NFT | ||
|
|
||
| You can use Sui Wallet to send an NFT to another address. | ||
|
|
||
| 1. Click **NFTs**. | ||
| 1. Click on the NFT to send, and then click **Send NFT**. | ||
| 1. Enter the recipient address then click **Send NFT Now**. | ||
| 1. Click **Done** to return to the wallet. | ||
|
|
||
|
|
||
| ## Wallet Playground | ||
|
|
||
| You can view and try out some apps that already support the Sui Wallet from the Playground on the Apps tab. The apps displayed let you connect your Sui Wallet and use SUI tokens to interact with them, perform transactions, and obtain NFTs that go directly to your connected wallet. | ||
|
|
||
| Click on an app to open the site for the app. Follow the guidance on the site to connect your wallet. After you connect your wallet to an app you can view the app on the **Active Connections** view. | ||
|
|
||
|
|
||
| ## View connected apps | ||
|
|
||
| To view the apps with active connections to your wallet, click Apps. By default, the Playground view displays. Click Active Connections to view the connected apps. | ||
|
|
||
| To open the site associated with the app, click on the app and then click View. | ||
|
|
||
|
|
||
| ## Disconnect from an app | ||
|
|
||
| You can easily disconnect your wallet from a connected app. | ||
| 1. Click Apps and then click Active Connections. | ||
| 1. Click the app to disconnect from your wallet, then click Disconnect. | ||
|
|
||
| Your wallet immediately disconnects from the app and returns to the **Apps** tab. | ||
|
|
||
| To install the Sui Wallet Browser Extension: | ||
| 1. Visit its [link in the Chrome Webstore](https://chrome.google.com/webstore/detail/sui-wallet/opcgpfmipidbgpenhmajoajpbobppdil). | ||
| 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 Browser Extension* | ||
| 1. Click **Create new 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 Browser Extension* | ||
| 1. View and capture the distinct mnemonic for the new wallet. | ||
| 1. Click **Done**. | ||
|
|
||
| ## Configure | ||
|
|
||
| In the Wallet home page, you will see the message _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 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* | ||
|
|
||
| ## Use | ||
|
|
||
| The Sui Wallet Browser Extension lets you: | ||
|
|
||
| * See your account balance by clicking the **Tokens ($)** icon: | ||
|  | ||
| *See your account balance in the Sui Wallet Browser Extension* | ||
| * Send coins by clicking **Send** in the _Tokens_ tab: | ||
|  | ||
| *Send tokens with the Sui Wallet Browser Extension* | ||
| * Transfer NFTs by clicking **Send** on the _NFT_ tab: | ||
|  | ||
| *Send NFTs with the Sui Wallet Browser Extension* | ||
| * View _recent transactions_ by clicking the **Arrow** icon at the top: | ||
|  | ||
| *View recent transactions in the Sui Wallet Browser Extension* | ||
| * Sign transactions through a framework connecting Sui wallet to other DApps: | ||
|  | ||
| *Sign transactions in the Sui Wallet Browser Extension* | ||
| * 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 | ||
|  | ||
| *Access settings for the Sui Wallet Browser Extension* | ||
| * 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. | ||
|
|
||
| ## Contribute | ||
|
|
||
| If you want to experiment with and contribute to the Sui Wallet Browser Extension, you can find its source and README at: | ||
| https://github.com/MystenLabs/sui/tree/main/wallet |