Merge pull request #229 from antonbosss/main

Updated FAQ + MOR Claim Testing Guide + Contributions (MRI 1, 8, 9)
MorpheusAIs · May 9, 2024 · 31d5898 · 31d5898
2 parents 2fb005a + 37a3c86
commit 31d5898
Show file tree

Hide file tree

Showing 40 changed files with 745 additions and 242 deletions.
diff --git a/!KEYDOCS README FIRST!/FAQs.md b/!KEYDOCS README FIRST!/FAQs.md
diff --git a/!KEYDOCS README FIRST!/Fair Launch.md → ...S README FIRST!/Morpheus Launch Phases.md b/!KEYDOCS README FIRST!/Fair Launch.md → ...S README FIRST!/Morpheus Launch Phases.md
@@ -1,29 +1,37 @@
-# Date For Morpheus Fair Launch - February 8th 2024
-Following successful audits and testnet deployments, smart contracts for the Morpheus (MOR) token and its fair launch were deployed to Ethereum and Arbitrum mainnet on February 7th 2024.  
-The fair launch commenced on February 8th for Code and Capital contributors, as per the bootstrapping schedule outlined below.
+# The 5 phases of Morpheus launch match those of Ethereum - Genesis, Frontier, Homestead, Metropolis & Serenity
 
-## Bootstrapping Period Phase 1: Code & Capital
-The Smart Contracts began allocating MOR token emissions for Code, Capital, Compute, and Community from day 1. Keep in mind MOR tokens are not be claimable or transferrable until day 91 after phase 1 of the bootstrapping period which is May 8th.
+## Genesis
+**September 2nd 2023 to February 8th 2024**  
+Morheus whitepaper released, first local install in October 2023. Following successful audits and testnet deployments, smart contracts for the Morpheus (MOR) token and its fair launch were deployed to Ethereum and Arbitrum mainnet on February 7th 2024. 
 
-## Bootstrapping Period Phase 2: Compute
+## Frontier
+The fair launch commenced on February 8th 2024 kicking off the 90 day bootstrapping period.  
+The Smart Contracts began allocating MOR token emissions for Code, Capital, Compute, and Community from day 1. Tokens become claimable and transferrable on day 91 of the bootstrapping period which is May 8th.
+
+## Homestead
+Rewards for Compute via Morpheus / Lumerin node go live.  
 While rewards for Compute contributors began accruing on day 1, they will not be distributed until the Compute Router and other details are developed by the community.
 
-## Bootstrapping Period Phase 3: Community Front End Builders
+## Metropolis
+Launch of Smart Agents / End User Applications rewards via MOR staking.  
 Similarly, rewards for Community (frontend) contributors began accruing on day 1, but will not be distributed until distribution details are developed by the community.
 
-## Bootstrapping Period Phase 4: Adding More Chains / Yield Types
+## Serenity
+Morpheus spreads across many chains & yield types.  
 As Morpheus is intended to be chain-agnostic, it is worth considering proposals to deploy the MOR token on other chains and provision yield (with eligibility for Capital rewards) from other sources.
 
 - Examples of cross-chain deployments could entail using Wormhole or LayerZero to move MOR tokens between ETH, ARB, POLY, Solana, and the Cosmos chains.
 - Examples of alternative yield sources could include BTC yield from Thorchain or mSOL from Solana.
 
 These are significant and interrelated projects as adding yield sources necessitates adding the MOR token to other chains in a way where cross-chain messaging is possible. 
 
-## Updated Testing Plan
-Outlined here is the testing plan the Morpheus Smart Contracts were subject to before launch:
+---
+
+### Testing Plan
+Outlined here is the testing plan for the Morpheus Smart Contracts:
 https://github.com/MorpheusAIs/Docs/blob/main/!KEYDOCS%20README%20FIRST!/TestingPlan.md
 
-## History
+### History
 February 8th 2024 is the 28th Anniversary of "A Declaration of the Independence of Cyberspace" (February 8th 1996). 
 Seems like a good day to release Decentralized AI into the world.
 https://www.eff.org/cyberspace-independence
