-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
WIP: Kh.20240115 tutorials metamask (#25)
- Loading branch information
Showing
20 changed files
with
217 additions
and
65 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
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,129 @@ | ||
--- | ||
title: Add Topos and Incal to Metamask | ||
description: Before working with the Topos Testnet, you need to tell your Metamask Wallet about the subnets | ||
--- | ||
|
||
# Add Topos and Incal to Metamask | ||
|
||
In order to work with the Topos Testnet, you need to tell your wallet about the subnets. We currently recommend [MetaMask](https://metamask.io/download/) as the wallet of choice for the Topos Testnet. If you do not already have it installed, please [download](https://metamask.io/download/) and install it. | ||
|
||
This document will walk you through two different approaches for completing this. The most educational approach is to manually add the subnets to your MetaMask wallet. However, if you prefer, you can follow the procedure to [automatically add the subnets to your wallet](#alternative-method-leverage-the-erc20-messaging-app) using the ERC20 Messaging App. | ||
|
||
## Add Topos and Incal to MetaMask Manually | ||
|
||
Adding the networks to your MetaMask wallet manually is a useful exercise if you are new to MetaMask and web3 development, as it allows you to better understand the data that underlies the process. | ||
|
||
### Add Topos to Metamask | ||
|
||
<Steps> | ||
<StepItem> | ||
Once you have installed MetaMask, you will need to add the Topos subnet to it. To do this, open the MetaMask extension and click on the Networks dropdown. | ||
|
||
<ZoomImage small> | ||
![MetaMask Networks Dropdown](/images/metamask-networks-dropdown.png) | ||
</ZoomImage> | ||
|
||
Then click on the "Add Network" button. | ||
</StepItem> | ||
|
||
<StepItem> | ||
<ZoomImage small> | ||
![MetaMask Add Network](/images/metamask-add-network.png) | ||
</ZoomImage> | ||
|
||
Your browser will open an a MetaMask interface to add a new network. From that page, select the "Add a network manually" button. | ||
</StepItem> | ||
|
||
<StepItem> | ||
<ZoomImage small> | ||
![MetaMask Add Topos](/images/metamask-add-topos.png) | ||
</ZoomImage> | ||
|
||
Then enter the following information and press the "Save" button: | ||
|
||
- *Network Name*: **Topos** | ||
- *New RPC URL*: **https://rpc.topos-subnet.testnet-1.topos.technology** | ||
- *Chain ID*: **2359** | ||
- *Currency Symbol*: **TOPOS** | ||
- *Block Explorer URL*: **https://explorer.testnet-1.topos.technology** | ||
|
||
<ZoomImage small> | ||
![Topos Added Successfully](/images/metamask-topos-added.png) | ||
</ZoomImage> | ||
|
||
</StepItem> | ||
</Steps> | ||
|
||
### Add Incal to Metamask | ||
|
||
To add Incal to Metamask, you will need to repeat the process above, but with the following information: | ||
|
||
<ZoomImage small> | ||
![MetaMask Add Incal](/images/metamask-add-incal.png) | ||
</ZoomImage> | ||
|
||
- *Network Name*: **Incal** | ||
- *New RPC URL*: **https://rpc.incal.testnet-1.topos.technology** | ||
- *Chain ID*: **2360** | ||
- *Currency Symbol*: **INCA** | ||
- *Block Explorer URL*: **https://explorer.testnet-1.topos.technology** | ||
|
||
## Alternative Method -- Leverage the ERC20 Messaging App | ||
|
||
As an alternative approach, you can use the [ERC20 Messaging App](https://dapp-frontend-erc20.testnet-1.topos.technology/) to add the Topos and Incal subnets to your MetaMask wallet. | ||
|
||
<Steps> | ||
|
||
<StepItem> | ||
To do this, first [navigate to the application](https://dapp-frontend-erc20.testnet-1.topos.technology/). You should see a screen like this: | ||
|
||
<ZoomImage small> | ||
![ERC20 Messaging App](/images/erc20-messaging-connect-wallet.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
<StepItem> | ||
Press the `Connect to MetaMask` button. You should see a MetaMask popup like this: | ||
|
||
<ZoomImage small> | ||
![MetaMask Connect](/images/metamask-connect.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
<StepItem> | ||
Click `Next` and then `Connect` to the confirmation popup. | ||
|
||
<ZoomImage small> | ||
![MetaMask Connect Confirm](/images/metamask-connect-confirm.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
<StepItem> | ||
You should see the ERC20 Messaging app page change to reflect your wallet address in the upper right of the page: | ||
|
||
<ZoomImage small> | ||
![ERC20 Messaging App Connected](/images/erc20-messaging-connected.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
<StepItem> | ||
At this point, selecting a subnet from the `Sending subnet` dropdown will automatically trigger adding that subnet to your MetaMask wallet: | ||
|
||
<ZoomImage small> | ||
![ERC20 Messaging App Connected](/images/erc20-metamask-add-topos.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
<StepItem> | ||
Scroll down in the popup and click 'Approve'. The network will now be added to your MetaMask wallet. You should do this for both Topos and Incal. Once you have done this for both, opening the MetaMask extension, and clicking on the Networks dropdown should show both subnets: | ||
|
||
<ZoomImage small> | ||
![MetaMask Networks Dropdown](/images/erc20-metamask-networks-populated.png) | ||
</ZoomImage> | ||
</StepItem> | ||
|
||
</Steps> | ||
|
||
# Wrapping Up | ||
|
||
At this point, you should have both the Topos and the Incal subnets added to your MetaMask wallet. You will probably need to request tokens from the [Topos Faucet](https://faucet.testnet-1.topos.technology) in order to continue learning and experimenting. You can follow the instructions in our [How to use the Faucet to get Testnet Tokens](/content/how-to/use-the-faucet.html) guide to do this. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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,40 @@ | ||
--- | ||
title: Use the Faucet to Get Testnet Tokens | ||
description: In order to interact with the Topos and Incal subnets, tokens are requires in order to pay the minimal gas fees on these testnets. This guide will illustrate how to use the Faucet to get these tokens. | ||
--- | ||
|
||
# Use the Faucet to Get Testnet Tokens | ||
|
||
In order to interact with the Topos and Incal subnets, tokens are required to pay the minimal gas fees on these testnets. A [faucet](https://faucet.testnet-1.topos.technology/) exists to allow developers to access tokens for development purposes. | ||
|
||
## Prerequisites | ||
|
||
To use the Faucet, you must have an address to send the tokens to. We recommend using MetaMask as your wallet, and suggest that you first follow the guide on how to [add the Topos and Incal subnets to MetaMask](/how-to/add-topos-and-incal-to-metamask.html). | ||
|
||
## Use the Faucet | ||
|
||
The faucet is a simple web application that allows you to request tokens for a given address. It is located at [https://faucet.testnet-1.topos.technology/](https://faucet.testnet-1.topos.technology/). | ||
|
||
<ZoomImage small> | ||
![Topos Faucet](/images/topos-faucet.png) | ||
</ZoomImage> | ||
|
||
Enter the address to receive the funds in the `Address` field, and select the subnets to receive funds on. | ||
|
||
The faucet limits funding to once per 24 hours, based on the IP address of the requester, so we recommend ensuring that both **Topos** and **Incal** are selected before clicking the `Submit` button. This is less limiting than it may seem, however, as the fees on the testnet are so low that you should have plenty of funds to experiment with from just one request. | ||
|
||
If it has been less than 24 hours since the address has requested funds, you will see an error message: | ||
|
||
<ZoomImage small> | ||
![Faucet Error](/images/faucet-too-soon-error.png) | ||
</ZoomImage> | ||
|
||
If the token allocation is successful, the application will report that: | ||
|
||
<ZoomImage small> | ||
![Faucet Success](/images/faucet-success.png) | ||
</ZoomImage> | ||
|
||
# Wrapping Up | ||
|
||
With tokens for Topos and Incal in your wallet, you are ready to start interacting with the Topos testnet and learning more about the Topos platform. Remember that if you do need more tokens, you can request additional tokens once every 24 hours. |
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
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