Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

zkEVM User Guides 2 #649

Merged
merged 6 commits into from
Mar 22, 2024
Merged

zkEVM User Guides 2 #649

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
e8b546c
Update
Gunit2481 Mar 19, 2024
f87722c
Update ASTR-Liquid-Staking.md
Gunit2481 Mar 19, 2024
c0b531b
Update zkEVM-guides for JP (#648)
tksarah Mar 21, 2024
363e808
Add DOT address
Gunit2481 Mar 21, 2024
c2e4285
Merge branch 'main' into zKEVM-User-Guides-2
meganskye Mar 21, 2024
2c8c1d7
Fix Jp translations
Gunit2481 Mar 22, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 35 additions & 9 deletions docs/use/zkevm-guides/ASTR-Liquid-Staking.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,28 +26,54 @@ The Liquid Staking version of the ASTR token is called **vASTR** (voucher ASTR)
Bifrost charges a 10% commission on staking rewards.
:::

## How to stake ASTR & get vASTR:
## How to stake ASTR & receive vASTR:

1. Visit [Bifrost OmniLS](https://omni.ls/) and connect your EVM wallet on **Astar zkEVM** network;
1. Visit [Bifrost OmniLS](https://omni.ls/), select `vASTR` and connect your EVM wallet on **Astar zkEVM** network;

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_1.png').default} width="60%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_1.png').default} width="70%" />

2. Enter the amount of `ASTR` you want to stake in Liquid Staking. In return, you will receive `vASTR` tokens according to the ASTR/vASTR ratio;
*Remember to take into consideration the cross-chain transaction fee (deducted from the stake amount);*
3. Authorize Bifrost to access your funds by clicking on `Approve` and signing the transaction in your wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_2.png').default} width="60%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_2.png').default} width="80%" />

3. Authorize Bifrost to access your funds by clicking on `Approve` and signing the transaction in your wallet;

4. Click on `Stake Now` to initiate the transaction and sign it in your wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_3.png').default} width="60%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_3.png').default} width="80%" />

5. As the transaction takes place on several networks (*Astar zkEVM, Astar EVM & Bifrost*), it can take up to 10 minutes before the transaction is finalized and the vASTR appears in your wallet.
5. As the transaction takes place on several networks (*Astar zkEVM, Astar EVM & Bifrost*), it can take **up to 10 minutes** before the transaction is finalized and the vASTR appears in your wallet.
6. Once you have received the vASTR tokens, they are ready for use on Astar zkEVM.

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_4.png').default} width="60%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_4.png').default} width="80%" />

:::info
To add tokens to your EVM wallet manually, use the following contract addresses:
- **vASTR:** `0x7746ef546d562b443AE4B4145541a3b1a3D75717`
:::
:::

## How to unstake vASTR & receive ASTR:

