diff --git a/docs/general/images/wallet/ext/account_derivation.png b/docs/general/images/wallet/ext/account_derivation.png new file mode 100644 index 0000000000..c5b738bbb9 Binary files /dev/null and b/docs/general/images/wallet/ext/account_derivation.png differ diff --git a/docs/general/images/wallet/ext/account_history.png b/docs/general/images/wallet/ext/account_history.png deleted file mode 100644 index 2a2c43d392..0000000000 Binary files a/docs/general/images/wallet/ext/account_history.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/account_overview.png b/docs/general/images/wallet/ext/account_overview.png deleted file mode 100644 index 6fcaea02fa..0000000000 Binary files a/docs/general/images/wallet/ext/account_overview.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/accounts1.png b/docs/general/images/wallet/ext/accounts1.png deleted file mode 100644 index 82defa70d1..0000000000 Binary files a/docs/general/images/wallet/ext/accounts1.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/accounts2.png b/docs/general/images/wallet/ext/accounts2.png deleted file mode 100644 index d6e72edf1c..0000000000 Binary files a/docs/general/images/wallet/ext/accounts2.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/accounts3.png b/docs/general/images/wallet/ext/accounts3.png deleted file mode 100644 index 1c31544af9..0000000000 Binary files a/docs/general/images/wallet/ext/accounts3.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/buy.png b/docs/general/images/wallet/ext/buy.png new file mode 100644 index 0000000000..821c579f59 Binary files /dev/null and b/docs/general/images/wallet/ext/buy.png differ diff --git a/docs/general/images/wallet/ext/create_new_wallet_mnemonic1.png b/docs/general/images/wallet/ext/create_new_wallet_mnemonic1.png new file mode 100644 index 0000000000..2f9c313e6c Binary files /dev/null and b/docs/general/images/wallet/ext/create_new_wallet_mnemonic1.png differ diff --git a/docs/general/images/wallet/ext/create_new_wallet_mnemonic2.png b/docs/general/images/wallet/ext/create_new_wallet_mnemonic2.png new file mode 100644 index 0000000000..6765e31e4b Binary files /dev/null and b/docs/general/images/wallet/ext/create_new_wallet_mnemonic2.png differ diff --git a/docs/general/images/wallet/ext/create_profile.png b/docs/general/images/wallet/ext/create_profile.png new file mode 100644 index 0000000000..fbe40f4d22 Binary files /dev/null and b/docs/general/images/wallet/ext/create_profile.png differ diff --git a/docs/general/images/wallet/ext/create_wallet.png b/docs/general/images/wallet/ext/create_wallet.png deleted file mode 100644 index 7af7b2dc77..0000000000 Binary files a/docs/general/images/wallet/ext/create_wallet.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/delegate1.png b/docs/general/images/wallet/ext/delegate1.png new file mode 100644 index 0000000000..3aa90a7e18 Binary files /dev/null and b/docs/general/images/wallet/ext/delegate1.png differ diff --git a/docs/general/images/wallet/ext/delegate2.png b/docs/general/images/wallet/ext/delegate2.png new file mode 100644 index 0000000000..7b709a71a3 Binary files /dev/null and b/docs/general/images/wallet/ext/delegate2.png differ diff --git a/docs/general/images/wallet/ext/delegate3.png b/docs/general/images/wallet/ext/delegate3.png new file mode 100644 index 0000000000..a49f44268d Binary files /dev/null and b/docs/general/images/wallet/ext/delegate3.png differ diff --git a/docs/general/images/wallet/ext/deposit.png b/docs/general/images/wallet/ext/deposit.png deleted file mode 100644 index 2b12f22e70..0000000000 Binary files a/docs/general/images/wallet/ext/deposit.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/deposit1.png b/docs/general/images/wallet/ext/deposit1.png new file mode 100644 index 0000000000..f64806a645 Binary files /dev/null and b/docs/general/images/wallet/ext/deposit1.png differ diff --git a/docs/general/images/wallet/ext/deposit2.png b/docs/general/images/wallet/ext/deposit2.png new file mode 100644 index 0000000000..84c6fb9622 Binary files /dev/null and b/docs/general/images/wallet/ext/deposit2.png differ diff --git a/docs/general/images/wallet/ext/deposit3.png b/docs/general/images/wallet/ext/deposit3.png new file mode 100644 index 0000000000..23d52801e6 Binary files /dev/null and b/docs/general/images/wallet/ext/deposit3.png differ diff --git a/docs/general/images/wallet/ext/deposit4.png b/docs/general/images/wallet/ext/deposit4.png new file mode 100644 index 0000000000..346799def0 Binary files /dev/null and b/docs/general/images/wallet/ext/deposit4.png differ diff --git a/docs/general/images/wallet/ext/deposit5.png b/docs/general/images/wallet/ext/deposit5.png new file mode 100644 index 0000000000..41953c28a2 Binary files /dev/null and b/docs/general/images/wallet/ext/deposit5.png differ diff --git a/docs/general/images/wallet/ext/import.png b/docs/general/images/wallet/ext/import.png deleted file mode 100644 index 290842e0e8..0000000000 Binary files a/docs/general/images/wallet/ext/import.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/import1.png b/docs/general/images/wallet/ext/import1.png deleted file mode 100644 index be29fc5db9..0000000000 Binary files a/docs/general/images/wallet/ext/import1.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/import2.png b/docs/general/images/wallet/ext/import2.png deleted file mode 100644 index 3c7fa6f671..0000000000 Binary files a/docs/general/images/wallet/ext/import2.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/import3.png b/docs/general/images/wallet/ext/import3.png deleted file mode 100644 index dfffa6d7f0..0000000000 Binary files a/docs/general/images/wallet/ext/import3.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/import_wallet.png b/docs/general/images/wallet/ext/import_wallet.png new file mode 100644 index 0000000000..667fdb2ee8 Binary files /dev/null and b/docs/general/images/wallet/ext/import_wallet.png differ diff --git a/docs/general/images/wallet/ext/import_wallet_ledger1.png b/docs/general/images/wallet/ext/import_wallet_ledger1.png new file mode 100644 index 0000000000..407e47c84a Binary files /dev/null and b/docs/general/images/wallet/ext/import_wallet_ledger1.png differ diff --git a/docs/general/images/wallet/ext/import_wallet_ledger2.png b/docs/general/images/wallet/ext/import_wallet_ledger2.png new file mode 100644 index 0000000000..a3f9506311 Binary files /dev/null and b/docs/general/images/wallet/ext/import_wallet_ledger2.png differ diff --git a/docs/general/images/wallet/ext/import_wallet_mnemonic.png b/docs/general/images/wallet/ext/import_wallet_mnemonic.png new file mode 100644 index 0000000000..9e240c34cc Binary files /dev/null and b/docs/general/images/wallet/ext/import_wallet_mnemonic.png differ diff --git a/docs/general/images/wallet/ext/import_wallet_private_key.png b/docs/general/images/wallet/ext/import_wallet_private_key.png new file mode 100644 index 0000000000..a7d44ad8d5 Binary files /dev/null and b/docs/general/images/wallet/ext/import_wallet_private_key.png differ diff --git a/docs/general/images/wallet/ext/ledger.jpg b/docs/general/images/wallet/ext/ledger.jpg deleted file mode 100644 index a0cda3f58b..0000000000 Binary files a/docs/general/images/wallet/ext/ledger.jpg and /dev/null differ diff --git a/docs/general/images/wallet/ext/ledger1.png b/docs/general/images/wallet/ext/ledger1.png deleted file mode 100644 index b9d3568c45..0000000000 Binary files a/docs/general/images/wallet/ext/ledger1.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/ledger2.png b/docs/general/images/wallet/ext/ledger2.png deleted file mode 100644 index 8c99b2e762..0000000000 Binary files a/docs/general/images/wallet/ext/ledger2.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/ledger3.png b/docs/general/images/wallet/ext/ledger3.png deleted file mode 100644 index a6abacb2f5..0000000000 Binary files a/docs/general/images/wallet/ext/ledger3.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/metamask_account.png b/docs/general/images/wallet/ext/metamask_account.png deleted file mode 100644 index e246039db9..0000000000 Binary files a/docs/general/images/wallet/ext/metamask_account.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes.png b/docs/general/images/wallet/ext/paratimes.png index 6b0bd69766..58c58ed166 100644 Binary files a/docs/general/images/wallet/ext/paratimes.png and b/docs/general/images/wallet/ext/paratimes.png differ diff --git a/docs/general/images/wallet/ext/paratimes2.png b/docs/general/images/wallet/ext/paratimes2.png deleted file mode 100644 index 3d1958c8d0..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes2.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes_deposit.png b/docs/general/images/wallet/ext/paratimes_deposit.png deleted file mode 100644 index ed7040b0fe..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes_deposit.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes_deposit_address.png b/docs/general/images/wallet/ext/paratimes_deposit_address.png deleted file mode 100644 index a6f3e3920b..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes_deposit_address.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes_deposit_amount.png b/docs/general/images/wallet/ext/paratimes_deposit_amount.png deleted file mode 100644 index 36d82e5e2f..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes_deposit_amount.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes_deposit_select.png b/docs/general/images/wallet/ext/paratimes_deposit_select.png deleted file mode 100644 index 34d1a47727..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes_deposit_select.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/paratimes_deposited.png b/docs/general/images/wallet/ext/paratimes_deposited.png deleted file mode 100644 index 92387f9962..0000000000 Binary files a/docs/general/images/wallet/ext/paratimes_deposited.png and /dev/null differ diff --git a/docs/general/images/wallet/ext/stake.png b/docs/general/images/wallet/ext/stake.png new file mode 100644 index 0000000000..5b947543be Binary files /dev/null and b/docs/general/images/wallet/ext/stake.png differ diff --git a/docs/general/images/wallet/ext/transfer.png b/docs/general/images/wallet/ext/transfer.png new file mode 100644 index 0000000000..96762e7fab Binary files /dev/null and b/docs/general/images/wallet/ext/transfer.png differ diff --git a/docs/general/images/wallet/ext/undelegate1.png b/docs/general/images/wallet/ext/undelegate1.png new file mode 100644 index 0000000000..7ac45abd83 Binary files /dev/null and b/docs/general/images/wallet/ext/undelegate1.png differ diff --git a/docs/general/images/wallet/ext/undelegate2.png b/docs/general/images/wallet/ext/undelegate2.png new file mode 100644 index 0000000000..e5219783dc Binary files /dev/null and b/docs/general/images/wallet/ext/undelegate2.png differ diff --git a/docs/general/images/wallet/ext/undelegate3.png b/docs/general/images/wallet/ext/undelegate3.png new file mode 100644 index 0000000000..cbf675074e Binary files /dev/null and b/docs/general/images/wallet/ext/undelegate3.png differ diff --git a/docs/general/images/wallet/ext/wallet.png b/docs/general/images/wallet/ext/wallet.png new file mode 100644 index 0000000000..7e9ac73d1a Binary files /dev/null and b/docs/general/images/wallet/ext/wallet.png differ diff --git a/docs/general/images/wallet/ext/wallet_screen.png b/docs/general/images/wallet/ext/wallet_screen.png new file mode 100644 index 0000000000..0252aed05c Binary files /dev/null and b/docs/general/images/wallet/ext/wallet_screen.png differ diff --git a/docs/general/images/wallet/ext/withdraw1.png b/docs/general/images/wallet/ext/withdraw1.png new file mode 100644 index 0000000000..66d37b5e99 Binary files /dev/null and b/docs/general/images/wallet/ext/withdraw1.png differ diff --git a/docs/general/images/wallet/ext/withdraw2.png b/docs/general/images/wallet/ext/withdraw2.png new file mode 100644 index 0000000000..5d00fa9edd Binary files /dev/null and b/docs/general/images/wallet/ext/withdraw2.png differ diff --git a/docs/general/images/wallet/ext/withdraw3.png b/docs/general/images/wallet/ext/withdraw3.png new file mode 100644 index 0000000000..6b04df5c1a Binary files /dev/null and b/docs/general/images/wallet/ext/withdraw3.png differ diff --git a/docs/general/images/wallet/ext/withdraw4.png b/docs/general/images/wallet/ext/withdraw4.png new file mode 100644 index 0000000000..4cf14c6f4d Binary files /dev/null and b/docs/general/images/wallet/ext/withdraw4.png differ diff --git a/docs/general/images/wallet/ext/withdraw5.png b/docs/general/images/wallet/ext/withdraw5.png new file mode 100644 index 0000000000..af6650fded Binary files /dev/null and b/docs/general/images/wallet/ext/withdraw5.png differ diff --git a/docs/general/manage-tokens/oasis-wallets/browser-extension.mdx b/docs/general/manage-tokens/oasis-wallets/browser-extension.mdx index a8247acd65..794a3bb7f6 100644 --- a/docs/general/manage-tokens/oasis-wallets/browser-extension.mdx +++ b/docs/general/manage-tokens/oasis-wallets/browser-extension.mdx @@ -27,281 +27,431 @@ Next, either [create a new wallet](#create-a-new-account) or ## Create a New Account -Enter the **new wallet password**. You will need to enter this password each -time you open the wallet and after some time when the wallet automatically -locks. Click "Next". +The next screen is devoted to your mnemonic—**a unique list of +words representing your account(s)**. Review the information on this page very +carefully. Save your +mnemonic in the right order in a secure location. + +:::caution + +Your mnemonic (i.e. keyphrase) is required to access your wallet. Be sure to +store it in a secure location. If you lose or forget your mnemonic, you will +lose access to your wallet and any token funds contained in it. + +::: + +:::danger Never share your mnemonic (i.e. keyphrase)! + +Anyone with your mnemonic can access your wallet and your tokens. + +::: + +After you’ve saved your mnemonic, click the “I saved my keyphrase” checkbox and +then click on the “Import my wallet” button.
- ![Create new wallet: Enter - password](../../images/wallet/ext/create_wallet.png) + ![Create a New + Wallet](../../images/wallet/ext/create_new_wallet_mnemonic1.png)
-The newly generated mnemonic is shown to you. Carefully back it up. You will -need this mnemonic, to migrate the wallet to another device or to restore it, if -you uninstall your web browser. Click on the "Confirm backup" button. +Next, you will need to confirm your mnemonic by writing the mnemonic into the +text area. The ROSE Wallet will check for any typos and missing words. When +done click the "Import my wallet" button. -:::caution +
+ ![Confirm your + mnemonic](../../images/wallet/ext/create_new_wallet_mnemonic2.png) +
-Your mnemonic phrase is required to access your wallet. Be sure to **store it in -a secure location**. If you lose or forget your mnemonic phrase, you will lose -access to your wallet and any token funds contained in it. +### Account Derivation -::: +If you correctly entered the mnemonic the **account derivation popup** +will appear containing a list of `oasis1` addresses with their +balances on the right. These are the accounts derived from your +mnemonic based on the [ADR-8 derivation scheme][adr8]. Select one or more +accounts and click the "Open" button to import them into your wallet. -:::danger +
+ ![Account derivation](../../images/wallet/ext/account_derivation.png) +
-**Never share your mnemonic keyphrase**. Anyone with your keyphrase can access -your wallet and your tokens. +### User Profile -::: +If you want to permanently store the keys of selected accounts, turn on the "Create a profile" toggle button below, which will Store your private keys locally and protect them with a password by creating a profile. +After entering a password below, this will **instantiate a profile inside the local store of your +browser to safely store your keys**. To access them, you will need to enter the correct +password each time you will open the ROSE Wallet - Chrome extension. -Now reenter the mnemonic words as a proof that you backed up the mnemonic and -click on the "Confirm" button. Once done, you will see your balance on the -**Oasis consensus layer**. +
+ ![Create a profile](../../images/wallet/ext/create_profile.png) +
+ +After clicking the 'Open' button, you will be taken to the _Wallet screen_, containing +information about your account balance, recent transactions and more.
- ![Account history](../../images/wallet/ext/account_overview.png) + ![The Wallet screen](../../images/wallet/ext/wallet_screen.png)
+[adr8]: ../../../adrs/0008-standard-account-key-generation.md + ## Import an Existing Account -In the top-right corner, click your account icon to open the Account management -menu. +On the "Open wallet" page select whether you want to open your +wallet via a mnemonic, a private key, or a Ledger hardware wallet.
- ![Account Management - Importing - Accounts](../../images/wallet/ext/accounts1.png) + ![Access an Existing Wallet](../../images/wallet/ext/import_wallet.png)
-Click "Import" and select the: + + + + +In the "Enter your mnemonic here" field, enter each word of your mnemonic +separated by a space. Then, hit the "Import my wallet" button. + +
+ ![Open Wallet via + Mnemonic](../../images/wallet/ext/import_wallet_mnemonic.png) +
-- "Oasis Private Key" to import your existing Oasis private key to be used by - Cipher ParaTime; or -- "Ethereum-compatible Private Key" to import your existing Ethereum Account to - be used by the EVM-compatible Sapphire or Emerald. +The [account derivation popup](#account-derivation) will be shown where +you can pick one or more derived accounts to import. :::info -We assume that you already have your public/private keypair. If you don’t have -one yet, please go and create one. Store your Private Key, because you will -need it in the ROSE Wallet - Browser Extension. +The ROSE Wallet uses English mnemonic phrase words as defined in +[BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki). +You can find a complete list of all valid phrase words +[here](https://github.com/bitcoin/bips/blob/master/bip-0039/english.txt). +If you misspelled a word, the wallet will warn you. ::: + + + + +Paste your Base64-encoded Ed25519 private key in the "Enter your private key +here" field and then click on the "Import my wallet" button. +
- ![Importing Ethereum-compatible Account with Private - Key](../../images/wallet/ext/import.png) ![Importing Ethereum-compatible - Account with Private Key](../../images/wallet/ext/import1.png) + ![Open Wallet via Private + Key](../../images/wallet/ext/import_wallet_private_key.png)
-Next, paste your Base64-encoded Oasis or hex-encoded Ethereum private key. +Toggling on "Create a profile" will store private keys locally, protected by a password and instantiate +the [user's profile](#user-profile). -:::note +:::tip -You will need to import **the private key and not the mnemonics**. You can -derive a private key from the mnemonics with BIP39→BIP44 converter. For example -by [importing](../cli/wallet.md#import) the mnemonic into the Oasis CLI and -[exporting it](../cli/wallet.md#export). +The 64 bytes long keypair is the preferred format for importing your account. It +consists of **two 32-byte parts**: + +1. The first part is the **private key** used for signing the transactions + (e.g. for sending tokens from your account). +2. The second part is a **public key** used to verify the signatures + of your transactions and also derive your account's address of the form + `oasis1...`. ::: +:::caution + +If you entered the 64-byte keypair then the wallet checks whether the public +key corresponds to its private counterpart. **If you mistyped any character, the +wallet will not allow you to proceed.** + +However, if you only typed in the first 32-byte part there is **no error +detection possible. It is imperative that you **correctly input all characters\*\* +and not mix similar characters like the big O and 0 or big I and 1! If unsure, +we suggest that you perform a test transaction the first time you import your +wallet from the private key so you can rest assured the key is valid. + +::: + + + + + +To use the Ledger hardware wallet, make sure you have your Ledger device readily +available and have familiarized yourself with the [Oasis-specific Ledger usage instructions](../holding-rose-tokens/ledger-wallet.md). + +Click on 'Grant access to your Ledger' and you'll see a pop-up in your Chrome Browser asking you to select which device to connect. +Click on your Ledger device. Then click "Connec Ledger device". + +Next, click on the "Select accounts to open". If this is the first time you're +using Ledger with your browser, a system popup will appear showing the list of +Ledger devices connected to your computer and requesting permission to use it. +Select one and then click the "Connect" button. +
- ![Entering Ethereum address Private Key - (BIP44)](../../images/wallet/ext/import3.png) + ![Open Wallet via Ledger](../../images/wallet/ext/import_wallet_ledger1.png)
-Your newly imported account will, depending on the account type, appear under -the "Oasis Account" or "Ethereum-compatible Account" sections in the Account -Management screen. Check that the Oasis or Ethereum address shown at the bottom -that it matches the address shown to you when you generated the keypair. +
+ ![Open Wallet via Ledger](../../images/wallet/ext/import_wallet_ledger2.png) +
+ +The [account derivation popup](#account-derivation) will be shown next, +where you can pick one or more derived accounts to import. -:::danger +:::warning -In older versions of the ROSE Wallet - Browser Extension there was also another -Bech32-encoded version of the Ethereum address shown in the Ethereum-compatible -wallet. This address is used in the backend for setting the allowance policy -on the Oasis Network. **If you can see it, you should immediately update -your Wallet Extension! The Bech32-encoded address of the Ethereum-compatible -account must never be used for withdrawing ROSE to. The signature schemes are -incompatible (the consensus layer only supports Ed25519) and those tokens will -not be accessible anymore!** +To date, only Chromium-based browsers support WebUSB component which is required +to access your Ledger device. ::: + + + +Finally, you will be taken to your _Wallet screen_, containing information about +your account balance, recent transactions and more. + +## Transfer + + + + + +To transfer tokens, open the _Wallet screen_. Fill in the "Recipient" and +"Amount" fields and click "Send". A confirmation popup will appear showing +transaction details. Carefully review the transaction and click the "Confirm" +button. +
- ![Account Management - Accounts - Overview](../../images/wallet/ext/accounts2.png) + ![Transfer confirmation dialog](../../images/wallet/ext/transfer.png)
-## Ledger + + -1. Plug your Ledger device into your computer and log into the Oasis app on-device +To receive tokens, open the _Wallet screen_ and copy the `oasis1` account +address at the top.
- ![Oasis App Ready on Ledger Nano S connected to your - device](../../images/wallet/ext/ledger.jpg) + ![The Wallet screen](../../images/wallet/ext/wallet.png)
-2. Open the Oasis Chrome Extension Wallet and click the account icon on the top - right. Select Ledger on the bottom right of the app. + + + +## Stake + +To [stake your tokens](../staking-and-delegating.md) go to _Stake tab_ at the bottom navigation. +The list of validators will appear, their status, current escrow and the +commission fee. Follow the sections below to delegate or undelegate your tokens.
- ![Unlock your ROSE Wallet Browser - Extension](../../images/wallet/ext/ledger1.png) + ![Stake screen](../../images/wallet/ext/stake.png)
-4. Follow user onboarding flow clicking "Next" as you move forward with set up. + + -5. You'll see a pop-up in your Chrome Browser asking you to select which device - to connect. Click on your Ledger device. Then click "Connect". +1. To delegate tokens, select the preferred validator you wish to delegate your + tokens to by clicking on it. Fill in the amount and click the "Delegate" + button. - :::note +
+ ![Stake screen: Selected validator](../../images/wallet/ext/delegate1.png) +
- You may need to resize the pop up window to see all buttons. +2. A confirmation popup will appear showing transaction details. Carefully + review the transaction and click the "Confirm" button. - ::: +
+ ![Delegate confirmation dialog](../../images/wallet/ext/delegate2.png) +
-
- ![Confirm your Ledger device and Import](../../images/wallet/ext/ledger2.png) -
+3. In a while, your delegated tokens will appear under the "Staked" + tab. -6. Follow the next onboarding steps to upload the correct Ledger account, clicking "Confirm" when complete. +
+ ![Active delegations](../../images/wallet/ext/delegate3.png) +
-
- ![Confirm your account(s) from Ledger for - Import](../../images/wallet/ext/ledger3.png) -
+ + -7. Use your Ledger to send, receive and stake on the Oasis Network! +1. To undelegate, click on a validator in the "Staked" tab, enter + the amount of tokens you wish to undelegate and click "Reclaim". You can also + click the "Reclaim all" button to undelegate all delegated tokens from this + validator. -## Transfer +
+ ![Active delegations](../../images/wallet/ext/undelegate1.png) +
- - - 1. Click the avatar on the top right corner - 2. Pick an account you want to transfer tokens out of - 3. Click "Send" - 4. Type in the token amount under "Amount" - 5. Type in the Receiver’s wallet address - 6. Click "Next" - 7. Check the "Send Details"; if everything looks good to you, click "Confirm" - 8. Wait for a couple of seconds, and you’ll get a status update of your transaction - 9. Go back to the Account page, and you’ll see the transfer has gone through - - - Click ‘Receive’ on the Account page, and you’ll get the QR code as well as - the wallet address in text format - - +2. A confirmation popup will appear showing transaction details. Carefully review + the transaction and click the "Confirm" button. -## Stake +
+ ![Undelegate confirmation dialog](../../images/wallet/ext/undelegate2.png) +
+ +3. In a while, your undelegated tokens will enter the **debonding period**. You can + check out all the delegations that are in the debonding period in the "Debonding + delegations" tab. -1. Click "Staking" on the Account main page -2. Go to "Validator node", and select a node you want to delegate your tokens to. -3. Click into the node you want to delegate your tokens to, and click "Add Escrow" -4. Fill in the amount you want to delegate under "Amount" and click "Next" -5. Check the "Delegate info", if everything looks good to you, click "Confirm" -6. Go to "My delegate" and you will see which node you just delegated tokens to and by how much +
+ ![Debonding delegations](../../images/wallet/ext/undelegate3.png) +
+ + + ## ParaTimes -Switch to the _ParaTimes tab_ to deposit and withdraw ROSE to or from the -ParaTimes. +To move tokens from the consensus layer to a ParaTime (**deposit**) or the +other way around (**withdrawal**), open the _ParaTime screen_. Click on the +"Deposit to ParaTime" or "Withdraw from ParaTime" button and follow the sections +below.
- ![The ParaTimes tab](../../images/wallet/ext/paratimes_deposit.png) + ![The ParaTime screen](../../images/wallet/ext/paratimes.png)
-:::tip + + -At time of writing, depositing and withdrawing ROSE to and from ParaTimes -works only for the accounts **imported from the private key or the mnemonic**. -If you want to use a hardware wallet, please use the [Oasis CLI]. +1. Select the ParaTime you wish to deposit your tokens to and click "Next". -::: +
+ ![Deposit tokens: Select ParaTime](../../images/wallet/ext/deposit1.png) +
- - +2. Enter the recipient address in the ParaTime. For EVM-compatible + ParaTimes you will need to enter a hex-encoded address starting with `0x` and + for other ParaTimes the Oasis native address starting with `oasis1`. Click + "Next". -For the sake of demonstration, we'll continue with the Sapphire ParaTime, but -the Emerald or Cipher ParaTimes work just as well. Under the Sapphire label -click on the "To ParaTime" button. +
+ ![Deposit tokens: Recipient address](../../images/wallet/ext/deposit2.png) +
-Fill in the "Amount" of ROSE that you want to transfer to Sapphire and, in our -case, your Ethereum-compatible address in the "To" field you imported/created -before. Then, click "Next", review and confirm the transaction. +3. Enter the amount to deposit. -
- ![Select ParaTime](../../images/wallet/ext/paratimes_deposit_select.png) - ![Deposit Address](../../images/wallet/ext/paratimes_deposit_address.png) - ![Deposit Amount](../../images/wallet/ext/paratimes_deposit_amount.png) - ![Deposited](../../images/wallet/ext/paratimes_deposited.png) -
+ The gas fee and price will automatically be computed. You can toggle the + "Advanced" button to set it manually. -If everything goes well, you will see a successful ParaTime transaction in your -account history. + Finally, click "Next". -
- ![Account history](../../images/wallet/ext/account_history.png) -
+
+ ![Deposit tokens: Recipient address](../../images/wallet/ext/deposit2.png) +
- - +4. Review deposit details, check the "I confirm the amount and the address are + correct" and click the "Deposit" button. -You can withdraw your ROSE from the ParaTime back to your consensus account by first -selecting your ParaTime account in the _Account Management_ screen. Next, switch to -ParaTimes tab and click on the "To Consensus" button near the ParaTime entry. -Fill in the "Amount" and your Bech32-encoded consensus layer address and confirm -the withdrawal. In a few moments you will have your ROSE accessible on the -consensus layer. +
+ ![Deposit tokens: Review deposit](../../images/wallet/ext/deposit4.png) +
-:::danger + Once the deposit transaction is confirmed the tokens will appear on your + ParaTime account. -If you want to transfer ROSE to an exchange and you currently have them -deposited on Sapphire, **we strongly recommend that you withdraw ROSE -to your ROSE Wallet first and then perform a regular token transfer to your -Oasis address on the exchange!** The ParaTime's withdrawal procedure involves a -number of steps as described in the introduction and some exchanges may not -recognize this transaction as a valid transaction for funding your account on -the exchange. +
+ ![Deposit tokens: Deposit complete](../../images/wallet/web/deposit5.png) +
-::: + + -:::tip +1. Select the ParaTime you wish to withdraw your tokens from and click "Next". -Advanced users (e.g. those running ParaTime [compute nodes]) may need to -withdraw ROSE from ParaTimes stored in their `oasis1` accounts, for example to -claim their ParaTime execution rewards. The ROSE Wallet - Browser Extension does -not support such withdrawals. Use the [`oasis account withdraw`] command which -is part of the [Oasis CLI] instead, for example: +
+ ![Withdraw tokens: Select ParaTime](../../images/wallet/ext/withdraw1.png) +
-
- ![code shell](../../../../external/cli/examples/account/withdraw.y.in) -
+2. Enter the recipient address on the consensus layer below. -::: + If the ParaTime is EVM-compatible you will also need to enter the + **hex-encoded private key** of the account on the ParaTime which you are + withdrawing from. If you are using a [profile](#user-profile), the **private + key will be stored for any future withdrawals**. For other ParaTimes, the + withdrawal transaction will be signed with the **private key of your + currently selected account in your wallet**. + + Click "Next" to continue. + +
+ ![Withdraw tokens: Recipient + address](../../images/wallet/ext/withdraw2.png) +
+ +3. Enter the amount to withdraw. -[compute nodes]: ../../../node/run-your-node/paratime-node.mdx -[Oasis CLI]: ../cli/README.md -[`oasis account withdraw`]: ../cli/account.md#withdraw + The gas fee and price will automatically be computed. You can toggle the + "Advanced" button to set it manually. - + Finally, click "Next". + +
+ ![Withdraw tokens: Amount](../../images/wallet/ext/withdraw3.png) +
+ +4. Review withdrawal details, check the "I confirm the amount and the address + are correct" and click the "Withdraw" button. + +
+ ![Withdraw tokens: Review + withdrawal](../../images/wallet/ext/withdraw4.png) +
+ + Once the withdrawal transaction is confirmed the tokens will appear on your + consensus account. + +
+ ![Withdraw tokens: Withdrawal complete](../../images/wallet/ext/withdraw5.png) +
+ -You can check the balance of your consensus and ParaTime accounts by opening the -_Account Management_ screen and selecting the corresponding account. Then click -on the back arrow. The _Wallet_ tab will show you the balance on the consensus -layer and for ParaTimes navigate to the _ParaTimes tab_. There you will notice -the available amount of ROSE per each ParaTime. +## Buy + +You can buy ROSE via the _Buy screen_ tab that links to a 3rd party [Transak](https://transak.com/) +service which performs the necessary KYC, supports various payment methods, buys +the tokens on the market and transfers them to your currently selected account.
- ![ROSE balance in Sapphire](../../images/wallet/ext/paratimes2.png) + ![Buy tokens directly from the wallet](../../images/wallet/ext/buy.png)
-For EVM-compatible ParaTimes, you can as well verify the balance in -[Metamask](../README.mdx#metamask) or a built-in wallet in the Brave browser: +## Account options + +When you have at least one account opened, click on the account jazz icon in the +top-right corner. A popup will appear.
- ![Metamask - Received ROSE](../../images/wallet/ext/metamask_account.png) + ![Buy tokens directly from the wallet](../../images/wallet/ext/buy.png)
+ +### My Accounts + +Select a different account and click "Select" to switch the current account. + +### Contacts + +Contains a list of named addresses similar to the address book. + +### Profile + +Used to change the password or delete your [profile](#user-profile). + +### Settings + +You can change the wallet language and toggle between the light and the dark +theme. + +## Share your feedback with us + +If you have any questions or issues using the +[ROSE Wallet - Web](https://github.com/oasisprotocol/oasis-wallet-web/), you +can [submit a GitHub issue](https://github.com/oasisprotocol/oasis-wallet-web/issues), +and the dev team will take a look. You can also connect with us to share your +feedback via [Discord](https://oasis.io/discord) or +[Telegram](https://t.me/oasisprotocolcommunity).