Merge pull request #49 from MXCzkEVM/Changing_Tutorial_Text

Changing MNS Tutorial for Geneva Testnet
MXCzkEVM · Jun 24, 2024 · c8bf3aa · c8bf3aa
2 parents 9fee412 + 4f46a89
commit c8bf3aa
Show file tree

Hide file tree

Showing 15 changed files with 54 additions and 71 deletions.
diff --git a/docs/Tutorials/get-hexagon-domain.md b/docs/Tutorials/get-hexagon-domain.md
@@ -3,43 +3,41 @@ title: Get Hexagon Domain
 sidebar_position: 9
 ---
 
-This guide will help you get an MXC domain name and show you how to name a hexagon with the your domain name.
-
-<iframe width="560" height="315" src="https://www.youtube.com/embed/vabpCCjYcUk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+This guide will help you get an Moonchain domain name and show you how to name a hexagon with the your domain name.
 
 ## Prerequisites
 - You should have an Ethereum wallet address. Metamask is preferred.
-- You should have some MXC tokens to pay for MXC domain name and transaction fee. Get some tokens using [this guide](/docs/Tutorials/receive-tokens).
+- You should have some MXC tokens to pay for Moonchain domain name and transaction fee. Get some tokens using [this guide](/docs/Tutorials/receive-tokens).
 
 ## Steps
 
