diff --git a/docs/develop/api/networks.mdx b/docs/develop/api/networks.mdx index ce08dbee..f32b9c41 100644 --- a/docs/develop/api/networks.mdx +++ b/docs/develop/api/networks.mdx @@ -10,7 +10,7 @@ Below is a list of publicly available endpoints that you can use to connect to t public testnets: :::tip -You can also use [chainlist.org](https://chainlist.org/) to add the node directly to [Metamask](./../../use/connect-your-wallet/metamask#automatic-import). +You can also use [chainlist.org](https://chainlist.org/) to add the node directly to [Metamask](https://academy.evmos.org/articles/beginner/connect-your-wallet/metamask). ::: :::note diff --git a/docs/develop/faucet/index.mdx b/docs/develop/faucet/index.mdx index 94b5d262..3c388cac 100644 --- a/docs/develop/faucet/index.mdx +++ b/docs/develop/faucet/index.mdx @@ -8,7 +8,7 @@ of to anyone who can provide a valid testnet address. Users can request funds from the faucet either by using the Keplr or Metamask. -Follow the [Metamask](./../../use/connect-your-wallet/metamask), [Keplr](./../../use/connect-your-wallet/keplr) +Follow the [Metamask](https://academy.evmos.org/articles/beginner/connect-your-wallet/metamask), [Keplr](https://academy.evmos.org/articles/beginner/connect-your-wallet/keplr) or [Keyring](./../../protocol/concepts/keyring) guides for more info on how to setup your wallet account. After receiving funds from the faucet, view your account balance either by diff --git a/docs/develop/wallet-integration/index.md b/docs/develop/wallet-integration/index.md index e4cbc95d..76b6ff55 100644 --- a/docs/develop/wallet-integration/index.md +++ b/docs/develop/wallet-integration/index.md @@ -7,7 +7,7 @@ applications. Here are some key points from various sources on wallet integratio transactions and wallet interactions, and more. Developers enabling transactions on their dApp have to determine the wallet type of the user, create the transaction, request signatures from the corresponding wallet, and finally broadcast. -- Leverage Keplr, Metamask, Ledger, WalletConnect and more with Evmos. The latest wallets are located [here](./../../../use/wallet). +- Leverage Keplr, Metamask, Ledger, WalletConnect and more with Evmos. The latest wallets are located [here](https://academy.evmos.org/articles/wallet). - Head over to our [Evmos Client Integrations](./../../develop/tools/client-integrations) to leverage our Typescript or Python libraries. diff --git a/docs/protocol/concepts/signing.md b/docs/protocol/concepts/signing.md index 48a16555..6d70a6cf 100644 --- a/docs/protocol/concepts/signing.md +++ b/docs/protocol/concepts/signing.md @@ -7,7 +7,7 @@ sidebar_position: 11 Signing is the process of creating a digital signature using a private key to verify a transaction on the Evmos network. The signature is created using a specific cryptographic algorithm that ensures the authenticity and integrity of the transaction using methods like -[wallets](./../../use/connect-your-wallet) and the [CLI](./../evmos-cli). +[wallets](https://academy.evmos.org/articles/wallet) and the [CLI](./../evmos-cli). There are different methods for signing, but one of the most commonly used methods is the [EIP-712](https://eips.ethereum.org/EIPS/eip-712) standard. @@ -39,5 +39,5 @@ Ethereum and Cosmos networks, ultimately fostering greater interoperability betw :::note EvmosJS supports signing with EIP-712. More information about the library can be found [here](https://github.com/evmos/evmosjs). -Supported: [Ledger support](./../../use/connect-your-wallet/ledger) and [CLI Commands](./../evmos-cli/cli-commands). +Supported: [Ledger support](https://academy.evmos.org/articles/beginner/connect-your-wallet/ledger) and [CLI Commands](./../evmos-cli/cli-commands). ::: diff --git a/docs/protocol/evmos-cli/index.mdx b/docs/protocol/evmos-cli/index.mdx index 619f7f98..9a8991c0 100644 --- a/docs/protocol/evmos-cli/index.mdx +++ b/docs/protocol/evmos-cli/index.mdx @@ -149,7 +149,7 @@ evmosd keys add [name] \ --keyring-backend test ``` -To export your evmos key as an Ethereum private key (for use with [Metamask](./../../../use/connect-your-wallet/metamask) +To export your evmos key as an Ethereum private key (for use with [Metamask](https://academy.evmos.org/articles/beginner/connect-your-wallet/metamask) for example): ```bash diff --git a/docs/protocol/evmos-cli/single-node.mdx b/docs/protocol/evmos-cli/single-node.mdx index 4d47982a..e7c97ba0 100644 --- a/docs/protocol/evmos-cli/single-node.mdx +++ b/docs/protocol/evmos-cli/single-node.mdx @@ -204,7 +204,7 @@ You can generate a new key/mnemonic with: evmosd keys add $KEY ``` -To export your Evmos key as an Ethereum private key (for use with [Metamask](./../../../use/connect-your-wallet/metamask) +To export your Evmos key as an Ethereum private key (for use with [Metamask](https://academy.evmos.org/articles/beginner/connect-your-wallet/metamask) for example): ```bash diff --git a/docs/use/Interact-with-dApps/index.md b/docs/use/Interact-with-dApps/index.md deleted file mode 100644 index feb2057c..00000000 --- a/docs/use/Interact-with-dApps/index.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -sidebar_position: 4 -slug: '/dapps' ---- - -# Use dApps - -Before engaging with dApps, it is important to have a wallet with some Evmos tokens. If you have not installed a wallet, -please visit our [wallet's](./../use/wallet) section to select an appropriate wallet. If you do not have any EVMOS tokens, -you can acquire them by reading the [Onramp to Evmos](../transfer-tokens/index.md#onramp-to-evmos) strategies. - - - -You can start by using the Evmos dApps that are built and maintained by the Evmos core development team or use our -[Ecosystem Page](https://evmos.org/ecosystem) to browse through the rich ecosystem of dApps on Evmos. - -## Queries and Transactions - -Once you have your wallet set up, you can start using dApps on Evmos. Generally, reading information from the network -(querying) is free and doesn't require you to pay transaction fees. So dApps can always display blockchain information, -such as your asset balances without requiring you to pay a network fee. - -To engage with a dApp, you are required to sign transactions with your wallet and pay a small network fee. A transaction -is a transfer of value on the blockchain. This can be anything like a simple transfer of tokens to another account, -changing the ownership of a character in a game or accepting the terms of a loan when lending or borrowing assets. - -A typical flow to interact with a dApp can look like this: - -1. Connect your wallet to the Evmos network. -2. Visit a dApp and submit a transaction (e.g. to stake your tokens). -3. On your wallet, sign and broadcast the transaction by paying the network fee with gas. -4. Wait until the transaction is confirmed and successful. -5. View the changes from your transaction in the dApp. You can view more details about your transaction using a block - explorer. Transactions are batched and processed together with other transactions in a block and block explorers allow - anyone to view all transactions in the network. - -## Evmos dApps - -Alongside the applications built by the developer community, the Evmos Core Development Team also builds its own -[Evmos dApps](https://app.evmos.org). An easy way to get started is by staking and voting for governance proposals. - -### Staking - -Staking plays an essential role in keeping the Evmos network secure and decentralized. The Evmos network is run by a -technology that incentivizes a set of community members to keep it online and decentralized, called Proof-of-Stake. -These community members, called validators, are responsible for validating transactions in a block and are usually -very technical teams as they have to monitor and upgrade the software that runs the Evmos network. Validators are -incentivized to stay online as they earn a commission on your stake. - -You can help keep the network secure and put your EVMOS tokens at "stake", by delegating them to a validator. This will -earn you a daily interest in form of new EVMOS tokens (aka. staking rewards). As long as your tokens are staked, you -cannot transfer or use them in other dApps. At any given time, you can undelegate your tokens. This will allow you to -start using your tokens again after an unbonding period that is defined in the protocol (e.g. two weeks). - -![evmos_staking.png](/img/evmos_staking.png) - -You can choose validators to stake your tokens with from a list on the [Evmos Staking dApp](https://app.evmos.org/staking). -We recommend choosing a reputable validator, that can promise to stay online and doesn't have a large voting power -(e.g. is not in the top 20). Validators that are offline for an extended period or act maliciously can get slashed, -resulting in a loss of your stake. Also, delegating to validators with less voting power keeps the network more -decentralized. You can switch between validators without undelegating your tokens by redelegating them. - -### Governance - -Evmos has an on-chain governance mechanism for making changes to the network protocol, such as changing chain parameters -(like the unbonding period for staking), spending funds from the community pool (e.g. to fund teams to build on Evmos), -or upgrading the Evmos software that is run by validators. - -Developers propose changes through code updates and the community votes on whether to accept or reject the proposed change. -Every participant can vote for proposals, as long as they have staked EVMOS tokens. Each vote is weighted by the amount -of staked tokens. - -![evmos_governance.png](/img/evmos_governance.png) - -Evmos is known for hosting one of the most active governance communities in the blockchain space. Anyone can participate -in governance so the ownership, norms, and culture of the Evmos network are thus spread across the community. Once you -have staked your tokens, head over to the [Evmos Governance dApp](https://app.evmos.org/governance) to start voting on -governance proposals. - -:::note -Engage with our community on [Commonwealth](https://commonwealth.im/evmos) and learn about upcoming proposals. If you are -interested in launching your own governance proposals, head over [here](https://academy.evmos.org/community/governance/) -for a guide. -::: diff --git a/docs/use/connect-your-wallet/_category_.json b/docs/use/connect-your-wallet/_category_.json deleted file mode 100644 index 331ae90a..00000000 --- a/docs/use/connect-your-wallet/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Connect Your Wallet", - "position": 1 -} \ No newline at end of file diff --git a/docs/use/connect-your-wallet/index.mdx b/docs/use/connect-your-wallet/index.mdx deleted file mode 100644 index 23644561..00000000 --- a/docs/use/connect-your-wallet/index.mdx +++ /dev/null @@ -1,22 +0,0 @@ ---- -sidebar_position: 1 -title: Wallet Overview -slug: '/wallet' ---- - -# Wallet Overview - -Evmos network supports both Cosmos and ERC-20 coins. There are several wallets that work with the network. Some of these wallets support Ledger connectivity. Consult the table below for more information. We recommend Metamask and Keplr wallets. These two wallets also work with the Ledger. For more information about Ledger, proceed to [here](./connect-your-wallet/ledger). - -| Wallet | Supported | Ledger | Detail | -| ---------------------- | ---------- |---------|------------------------------------------- -| [Metamask](https://metamask.io/) | ✅ | ✅ | Mobile & Browsers. Supports ERC-20 tokens, but no Cosmos coins| -| [Keplr](https://www.keplr.app/) | ✅ | ✅ | Mobile & Browsers. Supports Cosmos coins but ERC-20 support coming soon | -| [WalletConnect v2](https://docs.walletconnect.com/2.0) | ✅ | ✅ | Supported only on the [Dashboard Assets](https://app.evmos.org/assets) -| [WalletConnect v1](https://docs.walletconnect.com/1.0/) | 🟡 | ✅ | Supported only on the [Dashboard](https://app.evmos.org/) (excluding Assets). Deprecating soon. | -| [Ledger](https://www.ledger.com/) | ✅ | ✅ | Desktop & Mobile. Supported on Metamask, Keplr, and CLI | -| [Trust Wallet](https://trustwallet.com/) | ✅ | ❌ | Mobile & Browser | -| [Leap Wallet](https://www.leapwallet.io/) | ✅ | ❌ | Brwoser | -| [Coinbase Wallet](https://www.coinbase.com/wallet) | ❌ | ✅ | Not Supported | -| [Cosmostation](https://wallet.cosmostation.io/cosmos) | ✅ | ❌ | Supported on Browswer and Mobile | -| [Cypher](https://www.cypherwallet.io/) | ✅ | ❌ | Supported on Mobile | \ No newline at end of file diff --git a/docs/use/connect-your-wallet/keplr.mdx b/docs/use/connect-your-wallet/keplr.mdx deleted file mode 100644 index bda88396..00000000 --- a/docs/use/connect-your-wallet/keplr.mdx +++ /dev/null @@ -1,162 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Keplr - -Connect your Keplr wallet with Evmos. - -- [Install Keplr](https://www.keplr.app/) - -![keplr-homepage.png](/img/keplr-homepage.png) - -:::tip -**Note**: The Keplr extension is officially supported on Chromium-based browsers (i.e. Edge, Chrome, and Brave) and Firefox. -::: - -import ProjectValue from '@site/src/components/ProjectValue.js'; - -The [Keplr](https://www.keplr.app/) browser extension is a wallet for accessing applications in the Cosmos ecosystem and -managing user identities. It can be used to connect to mainnet and testnet and claim -rewards, send and stake tokens, interact with governance, and more. - -## Set Up Keplr - -:::tip -**Note**: Further information about the process of setting up Keplr can be found in the official -[Keplr Documentation](https://keplr.crunch.help/getting-started) or in this [Medium article](https://medium.com/chainapsis/how-to-use-keplr-wallet-40afc80907f6). -::: - -Open the Keplr extension on your browser. If you are setting up Keplr for the first time, you can either -[create a new account](#create-a-new-account) or [import an existing account](#import-an-existing-account). - -### Create a New Account - -There are several ways to create a new account: - -- via a [mnemonic/seed phrase](#create-an-account-with-a-seed-phrase) -- via [one-click login](#create-an-account-with-one-click-login) - -#### Create an Account with a Seed Phrase - -![keplr-create-new.png](/img/keplr-create-new.png) - -1. In the initial pop-up window, choose **Create New Account** - -- If you have used Keplr before, click on the silhouette in the upper-right corner, then the blue box labeled -**Add Account**, and select **Create New Account** - -2. Choose to have a seed/mnemonic phrase of 24 words, and save the phrase - -- You can change the derivation path by clicking on **Advanced**, but this is optional (learn more in the -[Keplr FAQ](https://faq.keplr.app/)) - -3. Enter a name for your account (can change later) -4. Once you have transcribed your 24 word seed/mnemonic phrase, click on **Next** -5. To confirm the creation of the new account, click on the words on the right order in which they appear in your -seed/mnemonic phrase, and press **Register** -6. If you have not used Keplr before, set a **strong** password for the Keplr extension, and click **Confirm** - -#### Create an Account with One-Click (Google OAuth) Login - -:::tip -**Note**: It is suggested to create an account via mnemonic phrase or utilize a Ledger and not use the `Sign in with Google`. -::: - -1. Choose the option **Sign in with Google** -2. Now enter the email/phone number associated with your Google account, the password, and click **Next** -3. If you have not used Keplr before, set a **strong** password for the Keplr extension, and click **Confirm** - -### Import an Existing Account - -There are several ways to import an existing account: - -- via a [mnemonic/seed phrase/private key](#import-an-account-with-a-seed-phrase) -- via [ledger](#import-an-account-with-a-ledger) - -#### Import an Account with a Seed Phrase - -1. In the initial pop-up window, choose **Import Existing Account** - -- If you have used Keplr before, click on the silhouette in the upper-right corner, then the blue box labeled -**Add Account**, and select **Import Existing Account** -![keplr-import-existing.png](/img/keplr-import-existing.png) -![keplr-seed-phrase.png](/img/keplr-seed-phrase.png) - -2. Enter your mnemonic/seed phrase/private key in the appropriate slot, separating the words with spaces and taking -care to check they are spelled correctly -3. Make sure you have imported the account with the correct derivation path, viewable by clicking on **Advanced** - -- Normally, the derivation path should be `m/44'/…’/0/0/0`, but if you see that importing the account via -mnemonic on Keplr, the Cosmos Mainnet address displayed is different than yours, it is possible the derivation - path ends with 1 (or another number) instead of 0 -- If this is the case, you just have to start the process over, and replace the last 0 with 1 -- Learn more in the [Keplr FAQ](https://faq.keplr.app/) - -4. If you have not used Keplr before, set a **strong** password for the Keplr extension, and click **Confirm** - -#### Import an Account with a Ledger - -![kepler-import-ledger.png](/img/kepler-import-ledger.png) - -1. In the initial pop-up window, choose **Import Ledger** - -- If you have used Keplr before, click on the silhouette in the upper-right corner, then the blue box labeled -**Add Account**, and select **Import Ledger** -- Be sure you have both the Cosmos and Ethereum Ledger apps downloaded on your Ledger device - -2. To complete the connection with your Ledger device, follow the steps described in the pop-up that appears (a detailed -tutorial can be found [here](https://medium.com/chainapsis/how-to-use-ledger-nano-hardware-wallet-with-keplr-9ea7f07826c2)) -or another article from a [validator](https://medium.com/coinmonks/how-to-set-up-ledger-wallet-evmos-using-keplr-c438cf8c5321). -3. If you have not used Keplr before, set a **strong** password for the Keplr extension, and click **Confirm** -4. Switch to the Ethereum app on the Ledger, then select “Evmos” from the Keplr chain registry to connect the public key - -- All signing from Keplr will use the Ledger Ethereum app, with either [EIP-712 transactions](https://eips.ethereum.org/EIPS/eip-712) -or standard [Ethereum transactions](https://ethereum.org/en/developers/docs/transactions/). - -## Changing RPC/REST on Keplr Wallet - -There are times when the wallet's connected RPC or REST is not working and requires an update. Check the -[networks list](../../develop/api/networks) for endpoints to use. To change the configuration, follow these steps: - -1. Click on the Keplr Wallet Extension -2. Go to `Settings` and go to `Endpoints` -3. Make sure you are on the `Evmos Testnet` network from the dropdown. Testnet networks will likely be towards the bottom -of the list. -4. Update either the `RPC` or `Rest` or both inputs and click `Confirm` - -## Connect Keplr to Mainnet - -Once you are signed in to the Keplr extension, you can connect the wallet with the Evmos network. The Evmos mainnet network -is already built into Keplr and look for the `Evmos` network by clicking on the extension and scrolling to select the network. - -## Connect to Evmos Testnet - -![keplr-testnet-evmos.png](/img/keplr-testnet-evmos.png) - -The default network configurations for Keplr comes with mainnet as its default. To connect to the testnet environment, -you will need to head to a site/project that has testnet configuration. A window will request your approval for the chain -and the `chain-id`. Once approved, the testnet will be selectable under the `Beta Support` section of Keplr Wallet. - -import { chainConfig, handler } from '@site/src/utils/ChainConfig'; - -:::tip -Add Evmos Testnet to Keplr. - - -::: - -## Register Interchain Nameservice (ICNS) - -:::note -ICNS is not the same as ENS (Ethereum Name Service). ICNS is exclusive to Cosmos chain and ENS is exclusive to any -EVM-based chains. Since Evmos supports EVM and Cosmos-based actions, both ENS and ICNS are supported. Users can have -both ICNS and ENS but be advised that Cosmos-wallets support ICNS while EVM-wallets support ENS. -::: - -The Interchain Nameservice is an optional service that allows users to use easy-to-remember names instead of addresses -and many interchain networks support it. To learn more about ICNS, head over to [here](https://medium.com/@icns/announcing-icns-the-interchain-name-service-e61e0c3e2abb) to learn more. If you are ready to proceed, you will need -Twitter, `0.5 OSMO` and signed in Keplr Wallet. If you need to obtain `OSMO` token, check out -[this link](https://app.osmosis.zone/?from=USDC&to=OSMO). ICNS registration link is [here](https://app.icns.xyz/). diff --git a/docs/use/connect-your-wallet/ledger.mdx b/docs/use/connect-your-wallet/ledger.mdx deleted file mode 100644 index 05bb2be4..00000000 --- a/docs/use/connect-your-wallet/ledger.mdx +++ /dev/null @@ -1,214 +0,0 @@ ---- -sidebar_position: 4 -slug: 'ledger' ---- - -# Ledger - -Ledger offers a hardware wallet to hold user's private keys. - -## Checklist - -- ✅ [Ledger device](https://shop.ledger.com/) -- ✅ [Ledger Live](https://www.ledger.com/ledger-live) installed -- ✅ [Metamask](https://metamask.io) installed -- ✅ Ethereum Ledger app installed -- ✅ Latest Versions (Firmware and Ethereum app) - -## Introduction - -[Ledger](https://www.ledger.com/)'s hardware wallets are cryptocurrency wallets that are used to store private keys offline. - -> “Hardware wallets are a form of offline storage. A hardware wallet is a cryptocurrency wallet that stores the user's private keys (a critical piece of information used to authorize outgoing transactions on the blockchain network) in a secure hardware device.” -> [Investopedia](https://www.investopedia.com/terms/l/ledger-wallet.asp) - -## Installation - -## Ethereum Ledger App - -If you want to connect to Evmos mainnet and Evmos testnet, you can use the Ethereum Ledger app on Ledger Live by setting the chain ID. - -First, you will need to install the Ethereum Ledger app by following the instructions below: - -1. Open up Ledger Live app on your Desktop -2. Select **Manager** from the menu -3. Connect and unlock your device (this must be done before installation) -4. In the **App catalog** search for `Ethereum (ETH)` and click **Install**. Your Ledger device will show **Processing** and once the installation is complete, the app will appear on your Ledger device - -In the Ledger Live app, you should see the Ethereum app listed under the **Apps installed** tab on the **Manager** page. After the app has been successfully installed, you can close out of Ledger Live. - -### Chain IDs - -In the table below you can find a list of Chain IDs to use with the Ethereum Ledger app. - -| Network | EIP155 chain ID | -| ------------- | --------------- | -| Evmos mainnet | `9001` | -| Evmos testnet | `9000` | - -## Import your Ledger Account - -### Metamask - -Now that you've installed the app on Ledger Live, you can connect your Ledger to your computer and unlock it with your PIN-code and open the Ethereum app. - -:::tip -Follow our [Metamask Guide](./metamask) to add the Evmos Mainnet and Testnet to your Settings -::: - -Now you can import your Ledger account to MetaMask by using the following steps: - -1. Click on connect hardware wallet - -![mm1.png](/img/mm1.png) - -2. Select Ledger hardware wallet - -![mm2.png](/img/mm2.png) - -3. Select your connected Ledger Device - -![mm4.png](/img/mm4.png) - -4. Import the hex addresses that you want to use - -![mm3.png](/img/mm3.png) - -### Keplr - -Reference the [Keplr Wallet](./keplr) to setup Ledger support. - -### Evmos CLI - -To use your Ledger with the Evmos CLI, first connect your device to your computer, unlock it using your PIN, and open the Ethereum app. - -Then, connect your Ledger to the CLI with `keys add` command, and select a name for your device: - -``` -evmosd keys add NAME --ledger -``` - -**Example:** - -``` -evmosd keys add myledger --ledger - -- address: evmos1hnmrdr0jc2ve3ycxft0gcjjtrdkncpmmkeamf9 - name: myledger - pubkey: '{"@type":"/ethermint.crypto.v1.ethsecp256k1.PubKey","key":"A19Ty8NGmXQj/oQ+LubST9eDIhEACmWXW6gdU8h60eXI"}' - type: ledger -``` - -To sign any transaction, simply append `--from myledger` to the end of the command to indicate that the Ledger account should be used to authenticate the message: - -**Example:** - -``` -evmosd tx bank send myledger evmos1hnmrdr0jc2ve3ycxft0gcjjtrdkncpmmkeamf9 100000aevmos --fees 2000aevmos --from myledger -``` - -Now, you can use your Ledger as you would normally interact with the CLI. - -## EIP712 signing - -In order to sign Cosmos transactions (staking, voting on proposals, IBC transfers), with Ledger hardware wallets, we implemented EIP712. - -EIP712 means that the signer will generate a signature for something like a JSON representation of the Cosmos transaction and that signature will be included in the Cosmos transaction itself. - -### Step-by Cosmos transaction using Evmos.me - -1. **Get your address in both encodings** - -After connecting the Ledger wallet to Metamask and connecting to the [https://evmos.me](https://evmos.me) webpage, it will display our wallet formatted on `bech32` and `hex` representation, we need these values to make sure that the message that we are going to sign is the correct one. - -![addresses.png](/img/addresses.png) - -2. **Create a Cosmos transaction** - -In this example, we are going to create a simple message to send tokens to a recipient*.* - -![msgsend.png](/img/msgsend.png) - -After clicking `Send Coins`, Metamask will ask us to sign the typed message - -3. **Sign with Metamask and Ledger** - -![mm5.png](/img/mm5.png) - -You can see the complete message to be signed - -![eipmessage.png](/img/eipmessage.png) - -4. **Validate the data before signing!** - -- `feePayer`: represents the wallet that is signing the message. So it MUST match yours, if it’s different your transaction will be invalid. -- `fee`: amount to be paid to send the transaction. -- `gas`: max gas that can be spent by this transaction (aka gas limit). -- `memo`: transaction note or comment. -- `msgs`: This is the content of the cosmos transaction, in this example, we need to make sure that we are using a MsgSend, and that the *to_address* is the one that we want to send the founds. Also, we can verify that we are actually sending *10000aevmos* to that wallet. - -### Ledger signing - -If you have a Ledger connected to Metamask, you need to use it to sign the message. - -The Ledger device will display the domain hash and message hash before asking you to sign the transaction. - -![hw_01.jpg](/img/hw_01.jpg) - -![hw_02.jpg](/img/hw_02.jpg) - -![hw_03.jpg](/img/hw_03.jpg) - -![hw_04.jpg](/img/hw_04.jpg) - -**Broadcast the transaction** - -After signing the message, that signature needs to be added to the cosmos transaction and broadcasted to the network. - -This step should be done automatically by the same service that generated the message, in this case, [evmos.me](http://evmos.me) will broadcast the transaction for you. - -![txsent.png](/img/txsent.png) - -### Common errors - -- Make sure that the Ethereum Ledger app is installed. The Cosmos Ledger app is not supported on the Evmos chain at the moment (see [FAQ](#faq)). -- Make sure you have created at least one Ethereum address on the Ledger Ethereum app. -- Make sure the Ledger device is unlocked and with the Ledger Ethereum app opened before starting the importing process. - -### Known issues - -- The denomination displayed as `ETH` when importing the wallet because we are using the Ethereum app. -- If you have Metamask correctly configured, the balance on the extension will be displayed as `EVMOS`, but on the Ledger device it will be displayed as `ETH`. - -:::warning -**IMPORTANT:** Make sure you are on the correct network before signing any transaction! -::: - -## FAQs - -
- -How can I generate Cosmos `secp256k1` keys with Ledger? - -Cosmos `secp256k1` keys are not supported on Evmos with Ledger. Only Ethereum keys (`eth_secp256k1`) can be generated with Ledger. - -
- - -
- -My Ledger has trouble connecting or signing on the CLI - -The Ledger's connection to the CLI can fail for a number of reasons. Make sure to close any other apps using the Ledger (such as Ledger Live or Metamask), unlock the Ledger, and open the Ethereum app. If this does not work, simply disconnecting and reconnecting the device often solves the issue. - -
- - -
- -I can’t use Metamask or Keplr with the Cosmos Ledger app - -Since Evmos only support Ethereum keys and uses the same HD (hierarchival determination) wallet derivation path as Ethereum, the Cosmos Ledger app doesn’t work to sign cosmos transactions. Using Keplr with the Cosmos Ledger app will only work with derivation path `m/44'/118'/0'/0` (Cosmos) and not `m/44'/60'/0'/0` (Ethereum). On your Ledger hardware device, you can always switch to Ethereum to reconnect to the Keplr Evmos network. - -
- diff --git a/docs/use/connect-your-wallet/metamask.mdx b/docs/use/connect-your-wallet/metamask.mdx deleted file mode 100644 index b22b9250..00000000 --- a/docs/use/connect-your-wallet/metamask.mdx +++ /dev/null @@ -1,116 +0,0 @@ ---- -sidebar_position: 3 ---- - -# MetaMask - -To interact with the Evmos blockchain, you can use MetaMask, a popular wallet -browser extension that launched with Ethereum. Once connected to Evmos, you can use Metamask -to manage your Evmos accounts and interact with dApps on Evmos. - -## Connect to Mainnet - -If you don't have MetaMask installed, go to the [MetaMask -website](https://metamask.io/download/) and install the extension for your -browser. Once installed, click the button below to connect your Metamask wallet -with Evmos Mainnet using Chainlist. - - - -Chainlist helps you connect to the Evmos Blockchain. It provides an overview of -RPC nodes that you can connect to. The purpose of RPC nodes is to allow -applications and users to communicate with a Blockchain network. RPC nodes -listen for requests, respond with the necessary data, or execute the requested -transaction. - -Click `Add to Metamask` to connect to the standard provider or choose -from a list of RPC Server providers by clicking `Connect Wallet` next to the -address. - -Once you've connected to an RPC Server, you're ready to go and can start using -Evmos. If you run into any issues, you can switch your RPC endpoint, and you -should be good to go. - -## Connect to Testnet - -You might want to connect your wallet to the Evmos Testnet to interact with -dApps that havn't launched on Mainnet yet. Click the button below to connect -your Metamask wallet with Evmos Testnet using Chainlist: - - - -## Connect to Local Node - -You can also connect Metamask to a local node, which is useful if you are -planning on developing on Evmos locally. If you haven't already set up your own -local node, refer to [the quickstart -tutorial](./../../protocol/evmos-cli/single-node), or follow the instructions in -the [GitHub repository](https://github.com/evmos/evmos/). - -Open the MetaMask extension on your browser and log in to your -MetaMask account if you are not already. Then click the top right circle and go -to `Settings` > `Networks` > `Add Network` and fill the form as shown below. - -import ProjectValue from '@site/src/components/ProjectValue'; -import Highlighter from '@site/src/components/Highlighter'; - -![metamask networks settings](/img/metamask_network_settings.png) - -Here is the list of fields that you can use to paste on Metamask: - -- **Network Name:** -- **New RPC URL:** -- **Chain ID:** -- **Currency Symbol (optional):** -- **Block Explorer URL (optional):** `n/a` - -In case you can't open up the MetaMask extension or are blocked in some way, alternatively, you can go on ChainList and switch to a different RPC address. To do this: -- go on https://chainlist.org/chain/9001 -- look for another available RPC server -- Connect your wallet -- Click Approve - -Now you should be connected to a server and be able to properly use MetaMask. - -## Importing Accounts - -If you own the private key to an account, you can import it to Metamask to use -the account on Evmos. Go to `My Accounts` (top right circle) and select `Import -Account`. You should see an image like the following one: - -![metamask manual import account page](/img/metamask_import.png) - -:::tip -If it takes some time to load the balance of the account, change the -network to `Main Ethereum Network` (or any other than `Localhost 8545` or -) and then switch back to . -::: - -## Download Account State - -To see your Metamask logs, click the top right circle and go to `Settings` > -`Advanced` > `State Logs`. If you search through the JSON file for the account -address you'll find the transaction history. - -## Reset Account - -If you used your Metamask account for a legacy testnet/mainnet upgrade, you will -need to reset your account in order to use it with the new network. This will -clear your account's transaction history, but it won't change the balances in -your accounts or require you to re-enter your Secret Recovery Phrase. - -:::warning -Make sure you download your [account state](#download-account-state) -to persist public account addresses and transactions before clearing your wallet -accounts. -::: - -Go to `Settings` > `Advanced` and click the `Reset Account` button as shown -below: - -![Metamask Account Reset](/img/reset_account.png) diff --git a/docs/use/faq.md b/docs/use/faq.md deleted file mode 100644 index 3ed0d7fe..00000000 --- a/docs/use/faq.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -sidebar_position: 5 ---- - -# Frequently Asked Questions - -## Wallets - -
- -Which wallet would you recommend for Evmos? - -There are many wallets to select from but the top wallets with the widest support are [Metamask](https://metamask.io/) -and [Keplr](https://www.keplr.app/). Evmos is an EVM chain built on top of the Cosmos SDK and Metamask does not support -non EVM-specific assets while Keplr wallet does. Keplr wallet will soon support ERC-20. - -
- -
- -Can I use my Ledger device? - -Absolutely! Take a look at the [Ledger](./connect-your-wallet/keplr) for more information. Metamask, -Keplr, and WalletConnect all work with Ledger. Ledger setup will be required before engaging with the dApps and products on Evmos. - -
- -
- -For certain wallets, I see both bech32 and hex while others only show hex formatted addresses, which should - I use? - -The Evmos network supports both formats: bech32 and hex. Other EVM peers and its ecosystem uses hex encoding while -Cosmos-native uses bech32 formatted addresses. Keplr is unique and the EVM-compatible chains shows both formats. If you -are sending tokens (via [IBC](https://www.mintscan.io/evmos/relayers)), you will use bech32 formatted addresses unless -the receiving chain support EVM (i.e. Ethermint-based chains). You can further details [here](./../protocol/concepts/accounts). - -
- -## Onramp - -
- -Where can I acquire EVMOS token? - -There are several paths users can take to acquire EVMOS Token. - -- Decentralized Exchanges: [Osmosis](https://app.osmosis.zone/?from=ATOM&to=EVMOS) -- [C14 Money](https://pay.c14.money/) is an onramp service -- [Testnet Faucet](https://faucet.evmos.dev/) dispenses a small amount of testnet tokens - -
diff --git a/docs/use/index.mdx b/docs/use/index.mdx deleted file mode 100644 index 391c7e6f..00000000 --- a/docs/use/index.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -sidebar_position: 0 ---- - -# Getting Started - -## What is Evmos? - -Evmos is the blockchain network, that lets you use a new generation of applications, built by developers across the world. Using and building on the network is permissionless so it doesn't require any authorization and you can get started right now. - -We believe that you shouldn't be constrained to interacting with applications on only one blockchain. This creates a bad user experience forcing you to reconnect to new networks and transfer currencies between different blockchains. Instead, you should be able to seamlessly use applications, regardless of where they are built. - -That's why at Evmos we enable developers to create applications "cross-chain". These are built once and are accessible from across multiple chains. As a result, you can seamlessly interact with applications on Evmos, without having to know what underlying blockchain they are built on. - -## What are dApps? - -Evmos hosts a rich ecosystem of decentralized applications (dApps), that are disrupting traditional ideas from finance, creative ownership, gaming, governance, and more. A dApp is called "decentralized", as it doesn't rely on a centralized entity and instead gives back ownership to the community. - -A dApp's core business logic is implemented through smart contracts. These contracts execute code over a decentralized network (Evmos) that is publicly visible. A centralized application (e.g. Airbnb) instead executes code in a privately regulated environment such as the application’s own servers. - -## What can you do on Evmos? - -Once connected to the Evmos network, you can send money peer-to-peer without the need for banks or payment services or interact with cross-chain dApps. - -![Evmos dApp - Assets](/img/evmos_assets.png) - -Alongside the applications built by the developer community, the Evmos Core Development Team also builds its own dApps. Here are some examples: - -* [Assets](https://app.evmos.org/assets) - View, withdraw, and deposit cross-chain tokens like a bank account -* [Staking](https://app.evmos.org/staking) - Help keep the network stable, by staking your tokens and earning a daily interest on your stake. -* [Governance](https://app.evmos.org/governance) - Evmos is known for hosting one of the most active governance in the blockchain space. - -To get started, read about how to connect your wallet, transfer tokens and interact with dApps in the following sections. If you want to start building cross-chain applications on Evmos, head over to the development section. diff --git a/docs/use/transfer-tokens/index.md b/docs/use/transfer-tokens/index.md deleted file mode 100644 index 5030aa1e..00000000 --- a/docs/use/transfer-tokens/index.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 3 -slug: '/transfer' ---- - -# Transfer Tokens - -Once connected to the Evmos network, you can use your wallet to transfer tokens peer-to-peer without the need for a bank or an intermediary payment service. This gives you full ownership of your assets but also full responsibility for safekeeping your passwords. - -Using either your wallet directly or connecting it to a dApp like the [Evmos Assets page](https://app.evmos.org/assets), gives you access to view your token balances, transfer tokens on the Evmos network, or deposit & withdraw tokens from & to other blockchain networks. - -## View Balances - -You can view the balances of all your crypto assets on Evmos, both the native EVMOS token and assets that have been created on or sent to the Evmos network from other blockchains. The balance of an asset is described by the number of tokens and the equivalent value in $USD. - -Like any other currency, crypto assets can be used as a storage of value or a medium of exchange. Only if an asset is traded on an exchange, its price can be determined by demand and supply against other assets. The native EVMOS token provides additional utility on Evmos as it is used to secure the network through [staking](https://app.evmos.org/staking), vote on [governance](https://app.evmos.org/governance) proposals, and pay for gas. - -On Evmos, assets can be represented as different types of tokens (e.g. Cosmos IBC Coins or EVM ERC20 tokens). We believe, however, that unless you are a developer, you don't need to be concerned with the underlying representation of a token. You just use the asset name and the Evmos network performs conversions between representations automatically. - -![Evmos Assets page](../../../static/img/evmos_assets.png) - -## Onramp to Evmos - -Onramping to Evmos (obtaining EVMOS tokens) is required to start using Evmos as you need a small amount of "gas" to transfer assets or interact with dApps. This prevents users from spamming the network for free and paid gas is used to reward developers. - -Here are some examples of how to onramp to Evmos: - -* Use a decentralized exchange like Osmosis -* Ask a friend to transfer you EVMOS -* Use services that allow you to exchange fiat currencies (e.g. $USD) for cryptocurrencies, (e.g. [C14](https://www.c14.money/buy)) - -## Send Assets on the same Chain - -Sending and receiving Assets from one account on Evmos to another account on Evmos can be done directly through your wallet (e.g. Keplr/Metamask). To `send` assets you will have to provide the address of the receiving account, either in its Ethereum (e.g. `0x47EeB2eac350E1923b8CBDfA4396A077b36E62a0`) or Cosmos format (e.g. `evmos1glht96kr2rseywuvhhay894qw7ekuc4qg9z5nw`). - -## Deposit and Withdraw Assets across Chains - -Depositing assets from another blockchain to Evmos or withdrawing assets from Evmos to another blockchain is possible using the Evmos [Evmos Assets page](https://app.evmos.org/assets). This is useful, for example to onramp to Evmos or offramp Evmos into fiat currency. diff --git a/docusaurus.config.js b/docusaurus.config.js index 98c888c0..cc25279e 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -21,7 +21,6 @@ function defineSection(section, options = {}) { } const SECTIONS = [ - defineSection('use'), defineSection('develop'), defineSection('validate'), defineSection('protocol'), @@ -138,11 +137,6 @@ const config = { src: 'img/evmos.svg', }, items: [ - { - position: 'left', - label: 'Use', - to: '/use', - }, { position: 'left', label: 'Develop', @@ -192,7 +186,7 @@ const config = { }, { label: 'Contribute to Evmos', - to: '/use', + to: 'https://academy.evmos.org/', }, { label: 'Become a Validator',