zkEVM User Guides 2 (#649)

* Update

- Add from Astar zkEVM to Astar EVM bridge
- Add from Astar zkEVM to Ethereum
- Add unstaking vASTR on Astar zkEVM
- Improve images

* Update ASTR-Liquid-Staking.md

* Update zkEVM-guides for JP (#648)

* Add DOT address

* Fix Jp translations

---------

Co-authored-by: tksarah <[email protected]>
Co-authored-by: Megan Skye <[email protected]>

docs/use/zkevm-guides/ASTR-Liquid-Staking.md

@@ -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.

docs/use/zkevm-guides/Bridge-Astar-EVM.md

@@ -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.

docs/use/zkevm-guides/Bridge-Ethereum.md

@@ -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).
 
@@ -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:
@@ -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%" />