diff --git a/docs/use/get-started/accounts.md b/docs/use/get-started/accounts.md new file mode 100644 index 0000000..3b2d389 --- /dev/null +++ b/docs/use/get-started/accounts.md @@ -0,0 +1,34 @@ +--- +sidebar_position: 2 +sidebar_label: Accounts +title: Astar Accounts +--- + +## Accounts + +An account on Astar Network consists of two parts - a private key and a public key. A public key is also known as an address of an account because it is accessible and known to the public - just like an e-mail address, for example. A private key is a key to access and manage your address. With that said, anybody can send tokens to your address, but only you can access them with your private key. Therefore, it is crucial to keep your private keys safe at all times. + +Astar Network supports two virtual machines (Wasm VM and EVM) and therefore utilizes two account formats. + +## Substrate Accounts + +Astar is built with Substrate, a framework to build blockchains, and uses Substrate accounts. Substrate-based chains use the underlying public key to derive one or more public addresses. Instead of using the public key directly, Substrate allows you generate multiple addresses and address formats for an account, meaning you only need to generate your public key, private key pair once and derive different addresses for different Substrate-chains. + +The private key is a cryptographically-secure sequence of randomly-generated numbers. For human readability, the private key generates a random sequence of words called a secret seed phrase or mnemonic. + +The address format used in Substrate-based chains like Astar is ss58. ss58 is a modification of Base-58-check from Bitcoin, with some minor modifications. Notably, the format contains an address type prefix that identifies an address as belonging to a specific network. + +Astar supports spezialized accounts, such as Proxy and Keyless accounts. +You can read more about Proxy accounts [here] (/docs/learn/Proxies). **LINK TO UPDATE** + +## EVM Accounts + +Astar EVM side allows Ethereum-style addresses (H160 format), which is 40+2 hex-characters long, in a Substrate based chain. This address matches a private key, which can be used to sign transactions in the Ethereum side of the chain. Furthermore, the address is mapped into a storage slot inside the Substrate Balance pallet to a Substrate-style address (H256 format). + + +## Learn more +[Create a Substrate account] (/docs/use/manage-wallets/create-wallet/) **LINK TO UPDATE** + +[Create an EVM account] (/docs/use/evm-guides/setup-metamask/) **LINK TO UPDATE** + +[Read about Substrate accounts] (https://docs.substrate.io/learn/accounts-addresses-keys/) **LINK TO UPDATE** \ No newline at end of file diff --git a/docs/use/get-started/astar-evm-wallet/index.md b/docs/use/get-started/astar-evm-wallet/index.md new file mode 100644 index 0000000..a2e22ce --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 3 +sidebar_label: Astar EVM - Choose your wallet +title: Astar EVM - Choose your wallet +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-evm-wallet/wallet/index.md b/docs/use/get-started/astar-evm-wallet/wallet/index.md new file mode 100644 index 0000000..5d8228d --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 1 +sidebar_label: Wallet +title: Create an Astar Wallet +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/_category_.json b/docs/use/get-started/astar-evm-wallet/wallet/ledger/_category_.json new file mode 100644 index 0000000..0e287b7 --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/ledger/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Ledger", + "position": 2 +} diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/1-AstarEVM.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/1-AstarEVM.jpg new file mode 100644 index 0000000..a246313 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/1-AstarEVM.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/11-AcceptAndSend.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/11-AcceptAndSend.jpg new file mode 100644 index 0000000..2527fbb Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/11-AcceptAndSend.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/12-Reject.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/12-Reject.jpg new file mode 100644 index 0000000..3219ffb Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/12-Reject.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/2-ShidenEVM.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/2-ShidenEVM.jpg new file mode 100644 index 0000000..0bd1fa4 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/2-ShidenEVM.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/3-ApplicationIsReady.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/3-ApplicationIsReady.jpg new file mode 100644 index 0000000..6df2ba2 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/3-ApplicationIsReady.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/4-ReviewTransaction.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/4-ReviewTransaction.jpg new file mode 100644 index 0000000..d287a2f Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/4-ReviewTransaction.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/5-AmountASTR1.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/5-AmountASTR1.jpg new file mode 100644 index 0000000..7be1650 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/5-AmountASTR1.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/6-Address.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/6-Address.jpg new file mode 100644 index 0000000..a397a03 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/6-Address.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/7-Network_Astar.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/7-Network_Astar.jpg new file mode 100644 index 0000000..8788d91 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/7-Network_Astar.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/9-MaxFees_ASTR.jpg b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/9-MaxFees_ASTR.jpg new file mode 100644 index 0000000..04d796b Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/9-MaxFees_ASTR.jpg differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app.png new file mode 100644 index 0000000..9f2aca0 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_2.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_2.png new file mode 100644 index 0000000..25ccca5 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_2.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_3.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_3.png new file mode 100644 index 0000000..83cb924 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_3.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_4.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_4.png new file mode 100644 index 0000000..ba3fee3 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_4.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_5.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_5.png new file mode 100644 index 0000000..d36dc15 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_5.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_6.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_6.png new file mode 100644 index 0000000..e3fe297 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_6.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_7.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_7.png new file mode 100644 index 0000000..ae6422e Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_7.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-live-ethereum.png b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-live-ethereum.png new file mode 100644 index 0000000..eb7620f Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-live-ethereum.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/ledger/ledger-evm.md b/docs/use/get-started/astar-evm-wallet/wallet/ledger/ledger-evm.md new file mode 100644 index 0000000..fcb8c9d --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/ledger/ledger-evm.md @@ -0,0 +1,142 @@ +--- +sidebar_position: 1 +sidebar_label: Ledger for Astar EVM +title: Interact with Ledger on Astar EVM using MetaMask +--- + +import Figure from '/src/components/figure' +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## Introduction + +**Ledger devices** can be used on **Astar EVM Network** to perform and sign transactions using the Ledger default `Ethereum` application. +This means that MetaMask users can now sign transactions for EVM accounts on Astar Network using Ledger Nano S (plus) or Ledger X devices. + +This guide will show you how to set up **Astar EVM** on your Ledger hardware wallet and how to use it in combination with **MetaMask**. + +:::info +Photos are taken using Nano S Plus device, and the example shows interaction with Ethereum app, but the process is the same with Nano S and Nano X devices. +::: + +## Requirements + +### Your Ledger device is ready for use + +- [Make sure you have set up your Ledger device](https://support.ledger.com/hc/en-us/articles/360000613793?docs=true) +- Update your device to latest firmware + - [Nano S](https://support.ledger.com/hc/en-us/articles/360002731113?docs=true) + - [Nano S Plus](https://support.ledger.com/hc/en-us/articles/4445777839901?docs=true) + - [Nano X](https://support.ledger.com/hc/en-us/articles/360013349800?docs=true) +- [Download and install Ledger Live app for your OS](https://support.ledger.com/hc/en-us/articles/4404389606417-Download-and-install-Ledger-Live?docs=true) +- [Download and install MetaMask for your browser](https://metamask.io/download/) + +### Astar Network set up on Metamask + +If you already have this, feel free to skip this part. + +1. In the MetaMask menu, navigate to `Settings` → `Networks`, and click **Add a network**; +2. Enter following details: + + + | | Public endpoint Astar | + | --- | --- | + | Network name | Astar Network | + | New RPC URL | Astar Team: https://evm.astar.network | + | | BlastAPI: https://astar.public.blastapi.io | + | | Dwellir: https://astar-rpc.dwellir.com | + | | OnFinality: https://astar.api.onfinality.io/public | + | Chain ID | 592 | + | Currency symbol | ASTR | + | Block Explorer URL | https://astar.blockscout.com/ | + +