-### 1. Navigate to the Wannsee MNS and Connect Your Wallet
-- Make sure your wallet is on MXC Wannsee zkEVM Testnet network
-- Navigate to the [MXC Wannsee MNS](https://wannsee-mns.mxc.com/)
+### 1. Navigate to the Geneva MNS and Connect Your Wallet
+- Make sure your wallet is on MXC Geneva zkEVM Testnet network
+- Navigate to the [Moonchain Geneva MNS](https://Geneva-mns.moonchain.com/)
 - Click on the Connect button at the top right corner
 - Select Metamask from the modal that pops up and connect your wallet
 
-![connect wallet](./img/get-hexagon-domain/step1/connectWallet.png)
+![connect wallet](./img/dominic/mns1.jpg)
 
 ### 2. Search for a Preferred Available Username
 - Type any preferred name in the search box and check for availability
 - If available, click on the name with a green Available flag beside it
 
-![connect wallet](./img/get-hexagon-domain/step2/searchName.png)
+![connect wallet](./img/dominic/mns2.jpg)
 
 ### 3. Configure Domain Name Purchase
 - Click on the plus (+) button in increase the number of years you intend purchasing the Domain Name
 - You can turn on the Use as primary name switch, if you want the domain name to be use as your wallet address name
 - Click on the Next Button at the bottom of the page
 
-![connect wallet](./img/get-hexagon-domain/step3/configureNamePurchase1.png)
-![connect wallet](./img/get-hexagon-domain/step3/configureNamePurchase2.png)
+![connect wallet](./img/dominic/mns3.jpg)
+
 
 ### 4. Click the Skip profile Button
 - After click the Next Button in the previous page, it takes you to a Create your profile page
 - Click the Skip profile button
 
-![connect wallet](./img/get-hexagon-domain/step4/skipProfile.png)
+![connect wallet](./img/dominic/mns4.jpg)
 
 ### 5. Start the Domain Registration
 - Click on the Begin button to start the actual domain registration transaction
@@ -50,7 +48,6 @@ This guide will help you get an MXC domain name and show you how to name a hexag
 - Metamask will popup again, click the Confirm button and wait for the transaction to finish processing
 - Once the transaction has finished processing you will see a congratulation page and your wallet address will change to your domain name
 
-![connect wallet](./img/get-hexagon-domain/step5/beginRegistration.png)
-![connect wallet](./img/get-hexagon-domain/step5/registrationCompleted.png)
+![connect wallet](./img/dominic/mns5.jpg)
 
-You have successfully purchased an MNS Domain Name, Let's now name a Hexagon with it.
+You have successfully purchased an Moonchain Domain Name, Let's now name a Hexagon with it.
diff --git a/docs/Tutorials/img/dominic/dexToHex.jpg b/docs/Tutorials/img/dominic/dexToHex.jpg
diff --git a/docs/Tutorials/img/dominic/hex0.jpg b/docs/Tutorials/img/dominic/hex0.jpg
diff --git a/docs/Tutorials/img/dominic/hex1.jpg b/docs/Tutorials/img/dominic/hex1.jpg
diff --git a/docs/Tutorials/img/dominic/hex2.jpg b/docs/Tutorials/img/dominic/hex2.jpg
diff --git a/docs/Tutorials/img/dominic/hex5.jpg b/docs/Tutorials/img/dominic/hex5.jpg
diff --git a/docs/Tutorials/img/dominic/hex6.jpg b/docs/Tutorials/img/dominic/hex6.jpg
diff --git a/docs/Tutorials/img/dominic/hex7.jpg b/docs/Tutorials/img/dominic/hex7.jpg
diff --git a/docs/Tutorials/img/dominic/mns1.jpg b/docs/Tutorials/img/dominic/mns1.jpg
diff --git a/docs/Tutorials/img/dominic/mns2.jpg b/docs/Tutorials/img/dominic/mns2.jpg
diff --git a/docs/Tutorials/img/dominic/mns3.jpg b/docs/Tutorials/img/dominic/mns3.jpg
diff --git a/docs/Tutorials/img/dominic/mns4.jpg b/docs/Tutorials/img/dominic/mns4.jpg
diff --git a/docs/Tutorials/img/dominic/mns5.jpg b/docs/Tutorials/img/dominic/mns5.jpg
diff --git a/docs/Tutorials/name-hexagon.md b/docs/Tutorials/name-hexagon.md
@@ -5,68 +5,51 @@ sidebar_position: 10
 
 This guide will help you name a Hexagon using any of your Hexagon Domain Name
 
-<iframe width="560" height="315" src="https://www.youtube.com/embed/_YbllGOfEbA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
-
 ## Prerequisites
 - You should already have a Hexagon Domain Name. Get one using [this guide](/docs/Tutorials/get-hexagon-domain).
 
 ## Steps
 
-### 1. Navigate to the Wannsee ZK Explorer
-- Navigate to the [Wannsee ZK Explorer](https://wannsee-explorer.mxc.com/)
+### 1. Navigate to the Geneva ZK Explorer
+- Navigate to the [Geneva ZK Explorer](https://geneva-explorer.moonchain.com/)
 - On the left hand side of the page, you'll see a vertical list of icons
 - Click on the second icon titled Mapper
 
-![connect wallet](./img/name-hexagon/step1/navigateToExplorer.png)
+![connect wallet](./img/dominic/hex0.jpg)
 
 ### 2. Get Hexagon Address
-- On the Mapper page, click on any of the Hexagon (the green Hexagon shapes), click on any
-- Onclick of a Hexagon, you will see modal at the right side of the screen
-- Click on Hexagon Address, the first item on the list (the one starting with 0x)
-
-![connect wallet](./img/name-hexagon/step2/getHexagonAddress.png)
-
-### 3. Get the Transaction Hash
-- Onclick of the Hexagon Address in the previous page, it takes you to transaction detail page
-- Copy the transaction hash and ask MXC team for Naming Rights, but in near future we will put the Naming Right NFTs in an NFT marketplace for people to purchase.
-- Once Naming Rights is given to your address
-- On the same transaction detail page where you copied the transaction hash, get/copy the token ID under the Tokens minted section
-
-![connect wallet](./img/name-hexagon/step3/getTransactionHash.png)
+- On the Mapper page, click on any area without a Hexagon (the green Hexagon shapes)
+- Onclick of the map, you will see a hexadecimal number at the right side of the screen. This number is the area identifier.
+- Copy this hexadecimal number 
 
-### 4. Get the HEX of the Token ID
-- After copying the token ID, navigate to [RapidTables](https://www.rapidtables.com/convert/number/decimal-to-hex.html)
-- Select From Decimal, To Hexadecimal
-- Paste the Token ID you copied and click the Convert button
-- You will get the Hexadecimal of the Token ID
-- Copy the Hexdecimal, you will need it to name the Hexagon
+![connect wallet](./img/dominic/hex1.jpg)
 
-![connect wallet](./img/name-hexagon/step4/getHexOfID.png)
+### 3. Mint your Hexagon on MNS
+- To mint the selected hexagon, switch to the Moonchain MNS and select your account.
+- Under 'Profile', click on the Mint MEP1002 Hexagon button and enter the hexadecimal digit of the previously selected map area in the popup that opens. Click confirm and approve the transaction in your wallet. Keep the popup open until the transaction is completed. 
+- When you look into the Mapper on Moonchain Explorer you now can see your newly minted hexagon.
 
-### 5. Navigate Back to Wannsee MNS and Set Hexagon to your Domain Name
-- Navigate to the [MXC Wannsee MNS](https://wannsee-mns.mxc.com/)
-- Connect your Wallet
-- Search for your registered domain name and click on it
-- Click on the Set to MEP1002 Hexagon
+![connect wallet](./img/dominic/hex2.jpg)
 
-![connect wallet](./img/name-hexagon/step5/backToMNS.png)
+### 4. Set the name of our Hexagon
+- After the confirmed mint of your Hexagon, you are able to name it with an MNS name.
+- To do this, click on the "Set to MEP1002 Hexagon" button.
+- In the pop-up again enter the hexadecimal number of your selected map area. 
+- If you need this number again, you can use the address of your minted hexagon to search for it in the [Geneva ZK Explorer](https://geneva-explorer.moonchain.com/)
+- the searched hexadecimal number is the minted token id converted from decimal to hexadecimal
 
-- A modal will popup, paste in the Hexadecimal gotten from converting the Token ID
-- Click the Confirm button
-- Click on Open Wallet button
-- Metamask will popup, Click Confirm on the Metamask popup and wait for transaction to complete
+![connect wallet](./img/dominic/hex5.jpg)
+![connect wallet](./img/dominic/dexToHex.jpg)
 
-![connect wallet](./img/name-hexagon/step5/setMEP.png)
-
-- Click on Done
-
-![connect wallet](./img/name-hexagon/step5/clickDone.png)
+- After entering the number click confirm and approve the transaction in your wallet. Keep the popup open until the transaction is completed.
+![connect wallet](./img/dominic/hex6.jpg)
 
 ### 6. Confirm the Hexagon was set to your Domain Name
-- Navigate to the [Wannsee Explorer Mapper](https://wannsee-explorer.mxc.com/mapper)
+- Navigate to the [Geneva Explorer Mapper](https://Geneva-explorer.mxc.com/mapper)
 - In the search box, type your domain name, e.g: legalize.mxc
 - You should see: Found 1 matching mns location
 - Press enter on your keyboard, and you will see the Hexagon that has your Domain Name
-![connect wallet](./img/name-hexagon/step6/confirmDomainSet.png)
 
-You have successfully set a Hexagon to you Domain Name.
+![connect wallet](./img/dominic/hex7.jpg)
+
+You have successfully set a Hexagon to you Domain Name.
diff --git a/docs/Tutorials/run-a-supernode.md b/docs/Tutorials/run-a-supernode.md
@@ -1,18 +1,17 @@
 ---
-title: Run MXC Supernode
+title: Run Moonchain Supernode
 sidebar_position: 5
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-This guide will walk you through the process of operating a MXC supernode via [simple-mxc-node](https://github.com/MXCzkEVM/simple-mxc-node). You will be able to:
+This guide will walk you through the process of operating a Moonchain supernode via [simple-mxc-node](https://github.com/MXCzkEVM/simple-mxc-node). You will be able to:
 
-- Run a MXC supernode easily from the command line on Windows, Mac, and Linux.
-- Run a MXC supernode regularly or as a prover.
+- Run a Moonchain supernode easily from the command line on Windows, Mac, and Linux.
+- Run a Moonchain supernode regularly or as a prover.
 - View a [Grafana](https://grafana.com/) dashboard which displays the node's status.
 
-<iframe width="560" height="315" src="https://www.youtube.com/embed/6QI9YxFskYY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
 ## Prerequisites
 
@@ -22,14 +21,9 @@ This guide will walk you through the process of operating a MXC supernode via [s
 - Consult the [Geth minimum hardware requirements](https://github.com/ethereum/go-ethereum#hardware-requirements), with the exception of 1TB of free space (you won't need much, even ~50GB should suffice).
 ## Steps
 
-### Staking MXC on MXCL1 contract
-Staking Test MXC Token [here](https://wannsee-bridge.mxc.com/#/stake)
-![stake](./img/stake.png)
-
-
 ### Clone simple-mxc-node
 ```sh
-git clone https://github.com/MXCzkEVM/simple-mxc-node
+git clone https://github.com/MXCzkEVM/simple-mxc-node/geneva
 cd simple-mxc-node
 ```
 
@@ -71,15 +65,21 @@ You can get a Arbiturm L1 endpoint from a few places,
 are popular RPC providers. 
 :::
 
-**Make sure you select the RPC as Arbiturm Goerli testnet, and not Ethereum mainnet**.
+**Make sure you select the RPC as Arbiturm Sepolia testnet, and not Ethereum mainnet**.
 
+### Set Permissions and create Folders
+Create the necessary directories and set the permissions so that the Docker containers can access and write to them:
+```
+mkdir -p ./data/l2_execution_engine_data ./data/zkevm_chain_prover_rpcd_data ./data/prometheus_data ./data/grafana_data ./docker/prometheus ./docker/grafana/custom
+sudo chmod -R 777 ./data ./docker
+```
 ### Enable your supernode as a prover (optional)
 
 See [enable a prover](/docs/Tutorials/enable-a-prover) for more information.
 
 ### Start a supernode
 :::caution
-It may take some time to synchronize from the genesis block. You can monitor this progress through logs, or in the local grafana dashboard and see the latest L2 chain status in the [MXC Wannsee block explorer](https://wannsee-explorer.mxc.com/).
+It may take some time to synchronize from the genesis block. You can monitor this progress through logs, or in the local grafana dashboard and see the latest L2 chain status in the [MXC Geneva block explorer](https://geneva-explorer.moonchain.com/).
 :::
 Make sure Docker is running and then run the following command to start the supernode. If you want to run it in the background, please add the `-d` flag (`docker compose up -d`).
 
@@ -162,6 +162,9 @@ You can ignore any WARN logs.
 #### `error: L1_STAKE_AMOUNT`
 You need to stake 5000 MXC on MXCL1 contract to run a supernode as a proposer.
 
+#### `mkdir: can't create directory [...]: Permission denied`
+Make sure you gave the needed permissions to the node.
+
 #### `error: L1_ID`
 The block that you want to prove has already been verified, you can ignore this.