1. Visit [Bifrost OmniLS](https://omni.ls/), select `vASTR` and connect your EVM wallet on **Astar zkEVM** network;

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_1.png').default} width="70%" />

2. Switch to the **Unstake Panel** and enter the amount of `vASTR` you want to redeem. In return, you will receive `ASTR` tokens according to the ASTR/vASTR ratio including your staking rewards;
*Remember to take into consideration the cross-chain transaction fee (deducted from the stake amount);*

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_5.png').default} width="90%" />

3. Authorize Bifrost to access your funds by clicking on `Approve` and signing the transaction in your wallet;

4. Click on `Unstake Now` to initiate the transaction and sign it in your wallet;

:::warning
Note that there is a unstaking period of **0 to 10 days**;
:::

<Figure src={require('/docs/use/zkevm-guides/img/Bifrost_6.png').default} width="90%" />

5. As the transaction takes place on several networks (*Astar zkEVM, Astar EVM & Bifrost*), it can take **up to 10 minutes** before the transaction is finalized and the unstaking process begins;

6. At the end of the unstaking period, your ASTR tokens and rewards will automatically arrive in your wallet.
46 changes: 35 additions & 11 deletions docs/use/zkevm-guides/Bridge-Astar-EVM.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,30 +16,54 @@ If you have `ASTR` on Astar native (Substrate) instead, consult [this guide](/do

*Please be advised that Astar Foundation assumes no responsibility or liability for any direct, indirect, incidental, special, consequential, or exemplary damages resulting from your utilization of any third-party application presented in our documentation.*

1. Visit [Stargate](https://stargate.finance/transfer) and connect your EVM wallet;
Visit [Stargate application](https://stargate.finance/transfer) and connect your EVM wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_1.png').default} width="70%" />
<Figure src={require('/docs/use/zkevm-guides/img/Stargate_1.png').default} width="75%" />

2. Select the token that you want to transfer and select `Astar EVM` for the **source network**;
3. Select the token that you want to receive and select `Astar zkEVM` for the **destination network**;
4. Enter the amount of tokens you want to transfer and confirm the transaction by clicking `Transfer` ;
### From Astar EVM to Astar zkEVM:

1. Select the token that you want to transfer and select `Astar EVM` for the **source network**;
2. Select the token that you want to receive and select `Astar zkEVM` for the **destination network**;
3. Enter the amount of tokens you want to transfer and confirm the transaction by clicking `Transfer`;
*The gas cost corresponds to the gas fees for the destination transaction and is paid up-front.*

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_2.png').default} width="60%" />
<Figure src={require('/docs/use/zkevm-guides/img/Stargate_2.png').default} width="85%" />

:::tip
You have the option of requesting gas tokens on Astar zkEVM (`ETH`). Stargate will swap a portion of your assets in ETH and transfer them to your wallet on Astar zkEVM.

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_3.png').default} width="95%" />
<Figure src={require('/docs/use/zkevm-guides/img/Stargate_3.png').default} width="85%" />
:::

5. Sign the transaction in your wallet:
4. Sign the transaction in your wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_4.png').default} width="50%" />
<Figure src={require('/docs/use/zkevm-guides/img/Stargate_4.png').default} width="75%" />

6. Once the transaction has been confirmed on the network, you should now see the bridged assets in your EVM wallet, ready for use on Astar zkEVM.
5. Once the transaction has been confirmed on the network, you should now see the bridged assets in your EVM wallet, ready for use on Astar zkEVM.

:::info
To add tokens to your EVM wallet manually, use the following contract addresses:
- **ASTR:** `0xdf41220C7e322bFEF933D85D01821ad277f90172`
:::
- **DOT:** `0x7Cb5d4D178d93D59ea0592abF139459957898a59`
:::

### From Astar zkEVM to Astar EVM:

1. Select the token that you want to transfer and select `Astar zkEVM` for the **source network**;
2. Select the token that you want to receive and select `Astar EVM` for the **destination network**;
3. Enter the amount of tokens you want to transfer and confirm the transaction by clicking `Transfer`;
*The gas cost corresponds to the gas fees for the destination transaction and is paid up-front.*

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_5.png').default} width="85%" />

:::tip
You have the option of requesting gas tokens on Astar EVM (`ASTR`). Stargate will swap a portion of your assets in ASTR and transfer them to your wallet on Astar EVM.

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_6.png').default} width="85%" />
:::

4. Sign the transaction in your wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Stargate_4.png').default} width="75%" />

5. Once the transaction has been confirmed on the network, you should now see the bridged assets in your EVM wallet, ready for use on Astar EVM.
72 changes: 54 additions & 18 deletions docs/use/zkevm-guides/Bridge-Ethereum.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,36 +9,72 @@ import Figure from "/src/components/figure"

This page explains how to transfer `ETH` and other `ERC20` assets between **Astar zkEVM** and **Ethereum Mainnet** and other EVM-based chains. There are three options for bridging assets to the zkEVM:

## 1. Transfer using the Astar Portal:
## Transfer using the Astar Portal:

1. Visit the [Astar Portal](https://portal.astar.network/astar-zkevm/bridge/ethereum) and connect your wallet on Astar zkEVM Network;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_1.png').default} width="50%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_1.png').default} width="60%" />

2. Use the network modal window and switch to the Astar zkEVM network, or let MetaMask switch to Astar zkEVM for you;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_2.png').default} width="40%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_2.png').default} width="70%" />

3. Click on the Bridge tab on the left and select `Native Bridge` (_ERC20_);

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_3.png').default} width="120%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_3.png').default} width="100%" />

### From Ethereum to Astar zkEVM

1. Ensure `Ethereum` is selected as the **source network**, and that `Astar zkEVM` is selected as the **destination network**;
After entering the amount of ETH to be transferred, press the `Bridge` button;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_4.png').default} width="100%" />

2. Sign the transaction in your wallet;
3. You should now see the bridged assets in MetaMask for use on Astar zkEVM.

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_5.png').default} width="70%" />

:::info
The transfer can take between 10 and 30 minutes, depending on Ethereum network usage.

Once the transaction has been confirmed in your wallet extension, it will take approximately **5-10 minutes** for the Astar portal and MetaMask to update your balance on the Astar zkEVM network.
:::

### From Astar zkEVM to Ethereum

:::warning
This is a two-step process in which you will need to claim your tokens on Ethereum's mainnet and pay the corresponding gas fees.
Make sure you have enough `ETH` tokens on mainnet to cover the fees.
:::

1. Ensure `Astar zkEVM` is selected as the **source network**, and that `Ethereum` is selected as the **destination network**;
After entering the amount of ETH to be transferred, press the `Bridge` button;
=======
4. Ensure Ethereum is selected as the Bridge source, and that Astar zkEVM is selected as the destination;
After entering the amount of ETH to be transferred, press the `Bridge` button;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_4.png').default} width="120%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_6.png').default} width="100%" />

