-
Notifications
You must be signed in to change notification settings - Fork 47
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: rewrite for clarity, update screenshots (#2206)
* docs: rewrite for clarity, update screenshots * docs: be less cavalier about private key, other improvements * docs: missed some spots * docs: move private key warning to beginning
- Loading branch information
Showing
1 changed file
with
65 additions
and
68 deletions.
There are no files selected for viewing
133 changes: 65 additions & 68 deletions
133
docs/tutorial/pre-requisites-of-running-on-chain-spam-protected-chat2.md
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,111 +1,108 @@ | ||
| In this tutotial you will learn how to: | ||
| 1. Create Sepolia Ethereum Account and obtain its private key. | ||
| 2. Obtain Sepolia Ethers from faucet. | ||
| 3. Set up a hosted node on Sepolia Testnet using Infura. | ||
| In this tutorial you will learn how to: | ||
| 1. Create a Sepolia Ethereum account and obtain its private key. | ||
| 2. Obtain Sepolia ETH from faucet. | ||
| 3. Access a node on the Sepolia testnet using Infura. | ||
|
|
||
| If you already have an Ethereum account with sufficient ethers on the Sepolia testnet then you can skip the first two sections. | ||
| ## Creating Sepolia Ethereum Account and obtaining its private key | ||
| ## 1. Create a Sepolia Ethereum account and obtain its private key | ||
|
|
||
| > _**WARNING:**_ The private key is used elsewhere by Waku RLN registration tools to assist with membership registration in the Sepolia test network. | ||
| > We strongly recommend that you create an account only for this purpose. | ||
| > NEVER expose a private key that controls any valuable assets or funds. | ||
| 1. Download and install Metamask. [https://metamask.io/download/](https://metamask.io/download/) | ||
| 2. Create a new wallet and save your secret recovery key. | ||
| If you already have Metamask installed, go to step 3. | ||
| If you encounter any issues during the Metamask setup process, please refer to the [official Metamask support page](https://support.metamask.io/hc/en-us). | ||
| 2. Create a new wallet and save your secret recovery phrase. | ||
|
|
||
|  | ||
|
|
||
| 3. Login to Metamask. | ||
|
|
||
|  | ||
|
|
||
| 4. You should already see an account created. As you can see on top right, it should be pointing to Ethereum mainnet. | ||
| 4. By default, Metamask connects to the Ethereum Mainnet (dropdown menu in the top right corner). | ||
|
|
||
|  | ||
|
|
||
| 5. You can use the same account for different networks. For Waku we need to connect to the Sepolia test network. | ||
| 6. You can switch to a test network by clicking on the drop down menu. Select Sepolia test network for Waku: | ||
| To publish messages to the Waku Network, you need to connect to the Sepolia test network. | ||
| 5. Switch to the Sepolia test network by selecting it from the dropdown menu. Ensure "Show test networks" is enabled. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 7. Click on Show/hide test networks. | ||
| 8. Enable “Show Test Networks". | ||
| The same account can be used with different networks. Note that the ETH balance is different for each network (each has its own native token). | ||
|
|
||
|  | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 9. Close the settings and now you should see the test networks in the drop down on the top right. | ||
| 6. To view the private key for this account, click on the three dots next to the account name and select "Account Details". | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 10. Switch to Sepolia Test Network. | ||
| 11. You can see that the same account can be used with different networks. But note that the ETH balance on different networks are different and are different tokens. | ||
| Select "Show Private Key". | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 12. Now to export your private key for the account, if needed, please click on the three dots beside the account. | ||
| Enter your Metamask password and click "Confirm" | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 13. Click on Account Details. | ||
| 14. Click on Export Private Key. | ||
|
|
||
|  | ||
| You will be shown the private key. | ||
|
|
||
| 15. Enter your Metamask password when prompted. | ||
|
|
||
|  | ||
|
|
||
| 16. You will be shown the private key. Copy it as needed. | ||
|
|
||
| Obtain Sepolia Ethers from faucet | ||
| --- | ||
|
|
||
| 1. Ethers on Sepolia test networks can be obtained from different faucets. | ||
| 2. One of the faucets is as follows: | ||
| 1. [https://sepoliafaucet.com//](https://sepoliafaucet.com/) | ||
| (NOTE: We have not tested the security of these faucets so please feel free to do your own research or obtain Sepolia ethers from other faucets if needed.) | ||
| 3. Please follow the instructions on the webpages of these faucets. | ||
| 4. A lot of faucets limit the Sepolia ETH to 0.05 ETH/day. | ||
| 5. To obtain more eth, you can do some POW mining. One of those POW faucet is: | ||
| [https://sepolia-faucet.pk910.de/](https://sepolia-faucet.pk910.de/) | ||
| 6. Enter your Eth account address, accept Captcha and start mining. | ||
|
|
||
|  | ||
| ## 2. Obtain Sepolia ETH from faucet | ||
|
|
||
| Sepolia ETH can be obtained from different faucets. | ||
| Three popular examples include: | ||
|
|
||
| 1. [sepoliafaucet.com](https://sepoliafaucet.com/) (requires an Alchemy account) | ||
| 2. [Infura Sepolia faucet](https://www.infura.io/faucet/sepolia) (requires an Infura account) | ||
| 3. [Sepolia POW faucet](https://sepolia-faucet.pk910.de/) | ||
|
|
||
| > _**NOTE:**_ This list is provided for convenience. We do not necessarily recommend or guarantee the security of any of these options. | ||
| 7. You can see the estimated Sepolia ETH mined per hour. Each session is restricted to a few hours. | ||
| Many faucets limit the amount of Sepolia ETH you can obtain per day. | ||
| We include instructions for [sepolia-faucet.pk910.de](https://sepolia-faucet.pk910.de/) as an example: | ||
|
|
||
| 1. Enter your Sepolia Ethereum account public address, solve the Captcha and start mining. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 8. When you exceed the hour limit of the session, then the mining will be stopped. | ||
| 9. Alternatively, stop the mining when mined enough sepolia ether. | ||
| 10. Do not forget to claim your sepolia ether. | ||
| 2. Keep the browser tab open for a while. You can see the estimated Sepolia ETH mined per hour. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| Each session is limited to a few hours. | ||
| 3. When you've mined enough Sepolia ETH (minimum of 0.05 Sepolia ETH), click on "Stop Mining" and claim your reward. | ||
|
|
||
|  | ||
|
|
||
| Setting up a hosted node on Sepolia Testnet using Infura | ||
| --- | ||
| ## 3. Access a node on the Sepolia testnet using Infura | ||
|
|
||
| (Note: Infura provides a simple straight-forward way of setting up endpoints for interaction with the Ethereum chain and the Waku RLN smart contract without having to run a dedicated Ethereum node. Setting up infura is not mandatory. Operators concerned with the centralized aspect introduced by infura can setup their own node.) | ||
| > _**NOTE:**_ Infura provides a simple way of setting up endpoints for interaction with the Ethereum chain and the Waku RLN smart contract without having to run a dedicated Ethereum node. | ||
| > Setting up Infura is not mandatory. Operators concerned with the centralized aspect introduced by Infura should use their own node. | ||
| 1. Sign up to infura if you do not have an account already. [https://infura.io/register](https://infura.io/register) | ||
| 1. Sign up for Infura if you do not have an account already. [https://infura.io/register](https://infura.io/register) | ||
|
|
||
|  | ||
|
|
||
| 2. After registering and verifying the account, create a new project using Ethereum and give it a name. | ||
|
|
||
|  | ||
| Follow the instructions to register and verify the account. | ||
|
|
||
| 2. Click on "Create a new API key". | ||
|
|
||
|  | ||
|
|
||
| 4. Select "Web 3 API", give your API key a descriptive name and click on "Create". | ||
|
|
||
|  | ||
|
|
||
| 3. After creating the project, you will be presented with a dashboard like follows. Note that your Project Id and secret will be different. | ||
| You will be presented with a dashboard for the newly created key. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 4. Select Sepolia network in Endpoints. | ||
| 4. Select "Sepolia" in the dropdown menu for Ethereum. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 5. You can find the endpoints for the hosted node using https and wss. The wss endpoint is the relevant one for connecting the waku node to the RLN contract on Sepolia network. Like follows: | ||
| Both Https and WebSockets endpoints are available. Waku requires the WebSockets endpoint. | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 6. You can change security settings or view usage options as required in the dashboard. | ||
| 7. Congratulations, you are now ready to use the Infura node. | ||
| 5. Copy this address (starting with `wss://sepolia.infura`) as needed when setting up your Waku node. |