-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
5 changed files
with
324 additions
and
0 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 |
---|---|---|
@@ -0,0 +1,21 @@ | ||
import { Callout } from 'nextra/components' | ||
|
||
# Address book | ||
|
||
The Fetch wallet **Address book** makes it easy to transfer funds to accounts you frequently use. | ||
|
||
If you want to add an address to the address book: | ||
|
||
1. From the wallet dashboard click the ☰ icon in the top left, then **Address book**. | ||
2. Select the network this address belongs to, then **+ Add New**. | ||
4. Fill in the details: | ||
|
||
- **Name**: the name you give to this account. | ||
- **Address**: the account's address. | ||
- **Default memo**: the memo used by default when sending funds to this account. | ||
|
||
5. Click on **Save**. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
When sending funds, instead of writing the address of the recipient you can hit the icon to the right to select an account from the address book. | ||
</Callout> |
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 |
---|---|---|
@@ -0,0 +1,29 @@ | ||
import { Callout } from 'nextra/components' | ||
|
||
# Connections | ||
|
||
Some webpages can connect to your wallet and enable interactions that otherwise would be not possible. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
By default, the [Fetch ledger browser ↗️](https://browse-fetchhub.fetch.ai/validators) only shows a list of active validators for the Fetch network along with some staking-related details (e.g. the validators' commission rates and number of delegated FETs). | ||
</Callout> | ||
|
||
If you have your wallet set up on the browser, you will see a button for connecting your wallet in the top right of the page, and if you do, you will get the option of staking your FETs with any of the validators on the list and accessing your staking dashboard. Visit the [staking ↗️](/guides/fetch-network/how-to-stake) and [Different ways of staking FET tokens ↗️](/guides/fetch-network/different-ways-to-stake-the-fet-token) guides available within our documentation for a better understanding of the steps needed to carry out such operations. | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
If you view such web pages using a browser with the Fetch wallet, you will see additional options. | ||
If you use a browser with no wallet, those options will not be shown at all! | ||
</Callout> | ||
|
||
You can manage these connections directly on the wallet in the following way: | ||
|
||
1. From the wallet dashboard, click the ☰ icon in the top left, then **Settings**. | ||
2. Click on **Manage Connections**. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
Here, you will see a list of web pages which have been connected to your wallet. Visiting these pages will not ask you for a connection with your wallet again; the page will automatically connect. | ||
|
||
You have the option of removing and thus revoking these connections. If you do, the next time you visit that page, it will not automatically connect to your wallet. | ||
</Callout> | ||
|
||
3. You can remove a connection by clicking the ✖ ️icon on the connection you wish to remove. |
132 changes: 132 additions & 0 deletions
132
pages/guides/fetch-network/fetch-wallet/fetch-wallet-getting-started.mdx
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 |
---|---|---|
@@ -0,0 +1,132 @@ | ||
import { Callout } from 'nextra/components' | ||
|
||
# Fetch wallet | ||
|
||
## Getting started | ||
|
||
The **Fetch Wallet**, originally forked from the [Kepl ↗️](https://github.com/chainapsis/keplr-wallet) wallet, is a wallet for interacting with the [Fetch ledger ↗️](/concepts/fetch-network/ledger/intro) and other blockchain networks built using the Cosmos-SDK ecosystem, and supports the Inter-Blockchain Communication (IBC) protocol. | ||
|
||
Some of its highlights include: | ||
|
||
- Private keys and mnemonics are encrypted (using scrypt) and are stored locally on device. This means neither Fetch nor the websites visited have access to these sensitive data. | ||
- Multiple accounts on the Fetch ledger and other Cosmos-based ledgers. | ||
- Support for Ledger hardware wallets for enhanced security. | ||
- Native and IBC token transfers. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
IBC, or Inter-Blockchain Communication, is a protocol designed to facilitate communication and the transfer of digital assets and data between different blockchain networks. It enables interoperability, allowing separate blockchains to interact with one another. | ||
</Callout> | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
Checkout our [GitHub repository ↗️](https://github.com/fetchai/fetch-wallet) for the Fetch wallet to improve your knowledge on the topic. You can also get started with the Fetch wallet by having a look at our [Fetch wallet guides ↗️](/guides#fetch-wallet). | ||
</Callout> | ||
|
||
## Compatibility | ||
|
||
The Fetch Wallet works on all Chromium-based web browsers, including [Chrome ↗️](https://www.google.com/chrome/), [Brave ↗️](https://brave.com/), [Edge ↗️](https://www.microsoft.com/edge) and [Decentr ↗️](https://decentr.net/). | ||
|
||
## Get the wallet | ||
|
||
You can directly install the Fetch wallet from the [Chrome web store ↗️](https://chrome.google.com/webstore/detail/fetchai-network-wallet/ellkdbaphhldpeajbepobaecooaoafpg/related?hl=en-GB). | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
At this time, you cannot run the [Keplr ↗️](https://chrome.google.com/webstore/detail/keplr/dmkamcknogkgcdfhhbddcghachkejeap?hl=en) and Fetch wallets together because they interfere. Please disable the Keplr wallet before using the Fetch wallet. | ||
</Callout> | ||
|
||
## Version | ||
|
||
 | ||
|
||
## Set up | ||
|
||
After opening the wallet for the first time, you will see the following options: | ||
|
||
1. Create a new account. | ||
2. Import an existing account. | ||
3. Connect your ledger hardware wallet. | ||
4. Migrate from ETH. | ||
|
||
### Create a new account | ||
|
||
1. Select **Create new account**. | ||
2. Backup your mnemonic seed securely. | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
KEEP IT SAFE! Anyone with your mnemonic seed can access your wallet and take your assets. | ||
|
||
DON'T LOSE IT! Lost mnemonic seed cannot be recovered! If you lose your mnemonic seed you will lose access to your wallet! | ||
</Callout> | ||
|
||
3. Give your account a name and set a password. This password will be used the next time you want to use the wallet or make important changes to your account. | ||
4. Rearrange the mnemonic phrases by clicking on them in the correct order to confirm your mnemonic seed. | ||
|
||
### Import an existing account | ||
|
||
If you have an account on the Fetch network (e.g., having had one already on the Fetch wallet and want to access it again, have an account on another wallet and wish to bring it to the Fetch wallet, or having created an address using one of our tools), you can import it into the Fetch wallet in the following way: | ||
|
||
|
||
1. First of all, you need to select **Import existing account**. | ||
2. Then you need to enter your mnemonic seed (set of words) or private key (hexadecimal). | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
KEEP IT SAFE! Anyone with your mnemonic seed or private key can access your wallet and take your assets. | ||
</Callout> | ||
|
||
3. Lastly, you need to give your account a name and set a password. This password will be used the next time you want to use the wallet or make important changes to your account. | ||
|
||
### Use ledger hardware wallet | ||
|
||
If you have a ledger hardware wallet and wish to keep your key and mnemonics on that device while using the Fetch wallet: | ||
|
||
1. You need to select **Import ledger**. | ||
2. You need to give your account a name and set a password. This password will be used the next time you want to use the wallet or make important changes to your account. | ||
3. Follow the instructions on the popup to connect your device. | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
Please ensure you keep your mnemonic seed somewhere safe where others cannot access it. If you lose it, your wallet will be inaccessible once you log out. The password for your account should also be kept safe but is not necessary for recovery if you have your mnemonic seed. | ||
</Callout> | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
If you lose your password, you need to uninstall and re-install the Fetch wallet and select **Import existing account**. Then use the mnemonic seed for your account and choose a new password. | ||
</Callout> | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
Currently, only [ledger hardware wallets ↗️](https://www.ledger.com/) are supported. | ||
</Callout> | ||
|
||
### Migrate from ETH | ||
|
||
Prior to the transition to our native Cosmos SDK-based ledger, [ERC-20 FET ↗️](/concepts/fetch-network/native-and-erc20-fet-tokens) staked using accounts on Ethereum were migrated to native accounts on the Fetch main network. These accounts correspond to the private key of their associated Ethereum accounts. | ||
|
||
These native accounts can be accessed by transforming the original Ethereum keypair into a native Fetch keypair and address: | ||
|
||
1. Click **Migrate from ETH**. | ||
2. Click **Migrate a Metamask Private Key**. | ||
3. Enter the address and private key of the Ethereum account which staked ERC-20 FETs. | ||
4. Give your account a name and set a password if one is not set (i.e. if it is the first time you open the wallet, or in case you have removed all of your accounts). The password will be used the next time you want to use the wallet or make important changes to your account. Hit **Next**. | ||
|
||
## Other operations | ||
|
||
### Switching accounts | ||
|
||
If you have multiple accounts set up on the Fetch wallet, to switch between them: | ||
|
||
1. First of all, ensure you are logged into the wallet correctly. | ||
2. Click the account icon in the top right corner of the dashboard. | ||
3. Then, select the account you want to switch to. | ||
|
||
### Removing accounts | ||
|
||
If you want to remove an account from your Fetch wallet: | ||
|
||
1. Ensure you are logged into the wallet. | ||
2. Click the account icon in the top right corner of the dashboard. | ||
3. Hit the three dots icon for the account you want to remove and choose **Delete Account**. | ||
4. Enter your wallet password. | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
If you have not yet backed up your mnemonic seed, click on **Back-up account** and enter you password to view it. | ||
Then **back it up safely**. If you lose your mnemonic seed you will lose access to your account! | ||
</Callout> | ||
|
||
5. Lastly, click on **Confirm** to remove the account from your wallet. |
118 changes: 118 additions & 0 deletions
118
pages/guides/fetch-network/fetch-wallet/how-to-use-the-fetch-wallet.mdx
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 |
---|---|---|
@@ -0,0 +1,118 @@ | ||
import { Callout } from 'nextra/components' | ||
|
||
# How to use the Fetch wallet | ||
|
||
## Deposit Tokens | ||
|
||
If you want to transfer funds to your Fetch wallet account: | ||
|
||
1. First of all, you need to enter the Fetch wallet with your credentials. | ||
2. Copy your account's address: you can do so by either clicking on the account address at the top of the dashboard (under the account name) or by clicking on the **Deposit** button you find at the end of the pop-up window. You can also scan the QR code. You can also buy tokens by clicking on the **Buy Tokens** button. | ||
3. Within the wallet or application you are using to send the funds, use the account's address just copied as the destination account to which the funds must go. | ||
4. Once you send the tokens, the balance should be updated within your Fetch wallet. | ||
|
||
<Callout type="error" emoji="🚫"> | ||
If your origin wallet says that the address (which should start with "fetch") is invalid, it is probably expecting an Ethereum address (beginning with "0x") and is most likely trying to send ERC-20 FET. In this case, you need to use the token bridge to swap your ERC-20 FET for native FET . | ||
</Callout> | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
For information on ERC-20 and native FET tokens, head over to the [Native and ERC-20 FET tokens ↗️](/concepts/fetch-network/native-and-erc20-fet-tokens) page. | ||
</Callout> | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
You should not send ERC-20 FET to this wallet. If you do, you will lose your tokens. The Fetch wallet can only hold native FET tokens and not ERC-20 FET tokens. | ||
</Callout> | ||
|
||
## Send Tokens | ||
|
||
If you want to send tokens from your account: | ||
|
||
1. First select **Send**. | ||
2. Fill in the details of your transaction: | ||
|
||
- **Recipient**: the address you want to send the tokens to. | ||
- **Token**: the token denomination or type. | ||
- **Amount**: the number of tokens you want to send with this transaction (you can see your current balance above the Amount) | ||
- **Memo (Optional)**: some transactions (e.g. to/from some exchanges) require a specific memo. If not needed, you can leave it blank. | ||
- **Fee**: the transaction fee. Choose from Low, Average and High. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
Usually, the lower the transaction fee, the longer you need to wait for your transaction to be settled on the network. | ||
</Callout> | ||
|
||
3. Press **Send**. | ||
4. In the summary screen, review the details and if everything is correct, select **Approve**. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
You can check the status of your transaction via the [explorer ↗️](https://explore-fetchhub.fetch.ai/). | ||
</Callout> | ||
|
||
## IBC transfer | ||
|
||
1. Ensure you are logged into the wallet. | ||
2. Make sure IBC transfers are enabled and that your selected network supports it. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
To enable IBC transfers in the wallet, in the dashboard, click the ☰ icon in the top left, then click on **Settings**. Toggle the **Show Advanced IBC Transfers** switch on. | ||
|
||
If your selected network does not support IBC transfers, you will not see an **IBC Transfer** section in the dashboard. | ||
</Callout> | ||
|
||
3. Click the **Transfer** button in the **IBC Transfer** section. | ||
4. Fill in the details of your transaction: | ||
|
||
- **Destination Chain**: the destination blockchain. | ||
- **Recipient**: the address you want to send the tokens to. | ||
- **Memo (Optional)**: an optional memo. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
If you do not see your desired chain, you need to [set up IBC channels first ↗️](/guides/fetch-network/fetch-wallet/how-to-use-the-fetch-wallet#first-time-origindestination-transfer). | ||
</Callout> | ||
|
||
5. Press **Next**. | ||
6. In the next page, provide the following: | ||
|
||
* **Token**: the denomination or type of the tokens being sent. | ||
* **Amount**: the number of tokens to be sent. | ||
* **Fee**: the transaction fee. Choose from **Low**, **Average**, **High**. | ||
- **Token**: the denomination or type of the tokens being sent | ||
- **Amount**: the number of tokens to be sent | ||
- **Fee**: the transaction fee. Choose from **Low**, **Average**, **High**. | ||
|
||
7. Hit **Submit**. | ||
8. The wallet now shows you a summary of the transaction. Review it and if you are happy, hit **Approve** to complete the transfer. | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
Do not send tokens via IBC directly to an exchange. In most cases, this will result in the loss of your funds. | ||
</Callout> | ||
|
||
### First-time origin/destination transfer | ||
|
||
Before being able to make an IBC transfer between any two chains for the first time, an IBC channel must be configured in the wallet: | ||
|
||
1. Follow the instructions for [making an IBC transfer ↗️](/guides/fetch-network/fetch-wallet/how-to-use-the-fetch-wallet#ibc-transfer), up to step 4. | ||
2. Click the **Select Chain** drop-down. | ||
3. Select **+ New IBC Transfer Channel**. | ||
4. Select the **Destination Chain** and enter the source **Channel ID** (e.g. `channel-100`). | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
To find out the IBC channel ID between any two chains: | ||
|
||
1. Head over to this [page ↗️](https://www.mintscan.io/fetchai/relayers). | ||
2. At the top, select the sending chain, for example **Fetch.AI**. Then below it, click **IBC RELAYERS**. | ||
3. Select the destination chain, for example **OSMOSIS**. | ||
4. You can now see the channels between the two chains. Select an active channel (in green) and note the sending chain's channel ID. For Fetch.AI to Osmosis, the sending chain's (Fetch.AI's) channel ID is `channel-10`. | ||
5. Enter the channel ID in the Fetch wallet (`channel-10` in our example). | ||
</Callout> | ||
|
||
Remember to write the channel ID in lower case (i.e. `channel-X`) | ||
|
||
<Callout type="warning" emoji="⚠️"> | ||
If there are no green channels, the relayers are temporarily inactive, and you will need to wait until one becomes active again. | ||
</Callout> | ||
|
||
5. Click **Save**. | ||
|
||
<Callout type="error" emoji="️🚫"> | ||
If you input an incorrect Channel ID, either the wallet will not accept it and shows you an error, or your transaction could get stuck in an inactive channel. | ||
</Callout> |
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 |
---|---|---|
@@ -0,0 +1,24 @@ | ||
import { Callout } from 'nextra/components' | ||
|
||
# How to stake and claim rewards | ||
|
||
You can learn how to stake your tokens by following the [How to stake FET ↗️](/guides/fetch-network/how-to-stake) and [Different ways of staking FET tokens ↗️](/guides/fetch-network/different-ways-to-stake-the-fet-token) guides available within our documentation. | ||
|
||
## Claiming rewards | ||
|
||
If your account has tokens staked, you can withdraw your rewards directly from the wallet: | ||
|
||
1. Ensure you are logged into the wallet. | ||
2. From the wallet dashboard, select **Claim**. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
This will claim the total rewards accrued for your stakes across every validator. | ||
</Callout> | ||
|
||
3. The wallet shows you a summary of the transaction. Review it, select a transaction fee, and if you are happy, hit **Approve** to complete the operation. | ||
|
||
You should now see the rewards added to your **Total Balance**. | ||
|
||
<Callout type="info" emoji="ℹ️"> | ||
If you want to claim rewards from each validator individually, see the [Claim rewards using the staking dashboard ↗️](/guides/fetch-network/how-to-stake). | ||
</Callout> |