Skip to content

Commit

Permalink
docs: update keplr document (#534)
Browse files Browse the repository at this point in the history
* update keplr doc

* address comments

* Apply suggestions from code review

* lint

Co-authored-by: Federico Kunze Küllmer <[email protected]>
Co-authored-by: Federico Kunze Küllmer <[email protected]>
  • Loading branch information
3 people committed Apr 28, 2022
1 parent 4e84ecb commit e17db5a
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 23 deletions.
32 changes: 25 additions & 7 deletions docs/developers/faucet.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,41 @@ The Evmos Testnet Faucet distributes small amounts of {{ $themeConfig.project.te
Follow the [Metamask](./../guides/keys-wallets/metamask.md), [Keplr](./../users/wallets/keplr.md) or [Keyring](./../users/keys/keyring.md) guides for more info on how to setup your wallet account.
:::

## Request tokens
## Request Testnet tokens

You can request tokens for the testnet by using the Evmos [faucet](https://faucet.evmos.dev).
Simply fill in your address on the input field in Bech32 (`evmos1...`) or Hex (`0x...`) format.
Once you are signed in to the Keplr extension, visit the [Faucet](https://faucet.evmos.dev/) to request tokens for the testnet. Click the `Request Funds with Keplr` button. Then approve the both following pop ups `Chain Add Request` and `Request Connection` to add the {{ $themeConfig.project.name }} testnet chain (`evmos_{{ $themeConfig.project.testnet_chain_id }}-{{ $themeConfig.project.testnet_version_number }}`) to Keplr and approve the connection.

![chain add request](./../img/keplr_approve_chain.png)

After approval, you can see a transaction confirmation informing you that {{ $themeConfig.project.testnet_denom }} have been successfully transferred to your [evmos address](../../users/technical_concepts/accounts#address-formats-for-clients) on the testnet.

::: warning
**Note**: only Ethereum compatible addresses (i.e `eth_secp256k1` keys) are supported on Evmos.
:::

![chain add request](./../img/keplr_transaction.png)

Alternatively you can also fill in your address on the input field in Bech32 (`evmos1...`) or Hex (`0x...`) format.

::: warning
If you use your Bech32 address, make sure you input the [account address](./../technical_concepts/accounts#addresses-and-public-keys) (`evmos1...`) and **NOT** the validator operator address (`evmosvaloper1...`)
:::

![faucet site](./../img/faucet_web_page.png)

View your account balance either by clicking on the Keplr extension or by [interacting with the node](../../quickstart/interact_node).

::: tip
**Note**: Keplr might not display the amount of {{ $themeConfig.project.testnet_denom }} transferred by the faucet, as it might be smaller than the number of decimals displayed in the Keplr extension.
:::

## Rate limits

To prevent the faucet account from draining the available funds, the Evmos testnet faucet
imposes a maximum number of request for a period of time. By default the faucet service accepts 1
request per day per address. All addresses **must** be authenticated using
ReCAPTCHA before requesting tokens.
::: tip
All addresses **MUST** be authenticated using ReCAPTCHA before requesting tokens.
:::

To prevent the faucet account from draining the available funds, the Evmos testnet faucet imposes a maximum number of requests for a period of time. By default, the faucet service accepts 1 request per day per address. You can request {{ $themeConfig.project.testnet_denom }} from the [Faucet](./../../developers/faucet) for each address only once every 24h. If you try to request multiple times within the 24h cooldown phase, no transaction will be initiated. Please try again in 24 hours.

## Amount

Expand Down
16 changes: 2 additions & 14 deletions docs/users/wallets/keplr.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,18 +20,6 @@ Add the Keplr browser extension following the instructions on the [Keplr website

Open the Keplr extension on your browser. If you are setting up Keplr for the first time, you can either create a new account or import an existing account. Refer to the [Keplr documentation](https://keplr.crunch.help/getting-started) for further information.

## Connect to Evmos Testnet and Request Funds from the Faucet
## Connect Keplr to Mainnet

Once you are signed in to the Keplr extension, visit the [Faucet](https://faucet.evmos.dev/) and click the `Request Funds with Keplr` button. Then approve the both following pop ups `Chain Add Request` and `Request Connection` to add the {{ $themeConfig.project.name }} testnet chain (`evmos_{{ $themeConfig.project.testnet_chain_id }}-{{ $themeConfig.project.testnet_version_number }}`) to Keplr and approve the connection.

![chain add request](./../../img/keplr_approve_chain.png)

After approval, you can see a transaction confirmation informing you that {{ $themeConfig.project.testnet_denom }} have been successfully transferred to your [evmos address](../../users/technical_concepts/accounts#address-formats-for-clients) on the testnet (only `eth_secp256k1` addresses are supported).

![chain add request](./../../img/keplr_transaction.png)

::: tip
You can request {{ $themeConfig.project.testnet_denom }} from the [Faucet](./../../developers/faucet) for each address only once every 24h. If you try to request multiple times within the 24h cooldown phase, no transaction will be initiated. Please try again in 24 hours.
:::

View your account balance either by clicking on the Keplr extension or by [interacting with the node](../../quickstart/interact_node). Note that Faucet might not display the amount of {{ $themeConfig.project.testnet_denom }} transferred by the Faucet, as it might be smaller than the number of decimals displayed in the Keplr extension.
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; look for the `Evmos (beta)` network.
3 changes: 1 addition & 2 deletions docs/users/wallets/ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,5 +174,4 @@ Since Evmos only support Ethereum keys and uses the same HD path as Ethereum, th

<!-- 4. **I can’t use Ledger for my validator**
Validators can use [`EIP712`](#eip712-signing) with their Ethereum Ledger app to sign transactions. If you are using an
existing Cosmos `secp256k1` key, it won't work -->
Validators can use [`EIP712`](#eip712-signing) with their Ethereum Ledger app to sign transactions. If you are using an existing Cosmos `secp256k1` key, it won't work -->

0 comments on commit e17db5a

Please sign in to comment.