+ +3. Close the `Settings` menu and, from the drop-down menu, select the network you wish to interact with. + +### Install Ethereum app to your Ledger device + +1. Open **My Ledger** in Ledger Live. +2. Connect and unlock your Ledger device. + If asked, allow `My Ledger` to access your device. +3. Search for **Ethereum** in the app catalog. +4. Click Install. + +
+ +After this step, you should have the Ethereum app installed: + +
+ + +## Connecting your Ledger device to MetaMask + +1. In MetaMask menu, select **Connect Hardware wallet**; + +
+ +2. On the next screen select **Ledger** and click **Continue**; + +
+ +3. Pair and **Connect** your Device when prompted by the browser; + +
+ +4. Select an account you wish to connect and click **Unlock**; + +
+ +5. You should now see your account and balance: + +
+ +# Receiving tokens + +To receive tokens, copy the address of your connected account by clicking your account name in MetaMask header, and send some tokens to that address from your preferred source. + +# Sending tokens + +1. In MetaMask, click **Send** button and enter the address you wish to send to; +2. Enter the amount to send and click **Next**; +3. Connect your Ledger device and unlock it; + +
+ +4. When your Ledger device screen is showing `Application is ready`, click **Confirm** in MetaMask; + +
+ +5. Review the transaction on your Ledger device; + +
+ + a) Check amount: + +
+ + b) Check receiving address: + +
+ c) Check network: + +
+ + d) Check Fees: + +
+ +
+ +
+ +6. Check the transaction result in MetaMask `Activity` tab. + +## Interacting with smart contracts + +In order to interact with smart contracts, you need to enable blind signing in the Astar EVM app on your Ledger device: + +1. Open the app; +2. Navigate to `Settings` and **Confirm**; +3. Confirm the `Blind signing` option, so it turns to `Enabled`; +4. Navigate to `Back` and **Confirm**. diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/_category_.json b/docs/use/get-started/astar-evm-wallet/wallet/metamask/_category_.json new file mode 100644 index 0000000..e0bab18 --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/metamask/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Metamask", + "position": 1 +} diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_1.png b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_1.png new file mode 100644 index 0000000..29ec83c Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_1.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_2.png b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_2.png new file mode 100644 index 0000000..3a28b06 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_2.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_3.png b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_3.png new file mode 100644 index 0000000..cb38cb5 Binary files /dev/null and b/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_3.png differ diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/install-metamask.md b/docs/use/get-started/astar-evm-wallet/wallet/metamask/install-metamask.md new file mode 100644 index 0000000..9409a98 --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/metamask/install-metamask.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +sidebar_label: Install Metamask +title: Install Metamask +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. \ No newline at end of file diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/manage-xc20-with-metamask.md b/docs/use/get-started/astar-evm-wallet/wallet/metamask/manage-xc20-with-metamask.md new file mode 100644 index 0000000..0a0db7a --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/metamask/manage-xc20-with-metamask.md @@ -0,0 +1,34 @@ +--- +sidebar_position: 3 +sidebar_label: Manage XC20 assets +title: Manage XC20 assets in Metamask +--- + +import Figure from "/src/components/figure" + +## Instructions + +### Visit the Portal + +Visit the [Assets page](https://portal.astar.network/assets), and log in with your MetaMask account to view your assets. + +
+ +As you can see in the screenshot above, there is DOT in our EVM wallet. Let's add the asset to MetaMask. + +### Import assets to MetaMask + +Open MetaMask and connect the account with DOT. Make sure you are connected to the Astar Network. If not, you will find the Network Details in the Integration section. + +After the account is connected, you will be able to import tokens into the wallet. Click on **Add to wallet** button in DOT row. + +
+ +Click on **Import Tokens** in MetaMask popup. + +
+ + +When you are finished adding and importing DOT, you will see them in your wallet. You can find the full list of supported XCM assets [(/docs/learn/interoperability/xcm/asset-list)].**[INSERT LINK]** + +To manually import assets that are not listed on the *Assets page*, follow [this guide] (/docs/learn/interoperability/xcm/building-with-xcm/send-xc20-evm.md#import-assets-on-metamask). **[INSERT LINK]** diff --git a/docs/use/get-started/astar-evm-wallet/wallet/metamask/setup-metamask.md b/docs/use/get-started/astar-evm-wallet/wallet/metamask/setup-metamask.md new file mode 100644 index 0000000..60d0219 --- /dev/null +++ b/docs/use/get-started/astar-evm-wallet/wallet/metamask/setup-metamask.md @@ -0,0 +1,35 @@ +--- +sidebar_position: 2 +sidebar_label: Setup Astar Network +title: Setup Astar Network in Metamask +--- + +In this tutorial we will navigate you how to add Astar/Shiden Network to your Metamask account. + +
+ +Adding Astar Network to Metamask is very easy. +
+ +1. You will just need to go to [our Portal](https://portal.astar.network/) and try to connect to Metamask. + +Screenshot 2022-09-06 at 14 08 21
+
+ +2. Metamask will pop-up and ask you if you would like to add Astar Network. Please check the info and approve.
+ +Screenshot 2022-09-06 at 14 33 44 + +
+ +:::note +Alternatively, you can also set it up manually by giving information bellow. +
+Network Details
+Network Name: Astar Network Mainnet
+Network URL: https://evm.astar.network
+Chain ID: 592
+Currency Symbol: astr
+Block Explorer URL: https://blockscout.com/astar + +::: diff --git a/docs/use/get-started/astar-substrate-wallet/index.md b/docs/use/get-started/astar-substrate-wallet/index.md new file mode 100644 index 0000000..fc05772 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 4 +sidebar_label: Astar Substrate - Choose your wallet +title: Astar Substrate - Choose your wallet +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-substrate-wallet/mobile-wallet/index.md b/docs/use/get-started/astar-substrate-wallet/mobile-wallet/index.md new file mode 100644 index 0000000..9b4f6b2 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/mobile-wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 2 +sidebar_label: Mobile Wallet +title: Create an Astar Wallet on a Mobile Device +--- + +**This guide will support you to setup an Astar/Shiden wallet for both EVM and Native on your mobile.** + +There are a few mobile wallets that support Astar native environment such as [Nova Wallet](https://novawallet.io/), [Math Wallet](https://mathwallet.org/en-us/) and [SubWallet](https://subwallet.app/), while [Metamask](https://metamask.io/download/) supports Astar EVM. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-substrate-wallet/mobile-wallet/math-wallet/index.md b/docs/use/get-started/astar-substrate-wallet/mobile-wallet/math-wallet/index.md new file mode 100644 index 0000000..95dfa8c --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/mobile-wallet/math-wallet/index.md @@ -0,0 +1,37 @@ +--- +sidebar_position: 1 +sidebar_label: Math Wallet +title: Install Math Wallet +--- + +In this tutorial, we will use Math Wallet since it supports both Native and EVM. + +1. Download [Math Wallet](https://mathwallet.org/en-us/) for either Android or iOS. +2. Select Astar for Native and Astar EVM for EVM. + +![image](https://user-images.githubusercontent.com/37278708/199638326-b2dc20cf-1446-40f9-9b7a-152ee5f35da7.png) +![image](https://user-images.githubusercontent.com/37278708/199638421-d27fa62b-72b0-485f-a654-f949bf128f89.png) + +3. Select "Create Wallet" if you want to create a new wallet (You can also import wallet if you want to restore an existing wallet from other devices). +4. Give the wallet a name and password and please remember to store your password in a safe and secure place. +5. Write down the 12-word seed phrase and store it in a safe and secure place. + +![image](https://user-images.githubusercontent.com/37278708/199640362-e22c2328-0d5a-472a-acbf-c5b357c23339.png) + + +7. On the next screen, verify that you have the correct seed phrase and click confirm. + +![image](https://user-images.githubusercontent.com/37278708/199640403-1b8091b6-9e65-4aef-920c-751698682c55.png) + + +8. Your Astar wallet is now ready. +9. Click on the dApp browser and you will be able to use [Astar portal](https://portal.astar.network/) to use dApp staking (only on Astar Native) and make [token transfers] (https://docs.astar.network/docs/user-guides/transfer-tokens) between native to EVM and vice versa. **[INSERT LINK]** + +![image](https://user-images.githubusercontent.com/37278708/199640641-81e1ed72-1357-490f-b9c6-ccab0d6f3cd8.png) +![image](https://user-images.githubusercontent.com/37278708/199640688-eb338b50-8581-4e85-8402-4808aea05739.png) + +11. If you have the EVM wallet, you can use it to navigate the dApps within the EVM environment. + +--- + +That's all and as a **REMINDER**, please make sure you save the seed phrase and password in a safe and secure place. Don't share this with anyone! diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/index.md b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/index.md new file mode 100644 index 0000000..c59c977 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 3 +sidebar_label: Multisig Wallet +title: Create an Astar Multisig Wallet +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_1.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_1.png new file mode 100644 index 0000000..d44df80 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_1.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_10.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_10.png new file mode 100644 index 0000000..6d87f09 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_10.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_11.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_11.png new file mode 100644 index 0000000..d0524d3 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_11.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_12.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_12.png new file mode 100644 index 0000000..8056a8b Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_12.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_13.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_13.png new file mode 100644 index 0000000..1c7adb9 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_13.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_14.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_14.png new file mode 100644 index 0000000..52e7273 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_14.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_15.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_15.png new file mode 100644 index 0000000..0d4f697 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_15.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_2.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_2.png new file mode 100644 index 0000000..4262d34 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_2.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_3.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_3.png new file mode 100644 index 0000000..daae209 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_3.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_4.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_4.png new file mode 100644 index 0000000..1aa22c3 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_4.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_5.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_5.png new file mode 100644 index 0000000..f58d9e5 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_5.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_6.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_6.png new file mode 100644 index 0000000..56e0449 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_6.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_7.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_7.png new file mode 100644 index 0000000..481ae33 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_7.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_8.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_8.png new file mode 100644 index 0000000..40f0e70 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_8.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_9.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_9.png new file mode 100644 index 0000000..66f826a Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/img/multisig_guide_9.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/index.md b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/index.md new file mode 100644 index 0000000..5a32103 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkaSafe/index.md @@ -0,0 +1,101 @@ +--- +sidebar_position: 2 +sidebar_label: PolkaSafe +title: Use a Multisig Account on Astar Portal using PolkaSafe +--- + +# Use a Multisig Account on Astar Portal + +This guide will assist you in utilizing a multisig account on Astar Portal via PolkaSafe. + +:::danger +At the time of this release, PolkaSafe only supports Astar Network. +::: + + +## **Prerequisites** + +- Install a Substrate wallet extension (such as Polkadot.js, SubWallet, or Talisman) on your browser. + +- Prepare at least two Astar wallet addresses [See reference] (/docs/use/manage-wallets/using-a-multisig-account-on-astar-portal.md) **LINK TO UPDATE** + +## Understanding the Benefits of Multisig Accounts + +Multisig accounts offer several key benefits, particularly in terms of security, control, and flexibility: + +1. **Enhanced Security:** The need for more keys reduces the risk of unauthorized access. +2. **Reduced Risk:** You won't lose access to the account even if you lose a single key. +3. **Access Control:** Multisig allows multiple users to share control over an account. +4. **Flexibility:** You can customize the number of required signatures for transactions. +5. **Dispute Resolution:** Multisig prevents unilateral decisions by requiring majority or total agreement. +6. **Auditability:** Multisig accounts provide a clear record of approved transactions. + +## Creating a Multisig Account on PolkaSafe + +PolkaSafe integrates with Polkadot's multisig solution, offering seamless user experience and robust security features for managing assets in the Polkadot ecosystem. You can use the multisig accounts created on PolkaSafe with the Astar Portal. + +1. Visit [PolkaSafe](https://app.polkasafe.xyz/). +2. Select Astar network and click 'Connect Wallet.' +![multisig_guide_1.png](img/multisig_guide_1.png) +3. Choose a wallet and select an account with more than 0 ASTR. +4. Sign the message via the wallet extension. +5. Select 'Create Multisig.' +![multisig_guide_2.png](img/multisig_guide_2.png) +6. Choose the signatory addresses to include in the multisig account. You can select from your wallet or add an address manually. +:::danger +Ledger accounts cannot be multisig signatories +::: +![multisig_guide_3.png](img/multisig_guide_3.png) +7. Input the threshold number (the minimum required signatures to authorize and execute a transaction) and name the multisig account. +8. Sign the message to add a small Existential Deposit to the multisig account. +![multisig_guide_4.png](img/multisig_guide_4.png) +9. Optionally, you can enable proxy signatory management to allow enhanced functionalities for your multisig account. [See reference] (/docs/use/manage-wallets/pallet-proxy.md) **LINK TO UPDATE** +10. Now, you can manage your multisig account on PolkaSafe. +![multisig_guide_5.png](img/multisig_guide_5.png) + +## (Optional) Enabling Proxy Signatory Management for Your Multisig Account on PolkaSafe +Adding a proxy account to your multisig account enhances functionality and flexibility. A proxy allows signatories to alter key parameters and setup account backups. Furthermore, the proxy wallet address remains unchanged even when the multisig account's consensus conditions are modified. A proxy can: + +1. Edit the Threshold: Alter the number of required signatures for transaction authorization. +2. Modify Signatories: Change the signatories of the multisig account. +3. Create Backups: Establish a backup of the multisig account, facilitating seamless asset transfers. In other words, all assets will be in the proxy account. This means that when you add or remove any signatory, the multisig address will change, but the proxy address will not. Therefore, assets in the proxy account won't be lost. + +You can add a proxy to your multisig account either during multisig creation or from the account dashboard. + +![multisig_guide_12.png](img/multisig_guide_12.png) +![multisig_guide_13.png](img/multisig_guide_13.png) + +Switch to the proxy account by clicking the switch icon. +![multisig_guide_14.png](img/multisig_guide_14.png) + +The address should now display as the proxy account. +![multisig_guide_15.png](img/multisig_guide_15.png) + +:::tip +Editing a multisig account (e.g., adding signatories) creates a new multisig address linked to the existing proxy address. This new multisig lacks an Existential Deposit, so you must add some balance to the new multisig address before initiating transactions. +::: + +## Sending Transactions on Astar Portal and Approving them on PolkaSafe + +1. Go to the Astar Portal and select PolkaSafe. +![multisig_guide_6.png](img/multisig_guide_6.png) +2. Choose one of the signatories (owners) to create multisig transactions. +![multisig_guide_7.png](img/multisig_guide_7.png) +1. Sign the message on the wallet extension (the wallet popup might **take a moment** to appear).
+2. Select the multisig account and click Connect.
+![multisig_guide_8.png](img/multisig_guide_8.png) +1. You can now use the Astar Portal in the same way you would with normal accounts. +2. Once the transaction is completed, click 'Approve on PolkaSafe' and approve the transaction on PolkaSafe. You should connect to signatory accounts other than the one selected on Astar Portal.
+![multisig_guide_9.png](img/multisig_guide_9.png) +1. If you want to understand the transaction details, copy the 'Call Data' and paste it on the [Decode page](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.astar.network#/extrinsics/decode) on the Polkadot.js portal. +![multisig_guide_10.png](img/multisig_guide_10.png) +![multisig_guide_11.png](img/multisig_guide_11.png) + +## References: +### PolkaSafe +* [PolkaSafe Documentation](https://docs.polkasafe.xyz/) +* [Introduction to Multisig Accounts](https://wiki.polkadot.network/docs/learn-account-multisig) +* [Creating a pure proxy](https://docs.polkasafe.xyz/setup-polkasafe/creating-a-pure-proxy) +### Polkadot Wiki +* [Multi-Signature Accounts](https://wiki.polkadot.network/docs/learn-account-multisig#introduction-to-multisig-accounts) +* [Proxy Accounts](https://wiki.polkadot.network/docs/learn-proxies) \ No newline at end of file diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/12.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/12.png new file mode 100644 index 0000000..555b1c0 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/12.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/13.png b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/13.png new file mode 100644 index 0000000..103b965 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/img/13.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/index.md b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/index.md new file mode 100644 index 0000000..1639e08 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/multisig-wallet/polkadot.js/index.md @@ -0,0 +1,37 @@ +--- +sidebar_position: 1 +sidebar_label: Polkadot.Js +title: Create an Astar Mutltisig Wallet using Polkadot.Js +--- + +import Figure from "/src/components/figure" + +# Create a Multisig Wallet + +This tutorial serves as a guide to create a multisig substrate wallet. + +## Add contacts + +1. Go to [https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.astar.network#/accounts](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.astar.network#/accounts) +2. Go to Accounts -> Address Book +3. Click `+ Add Contact` and add all the contact addresses that you want to include in the multisig wallet. +4. For example; Bob, Charlie and Dave. + +
+ +## Create new wallet + +1. Go to Accounts -> `+ Multisig` +2. From the available signatories, select the ones that you want to include in the multisig. +3. Add a threshold. A threshold of 2 means a minimum of 2 signatories are required to sign the transactions. +4. Give the multisig wallet a name. +5. Click "Create". + +
+ +## Test the wallet + +1. The multisig wallet is created. +2. To test the multisig wallet, it is recommended to first use Shibuya testnet. You can get SBY faucet from [https://portal.astar.network](https://portal.astar.network) by connecting your own wallet. +3. After getting the SBY faucet, send the SBY tokens to the multisig wallet and then you can start playing around. + diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/enkrypt/index.md b/docs/use/get-started/astar-substrate-wallet/wallet/enkrypt/index.md new file mode 100644 index 0000000..1808f36 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/enkrypt/index.md @@ -0,0 +1,128 @@ +--- +sidebar_position: 5 +sidebar_label: Enkrypt +title: Install Enkrypt Wallet +--- + +# Enkrypt Wallet + +![](https://i.imgur.com/imLQ4G4.png) + +## Connecting Enkrypt to Astar + +--- + +Enkrypt is a multichain, non-custodial, and open-source web3 browser wallet built by the team behind MEW (MyEtherWallet). With Enkrypt, users and developers can generate accounts, manage tokens and NFTs, and interact with dApps on Astar, as well as EVM chains. Follow the instructions in this guide in order to connect Enkrypt to Astar! + +![](https://i.imgur.com/c3yv69l.jpg) + +--- +## Install Enkrypt +You’ll first need to install the extension to begin. You can visit [Enkrypt.com](https://www.enkrypt.com/?mtm_campaign=Interacting%20with%20Astar%20using%20Enkrypt) to find the download link that corresponds with your browser. Click download in the top right corner. + +![](https://i.imgur.com/clC5IOa.png) + +You’ll be redirected to the download page shown below. Note that every browser’s download page will look slightly different from each other. + +![](https://i.imgur.com/cqCevR0.png) + +Add the extension to your browser. After downloading and installing Enkrypt you’re ready to go. + +--- +## Create A Wallet +When first opening up the extension, you’ll be met with a window containing a quick description of Enkrypt. You can create a new wallet or restore an existing wallet. Let’s start with creating a new wallet. + +![](https://i.imgur.com/aSdrCXp.png) + +After clicking “Create a new wallet” you’ll be able to pick a password. By clicking the crossed out eye symbol within the textbox, you can toggle the ability to see what you’re typing on or off. Enter your desired password and click “Next”. It’ll ask you to type your password in again for confirmation. Once you’ve done that, it’s time for your secret recovery phrase. + +![](https://i.imgur.com/rdAfVXa.png) + +![](https://i.imgur.com/npuMOQk.png) + +The window below will pop up. Note that your secret recovery is uniquely yours, and you will NOT have the same words shown below. You will have a completely unique and random set of 12 words. Write your secret recovery phrase down, and keep it somewhere safe. Never give your phrase to anyone for any reason. This is the key to your wallet and gives full access to your crypto. When you’re done, click “Next”. + +![](https://i.imgur.com/2U2MY1b.png) + +To be sure you have written down the secret recovery phrase, a pop-up will appear asking you to double check. Select the correct words according to your unique recovery phrase, then click “Next”. + +![](https://i.imgur.com/wTsgdb7.png) + +After you’ve set up your secret recovery phrase, your wallet is ready for you. + +At this point, we'd like to stress that Enkrypt is non-custodial and only you have the keys to your wallet. Not your keys, not your crypto! Enkrypt does NOT hold custody of assets, and does NOT collect or sell personal user data. On a lighter note, remember to pin the Enkrypt extension in your browser! + +--- +## Restore Wallet +If you already have a wallet, like MetaMask or Polkadot.js, you can import it into Enkrypt. In order to do so, follow the steps below. + +Click on “Restore existing wallet”. + +![](https://i.imgur.com/PLhSJyE.png) + +Next, click “Use recovery phrase”. + +![](https://i.imgur.com/vhpvq53.png) + +Enter your 12-24 word recovery phrase and click “Next”. + +![](https://i.imgur.com/bNbxr31.png) + +After entering your recovery phrase, your wallet is ready! Make sure to pin Enkrypt to your extension bar for quick access! + +![](https://i.imgur.com/9Sd1Xah.png) + +![](https://i.imgur.com/tzvoInk.png) + +Once you’ve got your wallet setup, you’ll be greeted with the pop-up shown below. Enter your password to proceed. Alternatively, if you’ve forgotten your password, click the link at the bottom entitled “I forgot my password” to begin the password recovery process. Remember, Enkrypt can't recover the password for you – you will need your recovery phrase to reset password. + +![](https://i.imgur.com/MPznxPI.png) + +--- +## Connect Enkrypt to Astar +Once you have Enkrypt installed and have created or restored your wallet, connect to Astar by clicking on the “Manage networks” button on the bottom left. + +![](https://i.imgur.com/PAm2GrB.png) + +After clicking on “Manage networks” the following window will appear. Scrolling down in this window will reveal more available networks. Click the button on the right of each corresponding network in order to activate or deactivate it. A green button indicates the network is currently being shown in your wallet, while a gray button indicates that it is not. When you’re done selecting Astar, you can simply click out of the window or click the “X” on the top right to continue. + +![](https://i.imgur.com/c21up34.png) + +After exiting the pop-up window, you should see Astar in your network list. See below for an example. Click on a network in order to start interacting on that chain. + +![](https://i.imgur.com/VTNFL9j.png) + +--- +## Basics +Below you’ll find screenshots showing you where to receive, send, and buy crypto using Enkrypt. By clicking on the drop-down menu on the top-center of the app, you’ll be able to see your different accounts. Enkrypt generates multiple EVM and Substrate addresses from the same recovery phrase. Use these addresses to receive crypto into your Enkrypt wallet. You can copy the address, open a QR code, or see it on a block explorer using the buttons on the upper right. + +![](https://i.imgur.com/wjLysH4.png) + +![](https://i.imgur.com/BnRPXNK.png) + +Clicking on “buy” will open up a webpage, prompting you to purchase via our partner Simplex (ETH, BNB, and MATIC currently available). Clicking on “send” will open a new page within Enkrypt - fill it out to send a transaction! + +Please refer to the MEW help center for detailed guides on using Enkrypt to buy, send, swap, add and import accounts, connect a hardware wallet, and interact with dApps on Dotsama and Ethereum: https://help.myetherwallet.com/en/collections/3575691-enkrypt + +![](https://i.imgur.com/QjXxk1M.png) + +![](https://i.imgur.com/dsWU9Vb.png) + +--- +## Working With DApps + +Every chain integrated into Enkrypt has its own “Featured dApps” section as seen below. The featured dApps change from time to time, so be sure to keep an eye out for new and exciting dApps in the Kusama ecosystem. If you build dApps and would like to see yours featured - get in touch at [enkrypt.com](https://www.enkrypt.com/?mtm_campaign=Interacting%20with%20Astar%20using%20Enkrypt)! + +![astar-dapps](https://blog.enkrypt.com/content/images/2022/11/astar-dapps.png) + +When landing on a dApps webpage, simply choose Enkrypt when asked how you would like to connect. If you don’t see Enkrypt, choose Polkadot.js or MetaMask, and it will automatically connect to Enkrypt for you, assuming you have Enkrypt installed. + +You can easily switch between networks and accounts directly in the Enkrypt extension while interacting with a dApp page. + +![](https://i.imgur.com/UgsoPP7.png) + +--- + +###### Join our [Discord](https://discord.com/invite/Gz8vBneyKe) community 🌐 | Follow us on [Twitter](https://twitter.com/enkrypt) 🐦 | Check out our [blog](https://blog.enkrypt.com) 📰 + +--- diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/index.md b/docs/use/get-started/astar-substrate-wallet/wallet/index.md new file mode 100644 index 0000000..5d8228d --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 1 +sidebar_label: Wallet +title: Create an Astar Wallet +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/_category_.json b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/_category_.json new file mode 100644 index 0000000..0e287b7 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Ledger", + "position": 2 +} diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-2.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-2.png new file mode 100644 index 0000000..bba3846 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-2.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-3.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-3.png new file mode 100644 index 0000000..0001004 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-3.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-4.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-4.png new file mode 100644 index 0000000..657ebf2 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-4.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-5.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-5.png new file mode 100644 index 0000000..8d6c15c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-5.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-6.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-6.png new file mode 100644 index 0000000..3cf61af Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app-6.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app.png new file mode 100644 index 0000000..d568d1c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-astar-app.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app-2.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app-2.png new file mode 100644 index 0000000..e9244a6 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app-2.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app.png b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app.png new file mode 100644 index 0000000..7bdb01f Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/img/ledger-live-astar-app.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/ledger-native.md b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/ledger-native.md new file mode 100644 index 0000000..9f53ce2 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/ledger-native.md @@ -0,0 +1,101 @@ +--- +sidebar_position: 2 +sidebar_label: Ledger for Astar Native +title: Interact with Ledger using Astar Native Accounts +--- +import Figure from "/src/components/figure" + +## Introduction + +**Astar Native app** is an app integrated with Ledger that users can use a ledger device as an account and sign transactions for substrate accounts. + +- [Release Version `2.83.0` by Zondax](https://github.com/Zondax/ledger-astar/releases/tag/v2.83.0) + +**Ledger Live is not supported hence user will not be able to create an account with Ledger Live**. + +:::danger +At the time of this release (Version `2.83.0`), the following operations are **NOT SUPPORTED** on Ledger devices: + +- **EVM withdrawal**: It is not possible to claim tokens from the Astar EVM side. +- **XCM transfers** +- **Vesting** +::: + +This tutorial describes the process of configuring a Ledger device to manage assets, connect to the Astar portal and participate in dApp staking using native ASTR tokens. It also includes the initiation of the first interaction between the device and the network. + +## Your Ledger device is ready for use + +- [Make sure you have set up your Ledger device](https://support.ledger.com/hc/en-us/articles/360000613793?docs=true) +- Update your device to latest firmware + - [Nano S](https://support.ledger.com/hc/en-us/articles/360002731113?docs=true) + - [Nano S Plus](https://support.ledger.com/hc/en-us/articles/4445777839901?docs=true) + - [Nano X](https://support.ledger.com/hc/en-us/articles/360013349800?docs=true) +- [Download and install Ledger Live app for your OS](https://support.ledger.com/hc/en-us/articles/4404389606417-Download-and-install-Ledger-Live?docs=true) +- [Download and install Polkadot.js extension for your browser](https://polkadot.js.org/extension/) + +## Install Astar app to your Ledger device + +1. Open **My Ledger** in Ledger Live. +2. Connect and unlock your Ledger device. + If asked, allow `My Ledger` to access your device. +3. Search for **Astar** (Version `2.83.0`) in the app catalog. +4. Click Install. + +
+ +After this step, you should have the Astar Native app installed: + +
+ +:::tip +Ledger NanoS users should install the Astar XL (Version `2.83.0`) of the app, shown in the image below: +::: + +
+ +## Connect your Ledger device to Astar Network using Polkadot.js + +1. Install **[Polkadot.js extension](https://polkadot.js.org/extension/)**; +2. Open extenstion; +3. Open the extension and select **Attach Ledger account** as shown below; + +
+ +4. Make sure your Ledger device is connected to your PC and Astar app is open; +5. Select **Astar Network** and name your **Astar** account; + +
+ +6. Click **Import Account**. + +You successfully connected to Ledger Astar account. + +**Configure the Ledger device connection method** + +1. Go to the **[Astar settings page on the Polkadot.js portal](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.astar.network#/settings)**; +2. Ensure **Attach Ledger via WebHID** is the preferred connection method listed under *account options* > *manage hardware connections*, as shown in the image below: + +
+ +## Connect your Ledger device to the Astar Portal + +1. Open your browser and visit the [Astar Portal](https://portal.astar.network). +2. Connect the [Polkadot.js extension](https://polkadot.js.org/extension/) to the Portal. +3. Open the Astar Native app on your Ledger device; + +
+ +4. Select the Ledger account that was imported during the last step. Check the toggle to let Portal recognize the device as a ledger. + +
+ +For detailed information about dApp staking or how to stake on the EVM side of Astar Portal using a Ledger device, please refer to the [Astar official documentation](/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/index.md) or [Ledger EVM staking guide](/docs/use/get-started/astar-evm-wallet/wallet/ledger/ledger-evm.md) + +:::tip +If you receive a **Ledger error: Failed to execute 'claimInterface' on 'USBDevice': Unable to claim interface** message during the dApp staking claim process, ensure you are performing the operation: +- Using a Chromium-based browser such as Chrome or Brave, +- The Ledger device connection method is WebHID, as outlined in the previous step +- The Ledger device is correctly connected to the Portal with the toggle activated. +::: + +
diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/ledger/restore-ledger.md b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/restore-ledger.md new file mode 100644 index 0000000..05a5ede --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/ledger/restore-ledger.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 2 +sidebar_label: Restore Ledger wallet +title: Restore Ledger wallet on Polkadot.js +--- + +Some of you might have issues making transactions with Ledger wallet on the portal. This is because the Ledger App that you are using is a minimal version. For now, restoring the Ledger seed phrase on Polkadot.js may help the issue. + +
+ +This is a 2-step process. +1. Restore the wallet on Polkadot.js. +2. Restore the json file on Polkadot.js extension. + +## Step 1: +1. Go to [Polkadot.js](https://polkadot.js.org/apps/#/settings). +2. Go to Settings. +4. On the Account Options dropdown menus, select `Allow local in-browser account storage`and `Attach Ledger via WebUSB (Chrome, recommended)`. +5. Click "Save". +![image](https://user-images.githubusercontent.com/37278708/218649665-db576329-7a93-4286-9b46-965e9bed3b2d.png) + +6. Next, go to "Account" and click on “Add Account”. +7. Replace the mnemonic seed with your Ledger seed. +8. Expand "Advanced creation options". +9. On "keypair crypto type", select `Ledger (ed25519, BIP32 derivation)`. +10. On "ledger app type", select `Astar Network`. +11. Tick the box “I have saved my mnemonic phrase safely”. +12. Click “Next”. +![image](https://user-images.githubusercontent.com/37278708/218649577-6eaf7936-bf3b-4610-8d3e-458b39353780.png) + +12. Give the account a name and a password, and click “Next”. Make sure to save the password. +13. Click “Save”. +![image](https://user-images.githubusercontent.com/37278708/214498123-dab270e0-9534-410f-8115-e254ac707041.png) + +14. You will be prompted to save the json file. Please save the json file safely as you will need this in the next step. + +## Step 2: +1. Go to https://polkadot.js.org/extension/ to download and install the browser extension wallet. +2. After installation, click on the “+’ icon and select “Restore account from a backup json file” +3. Select the json file that you saved from Step 1 and click “Restore”. +4. Enter the password that you saved from Step 1 and click”Restore”. +5. The wallet is now restored on the Polkadot.js extension. +6. Click on the 3 dots and select “Allow use on any chain”. +7. Your Ledger wallet is now restored on Polkadot.js and you can use it with Astar Portal. diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/01.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/01.png new file mode 100644 index 0000000..46a700a Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/01.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/02.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/02.png new file mode 100644 index 0000000..2fd8c10 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/02.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/03.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/03.png new file mode 100644 index 0000000..a3b33f6 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/03.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/04.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/04.png new file mode 100644 index 0000000..b5e9e8f Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/04.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/05.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/05.png new file mode 100644 index 0000000..4875785 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/05.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/06.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/06.png new file mode 100644 index 0000000..fa98509 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/06.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/08.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/08.png new file mode 100644 index 0000000..724acd4 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/08.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/09.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/09.png new file mode 100644 index 0000000..d1445e1 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/09.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/10.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/10.png new file mode 100644 index 0000000..2b0961f Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/10.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/11.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/11.png new file mode 100644 index 0000000..dc74ba0 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/11.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/12.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/12.png new file mode 100644 index 0000000..bd639d4 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/12.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/13.png b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/13.png new file mode 100644 index 0000000..59418c6 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/13.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/astar_snap_30s_v1.mp4 b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/astar_snap_30s_v1.mp4 new file mode 100644 index 0000000..2d51266 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/img/astar_snap_30s_v1.mp4 differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/index.md b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/index.md new file mode 100644 index 0000000..9c4ca48 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/index.md @@ -0,0 +1,126 @@ +--- +sidebar_position: 3 +sidebar_label: Metamask Snap +title: Install MetaMask Astar Wallet Snap +--- + +import Figure from '/src/components/figure' + +## Introduction + +The Astar Wallet Snap extends MetaMask's functionality, specifically for blockchains built with Astar’s Substrate technology, powered by Polkadot. The Astar Wallet Snap enables you to quickly generate a Substrate wallet with MetaMask for signing transactions and interacting with decentralized applications (dApps) that utilize the `@polkadot/extension-dapp` package. You can seamlessly interact with all dApps in the Astar ecosystem through MetaMask, thereby expanding MetaMask's utility beyond Ethereum and EVM-compatible networks. + +## How to install + +Follow these steps to interact with the Astar Wallet snap [Portal](https://portal.astar.network/). The [source code](https://github.com/AstarNetwork/metamask-snap-astar/tree/master/packages/example) for the example dApp is available as part of the repository. This guide assumes that MetaMask is [installed](https://metamask.io/download/) and properly configured. + +
+ +
+ +## Connect to the Portal + +Click the webpage button labeled "Astar Snap" with the MetaMask logo +'/docs/use/get-started/astar-substrate-wallet/wallet/metamask-snap/ +
+ +## Review & Accept Third-Party Software Notice + +Click the arrow to view the entire third-party software notice and, if you +accept it, click the MetaMask "Third-party software notice" button labeled +"Accept" to accept the MetaMask third-party software notice. + + +
+
+
+
+
+
+
+
+ +## Review & Accept Connection Request + +Review the connection request and, if you accept it, click the MetaMask +"Connection request" button labeled "Connect" to accept the Astar Wallet snap +connection request. + +
+ +## Review Snap Permissions & Begin Installation + +Click the arrow to view the entire list of permissions required by the Astar +Wallet snap and, if you accept them, click the MetaMask "Install snap" button +labeled "Install" to begin installing the Astar Wallet snap. + +
+
+
+
+
+
+
+
+ +## Confirm Elevated Permissions & Complete Installation + +Because the Astar Wallet snap has permission to control accounts for the +Astar & Shiden Networks (whose tokens carry real economic value), it's +necessary to review and confirm this elevated level of access. If you accept +this elevated level of access, check the boxes and click the MetaMask "Proceed with +caution" button labeled "Confirm" to confirm the elevated level of access and +install the Astar Wallet snap. Click the MetaMask "Installation complete" +button labeled "OK" to continue to the example dApp. + +
+
+
+
+
+
+
+
+ +## Connect the Snap Wallet + +The Astar Snap Wallet is now configured. Notice the address +was derived using the entropy from your MetaMask seed phrase and the snapId. +The public key does _not_ depend on the network and will always be the same. + +
+ +
+ +## How to Remove + +In MetaMask, click on the tripple dot icon on the top right of the extention, then Snap, +lastly click on **Astar Wallet**, scroll to the bottom and click **Remove Astar Wallet** + +This action will not destroy your account or your funds. But deleting your MetaMask account and/or seed could. + +
+
+
+
+
+
+
+
+ +## How to Restore + +Simply reconnect to the [Portal](https://portal.astar.network/) and choose the Astar Snap Wallet again. +You will obtain the same address as before with all the funds attached. + +## Disclaimer + +XCM is not recommended + +## Conclusion + +That concludes the Astar Wallet snap [Portal](https://portal.astar.network/) install instructions. If you have any +questions or believe you have found an error or bug, please +[open an Issue](https://github.com/AstarNetwork/metamask-snap-astar/issues/new). diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/_category_.json b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/_category_.json new file mode 100644 index 0000000..942a6b2 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Polkadot.js", + "position": 1 +} diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/33.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/33.png new file mode 100644 index 0000000..76de725 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/33.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/34.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/34.png new file mode 100644 index 0000000..668e7b2 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/34.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/35.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/35.png new file mode 100644 index 0000000..a71b4d5 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/35.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/36.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/36.png new file mode 100644 index 0000000..9d92db8 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/36.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/37.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/37.png new file mode 100644 index 0000000..7ee129c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/37.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/38.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/38.png new file mode 100644 index 0000000..70e8c08 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/38.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/4.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/4.png new file mode 100644 index 0000000..d92b9ba Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/4.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/5.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/5.png new file mode 100644 index 0000000..85c3a1f Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/5.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/6.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/6.png new file mode 100644 index 0000000..792166e Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/6.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/7.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/7.png new file mode 100644 index 0000000..95cfd1d Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/7.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/8.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/8.png new file mode 100644 index 0000000..a750ca1 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/8.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/9.png b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/9.png new file mode 100644 index 0000000..e82b5a7 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/img/9.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/install-polkadot-js.md b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/install-polkadot-js.md new file mode 100644 index 0000000..ab6f157 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/install-polkadot-js.md @@ -0,0 +1,89 @@ +--- +sidebar_position: 1 +sidebar_label: Install Polkadot.Js +title: Create an Astar Wallet using Polkadot.Js +--- + +## Astar Accounts + +### Address Format + +The address format used in Substrate-based chains like Astar is SS58. SS58 is a modification of Base-58-check from Bitcoin with some minor modifications. Notably, the format contains an address type prefix that identifies an address as belonging to a specific network. Astar Network is special in the Polkadot ecosystem because it's the only parachain that supports EVM as WASM smart contract. With the use of two different virtual machines comes two different kinds of addresses. + +- An Astar Native address or SS58 address +- An Astar EVM address or H160 address which starts with 0x + +1 +2 + +You will interact with our Astar native address when using WASM dApps are ready or our dApps Staking page. Using this address requires another extension than MetaMask. We recommend using the Polkadot JS extension if you are new to the ecosystem. + +## Astar Portal + +[Astar Portal]: https://portal.astar.network/ + +The [Astar Portal] is the place to be for doing anything in our ecosystem. The Astar developers created a one-stop-place for everyone who wants to interact in our ecosystem. + +Through our portal, you can connect to different networks in the Astar ecosystem. + +- **Astar Network**: parachain on Polkadot. +- **Shiden Network**: parachain on Kusama. +- **Shibuya**: parachain testnet + +2 + +## Recommend: Polkadot\{.js\} Browser Plugin + +The Polkadot\{.js\} plugin provides a reasonable balance of security and usability. It provides a separate local mechanism to generate your address and interact with the Astar portal. We recommend users who are new to our ecosystem and want to create an Astar native address use this wallet. If you don't have the Polkadot JS extension you will receive a popup in our portal when you try to connect your wallet. + +### Install the Browser Plugin + +The browser plugin is available for both [Google Chrome](https://chrome.google.com/webstore/detail/polkadot%7Bjs%7D-extension/mopnmbcafieddcagagdcbnhejhlodfdd?hl=en) (and Chromium-based browsers like Brave) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/polkadot-js-extension). After installing the plugin, you should see the orange and white Polkadot\{.js\} logo in your browser menu bar. + +![4](img/4.png) + +### Create Account + +Open the Polkadot\{.js\} browser extension by clicking the logo on the top bar of your browser. You will see a browser popup. + +![6](img/6.png) + +Click the big plus button - "Create new account". The Polkadot\{.js\} plugin will then use system randomness to make a new seed for you and display it to you in the form of twelve words. + +![7](img/7.png) + +You should back up these words. Please, store the seed somewhere safe, secret, and secure. If you cannot access your account via Polkadot\{.js\} for some reason, you can re-enter your seed through the "Add account menu" by selecting "Import account from pre-existing seed". + +![8](img/8.png) + +Best to create an account that is allowed on any chain in the Polkadot ecosystem. This account can then be used for Polkadot and Kusama. Your account will automatically change format when connected to a chain. + +A **descriptive name** is arbitrary and for your use only. It is not stored on the blockchain and will not be visible to other users who look at your address via a block explorer. If you're juggling multiple accounts, it helps to make this as descriptive and detailed as needed. + +The **password** will be used to encrypt this account's information. You will need to re-enter it when using the account for any kind of outgoing transaction or when using it to cryptographically sign a message. + +:::danger +Note that this password does **NOT** protect your seed phrase. If someone knows the twelve words in your mnemonic seed, they still have control over your account even if they do not know the password. +::: + +After clicking on "Add the account with the generated seed", your account is created. We recommend also saving your account as json file somewhere safe. + +## Connect your wallet to Astar Portal + +Return to [Astar Portal] and refresh the page. You will get a popup that Polkadot JS needs to be authorized to be used on our portal. Give the extension permission to do so! + +![9](img/9.png) + +When you have given the extension permission, let's connect the wallet. A popup will show with all possible extensions. We just create a new account with Polkadot JS, so let's select this extension. + +10 + +Once you have clicked on Polkadot JS, you can select your newly created account. Select your account and press confirm. + +11 + +You have now successfully connected an Astar wallet to our portal. Note that you can use this wallet on all parachains in the Dotsama ecosystem. + +## Support + +In case you have any problems. Join our community and our Ambassadors will support you. Please remember that we will never DM you first! If you get approached by someone pretending to be part of the team, do not trust them. diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/proxy-wallet.md b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/proxy-wallet.md new file mode 100644 index 0000000..004359e --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/proxy-wallet.md @@ -0,0 +1,97 @@ +--- +sidebar_position: 2 +sidebar_label: Create a Proxy Account +title: Create a Proxy Account with Polkadot.Js +--- + +import Figure from '/src/components/figure' + +This tutorial will be using [Polkadot.js Apps](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.shiden.astar.network#/extrinsics) for manipulating proxies. + +To create a proxy account, follow these steps: + +1. **Go to the Developer tab:** Locate and navigate to the "Developer" tab on the website. + +2. **Select Extrinsics:** Within the Developer tab, find the "Extrinsics" and select it. + +3. **Select the primary account:** Choose the primary account for which you want to create a proxy from the list. We will be using **ALICE** as primary account in this tutorial. + +4. **Submit the following extrinsic:** From the `submit the following extrinsic` dropdown, select **proxy** + +5. Choose the **addProxy** extrinsic + +6. Select the **delegate** account for the proxy + +7. **Choose the proxyType:** From the proxyType dropdown, choose **Balances** + +8. **(Optional) Add a time delay:** If desired, you may have the option to add a time delay to the transaction. This adds an extra layer of security by requiring the primary account to review the pending transaction before it is executed. Specify the desired number of blocks for the time delay. + +9. **Submit the transaction:** Once you have filled in all the necessary details, find the button to submit the transaction. Click on it to initiate the process. + +
+ +You will then be prompted to authorize and sign the transaction. Go ahead and click **Sign and Submit** to create the proxy relationship. + +
+ +Once the transaction has been successfully submitted, you will receive notifications confirming the transaction. + +You can also find the event `proxy.ProxyAdded` in recently emitted events inside **Network** > **Explorer** tab. + +
+ +**Verifying Proxy Account** +--- +There are many ways of verifying if your proxy was added or not. Easiest way to do so is using the **Accounts** page. + +1. Navigate to the Accounts page by clicking on **Accounts** tab and then selecting **Accounts**. + +2. Here find you **Primary Account** and click on the 3 dots as seen in the provided picture. + + +
+ +3. Select **Manage proxies** option. + + +Here you can see the list of all proxies that you account has. For this tutorial, it is only **Balances** proxy that we added in the above section. + +
+ +:::tip + +You can also remove the proxy by clicking on the (X) icon next to the proxy account (in our case **BOB**). After clicking (X) button, the proxy will diappear from the list, Click on `Submit`. + +Once the transaction has successfully been submitted, you can review your current proxies or if you removed all proxies you will notice the proxy icon is no longer being displayed next to the primary account. + +::: + +**Executing a Proxy Transaction** +--- + To execute a proxy transaction, go back to the **Extrinsic** page and do the following: + + ## Submitting a Proxy Transaction + +To submit a proxy transaction, follow these steps: + +1. **Select the proxy account:** Choose the proxy account to submit the transaction from using the "Select Account" dropdown. + +2. **Submit the following extrinsic:** From the "Submit the following extrinsic" menu, select "proxy". + +3. **Choose the proxy extrinsic:** Select the "proxy" extrinsic. + +4. **Select the primary account:** From the "real" dropdown, select **Id** and then select the **Primary Account** (ALICE in our case) + +5. Select the **balances** call + +6. Choose the **transfer** extrinsic + +7. **Enter the destination address:** In the "dest" field, enter the address where you want to send the funds. + +8. **Enter the value:** In the "value" field, enter the amount of funds to send. + +9. **Click Submit Transaction:** Once you have entered all the necessary details, click on "Submit Transaction" to initiate the transaction. + +
+ +Congratulations! You've completed the entire process successfully. You have created a proxy account, reviewed all the proxy accounts linked to your primary account, performed a proxy transaction, and even removed a proxy account. Well done! \ No newline at end of file diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/restore-ecdsa.md b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/restore-ecdsa.md new file mode 100644 index 0000000..7689075 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/polkadot.js/restore-ecdsa.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 3 +sidebar_label: Restore a ECDSA wallet +title: Restore a ECDSA wallet on Polkadot.js +--- + +During Lockdrop 1 & 2, some of you might have claimed PLM tokens to the default wallet. If you are one of them and have lost access to your Polkadot.js wallet, this tutorial will guide you on how to restore that wallet. + +
+ +This is a 2-step process. +1. Restore the wallet on Polkadot.js. +2. Restore the json file on Polkadot.js extension. + +## Step 1: +1. Go to [Polkadot.js](https://polkadot.js.org/apps/#/settings). +2. Go to "Settings". +3. On the Account Options dropdown menu, select `Allow local in-browser account storage` +4. Click Save". +![image](https://user-images.githubusercontent.com/37278708/214497161-f31e7685-f090-4e4c-806e-6a47bf18e48f.png) + +6. Next, go to Account and click on Add Account. +7. Change “Mnemonic” to “Raw Seed”. +8. Expand "Advanced creation options". +9. On "keypair crypto type", and select `ECDSA`. +10. On the SEED box, type 0x and paste your ETH private key. +11. Tick the box “I have saved my mnemonic phrase safely”. +12. Click “Next”. +![image](https://user-images.githubusercontent.com/37278708/214499043-aacc13c5-8e31-4a91-8384-e943169011a6.png) + +12. Give the account a name and a password, and click “Next”. Make sure to save the password. +13. Click “Save”. +![image](https://user-images.githubusercontent.com/37278708/214498123-dab270e0-9534-410f-8115-e254ac707041.png) + +14. You will be prompted to save the json file. Please save the json file safely as you will need this in the next step. + +## Step 2: +1. Go to https://polkadot.js.org/extension/ to download and install the browser extension wallet. +2. After installation, click on the “+’ icon and select “Restore account from a backup json file” +3. Select the json file that you saved from Step 1 and click “Restore”. +4. Enter the password that you saved from Step 1 and click”Restore”. +5. The wallet is now restored on the Polkadot.js extension. +6. Click on the 3 dots and select “Allow use on any chain”. +7. Your ECDSA wallet is now restored on Polkadot.js and you can use it with Astar Portal. diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-1.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-1.png new file mode 100644 index 0000000..f0631c9 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-1.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-10.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-10.png new file mode 100644 index 0000000..dd67819 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-10.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-11.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-11.png new file mode 100644 index 0000000..db59735 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-11.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-12.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-12.png new file mode 100644 index 0000000..82cb4c4 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-12.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-13.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-13.png new file mode 100644 index 0000000..5f7c362 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-13.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-14.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-14.png new file mode 100644 index 0000000..8a8b4ac Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-14.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-15.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-15.png new file mode 100644 index 0000000..8b08a64 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-15.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-16.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-16.png new file mode 100644 index 0000000..5a34617 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-16.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-17.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-17.png new file mode 100644 index 0000000..3301285 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-17.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-18.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-18.png new file mode 100644 index 0000000..c911533 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-18.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-19.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-19.png new file mode 100644 index 0000000..f86e463 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-19.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-2.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-2.png new file mode 100644 index 0000000..3ee3d61 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-2.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-20.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-20.png new file mode 100644 index 0000000..b231197 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-20.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-21.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-21.png new file mode 100644 index 0000000..d32d485 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-21.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-23.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-23.png new file mode 100644 index 0000000..3f41712 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-23.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-24.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-24.png new file mode 100644 index 0000000..1f6b40c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-24.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-25.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-25.png new file mode 100644 index 0000000..54ac545 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-25.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-26.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-26.png new file mode 100644 index 0000000..8647d6a Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-26.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-27.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-27.png new file mode 100644 index 0000000..970592c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-27.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-28.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-28.png new file mode 100644 index 0000000..979e65a Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-28.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-29.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-29.png new file mode 100644 index 0000000..dbbba9b Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-29.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-3.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-3.png new file mode 100644 index 0000000..078d59f Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-3.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-30.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-30.png new file mode 100644 index 0000000..c3e987d Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-30.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-31.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-31.png new file mode 100644 index 0000000..5fa494e Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-31.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-32.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-32.png new file mode 100644 index 0000000..ed15f08 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-32.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-33.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-33.png new file mode 100644 index 0000000..7dd4e5c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-33.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-34.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-34.png new file mode 100644 index 0000000..c3e6566 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-34.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-35.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-35.png new file mode 100644 index 0000000..777f06c Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-35.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-36.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-36.png new file mode 100644 index 0000000..08e11c3 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-36.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-37.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-37.png new file mode 100644 index 0000000..6dd5d02 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-37.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-4.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-4.png new file mode 100644 index 0000000..5e762af Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-4.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-5.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-5.png new file mode 100644 index 0000000..23cbbf1 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-5.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-6.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-6.png new file mode 100644 index 0000000..dbeccdb Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-6.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-7.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-7.png new file mode 100644 index 0000000..dea3ab7 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-7.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-8.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-8.png new file mode 100644 index 0000000..762eb06 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-8.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-9.png b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-9.png new file mode 100644 index 0000000..bb51013 Binary files /dev/null and b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/img/subwallet-9.png differ diff --git a/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/index.md b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/index.md new file mode 100644 index 0000000..6f1bad1 --- /dev/null +++ b/docs/use/get-started/astar-substrate-wallet/wallet/subwallet/index.md @@ -0,0 +1,267 @@ +--- +sidebar_position: 4 +sidebar_label: Subwallet +title: Connecting SubWallet to Astar +--- + +import Figure from '/src/components/figure' + +SubWallet is a comprehensive non-custodial wallet solution for Substrate & Ethereum ecosystems. Built on top of Polkadot.js, SubWallet focuses on improving UX & UI. We envision a crypto wallet as a Web3 multiverse gateway through which users can enjoy multi-chain services with utmost ease and absolute security. + +This guide will show you how to manage your accounts, your tokens, stake your tokens in-app, and connect to the Astar Portal using SubWallet! + +## Install SubWallet + +SubWallet is available on a range of platforms for you to choose from: + +1. A **browser extension** which is available on [Google Chrome](https://chromewebstore.google.com/detail/subwallet-polkadot-wallet/onhogfjeacnfoofkfgppdlbmlmnplgbn), [Brave](https://chromewebstore.google.com/detail/subwallet-polkadot-wallet/onhogfjeacnfoofkfgppdlbmlmnplgbn), [MS Edge](https://chromewebstore.google.com/detail/subwallet-polkadot-wallet/onhogfjeacnfoofkfgppdlbmlmnplgbn) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/subwallet/). + + +2. A **mobile app** which is available on the [App Store](https://apps.apple.com/us/app/subwallet-polkadot-wallet/id1633050285) and [Google Play Store](https://play.google.com/store/apps/details?id=app.subwallet.mobile). + +3. A web dashboard that does not require any downloading and can be accessed through https://web.subwallet.app + +For this tutorial, we will walk you through the process of creating a wallet using the browser extension. + +## Setup an account + +Once you have installed the extension, you'll have the option to **create**, **import** or **attach an account** ([Ledger](https://docs.subwallet.app/main/extension-user-guide/account-management/connect-ledger-device), [Keystone](https://docs.subwallet.app/main/extension-user-guide/account-management/connect-keystone-device), [Polkadot Vault](https://docs.subwallet.app/main/extension-user-guide/account-management/attach-a-polkadot-vault-previously-parity-signer-account) and [Watch-only account](https://docs.subwallet.app/main/extension-user-guide/account-management/attach-a-watch-only-account)) + +
+ +### Create a new account + +To create a new account, click on **Create a new account**. + +
+ +You will then need to create your master password which keeps all of your accounts secure. Once you have entered the password and then confirmed it, click on **Continue**. + +
+ +:::note +For each seed phrase created with SubWallet, you would have a Substrate account and an Ethereum account. + Substrate account would display your assets on Substrate-native blockchains (such as Polkadot, Kusama, and Astar), while Ethereum account would display your assets on Ethereum chains (such as Astar-EVM). +::: + +Now you will be shown a seed phrase together with the option to back it up. Once you have saved and stored it in a safe place, choose **I have kept it somewhere safe**. + +
+ +:::caution +You should never share your seed phrase (mnemonic) or private key with anyone. This gives them direct access to your funds. +::: + +You have finished creating a new account! If you want to create additional accounts, follow these steps: +1. Choose the accounts tab on the top of the extension. + + +
+ +2. Click on **Create a new account** and repeat the steps above. + +
+ +### Import an existing account + +To import an account that you have already created, choose **Import an account**. + +
+ +Then you can choose your preferred method of importing. + +
+ +After you have chosen a method, you will be prompted to create a master password. Enter your password and click on **Continue**. + +
+ +:::caution +Please note that SubWallet is non-custodial, so you would be the only person who knows your password; we cannot help you restore your password once it is lost. Please make sure that your password is well-kept. +::: + +#### Using seed phrase + +You could choose between importing either a Substrate account or Ethereum account, or both. After choosing, click on **Import account** + +
+ +Enter your seed phrase in the text boxes. You can use either a 12-word seed phrase or a 24-word seed phrase to import your account. Click on **Import account** and your account has been imported! + +
+ + +:::note +Incompatibility +In some cases, if you import an account from a seed phrase, problems can arise if the seed phrase of your original wallet is not compatible with SubWallet. **Trust Wallet** and **Safepal** are among the wallets not compatible with us. +::: + + +#### Using Polkadot.js JSON file + +You can import a Polkadot.js account after exporting the JSON backup file. Click on the **Import from Polkadot.js** field to upload a file from your device, or drag and drop your JSON file into the field. + +
+ +You will then need to enter your JSON file password (created when you set up the wallet for the first time) and click **Import by JSON file**. + +
+ +:::note +If you want to import multiple accounts simultaneously from a JSON file, you are required to enter the password for each account you want to import. +::: + +#### Using MetaMask private key + +Once you have exported your private key, enter it into the text box then click on **Import account**. + +
+ + +#### Using QR code + +
+ +Click on **Scan QR**. If you have not enabled camera access yet, a message will show up prompting you to **Go to settings**. + +
+ + + On the settings page, toggle on **Camera access for QR** then head back to the QR page, click on **Scan QR** and scan your accounts' QR code. After the successful import of your account by QR code, you will be directed to the Homepage. + + +
+ + + +#### Import additional accounts + +You have finished importing your account! If you want to import additional accounts, follow these steps: +1. Choose the accounts tab on the top of the extension. + +
+ + +2. Click on the **Import** icon and repeat the steps above. + +
+ + + +## Interacting with Astar + +### Managing ASTR on SubWallet + +To Manage ASTR on SubWallet, choose the **Customize asset display** icon next to the search icon. + +
+ + +On the search bar, search for **Astar**. Toggle on the networks to enable them. + +
+ + +Head back to the home screen. You should be able to see that Astar has been connected and all of the tokens available on the network should be displayed. + +
+ +## Receive token + +From your home screen, choose the first blue icon under the eye. + +
+ +:::note +**If you are in all-accounts mode** +You will be prompted to choose an account if you are in all-accounts mode. + +
+::: + +Search for the token that you would like to receive, in this case, ASTR. You can either **Copy the address** or **View address QR**. + +
+ + +:::note +ASTR is allowed to execute cross-chain transfer, so when choosing the token, make sure you are receiving ASTR on the correct chain by checking the network icon under the tokens. +
+::: + +Send the address or show the QR code to the sender and you'll be able to receive ASTR from them! + +
+ +### Send a transaction + +To get started with a simple token transfer to another address on Astar, you can click the send icon. + +
+ +Next, you can take the following steps: + +1. Specify the asset to send and the destination chain. + + :::note + ASTR is allowed to execute cross-chain transfer, so when choosing the destination network, you can choose the drop-down menu to see the available options. + ::: + +2. Enter the destination address +3. Enter the amount of tokens to send +4. Look over the transaction details, then press **Transfer** + +
+ +On the next screen, you can review the transaction details and submit the transaction. If the transaction details look good, you can click **Approve** to send the transaction. + +
+ +After you send the transaction, you can review the transaction details. + +### Connect to the Astar Portal + +First, head to the [Astar Portal](https://portal.astar.network/astar/assets). Once you arrive at the portal, you will be prompted to connect your wallet. + +If you want to connect your Ethereum account, choose **SubWallet** under the **Ethereum accounts** section. + +
+ +A window will appear. Choose the account that you would like to connect then choose **Connect**. Approve the connection and you have successfully connected to the Astar portal! + +
+ +Otherwise, if you want to connect using your Substrate account, choose **SubWallet** under the **Native accounts** section. + +
+ +Afterward, the steps to connect are identical to that of connecting Ethereum accounts. + +### dApp Staking + +First, head to the **staking** tab on the navigation bar. + +
+ +On the staking screen, choose the **+** icon on the top right of the screen. + +
+ +Choose the **Nominate** tab in the "Add to Bond" screen and enter the staking information: + +
+ +1. Choose the account from which you would like to stake (if you are in all accounts mode) +2. Choose the token that you would like to stake, in this case, ASTR. +3. Enter the amount of tokens. The minimum active for dApp staking with ASTR is 500 ASTR. +4. Select a dApp. + +A list of available dApps will be shown. It is suggested that you pay close attention to the dApp you are choosing. When selecting dApp, SubWallet supports you with the latest record of dApp details. Please click the three-dot icon on the right-hand side of each dApp to see the dApp details. + +
+ +In addition, you could use the sort function to find the most suitable dApp according to your needs. Click the sort icon on the upper right corner and choose your sorting criteria. + +
+ +After all the staking information is entered, click on **Stake** then approve the transaction. \ No newline at end of file diff --git a/docs/use/get-started/blockchain-smart-contracts.md b/docs/use/get-started/blockchain-smart-contracts.md new file mode 100644 index 0000000..c6725b8 --- /dev/null +++ b/docs/use/get-started/blockchain-smart-contracts.md @@ -0,0 +1,28 @@ +--- +sidebar_position: 1 +sidebar_label: Smart Contracts Blockchain +title: High-Level Blockchain & Smart Contracts Overview +--- + +Astar is a platform for smart contracts deployment. Developers can create and deploy smart contracts on Astar Network using a variety of programming languages, including Solidity, which is compatible with Ethereum smart contracts or ink!, a Rust-based smart contract language for Polkadot ecosystem. This compatibility ensures a seamless transition for developers from other blockchain ecosystems, fostering interoperability and encouraging the adoption of Astar Network. + + +Astar Network employs a high-performance consensus mechanism that ensures fast and efficient contract execution. The network utilizes a unique combination of proof-of-stake (PoS) and proof-of-work (PoW) consensus algorithms, enhancing security while maintaining scalability. This architecture enables Astar Network to handle a high volume of smart contract transactions, making it suitable for decentralized applications (DApps) with demanding computational requirements. + +Furthermore, Astar Network incorporates a comprehensive set of tools and development frameworks to facilitate the creation, testing, and deployment of smart contracts. These include a robust software development kit (SDK), detailed developer documentation, and a user-friendly integrated development environment (IDE). These resources empower developers to write secure and efficient smart contracts, reducing the risk of vulnerabilities and ensuring the reliability of decentralized applications. + + +## WebAssembly smart contracts +Astar & Shiden runtimes are based on Substrate, and both networks incorporate `pallet-contracts`, a sandboxed environment used to deploy and execute WebAssembly smart contracts. Any language that compiles to Wasm may be deployed and run on this Wasm Virtual Machine, however, the code should be compatible with the `pallet-contracts` [API](https://docs.rs/pallet-contracts/latest/pallet_contracts/api_doc/trait.Current.html). + +To avoid unnecessary complexity, and writing boilerplate code, the most appropriate method of building will involve the use of an eDSL specifically targeting `pallet-contracts`, such as [ink!] (based on Rust), or [ask!] (based on AssemblyScript), or possibly others as the ecosystem grows. + +After compilation, a Wasm blob can then be deployed and stored on-chain. + +## Ethereum Virtual Machine smart contracts +Astar EVM implementation is based on the Substrate Pallet-EVM, and we get a full Rust-based EVM implementation. +Smart contracts on Astar EVM can be implemented using Solidity, Vyper, and any other language which can compile smart contracts to EVM-compatible bytecode. Pallet-EVM aims to provide a low-friction and secure environment for the development, testing, and execution of smart contracts that is compatible with the existing Ethereum developer toolchain. + +## Learn more + + diff --git a/docs/use/get-started/gas.md b/docs/use/get-started/gas.md new file mode 100644 index 0000000..862d1f7 --- /dev/null +++ b/docs/use/get-started/gas.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 2 +sidebar_label: Gas fees & ASTR token +title: What are the gas fees and the token on Astar Network ? +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/get-started/index.md b/docs/use/get-started/index.md new file mode 100644 index 0000000..e717055 --- /dev/null +++ b/docs/use/get-started/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 1 +sidebar_label: Get Started +title: Get Started on Astar network +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/how-to-guides/index.md b/docs/use/how-to-guides/index.md new file mode 100644 index 0000000..696865e --- /dev/null +++ b/docs/use/how-to-guides/index.md @@ -0,0 +1,8 @@ +--- +title: How to Guides +position: 1 +--- + +# Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/astar-portal/img/Endpoint_error.png b/docs/use/how-to-guides/layer-1/astar-portal/img/Endpoint_error.png new file mode 100644 index 0000000..68e62b4 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/astar-portal/img/Endpoint_error.png differ diff --git a/docs/use/how-to-guides/layer-1/astar-portal/img/Network_modal.png b/docs/use/how-to-guides/layer-1/astar-portal/img/Network_modal.png new file mode 100644 index 0000000..be48cf0 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/astar-portal/img/Network_modal.png differ diff --git a/docs/use/how-to-guides/layer-1/astar-portal/img/Troubleshooting_dApp_Staking.png b/docs/use/how-to-guides/layer-1/astar-portal/img/Troubleshooting_dApp_Staking.png new file mode 100644 index 0000000..ebad3b8 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/astar-portal/img/Troubleshooting_dApp_Staking.png differ diff --git a/docs/use/how-to-guides/layer-1/astar-portal/img/lockdropacc.png b/docs/use/how-to-guides/layer-1/astar-portal/img/lockdropacc.png new file mode 100644 index 0000000..b89ee2b Binary files /dev/null and b/docs/use/how-to-guides/layer-1/astar-portal/img/lockdropacc.png differ diff --git a/docs/use/how-to-guides/layer-1/astar-portal/index.md b/docs/use/how-to-guides/layer-1/astar-portal/index.md new file mode 100644 index 0000000..43c21ea --- /dev/null +++ b/docs/use/how-to-guides/layer-1/astar-portal/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 1 +sidebar_label: Astar Portal +title: Interact with the Astar Portal +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/astar-portal/lockdrop.md b/docs/use/how-to-guides/layer-1/astar-portal/lockdrop.md new file mode 100644 index 0000000..30c53b0 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/astar-portal/lockdrop.md @@ -0,0 +1,60 @@ +--- +sidebar_position: 2 +sidebar_label: Lockdrop +title: Interact with Lockdrop accounts +--- + +## Regaining Access to Lockdrop Accounts + +We want to remind our users that lockdrop accounts were specifically created for the purpose of claiming ASTR lockdrop rewards and were not intended for ongoing transactions or use as regular accounts. Importantly, access to these accounts was disabled one and a half years following the claim period, impacting users who had not withdrawn their funds within this extended timeframe. + +To support our users in accessing their funds, we are temporarily updating Shiden and Astar to restore access to these lockdrop accounts. This initiative represents a limited support window aimed at facilitating the withdrawal of funds from a feature that is gradually being phased out. + +### Reconnecting Your Lockdrop Account: + +#### Prerequesite: +The EVM address will be used to dispatch the call on behalf of the lockdrop account. Please ensure that the **EVM address holds native tokens (ASTR or SDN) to cover gas fees** for the dispatch call. + +#### Steps: +1. Visit the Astar portal. +2. Log in using your Ethereum lockdrop address. +3. Select "Switch to lockdrop account." + +
+ +
+ +4. Authenticate by signing the message. +5. Carefully read and comprehend the warnings. + +:::caution + +Please note that the access will be discontinued 31-Aug 2024, so move your funds ASAP. + +Be aware that engaging in transactions from lockdrop accounts incurs higher fees than usual. This is specific to the use of lockdrop accounts and underlines the need of transferring your funds out of this account. + +Every call implying moving of funds are possible in Astar Portal: +- Native transfer +- Asset transfer +- dApp Staking unbond and withdraw +::: + +## How to claim ETH from Lockdrop + +This section will guide you on how to claim the ETH that you locked during Lockdrop 1 and 2. + +1. Go to the [Lockdrop page](https://lockdrop.astar.network/). +2. Select either Lockdrop 1 or Lockdrop 2. +3. You will be prompted to connect Metamask. +4. Connect the wallet that you used to lock the ETH and make sure that you are on the Ethereum Network. +5. Click "Unlock Tokens". +6. Click the 🔒. + +![image](https://user-images.githubusercontent.com/37278708/214504565-03984cde-a785-44c0-bade-5220ef6fc3e8.png) + +6. You will need to pay the gas fee to complete the transaction. +7. The ETH shall be in your wallet after the transaction is complete. +8. If you have troubles connecting, use VPN. + + +The other method to claim is by simply sending 0 ETH to the lock address. This will trigger the claim. diff --git a/docs/use/how-to-guides/layer-1/astar-portal/transfer-tokens.md b/docs/use/how-to-guides/layer-1/astar-portal/transfer-tokens.md new file mode 100644 index 0000000..5784464 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/astar-portal/transfer-tokens.md @@ -0,0 +1,263 @@ +--- +sidebar_position: 1 +sidebar_label: Transfer tokens +title: Transfer tokens using the Astar Portal +--- + +# Transfer tokens + +In this tutorial we will guide you through the process of sending and receiving tokens using the Portal. + +
+ +- [How to transfer tokens](#how-to-transfer-tokens) + - [How to Create Astar Accounts (Native and EVM)](#how-to-create-astar-accounts-native-and-evm) + - [Sending ASTR/SDN to Astar Network from Centralized Exchanges](#sending-astrsdn-to-astar-network-from-centralized-exchanges) + - [Sending ASTR/SDN to Centralized Exchanges from Astar Network](#sending-astrsdn-to-centralized-exchanges-from-astar-network) + - [Sending ASTR/SDN to Astar EVM from Astar Native (or any tokens in the account)](#sending-astrsdn-to-astar-evm-from-astar-native-or-any-tokens-in-the-account) + - [Sending ASTR/SDN to Astar Native Accounts from Astar EVM](#sending-astrsdn-to-astar-native-accounts-from-astar-evm) + - [Cross-chain Transfer (XCM)](#cross-chain-transfer-xcm) + - [Transferring cross-chain (XCM) assets to Astar Network](#transferring-cross-chain-xcm-assets-to-astar-network) + - [Transferring cross-chain (XCM) assets to other chains from Astar Network](#transferring-cross-chain-xcm-assets-to-other-chains-from-astar-network) + - [Cross Virtual Machine Transfer Of ERC20 Tokens(XVM)](#cross-virtual-machine-transfer-of-erc20-tokensxvm) + +
+ +## How to Create Astar Accounts (Native and EVM) + +Astar Network supports addresses with two different formats: + +- A Native address is used for dApp staking and interacting with Wasm projects +- An EVM address is used to interact with dApps on the Astar EVM + + +If you would like to create an Astar Native account, [this page] (/docs/use/manage-wallets/create-wallet) will guide you through the process. **LINK TO UPDATE** + +If you have not added yet Astar Network to MetaMask, you can do it quickly and easily on our [Portal](https://portal.astar.network/) by choosing MetaMask from the Select Wallet menu, which should appear automatically. After selection, MetaMask will prompt you for permission to add Astar Network. Alternatively, you can visit [here] (/docs/use/evm-guides/setup-metamask) for details about how to add Astar Network to your wallet manually. **LINK TO UPDATE** + + +
+ +## Sending ASTR/SDN to Astar Network from Centralized Exchanges + +Most Exchanges only support Astar Network (Native) tokens, except Gate.io which supports the Astar (EVM) version. You will need an Astar Native Account to receive ASTR tokens, and from there you can transfer them to an Astar EVM account, should you choose to do so. + +:::tip + +Most centralized exchanges only list 'Astar Network' as a destination, which means Astar Network (Native). + +::: + +:::danger + +**Double check the supported network, if it says Astar (EVM) then you can only transfer tokens to Astar EVM accounts**. + +::: + +1. Visit the Astar [Portal](https://portal.astar.network/). + +2. Connect the network to Astar/Shiden (Astar Network uses ASTR token, and Shiden Network uses SDN). + +network + +3. Connect your Polkadot.js wallet - if you have not done it yet please go back to [Create Astar Accounts] (/docs/use/manage-wallets/create-wallet.md). **LINK TO UPDATE** + +wallet　 + +4. This is the Assets page for your Astar Native Account, where you will see your address near the top of page. Copy the address. + +Account-copy + +5. Visit an exchange that supports ASTR token. Once you've obtained some ASTR, you will be able to initiate a withdrawal from your exchange account to the address above. + +6. Once the withdrawal is complete, revisit the Portal and check your balance. + +
+ +## Sending ASTR/SDN to Centralized Exchanges from Astar Network + +:::tip + +- **Use an Astar Native account to send tokens to exchanges that support Astar Network** +- **Use an Astar EVM account to send tokens to exchanges that support Astar EVM** +- **DO NOT attempt to send from EVM to the exchange native deposit address as this might result in the lost of funds.** + +::: + +:::caution + +In addition to the instructions below, please carefully read the instructions provided by the Exchange, as well (address type, format, and network selection). + +::: + +1. Copy a deposit address from an exchange you wish to make a transfer to. +2. Visit the Astar [Portal](https://portal.astar.network/) and change the network to either Astar or Shiden (Astar Network uses ASTR token and Shiden uses SDN). +3. Connect your wallet (Native or EVM will depend on the exchange) - if you have not done this yet please revisit [Create Astar Accounts] (/docs/use/manage-wallets/create-wallet). **LINK TO UPDATE** +4. Click transfer button. + Native-Asset-transfer +5. Add the destination address of the exchange and the amount you wish to transfer. + Native-local-destination-address + +
+ +## Sending ASTR/SDN to Astar EVM from Astar Native (or any tokens in the account) + +As mentioned above, most exchanges only support Astar Native, and you will need to transfer ASTR tokens to the Astar EVM if you wish to interact with EVM dApps. + +1. Visit the Astar [Portal](https://portal.astar.network/) and copy your Astar EVM address. + account-EVM + +2. Alternatively, open up MetaMask extension and copy your address. + MM + +3. Connect to Astar Native account. + +4. Press the transfer button next to the ASTR token. + ![image](https://user-images.githubusercontent.com/37278708/210126359-b31d52c4-2e5e-4da7-a421-478439e71ba8.png) + +5. You are now on the transfer page. Add the destination address and the amount you wish to transfer, then press the confirm button. + Native-local-destination-address + +
+ +## Sending ASTR/SDN to Astar Native Accounts from Astar EVM + +You can follow the steps below if you would like to transfer ASTR/SDN tokens to Astar Native. + +:::caution + +xcAssets (XCM tokens that are compatible with EVM networks) are non-transferrable to Native accounts, even if at some point in time they originated from a Native account. To convert xcAssets to Astar Native, you would first need to perform a cross-chain transfer (XCM) back to the origin chain, and then another XCM transfer to Astar Native. If you'd like to know more, you can follow [the steps here](#transferring-cross-chainxcm-assets-to-other-chains-from-astar-network). + +::: +:::danger + +**Please note that most exchanges support Astar Native addresses only, so do not use this method to transfer tokens to exchanges unless they specifically support Astar EVM.** + +::: + +1. Visit the Astar [Portal](https://portal.astar.network/) and connect your Astar Native account to copy address you wish to use. + Account-copy + +2. Connect to Astar EVM account by switching chains from the header button. + Switch-to-EVM + +3. Press the transfer button next to the token you wish to send. + EVM-transfer + +4. You are now on the transfer page. Add the destination Astar Native address and the amount you wish to transfer, then press the confirm button. **This transaction will withdraw tokens to an Astar EVM Deposit.** +![image](https://user-images.githubusercontent.com/37278708/210047489-797cbfae-004f-4860-9681-1a2f1390e57b.png) + +5. You will need to withdraw the EVM deposit before you can use the tokens. + +6. Return to your Native account and press the Withdraw button. + EVM-depo + +7. The modal will appear and you can continue with the withdrawal process by signing. + depo-withdraw + +
+ +## Cross-chain Transfer (XCM) + +There are a few things you will need to know before initiating a transfer. + +:::note + +- When transferring native tokens back to origin chains, we recommend leaving a small amount in the account, the avoid the potential for running out of gas for transactions in the future. + +- Min.Balance is applied to most network Native tokens in the Polkadot Ecosystem, and Astar Portal will only initiate transactions for amounts greater than the Min.Balance. + +::: + +
+ +## Transferring cross-chain (XCM) assets to Astar Network + +1. Visit the Astar [Portal](https://portal.astar.network/) and connect your Astar Native Account **(Deposit to Astar EVM is only possible through Astar Native account) ** + +2. Choose the token you wish to deposit to Astar Network. + +3. Click Transfer and move to Transfer Page. Choose the Cross-chain Transfer tab. + Native-XCM + +Polkadot.js supports all parachains, therefore you will be able to view all the assets of other parachains, including DOT. Any assets can be transferred over with just one click. + +:::caution + +Astar has set Polkadot’s DOT Min.balance to 1.1DOT and Min.Transfer Amount to 1.1, so users will need to have at least 2.2DOT + gas to make a minimum transfer. This is to protect user's funds from getting reaped by its Existential Deposit (ED) (more information about ED, please visit [Polkadot Wiki](https://support.polkadot.network/support/solutions/articles/65000168651-what-is-the-existential-deposit-).) + +::: + +4. If you would like tokens to be deposited to an Astar EVM account, then change the destination to Astar (EVM) and input the EVM address. + +Chain-select +XCM-Native-EVM + +1. Enter the amount you would like to send to Astar Network, then press the confirm button. + +2. Finding a history of XCM transactions can be tricky, so the Astar Portal has a browser history, which provides information about transactions you have made. + +history + +
+ +## Transferring cross-chain (XCM) assets to other chains from Astar Network + +1. Visit the Astar [Portal](https://portal.astar.network/) and connect your Native or EVM Account. + +:::tip + +If you wish to move cross-chain (XCM) assets to Astar Native accounts from Astar EVM accounts, you will first need to send tokens back to the origin chain and initiate another cross-chain (XCM) transfer back to your Astar Native account. + +::: + +2. Choose the token you wish to withdraw from Astar Network to another chain. + +3. Click Transfer and move to Transfer Page. Choose the Cross-chain Transfer (XCM) tab. + +4. If you are on Astar EVM, insert the destination address. You will need to use the [origin chain’s address] (https://docs.astar.network/docs/learn/interoperability/xcm/faq#q-where-can-i-find-other-chains-addresses). **[INSERT LINK]** + EVM-XCM + +5. If you are on Astar Native and would like to transfer tokens to a different chain within the same account, you do not need to input the address. Otherwise, enter the address manually if you want to transfer to another account. You may also transfer tokens from another chain to Astar Native by clicking the reverse button. + XCM-reverse + +Input-manually + +6. Enter the amount you would like to transfer, then press the confirm button. + +
+ +## Cross Virtual Machine Transfer Of ERC20 Tokens(XVM) + +:::tip + +This feature is currently available only on Shibuya. + +::: + +1. Connect Metamask to https://portal.astar.network +2. In the top right corner, connect to Shibuya. +3. Go to the Assets page. +4. If the asset that you want to transfer is not displayed, you will need to manually add the contract address. + +![image](https://user-images.githubusercontent.com/37278708/213384226-66737a56-9708-4622-a48c-d41c777a7772.png) + +5. Click “transfer” on the asset that you want to transfer. + +![image](https://user-images.githubusercontent.com/37278708/213384333-d480ba61-057d-4127-9d0b-270e2821ed2f.png) + +6. Enter the destination native address. +7. Enter the amount of tokens that you want to transfer. +8. Click confirm. + +![image](https://user-images.githubusercontent.com/37278708/213384489-cb1419df-f31c-410a-95bd-1d9376899a40.png) + +10. Done. Your ERC20 tokens have been transferred from EVM to Native. +11. Disconnect Metamask and connect the native wallet you sent the tokens to. +12. You should be able to see the XVM ERC20 asset. + +![image](https://user-images.githubusercontent.com/37278708/213384947-72f72fe5-1758-4a21-92f8-47e8fff1d1b3.png) + +12. If the asset is not displayed, you will need to add it manually. +13. You should now be able to transfer the asset from Native to EVM. + diff --git a/docs/use/how-to-guides/layer-1/astar-portal/troubleshooting.md b/docs/use/how-to-guides/layer-1/astar-portal/troubleshooting.md new file mode 100644 index 0000000..d5250ad --- /dev/null +++ b/docs/use/how-to-guides/layer-1/astar-portal/troubleshooting.md @@ -0,0 +1,71 @@ +--- +sidebar_position: 3 +sidebar_label: Troubleshooting +title: Portal Troubleshooting Guide +--- + +import Figure from "/src/components/figure" + +This section will guide you to troubleshoot and solve most issues when connecting to the portal. + +## Can't Connect Wallet To The Portal; + +**Allow Polkadot.js to access the portal** +1. Go to Polkadot.js browser extension. +2. Click on the `Gear` icon. +3. Click on `Manage Website Access`. +4. Make sure `https://portal.astar.network` is allowed. + +**Allow Polkadot.js to be used on Astar/Shiden** +1. Go to Polkadot.js browser extension. +2. Click on the `3 dots`. +3. On the dropdown menu, select `Allow use on any chain`. +4. If you have other extensions installed, please revoke access of those extensions. + +## Getting Errors Or Unable To Execute Certain Functions; +Some of you may be unable to execute certain funtions. Please try these steps. +1. Update metadata (if required). +2. Clear cache, restart browser and connect wallet to the portal again. +3. On the top right corner, switch to a different endpoint. +4. Brave browser is known to give errors. Use Chrome or Firefox instead. +5. Use VPN. + +## Unable To Claim Staking Rewards; +1. If you can't claim the staking rewards on the portal. Visit [HERE] (/docs/use/dapp-staking/for-stakers/manage-dApp-Staking#my-staking-panel). **LINK TO UPDATE** +2. If the transferrable balance in the wallet is too low, you might not be able to claim the staking rewards. Top up your wallet and then claim the rewards. + +## After signing the transaction, the portal spins indefinitely; +1. If the portal spins indefinitely after you've signed a transaction, your transferable balance in the wallet is too low to pay for the transaction. +2. Top up your wallet with new ASTR tokens and you'll be able to complete your transaction. + +## My staking is not displayed on the dApp Staking page of the Astar Portal ; + +
+ +1. Two dApps have been delisted from the dApp Staking and if you were a staker on these dApps, you may not see your staking position on the dApp Staking page. +2. dApps concerned: + - **Arthswap**, contract: `0xE915D2393a08a00c5A463053edD31bAe2199b9e7` + - **Sirius Finance**, contract: `0x9448610696659de8F72e1831d392214aE1ca4838` + - **ADAO**, contract: `0x1de7c3A07918fb4BE9159703e73D6e0b0736CaBC` +3. To release these funds, you must `claim` all your pending ASTR rewards. +4. Once all your pending rewards have been claimed, your tokens will be unlocked without any unbonding period and will become directly transferable. + +## "You do not have enough tokens to pay the transaction fee." + +1. As the sentence indicates, you do not have enough transferable tokens to cover the transaction fees. +2. Top up your wallet with new ASTR or SDN tokens and you'll be able to complete your transaction. +3. Bear in mind that tokens locked in dApp Staking, vesting or reserved balances cannot be used to pay gas fees. + +## "No reponse received from RPC endpoint in 60s." + +
+ +1. If you encounter this problem, it's probably due to a synchronization problem with the RPC endpoint used by the portal. +2. To solve this problem, you need to reset the connection with the RPC by changing the Portal endpoint. +3. On the Astar portal, click on the Astar logo in the top right-hand corner. +4. Under `Network`, expand the **advanced** panel by clicking on the 3 dots. +5. Modify the endpoint and click on the `Change Network` button to confirm your action. + +
+ +If none of the above is helpful, please contact any of the team members or agents on [Discord](https://discord.gg/2FGq5KqwBh). diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/_category_.json b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/_category_.json new file mode 100644 index 0000000..436baed --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "For Devs", + "position": 2 +} diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/create-promotion.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/create-promotion.md new file mode 100644 index 0000000..9f79c4e --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/create-promotion.md @@ -0,0 +1,33 @@ +--- +sidebar_position: 4 +--- + +import Figure from '/src/components/figure' + +# Create a promotion card on top page + +If you have a campaign or new product you would like to share in the community, this will help you spread the news. It will create a card which will be shown on the top of the dApp Staking page as well as the Portal asset page. + +You can create a PR once a month, at most. + +
+ +# Steps for creating a PR for the promotion card + +- Fork our [astar-apps](https://github.com/AstarNetwork/astar-apps) repository. + +- Find a file [dapp_promotion.json](https://github.com/AstarNetwork/astar-apps/blob/main/src/data/dapp_promotions.json) and put a promotion details there. + +- add a promotion image to [public/images/dapp_promotions](https://github.com/AstarNetwork/astar-apps/tree/main/public/images/dapp_promotions) folder. + +- Create a PR to the release-hotfix branch in [astar-apps](https://github.com/AstarNetwork/astar-apps). + + +:::info +- **Image must be 16:9 and recommended size is less than 1MB**. +- **Description is limited to 65 characters maximum**. +- Your PR will be merged after being reviewed by the dApp Staking operation team. +- Card can be removed at any time, for any reason, at the discretion of the operation team. +- Multiple PRs or more than one PR within a month from the same team will not be approved. +::: + diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_1.png new file mode 100644 index 0000000..d92b9ba Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_2.png new file mode 100644 index 0000000..792166e Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_3.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_3.png new file mode 100644 index 0000000..95cfd1d Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_3.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_4.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_4.png new file mode 100644 index 0000000..a750ca1 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Polkadotjs_4.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Project.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Project.png new file mode 100644 index 0000000..f9186d5 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Project.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_1.png new file mode 100644 index 0000000..cbe3471 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_2.png new file mode 100644 index 0000000..a9a2fd8 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_3.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_3.png new file mode 100644 index 0000000..b26316d Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Promotion_card_3.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_1.png new file mode 100644 index 0000000..6b37b09 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_2.png new file mode 100644 index 0000000..7b47932 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_banner.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_banner.png new file mode 100644 index 0000000..7ab15cc Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Registration_banner.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_1.webp b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_1.webp new file mode 100644 index 0000000..9871c06 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_1.webp differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_2.webp b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_2.webp new file mode 100644 index 0000000..0f5bedd Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_2.webp differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_3.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_3.png new file mode 100644 index 0000000..24ed17c Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Subwallet_3.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_1.webp b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_1.webp new file mode 100644 index 0000000..4df7df1 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_1.webp differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_2.webp b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_2.webp new file mode 100644 index 0000000..f6335fb Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_2.webp differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_3.webp b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_3.webp new file mode 100644 index 0000000..fa37c8a Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Talisman_3.webp differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page.png new file mode 100644 index 0000000..1086df8 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page_2.png new file mode 100644 index 0000000..24bc572 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page.png new file mode 100644 index 0000000..e5fc1c8 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page_2.png new file mode 100644 index 0000000..4e7c85e Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_page_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_rewards.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_rewards.png new file mode 100644 index 0000000..d0ecab6 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_rewards.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/index.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/index.md new file mode 100644 index 0000000..1efa1c3 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/index.md @@ -0,0 +1,73 @@ +import Figure from "/src/components/figure" + +# For Developers + +## Overview + +Discover [dApp Staking] (/docs/learn/dapp-staking/), **LINK TO UPDATE** a unique mechanism that allows communities to support their favorite teams by staking ASTR or SDN with them. When staking ASTR or SDN on a dApp, users not only support the development of innovative apps but also receive staking rewards from inflation. + +You can educate yourself more by reading the technical documentation about [dApp Staking] (/docs/learn/dapp-staking/). **LINK TO UPDATE** + +**Are you a product owner and want to list your dApp in our staking mechanism to earn rewards?** + +Please take the following parameters into consideration and make sure you meet the [requirements] (/docs/use/dapp-staking/for-devs/requirements.md): **LINK TO UPDATE** + +:::tip + +Before reading the dApp Staking section for dApp owner, make sure you understand the concept of periods, subperiods and eras, as well as the dApp Staking V3 parameters explained [here] (/docs/learn/dapp-staking/#period--subperiods). **LINK TO UPDATE** + +::: + +### Tier System and Rewards + +dApp Staking introduces the concept of a tier system for dApps. It's important to fully understand the [tier mechanism] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-system) before proceeding with dApp Staking application and registration as a dApp owner. **LINK TO UPDATE** + +Currently, there are **4 tiers** with a limited number of slots per tier. Tier capacity for dApp staking is calculated at the start of each period based on the ASTR price as described [here] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-system). **LINK TO UPDATE** + +The slots allocated to each tier can be viewed on the [dApp Staking Page](https://portal.astar.network/astar/dapp-staking/discover) of the Astar Portal. + +At the end of each **Build&Earn** subperiod, dApps are assigned to a tier based on the total value staked on them by users. Each tier has a **threshold** that a dApp must reach in order to access it. + +The threshold for tier 4 is fixed, but for the other tiers, the threshold is **dynamic** and calculated at the start of each new period based on the total number of slots for the period. To find out more, [click here] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-threshold-entry). **LINK TO UPDATE** + +**Rewards** for dApps are also **dynamic**, fluctuating from tier to tier. The higher the tier, the greater the number of ASTR tokens allocated from inflation as rewards for that tier. + +The rewards of a tier are divided between all available slots and distributed to the dApps occupying slots. This means that the rewards for dApps within a tier are the same for each dApp, even if not all slots within a tier are occupied. + +*Refer to the [dApp staking parameters] (/docs/learn/dapp-staking/protocol-parameters#network-values) page to find out more about the tier system and reward allocation.* **LINK TO UPDATE** + +:::tip +You have to claim your rewards to receive them. We recommend that you claim your rewards at least once a week or, optimistically, 2 or 3 times a week. + + ::: + +:::info + +**Example:** + +- Tier 1 has 5 slots for dApps and 50,000 ASTR tokens are allocated as a reward; +- At the end of the voting subperiod, only 3 slots are occupied by dApps in Tier 1 ; +- These 3 dApps will each receive 10,000 ASTR as reward; +- The remaining 20,000 ASTR tokens will not be minted by the network and will be considered burnt; + +::: + +If there are more dApps eligible for a tier than there is capacity, the dApps with the higher score get the advantage. dApps which missed out on a higher tier get priority for entry into the next lower tier (if there still is any). + +In the case a dApp doesn't satisfy the entry threshold for any tier, even though there is still capacity, the dApp will simply be left out of tiers and won't earn any reward. + +:::warning + +In the event that a dApp is **unregistered** from dApp Staking following a governance decision, all developer unclaimed rewards will become unavailable. We recommend that dApp owners claim their rewards regularly. + +::: + +In case you have any questions, please check the [FAQ page] (/docs/learn/dapp-staking/dapp-staking-faq/) **LINK TO UPDATE** in the Learn section or join our [Discord channel](https://discord.com/invite/astarnetwork). + +### Other pages may be of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + + diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/manage-dApp-Staking.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/manage-dApp-Staking.md new file mode 100644 index 0000000..bff3432 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/manage-dApp-Staking.md @@ -0,0 +1,38 @@ +--- +sidebar_position: 3 +--- + +import Figure from "/src/components/figure" + +# Manage dApp & claim rewards + +As a dApp owner, a new panel will appear in the Asset page of the Astar portal: **Your Project** ; + +
+ +By clicking on your dApp in the **Your Project** panel, you will have access to everything related to your dApp, from claiming developer rewards to editing your project information; + +### Your Dashboard: + +- **Curent Tier:** The current tier to which your dApp has been assigned. See [Tier system] (/docs/use/dapp-staking/for-devs/#tier-system-and-rewards) for more information; **LINK TO UPDATE** +- **Number of stakers:** Total of current stakers on your dApp; +- **Total Earned:** Total tokens received in the dApp Staking program; + +
+ +### Your Rewards: + +Here you can see how many tokens you have earned for past periods and what you still have to `claim`; + +
+ +To claim your tokens, click on the **Claim your rewards** button and sign the transaction with your wallet; +Claiming will release all your pending rewards; + +### Edit: + +- **Edit Project Page:** Allows you to edit information about your dApp Staking projects; +- **Edit your owner info:** If you want to change the registered smart contract address and the address receiving developer rewards ; +- **Add a promotion card:** If you are running a campaign, you can create a promotion card that will be added to the dApp Staking section of the Portal after review; + +
\ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/register-dapp.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/register-dapp.md new file mode 100644 index 0000000..f9f1eef --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/register-dapp.md @@ -0,0 +1,181 @@ +--- +sidebar_position: 2 +--- + +import Figure from "/src/components/figure" + +# Register dApp + +Once you have been approved by the Astar Council under Astar governance, you can take the following steps: + +## Step 1: Native wallet & Verified Smart-contract + +Before you can register your dApp or project, make sure you have : + +#### 1. An [Astar Native developer wallet] (/docs/use/manage-wallets/create-wallet) with some tokens to cover gas fee. *No Ledger hardware wallet or EVM wallet.* **LINK TO UPDATE** + +You can use one of the following wallets: + +
+**[Polkadot.js](https://chrome.google.com/webstore/detail/polkadot%7Bjs%7D-extension/mopnmbcafieddcagagdcbnhejhlodfdd?hl=en)** *(Recommended)* + +The Polkadot\{.js\} plugin provides a reasonable balance of security and usability. It provides a separate local mechanism to generate your address and interact with the Astar portal. We recommend users who are new to our ecosystem and want to create an Astar native address use this wallet. If you don't have the Polkadot JS extension you will receive a popup in our portal when you try to connect your wallet. + +### Install the Browser Plugin + +The browser plugin is available for both [Google Chrome](https://chrome.google.com/webstore/detail/polkadot%7Bjs%7D-extension/mopnmbcafieddcagagdcbnhejhlodfdd?hl=en) (and Chromium-based browsers like Brave) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/polkadot-js-extension). After installing the plugin, you should see the orange and white Polkadot\{.js\} logo in your browser menu bar. + +
+ +### Create Account + +Open the Polkadot\{.js\} browser extension by clicking the logo on the top bar of your browser. You will see a browser popup. + +
+ +Click the big plus button `Create new account`. The Polkadot\{.js\} plugin will then use system randomness to make a new seed for you and display it to you in the form of twelve words. + +
+ +You should back up these words. Please, store the seed somewhere safe, secret, and secure. If you cannot access your account via Polkadot\{.js\} for some reason, you can re-enter your seed through the `Add account menu` by selecting `Import account from pre-existing seed`. + +
+ +Best to create an account that is allowed on any chain in the Polkadot ecosystem including Astar or Shiden Network. Your account will automatically change format when connected to a chain. + +A **descriptive name** is arbitrary and for your use only. It is not stored on the blockchain and will not be visible to other users who look at your address via a block explorer. If you're juggling multiple accounts, it helps to make this as descriptive and detailed as needed. + +The **password** will be used to encrypt this account's information. You will need to re-enter it when using the account for any kind of outgoing transaction or when using it to cryptographically sign a message. + +After clicking on `Add the account with the generated seed`, your account is created. We recommend also saving your account as json file somewhere safe. + +
+ +
+**[Talisman](https://www.talisman.xyz/)** + +### Install the Browser Extension + +The extension is available on [chrome](https://chromewebstore.google.com/detail/talisman-ethereum-and-pol/fijngjgcjhjmmpcmkeiomlglpeiijkld?hl=en-GB) and [firefox](https://addons.mozilla.org/en-US/firefox/addon/talisman-wallet-extension/). + + +### Create a New Account + +Once the extension is downloaded you can proceed to setup your account. + +1. In order to set up a wallet, click `New wallet`. + +
+ +2. Add a password for your account and click `Continue`. + +
+ +3. Last step is to decide on allowing anonymous information to help talisman improve the wallet. Click any option and the setup is finished! + +
+ +### Create a new account in video + +

+ +**Don't forget to Back Up Your Secret Phrase! Consult [this guide](https://docs.talisman.xyz/talisman/start/installing-talisman/back-up-your-secret-phrase) if necessary.** + +
+ +
+**[Subwallet](https://www.subwallet.app/)** + +### Install the Browser Extension + +The extension is available on [chrome](https://chromewebstore.google.com/detail/subwallet-polkadot-wallet/onhogfjeacnfoofkfgppdlbmlmnplgbn) and [firefox](https://addons.mozilla.org/en-US/firefox/addon/subwallet/). + +### Create a New Account + +1. After installing SubWallet extension, open the wallet and choose `Create a new account`; + +
+ +2. Create a master password and click `Continue`; + +
+ +3. Keep your recovery phrase (also known as seed phrase or secret phrase) in a safe place; + +
+ +4. Your account has been successfully set up. Click `Exit` to get to Homepage; + +### Create a new account in video + +

+ +
+ +#### Connect your wallet to Astar Portal + +Visit the [Astar Portal](https://portal.astar.network/astar/assets) and connect your wallet. Once signed in, you'll see your native Astar address on the home page. + +Format: `YQnbw3oWxBnCUarnbePrjFcrSgVPP2jqTZYzWcccmN8fXhd` + +#### 2. Deploy a Smart-Contract in our ecosystem and verify the contract in an explorer. + +1. The first option is to use one of your **own smart contracts** and verify it. + +2. The second option is reserved for those who don't handle smart contracts. Deploy our `helloworld.sol` contract and provide all the information in the header of the contract. [Template contract](https://github.com/AstarNetwork/builders-program/blob/main/hellowold.sol). + +The smart contract can be on Astar Native (WASM) or Astar EVM ([Public Endpoints] (/docs/build/environment/endpoints/#public-endpoints)). *(Not on Astar zkEVM)* **LINK TO UPDATE** + +For the explorer, you can use: +- [Subscan](https://astar.subscan.io/) for Astar Native; +- [Blockscout EVM](https://astar.blockscout.com/) for EVM; + +#### 3. Once the vote is passed, share your addresses with the Astar Foundation. + +You can share your **Astar native address** and the **verified smart-contract address** in the discussion of your dApp Staking application on the [Astar Forum](https://forum.astar.network/); + +The Astar Foundation will whitelist your addresses for dApp Staking registration and inform you that you can proceed to step 2. + +## Step 2: Register your dApp on the Astar Portal + +After whitelisting, visit the dApp Staking page on the [Astar portal](https://portal.astar.network/astar/dapp-staking/discover). + +Connect your native wallet and choose the network on which you are going to register for dApp Staking *(Astar Network or Shiden Network)*; + +
+ +If the wallet has been whitelisted, a banner with a `Register Now` button, like the one below, will appear: + +
+ +Click on **Register Now** and fill in the form with all your project details: + +- Name of your dApp or project; +- Logo (Recommended size 512x512 px); +- Contract addres *(automatically filled)*; +- Project URL; +- At least 4 images of your project (Recommended a images with size 16:9 within 1 MB); +- Builders information (person contributing to the project); +- Description of the project; +- Community links; +- Category and tags; + +
+ +
+ +Once you've filled in all your details, click **Next** button and enter the description that will appear on your **New Listing Card**; + +
+ +Finally, click on **Register** and sign the transaction on the network; + +Congratulations! 🎉 Your project is now listed in dApp Staking and you can start your campaign and communication to attract stakers. + +
+ +:::tip + +When your dApp is deployed, we would appreciate it if you shared this with your community. We have created a template that you can use to write the article. You can find it [here](https://astarnetwork.notion.site/dApp-staking-template-Astar-Network-07d029f2d89644f48a17650522968682). + +::: \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md new file mode 100644 index 0000000..4c8a40b --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md @@ -0,0 +1,80 @@ +--- +sidebar_position: 1 +--- + +import Figure from "/src/components/figure" + +# Requirements + +**Are you a project owner and want to list your dApp in our staking mechanism to earn rewards?** + +Please read these guidelines carefully. If you meet all the requirements, please reach out to us on [Discord](https://discord.com/invite/astarnetwork) or on post your proposal on the [Astar Forum](https://forum.astar.network/). + +:::info + +Astar is aiming to become a DAO in a couple of years. While moving towards becoming a DAO our dApp staking onboarding also includes passing our council. The dApp staking application process is as stated below: +::: + +### Astar Network + +- Your dApp is **launched and live on Astar Network** +- Does your project contribute to Astar TVL? Make sure you are listed on [DefilLama] (/docs/build/integrations/dapp-listing/defillama). **LINK TO UPDATE** +- List your project on [DappRadar] (/docs/build/integrations/dapp-listing/dappradar). **LINK TO UPDATE** +- Your dApp has #astar-network, #dAppStaking tags in your GitHub repo. +- You need to create a PR to the Ecosystem Page. As our website is open-source, you can contribute directly to it - just create a PR on your own! [Here](https://github.com/AstarNetwork/astarwebsite_v2/blob/349db39d724b57f58fbee84b3fa500bf0d29bee6/components/Header.vue) +- If you wish to have your project listed on Astar website [ecosystem page](https://astar.network/community/ecosystem), fill in this [FORM](https://forms.gle/xsGUnCt3fm4isWWF7). +- Create your proposal to join dApp staking on our [forum](https://forum.astar.network/c/initiatives/dapp-staking-applications/21). For creating your proposal, you can take inspiration from the following [template] (/docs/use/dapp-staking/for-devs/requirements#template-for-dapp-staking-application). **LINK TO UPDATE** +- After the proposal is created, we will get the community to discuss. You are expected to answer all the questions. This will take around 4-5 days. +- The voting will be opened after the discussion period. +- For now, only the forum members with `Trust Level 2` and above are allowed to vote. +- After the voting is passed, you are should follow the registration instructions in the [Register dApp] (/docs/use/dapp-staking/for-devs/register-dapp.md) page. **LINK TO UPDATE** + +#### What about infrastructure partners? + +You don’t have any dApp but you are providing infrastructure services to the Astar ecosystem. You also can be added to dApp staking. + +- You already have a long-term partnership with Astar and a close relationship with some projects. +- You have a proven record in our ecosystem. +- You have docs about how to use your tools in our documentation and in yours. You can add instructions to our documentation by creating a PR on our Github. +- Create a proposal to join dApp staking on our [forum](https://forum.astar.network/c/initiatives/dapp-staking-applications/21). For creating your proposal, you can take inspiration from the following [template] (/docs/use/dapp-staking/for-devs/requirements#template-for-dapp-staking-application). **LINK TO UPDATE** +- After the proposal is created, we will get the community to discuss. You are expected to answer all the questions. This will take around 4-5 days. +- The voting will be opened after the discussion period. +- For now, only the forum members with Trust Level 2 and above are allowed to vote. +- After the voting is passed, you are should follow the registration instructions in the [Register dApp] (/docs/use/dapp-staking/for-devs/register-dapp.md) page. **LINK TO UPDATE** + +#### What about other projects who can't meet the above requirements? + +You can't add your project to DefilLama because it's not generating any TVL, also DappRadar is not an option because there is no use of smart contracts? These are the current steps to follow: + +- Be active in our community Discord channel and post your project updates in our dedicated `#project discussion` channel. +- Create a proposal to join dApp staking on our [forum](https://forum.astar.network/c/initiatives/dapp-staking-applications/21). For creating your proposal, you can take inspiration from the following [template] (/docs/use/dapp-staking/for-devs/requirements#template-for-dapp-staking-application). **LINK TO UPDATE** +- After the proposal is created, we will get the community to discuss. You are expected to answer all the questions. This will take around 4-5 days. +- The voting will be opened after the discussion period. +- For now, only the forum members with Trust Level 2 and above are allowed to vote. +- After the voting is passed, you are should follow the registration instructions in the [Register dApp] (/docs/use/dapp-staking/for-devs/register-dapp.md) page. **LINK TO UPDATE** + +### Shiden Network + +- Your dApp is **launched and live on Shiden Network**. +- Does your project contribute to the growth of Shiden it would be great to list your project on DappRadar and or DefilLama. This is not a requirement but it would help grow the trust for your project with our community. +- Infrastructure partners who are contributing to our ecosystem and need to cover their costs can apply to our dApp staking mechanism on Shiden. + +### Template for dApp Staking application + +:::info + +### Title: Project Name - dApp Staking Application + +**Introduction:** Brief introduction of your proposal; +**Project Overview:** Presentation of your project; +**Mission:** What is your mission and what do you want to achieve with your project? You can also share your vision; +**Team:** Introducing the team behind the project and the main contributors. You can share links to personal profiles; +**Security:** Share how you manage the security of your projects and users. You can share audit reports if you have them; +**Past Performance & Milestones:** Describe your latest achievements and the milestones you have reached in your project; +**Roadmap:** Present your plans and the next steps in your project; +**dApp Staking Reward Usage Breakdown:** Describe how you will use the rewards you earn with dApp Staking; +**Appendix:** Links to your projects, products and communities + +Being as specific and detailed as possible in your proposal will help council members to make their decisions, and be sure to answer any questions they may have when discussing your application. + +::: \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/_category_.json b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/_category_.json new file mode 100644 index 0000000..42d07c4 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "For Stakers", + "position": 1 +} diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/1.png new file mode 100644 index 0000000..c70c4b7 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/14_Myrewards.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/14_Myrewards.png new file mode 100644 index 0000000..876d058 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/14_Myrewards.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/15_Unbonding.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/15_Unbonding.png new file mode 100644 index 0000000..7ef9836 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/15_Unbonding.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/16_MydApps.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/16_MydApps.png new file mode 100644 index 0000000..1587219 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/16_MydApps.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/18_projects.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/18_projects.png new file mode 100644 index 0000000..496d837 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/18_projects.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/19_Staking.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/19_Staking.png new file mode 100644 index 0000000..7ebb684 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/19_Staking.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/20_unbonding_modal.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/20_unbonding_modal.png new file mode 100644 index 0000000..4142ae9 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/20_unbonding_modal.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/21_Re-Stake.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/21_Re-Stake.png new file mode 100644 index 0000000..d9c941e Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/21_Re-Stake.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/22_nomination01.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/22_nomination01.png new file mode 100644 index 0000000..d8b28b9 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/22_nomination01.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/23_nomination02.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/23_nomination02.png new file mode 100644 index 0000000..0e6d5aa Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/23_nomination02.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/24_nomination03.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/24_nomination03.png new file mode 100644 index 0000000..b3fb40f Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/24_nomination03.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/8.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/8.png new file mode 100644 index 0000000..7330991 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/8.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/MydApps_Panel_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/MydApps_Panel_1.png new file mode 100644 index 0000000..606d5b7 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/MydApps_Panel_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Networks.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Networks.png new file mode 100644 index 0000000..ffe630c Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Networks.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Projects_page.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Projects_page.png new file mode 100644 index 0000000..fc74403 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Projects_page.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page.png new file mode 100644 index 0000000..3f8b392 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_2.png new file mode 100644 index 0000000..a2fc9c0 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_3.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_3.png new file mode 100644 index 0000000..8c1a60c Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Page_3.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_1.png new file mode 100644 index 0000000..3da8981 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_2.png new file mode 100644 index 0000000..f1c04ae Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Staking_Panel_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_1.png new file mode 100644 index 0000000..7c15cea Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_2.png new file mode 100644 index 0000000..e7954f0 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Unbonding_2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Vote_Page.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Vote_Page.png new file mode 100644 index 0000000..10b9e8b Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Vote_Page.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/index.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/index.md new file mode 100644 index 0000000..1d2df9f --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/index.md @@ -0,0 +1,79 @@ +import Figure from "/src/components/figure" + +# For Stakers + +## Overview + +Do you love to stake? Or do you want to support your favorite project on Astar Network or Shiden Network? + +Discover [dApp Staking] (/docs/learn/dapp-staking/) **LINK TO UPDATE**, a unique mechanism that allows communities to support their favorite teams by staking ASTR or SDN with them. When staking ASTR or SDN on a dApp, users not only support the development of innovative apps but also receive staking rewards from inflation. + +You can educate yourself more by reading the technical documentation about [dApp Staking] (/docs/learn/dapp-staking/). **LINK TO UPDATE** + +:::tip + +Before reading the dApp Staking section for stakers, make sure you understand the concept of periods, subperiods and eras, as well as the dApp Staking V3 parameters explained [here] (/docs/learn/dapp-staking/#understand-the-terminology-and-parameters-of-dapp-staking). **LINK TO UPDATE** + +::: + +### Basic Staking Rewards: + +dApp Staking rewards are generated only if tokens have been staked on a dApp for at least 1 full `Era` and distributed on the following `Era` (Era+1); + +:::tip + +For stakers, if you stake today, you will start earning tomorrow (next era), and the rewards will be distributed the day after tomorrow. +For dApps If you get into a tier today, you will start earning rewards tomorrow (next era) and the rewards will be distributed the day after tomorrow. + +::: + +For stakers, the APR is the same for all stakers, regardless of which dApp they stake on; +For dApps, staking rewards depends on the Tier system, dApps go into rewards tier based on the amount of tokens staked by users. + +Rewards must be claimed before trying to `stake` or `unstake`. +*(If using the Astar Portal, the interface will automatically claim the rewards when trying to stake)* + +If a project is **unregistered** from dApp Staking, staked tokens on that project will still receive **basic rewards** as long as the tokens remain staked. + +:::warning + + There is no rewards during the Unlocking period when unstaking from dApp Staking; + + ::: + +### Bonus Staking Rewards: + +If an user stake on dApp(s) during the **Voting Subperiod** and keep the same staked amount or higher on a dApp through the whole **Build&Earn Subperiod**, they will be eligible for the **Bonus Reward** for this dApp. + +:::info + +**Example** + +- User stake 1500 ASTR on **dApp A** and 1000 ASTR on **dApp B** during the `Voting`subperiod. +- During the `Build&Earn` subperiod, user move 500 ASTR from **dApp B** to **dApp A**; +- He now has 2000 ASTR on **dApp A** and 500 ASTR on **dApp B**, so he's still eligible for the `Bonus reward` for **dApp A** but no longer for **dApp B** because the tokens staked on **dApp** B are less than those staked at the end of the `Voting` subperiod (500 < 1000 ASTR). +- To be eligible for the `Bonus reward` for **dApp B**, the user must stake an additional 500 ASTR on **dApp B** to reach 1000 ASTR. + +::: + +Bonus rewards for a period can only be claimed after the period finishes. + + +### Other: + +- You need to keep a minimum of 10 ASTR or 5 SDN tokens as transferable after staking. +- **You need to claim to receive your rewards, we recommend claiming your staking rewards once a week.** +- When unlocking tokens, there is a unlocking period on Astar and on Shiden. The unlocking period lenghts can be consulted [here] (/docs/learn/dapp-staking/#parameters). **LINK TO UPDATE** +Please note that this is based on a perfect block production of 12s. In case of any delay, your unlocking period can be a little longer. + +In case you have any questions, please check the [FAQ page] (/docs/learn/dapp-staking/dapp-staking-faq/) **LINK TO UPDATE** in the Learn section or join our [Discord channel] (https://discord.com/invite/astarnetwork). **LINK TO UPDATE** + +### Other pages may be of interest: + +
+ +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + + diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/manage-dApp-Staking.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/manage-dApp-Staking.md new file mode 100644 index 0000000..6aa621c --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/manage-dApp-Staking.md @@ -0,0 +1,54 @@ +--- +sidebar_position: 2 +--- + +import Figure from "/src/components/figure" + +# Manage dApp Staking & claim rewards + +Once you have staked, a new panel named **Staking** will appear in the [Assets Page] (https://portal.astar.network/astar/assets). **LINK TO UPDATE** + +### My Staking Panel: + +My Staking Panel is where you track your staking and locked tokens, see your pending rewards and take actions with your tokens and rewards; + +- **Locked amount:** Total amount of tokens locked in the address; + - **Unlock (↑):** Unlock your locked tokens *(subject to [unlocking parameters] (/docs/use/dapp-staking/for-stakers/unstaking#overview)*); **LINK TO UPDATE** + - **Stake (↓):** Stake your locked tokens in dApp Staking; +- **Staked amount**: Total amount of tokens you have staked; +- **Rewards**: Total of the estimated Basic and Bonus rewards; + - **Available**: Basic estimated rewards earned during the **Build&Earn subperiod**; + - **Bonus:** Bonus estimated rewards earned during the **Vote subperiod** if eligible; + +
+ +To claim your rewards, you need to click on the **Claim Button** and sign the transaction; + +If you have a lot of unclaimed rewards (`Eras`), you may have to make several `Claim` calls to receive all your rewards; + +All pending rewards on a dApp must be claimed before staking again. + +### My dApps Panel: + +My dApps Panel is where you can see all dApps you have staked with and manage your stake. + +- **Bonus:** if you are eligible for the [Bonus] (/docs/use/dapp-staking/for-stakers/#bonus-staking-rewards) **LINK TO UPDATE** on this dApps; +- **Move (→) :** you can move staked tokens between different dApps; +- **Add (↓) :** you can add more tokens in dApp staking on the desired dApp; +- **Unlock (↑) :** you can select how many tokens you want to unlock from your staked amount. + +
+ +### Unlocking Panel: + +The unlocking panel is where you can see the progress of unlocking and withdrawing. +For the runtime logic, when unlocking, you don’t unlock from a specific dApp but unlock as `Chunks`. First pending unlocking gives Chunk 1, second pending unlocking gives Chunk 2 etc. + +After you have unstaked and when those ERAs pass, you will be able to withdraw. More information about [Unlocking] (/docs/use/dapp-staking/for-stakers/unstaking/). **LINK TO UPDATE** +The unlocking period lenghts can be consulted [here] (/docs/learn/dapp-staking/#parameters). **LINK TO UPDATE** + +- **Remaining days:** The number of days or `Eras` you have to wait before you can withdraw your tokens; +- **Available to withdraw:** Unlock your tokens and make them `transferable`; +- **Re-lock:** Lock your tokens again to use them in dApp Staking; + +
\ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/move-staked-tokens.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/move-staked-tokens.md new file mode 100644 index 0000000..6bddd21 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/move-staked-tokens.md @@ -0,0 +1,28 @@ +--- +sidebar_position: 3 +--- + +import Figure from "/src/components/figure" + +# Move staked tokens between dApps + +Once your tokens have been staked on a dApp, you always have the option of reconsidering your decisions and moving them to another dApp. + +1) Go to the **Staking Panel** in the [Asset Page] (https://portal.astar.network/astar/assets); **LINK TO UPDATE** +2) Under **My dApps**, click on the **Move button (→)** of the dApp from which you want to move your tokens. + +
+ +3) Select the dApp(s) to which you want to `Move` your tokens and enter the desired amount; + +
+ +4) Confirm your decisions by clicking on the **Confirm Button** and sign the transaction on the network; + +Bear in mind that when you move tokens from one dApp to another, you are `unstaking` from one dApp to `stake` on a new dApp, which therefore has an impact on your rewards for those dApps: + +- If you move tokens from a dApp and your staked tokens are less than the [minimum staking] (/docs/learn/dapp-staking/#parameters) amount for a dApp, all your tokens will be `unstaked` from that dApp; **LINK TO UPDATE** +- If you move your tokens from one dApp to another, you'll lose the **basic staking rewards** for the current `Era` for the dApp you moved, and you won't earn rewards on the new dApp until the next `Era`; +- During the Build&Earn subperiod, if you move your tokens from one dApp to another and your staked tokens on the initial dApp at the end of the **Build&Earn subperiod** are less than your staked tokens at the end of the **Voting subperiod** for the same dApp, you will no longer be eligible for the **Bonus Rewards** for that dApp; + +Typically, users only receive rewards for stakes that have been present throughout the entire `Era`, from the first to the last block. In a runtime logic, the protocol does not distribute rewards to a user who started staking in the last block of the `Era` compared to a user who staked throughout the entire `Era`. diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md new file mode 100644 index 0000000..ccad354 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md @@ -0,0 +1,77 @@ +--- +sidebar_position: 1 +--- + +import Figure from "/src/components/figure" + +# How to stake + +:::warning + + To earn rewards continuously, users have to vote and stake **every [new period] (/docs/use/dapp-staking/for-stakers/#periods-subperiods--eras).** **LINK TO UPDATE** + + ::: + +At the end of a Period, tokens are unstaked from all dApps, remain locked on the account but must be staked back on dApps for the new Period. + +### Visit dApp Staking on the Portal + +Go to the [Astar Portal] (https://portal.astar.network/astar/dapp-staking/discover): **LINK TO UPDATE** and click on the `dApp Staking` page. + +Make sure you are connected to the correct network. +- **Shibuya Network**: testnet +- **Shiden Network**: mainnet on Kusama +- **Astar Network**: mainnet on Polkadot + +
+ +### Discover Projects + +:::tip + +Staked TVL and Project Leaderboards are available at the top of the page. + + +::: + +Click on the project cards for more information, access to their communities or to view team profiles. You can also find useful resources on our [forum](https://forum.astar.network/) or check [DefilLama](https://defillama.com/) or [DappRadar](https://dappradar.com/). + +
+ +### Vote & Stake + +:::important + +Before using dApp Staking, make sure you understand all the parameters and rules described [here] (/docs/learn/dapp-staking/#parameters). **LINK TO UPDATE** +An address can only stake on a maximum of 16 contracts (dApps). +::: + +1) On the [dApp staking](https://portal.astar.network/astar/dapp-staking/discover) page, you can either: + +- Click on the `Vote/Stake today` button; +- Select your favorite project and click on the `Vote & Stake` button on the project page; + +
+ +2) Once on the voting page, you can choose up to 16 projects that you would like to support; + + +
+ +3) To stake, enter the desired amount of tokens for the dApp(s) you have chosen. This may be the same or a different amount for each. + +:::tip + +Make sure to always keep some tokens free for gas manage to claim your rewards. + +::: + +
+ +:::note + +You can see how many tokens you have available to stake from **transferable** or **locked balances** in the section above the `Confirm` button; + +::: + +5) Confirm your decisions by clicking on `Confirm` and sign the transaction on the network; diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/unstaking.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/unstaking.md new file mode 100644 index 0000000..e780008 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/unstaking.md @@ -0,0 +1,76 @@ +--- +sidebar_position: 4 +--- + +import Figure from "/src/components/figure" + +# Unstaking from dApps + +## Overview + +**Locking** is a process by which tokens are temporarily `locked`. Staking is one of the scenarios that require tokens to be bonded. +**Unlocking** is the action of telling the network that you want to unlock these tokens. After the unlocking period, you can withdraw the tokens, and they become `transferable`. + +Please note that this is based on a perfect block production of 12s. In case of any delay, your unlocking period can be a little longer. +The unlocking period lenghts can be consulted [here] (/docs/learn/dapp-staking/#parameters). **LINK TO UPDATE** + +:::warning + +When you unlock or unstake your tokens from dApps Staking, you won’t earn rewards during the unlocking period! + +::: + +### How to unlock staked tokens: + +If you have staked on one of the dApp(s), you can now click on `Unlock` from **My dApps Panel** in the [Asset Page](https://portal.astar.network/astar/assets) to make your tokens transferables. + +
+ +1) Click on the **Unlock button (↑)** on the dApp you want to unstake from; + +2) Select the amount you want to **Unlock**, or click on **Max** to `unlock` your complete stake. + +3) To sign your transaction, click on **Start Unlocking**. + +:::tip + +If you `unstake` some of your tokens from a dApp and your remaining tokens are below the minimum staking amount for a dApp, all your tokens will be unstaked from that dApp; +If you `unstake` your tokens from one dApp during the Build&Earn subperiod and your staked tokens on this dApp are less than your staked tokens at the end of the Voting subperiod for the same dApp, you will no longer be eligible for the Bonus Rewards for that dApp; + +::: + +
+ +When unlocking tokens, a new window appears in your Staking Panel: **Unlocking**. + +
+ +- **Remaining Days** gives you an estimation on how many days or `Eras` you have to wait before being able to withdraw your tokens. +- When your unlock period is over, you need to withdraw your funds by clicking on the **withdraw button**. Sign the transaction and your tokens will be made transferrable in your wallet. + +**Chunks** + +Each unlocking is called a Chunk. But what is a Chunk? + +An unlocking chunk is some amount of ASTR that is undergoing the unlocking period. + +***E.g.***: One chunk can be described as: *"1000 ASTR is undergoing the unlocking period and will be available for transfer on block 42000000"*. + +### How to unlock locked tokens: + +If you have tokens that are still locked but not in staking, you can unlock them to make them transferable. + +:::note + +These tokens will always be subject to the unlocking period. + +::: + +In the **My Staking Panel** on the [Asset Page](https://portal.astar.network/astar/assets), you may have tokens under **Locked amount**, which are tokens that are not staked but could be unlocked. + +1) To release them, click on **Unlock (↑)**, which will trigger a transaction to `unlock` them all. + +
+ +2) At the end of the unlocking period, you can withdraw them by clicking on the **withdraw button**. +3) Sign the transaction and your tokens will be made transferrable in your wallet. diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/index.md b/docs/use/how-to-guides/layer-1/dapp-staking/index.md new file mode 100644 index 0000000..6440155 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/dapp-staking/index.md @@ -0,0 +1,27 @@ +--- +sidebar_position: 2 +sidebar_label: dApp Staking +title: Astar dApp Staking +--- + +## What is dApp Staking + +dApp staking on Astar and Shiden Network introduces a novel approach, empowering individuals to nominate their ASTR or SDN tokens to support dApps building on the network. + +For every block produced on the network, a segment of inflation is specifically allocated to dApp staking. These rewards are then divided between the dApp developers and stakers involved, offering benefits to both developers and stakers. + +As a dApp gains popularity and attracts more stakers, the developers stand to receive a greater share of block rewards. Importantly, the dApp staking program is inclusive, accommodating projects utilizing EVM and Wasm technologies, along with zkEVM dApps. + +For a more detailed explanation of dApp Staking, refer to the comprehensive presentation in the [Learn section] (/docs/learn/dapp-staking/). **LINK TO UPDATE** + +### User & Developers guides + +In the following sections, you'll find all the help you need to interact with dApp Staking as a staker or dApp owner. + +You will also find guides for dApp Staking V2 for reference until the full transition to dApp Staking V3. + + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/arthswap.md b/docs/use/how-to-guides/layer-1/get-astr-token/arthswap.md new file mode 100644 index 0000000..f5fd608 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/get-astr-token/arthswap.md @@ -0,0 +1,43 @@ +--- +sidebar_position: 1 +sidebar_label: Arthswap +title: Buying ASTR on a DEX using Arthswap +--- + +import Figure from "/src/components/figure" + +There are a few DEXs that are built on Astar Network. Arthswap is one of them. Arthswap is built on EVM, therefore we need to interact in the EVM environment. + +## Setup MetaMask + +Go Metamask extension -> Settings -> Network -> Add Network + +Use this Custom RPC below: + +**Network**: Astar
+**RPC**: [https://evm.astar.network](https://evm.astar.network)
+**Chain ID**: 592
+**Symbol**: ASTR
+**Explorer**: [https://blockscout.com/astar](https://blockscout.com/astar) + +## Bridge Ethereum Assets To Astar Network + +To buy ASTR, you need to have other assets which you can use to swap. One way to do that is to bridge your Ethereum assets such as wETH, USDT and USDC to Astar Network. + +1. Go to [http://app.arthswap.org/#/swap](http://app.arthswap.org/#/swap) +2. Click on “Bridge” and you will be taken to [https://cbridge.celer.network/#/transfer](https://cbridge.celer.network/#/transfer) +3. Go to “Transfer”, select “From Ethereum” and “To Astar” and connect Metamask. +4. Select the asset that you would like to bridge e.g USDT. +5. Click “Transfer” and you will have USDT on Astar Network. +6. You will have to pay the bridge fee and you will also receive some ASTR tokens for gas fees which you need when interacting on Astar Network. + +
+ +## Swap On Arthswap + +1. Go back to [http://app.arthswap.org/#/swap](http://app.arthswap.org/#/swap) and connect Metamask wallet. +2. Select swap USDT to ASTR and enter the amount you want. +3. Execute the swap and sign the transaction. +4. You now have ASTR tokens in your wallet. + +After having ASTR if your Metamask, you can send it to Polkadot.js if you want to dApp stake. Please refer the previous tutorials. diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/25.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/25.png new file mode 100644 index 0000000..acdd92c Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/25.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/26.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/26.png new file mode 100644 index 0000000..d4d7b15 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/26.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/27.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/27.png new file mode 100644 index 0000000..6a4bfb5 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/27.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/28.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/28.png new file mode 100644 index 0000000..42bf4fb Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/28.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/29.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/29.png new file mode 100644 index 0000000..bb5ae98 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/29.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/img/30.png b/docs/use/how-to-guides/layer-1/get-astr-token/img/30.png new file mode 100644 index 0000000..c7a2322 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/get-astr-token/img/30.png differ diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/index.md b/docs/use/how-to-guides/layer-1/get-astr-token/index.md new file mode 100644 index 0000000..f14f7a4 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/get-astr-token/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 3 +sidebar_label: Get ASTR tokens +title: Get ASTR tokens +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-1/get-astr-token/xy-finance.md b/docs/use/how-to-guides/layer-1/get-astr-token/xy-finance.md new file mode 100644 index 0000000..e85f2c3 --- /dev/null +++ b/docs/use/how-to-guides/layer-1/get-astr-token/xy-finance.md @@ -0,0 +1,47 @@ +--- +sidebar_position: 2 +sidebar_label: XY Finance +title: "Cross-Chain Swap : XY Finance" +--- + +## Swap Cross-Chain Assets from Major EVM Chains to Astar + +In this tutorial, we will guide you through the process for making a cross-chain swap from at least 12 EVM chains to Astar. + +## Visit XY Finance’s X swap page + +XY Finance is a one-stop cross-chain swap aggregator for DeFi & Metaverse, allowing users to directly buy ASTR and other tokens on Astar from other chains in one transaction. Currently, XY Finance supports 12 EVM chains, including Ethereum, BSC, Fantom, Polygon, Arbitrum, Optimism, Avalanche C-Chain, Cronos, KCC, ThunderCore, Astar, and Moonriver. + +## Connect Wallet + +Click the “Connect Wallet” button. + +Before you explore the straightforward features offered by XY Finance, you will need to connect your wallet. XY Finance currently supports Metamask and WalletConnect on desktop browsers, with more types of wallets supported on mobile. + +![26](img/26.png) + +## Swap token + +Choose the token you want to swap on your source chain and the token you want to receive on the Astar. Here, we’re going to swap USDT on Polygon to ASTR on Astar as an example. With the service offered by XY Finance, EVM users can directly acquire ASTR in one transaction. + +## Enter token amount + +Enter the amount of USDT you want to swap. + +![27](img/27.png) + +Double-check the recipient's address. XY Finance will display your connected wallet address by default and it also allows you to change the recipient address. + +![28](img/28.png) + +Click the “Approve to Swap” button, and your wallet will ask you to confirm the action. + +![29](img/29.png) + +# Swap + +Click the “ Swap” button, and your wallet will ask you to confirm the action again. Confirm your transaction from your wallet. + +![30](img/30.png) + +You will receive your ASTR on Astar Network in a few minutes. diff --git a/docs/use/how-to-guides/layer-1/index.md b/docs/use/how-to-guides/layer-1/index.md new file mode 100644 index 0000000..ce8658d --- /dev/null +++ b/docs/use/how-to-guides/layer-1/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 1 +sidebar_label: Astar Layer 1 +title: Interact with Astar Layer 1 (Substrate) +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/ASTR-Liquid-Staking.md b/docs/use/how-to-guides/layer-2/ASTR-Liquid-Staking.md new file mode 100644 index 0000000..22e2dcd --- /dev/null +++ b/docs/use/how-to-guides/layer-2/ASTR-Liquid-Staking.md @@ -0,0 +1,78 @@ +--- +sidebar_position: 3 +sidebar_label: ASTR Liquid dApp Staking +title: ASTR Liquid dApp Staking with Bifrost Finance +--- + +import Figure from "/src/components/figure" + +This page explains how to participate in Astar dApp Staking via Bifrost Liquid Staking solution on **Astar zkEVM**. +[More information about dApp Staking] (/docs/use/dapp-staking/index/). **LINK TO UPDATE** + +If you have `ASTR` on Astar L1 (Subtrate or EVM), consult [this guide] (/docs/use/zkevm-guides/Bridge-Astar-EVM/) to transfer them from Astar to Astar zkEVM. **LINK TO UPDATE** + +## Bifrost Finance + +*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.* + +[Bifrost](https://bifrost.app/) is a modular, scalable, non-custodial omnichain liquid staking parachain based on Polkadot. It provides standardized, high-yield, safe, and reliable underlying interest-bearing assets for Web3 through XCM, and is realizing the omnichain vision of using any LST on the any chain. [More information](https://docs.bifrost.finance/). + +Bifrost is accessible on Astar zkEVM via its [SLPx Omichain protocol](https://omni.ls/) (OmiLS), a cross-chain mechanism enabling LSD tokens to be minted on Bifrost parachain from EVM chains such as Astar EVM or Astar zkEVM. + +The Liquid Staking version of the ASTR token is called **vASTR** (voucher ASTR) is a shadow token of staked ASTR, with fully underlying ASTR reserve and yield-bearing feature of ASTR dApp staking reward. Users can deposit ASTR into Bifrost OmniLS protocol on Astar zkEVM and get vASTR as return, vASTR can be traded in the open market or be redeemed back to ASTR. Holding vASTR equals to holding the ASTR staking position, staking rewards appreciate the exchange price of vASTR. + +:::info +Bifrost charges a 10% commission on staking rewards. +::: + +## How to stake ASTR & receive vASTR: + +1. Visit [Bifrost OmniLS](https://omni.ls/), select `vASTR` and connect your EVM wallet on **Astar zkEVM** network; + +
+ +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; + +4. Click on `Stake Now` to initiate the transaction and sign it 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. + +
+ +:::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; + +
+ +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);* + +
+ +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**; +::: + +
+ +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. \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/bridge/Bridge-Astar-EVM.md b/docs/use/how-to-guides/layer-2/bridge/Bridge-Astar-EVM.md new file mode 100644 index 0000000..58b9c5f --- /dev/null +++ b/docs/use/how-to-guides/layer-2/bridge/Bridge-Astar-EVM.md @@ -0,0 +1,73 @@ +--- +sidebar_position: 3 +title: Bridge From Astar EVM to Astar zkEVM +--- + +import Figure from "/src/components/figure" + +# Bridge Assets to Astar zkEVM from Astar EVM + +This page explains how to transfer `ASTR` between **Astar EVM** and **Astar zkEVM**. +If you have `ASTR` on Astar native (Substrate) instead, consult [this guide] (/docs/use/manage-assets/transfer-tokens#sending-astrsdn-to-astar-evm-from-astar-native-or-any-tokens-in-the-account) to transfer them from Astar native to Astar EVM. **LINK TO UPDATE** + +## Transfer using Stargate: + +**[Stargate](https://stargate.finance/transfer)** is a community-driven organization building fully composable native asset bridges on LayerZero. [More information](https://stargateprotocol.gitbook.io/stargate/v/user-docs). + +*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.* + +Visit [Stargate application](https://stargate.finance/transfer) and connect your EVM wallet; + +
+ +### 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.* + +
+ +:::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. + +
+::: + +4. Sign the transaction in your wallet; + +
+ +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: + +:::warning +Please note that it takes around **6 hours** to complete a transfer 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.* + +
+ +:::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. + +
+::: + +4. Sign the transaction in your wallet; + +
+ +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. \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/bridge/Bridge-Ethereum.md b/docs/use/how-to-guides/layer-2/bridge/Bridge-Ethereum.md new file mode 100644 index 0000000..ad1bc55 --- /dev/null +++ b/docs/use/how-to-guides/layer-2/bridge/Bridge-Ethereum.md @@ -0,0 +1,101 @@ +--- +sidebar_position: 2 +title: Bridge From Ethereum to Astar zkEVM +--- + +import Figure from "/src/components/figure" + +# Bridge Assets to Astar zkEVM from Ethereum and other EVM-based chains + +This page explains how to transfer `ETH` and other `ERC20` assets between **Astar zkEVM** and **Ethereum Mainnet** and other EVM-based chains. There are two options for bridging assets to the zkEVM: + +## 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; + +
+ +2. Use the network modal window and switch to the Astar zkEVM network, or let MetaMask switch to Astar zkEVM for you; + +
+ +3. Click on the Bridge tab on the left and select `Native Bridge` (_ERC20_); + +
+ +### 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; + +
+ +2. Sign the transaction in your wallet; +3. You should now see the bridged assets in MetaMask for use on Astar zkEVM. + +
+ +:::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; + +
+ +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; + +
+ + +5. Sign the transaction in your wallet; +6. You should now see the bridged assets in MetaMask for use on Ethereum. + +
+ +:::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. +::: + +## 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). + +*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.* + +:::info +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; + +
+ +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`; + +
+ +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. \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_1.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_1.png new file mode 100644 index 0000000..2a6863b Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_1.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_2.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_2.png new file mode 100644 index 0000000..ceeb121 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_2.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_3.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_3.png new file mode 100644 index 0000000..c6c37da Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Layerswap_3.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_1.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_1.png new file mode 100644 index 0000000..5df5ec8 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_1.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_2.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_2.png new file mode 100644 index 0000000..4917508 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_2.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_3.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_3.png new file mode 100644 index 0000000..6c824b3 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_3.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_4.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_4.png new file mode 100644 index 0000000..e0f51ee Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_4.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_5.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_5.png new file mode 100644 index 0000000..ddc0737 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_5.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_6.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_6.png new file mode 100644 index 0000000..1429ef1 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_6.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_7.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_7.png new file mode 100644 index 0000000..2a93e97 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_7.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_8.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_8.png new file mode 100644 index 0000000..43a4000 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Portal_8.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_1.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_1.png new file mode 100644 index 0000000..9e61a5e Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_1.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_2.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_2.png new file mode 100644 index 0000000..83684a7 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_2.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_3.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_3.png new file mode 100644 index 0000000..1c90db5 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_3.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_4.png b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_4.png new file mode 100644 index 0000000..1ffd75d Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Bridge_ETH_Relaylink_4.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_1.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_1.png new file mode 100644 index 0000000..35cfa21 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_1.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_2.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_2.png new file mode 100644 index 0000000..59528e4 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_2.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_3.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_3.png new file mode 100644 index 0000000..619f5f9 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_3.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_4.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_4.png new file mode 100644 index 0000000..bca5e67 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_4.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_5.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_5.png new file mode 100644 index 0000000..a3601ec Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_5.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/img/Stargate_6.png b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_6.png new file mode 100644 index 0000000..cb496dc Binary files /dev/null and b/docs/use/how-to-guides/layer-2/bridge/img/Stargate_6.png differ diff --git a/docs/use/how-to-guides/layer-2/bridge/index.md b/docs/use/how-to-guides/layer-2/bridge/index.md new file mode 100644 index 0000000..9c8c0f3 --- /dev/null +++ b/docs/use/how-to-guides/layer-2/bridge/index.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 2 +sidebar_label: Bridge +title: Bridge Assets to Astar zkEVM +--- + +## Head Title + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_1.png b/docs/use/how-to-guides/layer-2/img/Bifrost_1.png new file mode 100644 index 0000000..fd73cc9 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_1.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_2.png b/docs/use/how-to-guides/layer-2/img/Bifrost_2.png new file mode 100644 index 0000000..3021e96 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_2.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_3.png b/docs/use/how-to-guides/layer-2/img/Bifrost_3.png new file mode 100644 index 0000000..d11d4b6 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_3.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_4.png b/docs/use/how-to-guides/layer-2/img/Bifrost_4.png new file mode 100644 index 0000000..5c4858c Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_4.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_5.png b/docs/use/how-to-guides/layer-2/img/Bifrost_5.png new file mode 100644 index 0000000..0406784 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_5.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Bifrost_6.png b/docs/use/how-to-guides/layer-2/img/Bifrost_6.png new file mode 100644 index 0000000..d8a5d2a Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Bifrost_6.png differ diff --git a/docs/use/how-to-guides/layer-2/img/Setup_zkevm_1.png b/docs/use/how-to-guides/layer-2/img/Setup_zkevm_1.png new file mode 100644 index 0000000..73dd132 Binary files /dev/null and b/docs/use/how-to-guides/layer-2/img/Setup_zkevm_1.png differ diff --git a/docs/use/how-to-guides/layer-2/index.md b/docs/use/how-to-guides/layer-2/index.md new file mode 100644 index 0000000..40b3564 --- /dev/null +++ b/docs/use/how-to-guides/layer-2/index.md @@ -0,0 +1,18 @@ +--- +sidebar_position: 2 +sidebar_label: Astar Layer 2 +title: Interact with Astar Layer 2 (Astar zkEVM) +--- + +## What is Astar zkEVM + +Astar zkEVM is Layer 2 scaling solution for Ethereum offering a blazing fast and more cost-effective experience compared to Ethereum itself. Coupled with support from Polygon, it's the first network to plug into the Aggregation Layer (AggLayer) and harnesses the power of zero-knowledge proofs to move transaction execution and data availability off-chain, while continuing to operate under the same security umbrella as Ethereum. + +For a more detailed explanation of Astar zkEVM, refer to the comprehensive presentation in the [Learn section] (/docs/learn/zkEVM/). **LINK TO UPDATE** + +## Pages of interest: + +import DocCardList from '@theme/DocCardList'; +import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; + + \ No newline at end of file diff --git a/docs/use/how-to-guides/layer-2/set-up-zkevm.md b/docs/use/how-to-guides/layer-2/set-up-zkevm.md new file mode 100644 index 0000000..9cc541d --- /dev/null +++ b/docs/use/how-to-guides/layer-2/set-up-zkevm.md @@ -0,0 +1,36 @@ +--- +sidebar_position: 1 +title: How to setup Astar zkEVM Network +sidebar_label: Set-up Astar zkEVM Network +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import Figure from "/src/components/figure" + +# How to setup Astar zkEVM Network + +## Automatically + +To automatically add **Astar zkEVM** networks to your wallet, you can use one of the following options: +- **[Astar Portal](https://portal.astar.network/astar-zkevm)** - When you switch to Astar zkEVM, the portal will prompt you to change and add the network to your EVM wallet; +- **[ChainList](https://chainlist.org/)** - You can find Astar zkEVM on ChainList *(ID: `3776`)* and add it to your EVM wallet; +- **[Astar zkEVM Block Explorer](https://astar-zkevm.explorer.startale.com/)** - At the bottom of the Block Explorer page, you can find an option to add Astar zkEVM to your wallet; + +## Manually + +To add **Astar zkEVM** network to MetaMask or any other EVM wallet, enter the following data : + + + + +| Name | RPC URL | ChainID | Block Explorer URL | Currency | +| ---- | ------------------------------- | ---------------- | ---------------- | ----- | +| **Astar zkEVM Network** | `https://rpc.startale.com/astar-zkevm` | `3776` | [https://astar-zkevm.explorer.startale.com/](https://astar-zkevm.explorer.startale.com/) | **ETH** | +| **Astar zkEVM Network** | `https://rpc.astar-zkevm.gelato.digital` | `3776` | | **ETH** | +| **Astar zkEVM Network** | `https://astar-zkevm-rpc.dwellir.com` | `3776` | | **ETH** | + + + + +
\ No newline at end of file diff --git a/docs/use/index.md b/docs/use/index.md index 732625d..e2b7a49 100644 --- a/docs/use/index.md +++ b/docs/use/index.md @@ -1,5 +1,5 @@ --- -title: Use +title: Use Astar Network position: 1 ---