diff --git a/Contributions/Code - Proof_Of_ContributionSnapshot4.md b/Contributions/Code - Proof_Of_ContributionSnapshot4.md
@@ -23,7 +23,8 @@ Theoretical Implied Value of a Weight = $0.407 USD per Weight (price is unknown
 
 **Snapshot 4.** 
 April 8th 2024 to May 8th 2024  
-Theoretical Implied Value of a Weight = $*.** (to be calculated at the end of the month) USD per Weight (price is unknown 1MOR = 1MOR). 
+Theoretical Implied Value of a Weight = $0.783 USD per Weight (price is unknown 1MOR = 1MOR).  
+The weight calculation method explained [here](https://github.com/MorpheusAIs/Docs/blob/main/Guides/Code%20Contributor%20Weights%20Guide.md#year-1-weights-schedule).
 
 > [!NOTE]
 > **Weights were rebased by 2,000 X at Snapshot 3 to create more granularity as fractions of weights are not supported in the Smart Contract. For more details check [MRC14](https://github.com/MorpheusAIs/MRC/blob/main/IMPLEMENTED/MRC14.md)**
@@ -45,7 +46,11 @@ Example fields below:
 Please include the "pipe" `|` symbol correctly as seen above so your contribution will format with the table.
 
 > [!IMPORTANT]  
-> There is new a new MRI column added where the contributor should specify which MRI the contribution is related to. 
+> There is new a new MRI column added where the contributor should specify which MRI the contribution is related to.
+>  
+> One MRI = one entry.
+> 
+> Don't combine multiple MRIs in a single line. Break out contributions into their own line in the table.  
 
 - **MRI Number 1:** [Smart Contracts on Ethereum / Arbitrum](https://github.com/MorpheusAIs/SmartContracts)  
   - **Maintainer's GitHub Handle:** [DavidAJohnston](https://github.com/DavidAJohnston) 
@@ -105,5 +110,3 @@ Please include the "pipe" `|` symbol correctly as seen above so your contributio
 | 0xe924d804cdcdcb483f39601504044c188012f8c8 | 8 | https://github.com/MorpheusAIs/MRC/blob/main/IN%20PROGRESS/MRC31.md , https://github.com/MorpheusAIs/Docs/pull/200 , https://github.com/MorpheusAIs/Docs/pull/210 | 35000 | (Nebuchadnezzar Crew #2) MRC31: Code Contributor Weights Guide. Revamped the Weights Guide and documentation per MRC31. Year 1 + 2 emissions merge. April 8th revaluation. USD Valuation calculation for May 8th. Smart contract testing and support.|
 | 0xe924d804cdcdcb483f39601504044c188012f8c8 | 8 | https://github.com/MorpheusAIs/MRC/blob/main/IN%20PROGRESS/MRC31.md , https://github.com/MorpheusAIs/Docs/pull/204 | 35000 | (Nebuchadnezzar Crew #2) MRC31: Weight Maintenance Guide. Guide detailing requirements for maintenance of weights and establishing procedures by which weights become at-risk along with an associated grace period.|
 | 0xe924d804cdcdcb483f39601504044c188012f8c8 | 1 | https://github.com/MorpheusAIs/Docs/blob/main/!KEYDOCS%20README%20FIRST!/Phased%20AMM%20Deployment%20and%20Fair%20Price%20Discovery.md | 30000 | (Nebuchadnezzar Crew #2) AMM launch. Discussions around strategy, updating design considerations, and final smart contract to ensure clean launch |
-
-
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/approve.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/approve.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/claim.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/claim.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/deposited.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/deposited.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/import MOR.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/import MOR.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/mint mock steth.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/mint mock steth.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/mor balance.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/mor balance.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/rewards.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/rewards.png
diff --git a/Graphics/Docs Graphics/English/MOR Claim Test Guide/stake.png b/Graphics/Docs Graphics/English/MOR Claim Test Guide/stake.png
diff --git a/...cs/Docs Graphics/English/Morpheus Capital Providers Contract Guide/approval.png b/...cs/Docs Graphics/English/Morpheus Capital Providers Contract Guide/approval.png
diff --git a/...ics/Docs Graphics/English/Morpheus Capital Providers Contract Guide/deposit.png b/...ics/Docs Graphics/English/Morpheus Capital Providers Contract Guide/deposit.png
diff --git a/...s/Docs Graphics/English/Morpheus Capital Providers Contract Guide/deposited.png b/...s/Docs Graphics/English/Morpheus Capital Providers Contract Guide/deposited.png
diff --git a/...ics/Docs Graphics/English/Morpheus Capital Providers Contract Guide/rewards.png b/...ics/Docs Graphics/English/Morpheus Capital Providers Contract Guide/rewards.png
diff --git a/...cs/Docs Graphics/English/Morpheus Capital Providers Contract Guide/withdraw.png b/...cs/Docs Graphics/English/Morpheus Capital Providers Contract Guide/withdraw.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/approve weth.png b/Graphics/Docs Graphics/English/Uniswap Guide/approve weth.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/import morr.png b/Graphics/Docs Graphics/English/Uniswap Guide/import morr.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/select mor.png b/Graphics/Docs Graphics/English/Uniswap Guide/select mor.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/select weth.png b/Graphics/Docs Graphics/English/Uniswap Guide/select weth.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/swap successs.png b/Graphics/Docs Graphics/English/Uniswap Guide/swap successs.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/swap weth mor.png b/Graphics/Docs Graphics/English/Uniswap Guide/swap weth mor.png
diff --git a/Graphics/Docs Graphics/English/Uniswap Guide/warning.png b/Graphics/Docs Graphics/English/Uniswap Guide/warning.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/1.md b/Graphics/Docs Graphics/MOR Claim test guide/1.md
@@ -0,0 +1 @@
+
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/Mint mock steth.png b/Graphics/Docs Graphics/MOR Claim test guide/Mint mock steth.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/approve.png b/Graphics/Docs Graphics/MOR Claim test guide/approve.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/claim.png b/Graphics/Docs Graphics/MOR Claim test guide/claim.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/deposited.png b/Graphics/Docs Graphics/MOR Claim test guide/deposited.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/mor balance.png b/Graphics/Docs Graphics/MOR Claim test guide/mor balance.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/rewards.png b/Graphics/Docs Graphics/MOR Claim test guide/rewards.png
diff --git a/Graphics/Docs Graphics/MOR Claim test guide/stake.png b/Graphics/Docs Graphics/MOR Claim test guide/stake.png
diff --git a/Graphics/Video logos.md b/Graphics/Video logos.md
@@ -0,0 +1 @@
+https://drive.google.com/drive/folders/11PbKnH9X98JgOA9Pml2zjxf6mFaVws8f?usp=sharing
diff --git a/Guides/MOR/Mainnet/MOR Rewards Claim Guide.md b/Guides/MOR/Mainnet/MOR Rewards Claim Guide.md
@@ -0,0 +1,96 @@
+# MOR Rewards Claim Guide
+
+## Table of contents
+1) [**Smart Contract Addresses**](#smart-contract-addresses)
+2) [**Get information about MOR rewards**](#how-much-mor-have-i-earned-as-rewards)
+3) [**Claim MOR rewards**](#how-to-claim-rewards)
+4) [**Get MOR on Arbitrum chain**](#how-to-verify-that-i-have-received-tokens)
+5) [**Add MOR to Metamask**](#add-mor-to-metamask)
+
+---
+
+## Introduction
+This guide will walk you through the process of claiming MOR rewards on the Ethereum chain and obtaining them on the Arbitrum chain. The Metamask wallet is used as a reference in this guide, but the logic remains the same for other Web3 wallets.
+
+---
+
+## Smart Contract Addresses
+**Ethereum:**  
+Distribution contract: [**0x47176B2Af9885dC6C4575d4eFd63895f7Aaa4790**](https://etherscan.io/address/0x47176B2Af9885dC6C4575d4eFd63895f7Aaa4790)
+
+**Arbitrum:**  
+MOR Token: [**0x092baadb7def4c3981454dd9c0a0d7ff07bcfc86**](https://arbiscan.io/address/0x092baadb7def4c3981454dd9c0a0d7ff07bcfc86)
+
+---
+
+## How much MOR have I earned as rewards?
+You need to go to the [Distribution](https://etherscan.io/address/0x47176B2Af9885dC6C4575d4eFd63895f7Aaa4790#readProxyContract) contract, open the **"Contract"** tab, then the **"Read as Proxy"** tab.  
+
+Don't forget to connect your wallet by clicking on the **"Connect to Web3"** button.
+
+The rewards are earned every block and to check the amount, you need to call the `2.getCurrentUserReward` function and input parameters:
+- `poolId_ (uint256)`: pool identifier; enter `0` for capital providers pool or `1` for code providers pool;
+- `user_ (address)`: user wallet address.
+
+Click "**Query**"  
+
+As a result, you will find out how many unclaimed rewards there are at the moment.  
+Amount is in WEI and you can use this unit converter calculator https://eth-converter.com.
+
+<img src="/Graphics/Docs%20Graphics/English/MOR%20Claim%20Test%20Guide/rewards.png" width=55% height=55%>
+
+---
+
+## How to claim rewards?
+You need to go to the [Distribution](https://etherscan.io/address/0x47176B2Af9885dC6C4575d4eFd63895f7Aaa4790#writeProxyContract) contract, open the **"Contract"** tab, then the **"Write as Proxy"** tab.  
+
+Don't forget to connect your wallet by clicking on the **"Connect to Web3"** button. Make sure your wallet has enough ETH to cover gas fees.
+
+Find and call the `claim()` function and input the following parameters:
+- `claim`: **0.001** - this is the amount of ETH that you will send with the transaction to pay for mint on the destination network. Any excess will be returned to you;
+- `poolId_`: pool identifier; enter `0` for capital providers pool or `1` for code providers pool;
+- `receiver_(address)`: Input the address that will receive the minted MOR tokens. 
+
+> [!WARNING]  
+> **Ensure the address is correct, as this action is irreversible.**
+
+Click **"Write"** and confirm the transaction.  
+
+<img src="/Graphics/Docs%20Graphics/English/MOR%20Claim%20Test%20Guide/claim.png" width=55% height=55%>
+
+>[!NOTE]
+> **After your Ethereum transaction is confirmed, it may take up to 15 minutes for MOR to appear in your wallet on the Arbitrum chain.**
+>
+> **This function claims the whole available balance, you can not claim in parts.**
+
+---
+
+## How to verify that I have received tokens?
+Switch your wallet to the Arbitrum chain. If the Arbitrum chain is not added yet, use [ChainList](https://chainlist.org/?search=Arbitrum) and click **"Add to Metamask".**
+
+Go to [MOR](https://arbiscan.io/address/0x092baadb7def4c3981454dd9c0a0d7ff07bcfc86#readContract) token contract. Open the **"Contract**" tab, then the **"Read Contract"** tab. 
+
+It is necessary to call the function `6. balanceOf()` and specify in the `account (address)` field your wallet address. 
+
+Click "**Query**"
+
+As a result, you will find out how many MOR tokens are in the wallet, reflected in WEI.  
+To convert WEI you can use this tool https://eth-converter.com.
+
+<img src="/Graphics/Docs%20Graphics/English/MOR%20Claim%20Test%20Guide/mor%20balance.png" width=55% height=55%>
+
+---
+
+## Add MOR to Metamask
+To add MOR token to your Metamask wallet token list, you need to follow steps from the [guide](https://support.metamask.io/managing-my-tokens/custom-tokens/how-to-display-tokens-in-metamask/#how-to-add-a-custom-token) and add MOR smart contract address: `0x092baadb7def4c3981454dd9c0a0d7ff07bcfc86`.
+
+<img src="/Graphics/Docs%20Graphics/English/MOR%20Claim%20Test%20Guide/import%20MOR.png" width=45% height=45%>
+
+---
+
+> [!TIP]  
+> **In case you face difficulties, find something unclear, or have questions, you can get assistance in the** [**Morpheus Discord server**](https://discord.com/channels/1151741790408429580/1183666837460897832).
+>
+> **Information on how to deposit or withdraw stETH through the Smart Contract is in this** [**guide**](https://github.com/MorpheusAIs/Docs/edit/main/Guides/MOR/Mainnet/Morpheus%20Capital%20Providers%20Contract%20Guide.md).
+
+## Beware of scams, Morpheus has no tech support team, no support tickets and will not commence any airdrops. Anyone who message you with proposal to help is likely a scammer.
diff --git a/Guides/MOR/Mainnet/MOR Uniswap Swap Guide.md b/Guides/MOR/Mainnet/MOR Uniswap Swap Guide.md
@@ -0,0 +1,114 @@
+# MOR Uniswap Swap Guide
+
+>[!WARNING]
+> **Trading on decentralized exchanges like Uniswap involves inherent risks, including but not limited to slippage and liquidity risk, smart contract risk, impermanent loss, scams. It's advisable to do your research and understand the risks before engaging in any trading activities.**
+
+---
+
+## Introduction
+This guide will familiarize you with the basic functions of the decentralized exchange Uniswap, particularly token management and swaps. The Metamask wallet is used as a reference in this guide, but the logic remains the same for other Web3 wallets.
+
+---
+
+## Table of contents
+1) [Smart Contract Addresses](#smart-contract-addresses)
+3) [Connect to Uniswap](#connect-wallet-to-uniswap)
+4) [Prepare to swap](#prepare-to-swap)
+5) [Swap tokens](#how-to-swap-tokens-on-uniswap)
+6) [Add MOR to Metamask](#add-mor-to-metamask)
+
+---
+
+## Smart Contract Addresses
+Arbitrum mainnet:  
+
+**MOR Token:** [0x092bAaDB7DEf4C3981454dD9c0A0D7FF07bCFc86](https://arbiscan.io/token/0x092bAaDB7DEf4C3981454dD9c0A0D7FF07bCFc86)  
+
+**wETH Token** [0x82aF49447D8a07e3bd95BD0d56f35241523fBab1](https://arbiscan.io/token/0x82aF49447D8a07e3bd95BD0d56f35241523fBab1)
+
+---
+
+## Connect wallet to Uniswap
+Go to the Uniswap web app https://app.uniswap.org and choose Arbitrum chain in the top right corner of the screen.
+
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/arb.png" width=100% height=100%>
+
+Click **"Connect"** button 
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/connect1.png" width=100% height=100%>
+
+Select the wallet you would like to connect and approve the connection.  
+
+Once approved your wallet will be connected!
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/connect2.png" width=100% height=100%>
+
+---
+
+## Prepare to swap
+Go to the Uniswap web app SWAP page [https://app.uniswap.org/swap](https://app.uniswap.org/swap?chain=arbitrum), search for and select tokens you wish to swap.
+
+> [!NOTE]
+> **In the example below we will buy MOR with wETH, but the process is the same for swaps in both directions.**
+> 
+> **You can NOT swap MOR until 12:00 UTC May 8th**
+
+Click on **You pay** (token you want to sell) field drop-down menu and select wETH token (or another token you want to swap to MOR)
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/select%20weth.png" width=75% height=75%>
+
+Perform the same actions with **You receive** (token you want to buy) field.  
+
+You will not be able to find MOR token in the list, so we need to add it manually. 
+
+For this, input MOR token smart contract address `0x092bAaDB7DEf4C3981454dD9c0A0D7FF07bCFc86` into the search field and click on **MOR** to add it.
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/select%20mor.png" width=75% height=75%>
+
+If the warning message pops up, read it and click **I understand**. That is the standard warning for new tokens.
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/warning.png" width=45% height=45%>
+
+
+## How to swap tokens on Uniswap?
+
+Enter the amount of tokens you want to sell in **You pay** field, the amount of tokens **You receive** will calculate automatically accordingly to the current price.  
+
+Check conditions, click **Swap.** 
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/swap%20weth%20mor.png" width=45% height=45%>
+
+Approve spendings for the token you are swapping, sign message and confirm swap.  
+
+For more information on token approvals see this [article](https://support.uniswap.org/hc/en-us/articles/8120520483085-What-is-an-approval-transaction).
+
+> [!TIP]
+> The best cybersecurity practice is to approve only amount you want to spend.
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/approve%20weth.png" width=40% height=40%>
+
+After swap transaction is confirmed, you will see updated balances.  
+
+<img src="/Graphics/Docs%20Graphics/English/Uniswap%20Guide/swap%20successs.png" width=50% height=50%>
+
+---
+
+## Add MOR to Metamask
+To add MOR token to your Metamask wallet token list, you need to follow steps from the [guide](https://support.metamask.io/managing-my-tokens/custom-tokens/how-to-display-tokens-in-metamask/#how-to-add-a-custom-token) and add MOR smart contract address: 
+
+`0x092baadb7def4c3981454dd9c0a0d7ff07bcfc86`
+
+After performing these steps you will be able to see MOR token balance in the tokens section of your Metamask wallet. 
+
+<img src="/Graphics/Docs%20Graphics/English/MOR%20Claim%20Test%20Guide/import%20MOR.png" width=45% height=45%>
+
+---
+
+> [!TIP]  
+> **In case you face difficulties, find something unclear, or have questions, you can get assistance in the** [**Morpheus Discord server**](https://discord.com/channels/1151741790408429580/1183666837460897832).
+>
+> **If you need more information about Uniswap exchange functions, please refer to the official Uniswap** [**support page.**](https://support.uniswap.org/hc/en-us ) 
+
+## Beware of scams, Morpheus has no tech support team, no support tickets and will not commence any airdrops. Anyone who message you with proposal to help is likely a scammer.
+
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		https://drive.google.com/drive/folders/11PbKnH9X98JgOA9Pml2zjxf6mFaVws8f?usp=sharing