2. Sign the transaction in your wallet;
3. Once the transaction has been sent, it will appear in the **History tab**;
4. To receive your tokens on Ethereum, click on the `Claim` button;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_7.png').default} width="70%" />


5. Sign the transaction in your wallet;
6. You should now see the bridged assets in MetaMask for use on Astar zkEVM.
6. You should now see the bridged assets in MetaMask for use on Ethereum.

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Portal_8.png').default} width="70%" />

:::info
The transfer can take between 10 and 30 minutes, depending on Ethereum network usage.

Once the transaction has been confirmed in your wallet extension, it will take approximately **5-10 minutes** for the Astar portal and MetaMask to update your balance on the Astar zkEVM network.
:::

## 2. Transfer using Layerswap:

## Transfer using Layerswap:

The second option is to use **[Layerswap](https://www.layerswap.io/app?to=ASTARZK_MAINNET)**, a reliable solution for transferring crypto assets across Centralized Exchanges, blockchains and banks in a matter of minutes. [More information](https://docs.layerswap.io/user-docs).

Expand All @@ -50,18 +86,18 @@ For the moment, Layerswap supports only **ETH token** for cross-chain transfers!

1. Visit [Layerswap](https://www.layerswap.io/app?to=ASTARZK_MAINNET) and connect your EVM wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_5.png').default} width="50%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_1.png').default} width="80%" />

2. Select the **origin network** or **Centralized Exchanges** from which you want to transfer your assets, and select `Astar zkEVM` for the **destination network**;
3. Enter the amount of ETH you want to transfer. You can also choose the address to which you want to send your assets;
4. Confirm the transaction by clicking on `Swap now` ;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_6.png').default} width="65%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_2.png').default} width="80%" />

5. Sign the transaction in your wallet;
4. Confirm the transaction by clicking on `Swap now`;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_7.png').default} width="65%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_3.png').default} width="80%" />

5. Sign the transaction in your wallet;
6. Once the transaction has been confirmed on the network, you should now see the bridged assets in your EVM wallet, ready for use on Astar zkEVM.

## 3. Transfer using Relay Link:
Expand All @@ -85,17 +121,17 @@ You can transfer assets to Astar zkEVM from the following chains:

1. Visit [Relay Link](https://www.relay.link/bridge/astar-zkevm/) and connect your EVM wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_8.png').default} width="70%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_1.png').default} width="70%" />

2. Select the **origin chain** from which you want to transfer your assets, and select `Astar zkEVM` for the **destination chain** ;
2. Select the **origin chain** from which you want to transfer your assets, and select `Astar zkEVM` for the **destination chain**;
3. Enter the amount of ETH you want to transfer and confirm the transaction by clicking `Bridge`;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_9.png').default} width="70%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_2.png').default} width="70%" />

4. Sign the transaction in your wallet;

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_10.png').default} width="70%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_3.png').default} width="70%" />

5. Once the transaction has been confirmed on the network, you should now see the bridged assets in your EVM wallet, ready for use on Astar zkEVM.

<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_11.png').default} width="70%" />
<Figure src={require('/docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_4.png').default} width="70%" />
Binary file modified docs/use/zkevm-guides/img/Bifrost_1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/use/zkevm-guides/img/Bifrost_2.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/use/zkevm-guides/img/Bifrost_3.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/use/zkevm-guides/img/Bifrost_4.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bifrost_5.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bifrost_6.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_1.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_10.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_11.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_2.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_3.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_4.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_5.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_6.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_7.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_8.png
View file
Open in desktop
Binary file not shown.
Binary file removed docs/use/zkevm-guides/img/Bridge_ETH_9.png
View file
Open in desktop
Binary file not shown.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_2.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Layerswap_3.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_2.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_3.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_4.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_5.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_6.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_7.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Portal_8.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_1.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_2.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_3.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Bridge_ETH_Relaylink_4.png
View file
Open in desktop
Binary file modified docs/use/zkevm-guides/img/Stargate_1.png
View file
Open in desktop
Binary file modified docs/use/zkevm-guides/img/Stargate_2.png
View file
Open in desktop
Binary file modified docs/use/zkevm-guides/img/Stargate_3.png
View file
Open in desktop
Binary file modified docs/use/zkevm-guides/img/Stargate_4.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Stargate_5.png
View file
Open in desktop
Binary file added docs/use/zkevm-guides/img/Stargate_6.png
View file
Open in desktop
Loading
Loading