Part 1

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**

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';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>

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';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>

docs/use/get-started/astar-evm-wallet/wallet/ledger/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Ledger",
+    "position": 2
+}

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:
+
+<TabItem value="astar" label="Astar Network" default>
+    |   | 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/ |
+</TabItem>
+<br></br>
+
+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. 
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-live-ethereum.png').default} width="80%" />
+
+After this step, you should have the Ethereum app installed:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app.png').default} width="60%" />
+
+
+## Connecting your Ledger device to MetaMask
+
+1. In MetaMask menu, select **Connect Hardware wallet**;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_2.png').default} width="70%" />
+
+2. On the next screen select **Ledger** and click **Continue**;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_3.png').default} width="70%" />
+
+3. Pair and **Connect** your Device when prompted by the browser;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_4.png').default} width="70%" />
+
+4. Select an account you wish to connect and click **Unlock**;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_5.png').default} width="70%" />
+
+5. You should now see your account and balance:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_6.png').default} width="70%" />
+
+# 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;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/ledger-ethereum-app_7.png').default} width="80%" />
+
+4. When your Ledger device screen is showing `Application is ready`, click **Confirm** in MetaMask;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/3-ApplicationIsReady.jpg').default} height='200px' />
+
+5. Review the transaction on your Ledger device;
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/4-ReviewTransaction.jpg').default} height='200px' />
+
+    a) Check amount:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/5-AmountASTR1.jpg').default} height='200px' />
+
+    b) Check receiving address:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/6-Address.jpg').default} height='200px' />
+    c) Check network:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/7-Network_Astar.jpg').default} height='200px' />
+
+    d) Check Fees:
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/9-MaxFees_ASTR.jpg').default} height='200px' />
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/11-AcceptAndSend.jpg').default} height='200px' />
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/ledger/img/12-Reject.jpg').default} height='200px' />
+
+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**.

docs/use/get-started/astar-evm-wallet/wallet/metamask/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Metamask",
+    "position": 1
+}

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.

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.
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_1.png').default} width="50%" /> 
+
+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.
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_2.png').default} width="100%" /> 
+
+Click on **Import Tokens** in MetaMask popup.
+
+<Figure src={require('/docs/use/get-started/astar-evm-wallet/wallet/metamask/img/XC20_EVM_3.png').default} width="100%" /> 
+
+
+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]**

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.
+
+<br />
+
+Adding Astar Network to Metamask is very easy.
+<br />
+
+1. You will just need to go to [our Portal](https://portal.astar.network/) and try to connect to Metamask.
+
+<img width="1000" alt="Screenshot 2022-09-06 at 14 08 21" src="https://user-images.githubusercontent.com/77480847/188554147-02f09f39-6051-4f7f-8e6f-d263867afb88.png" /><br />
+<br />
+
+2. Metamask will pop-up and ask you if you would like to add Astar Network. Please check the info and approve.<br />
+
+<img width="400" alt="Screenshot 2022-09-06 at 14 33 44" src="https://user-images.githubusercontent.com/77480847/188554595-bd9b0a82-5d15-4420-9eda-44c32418d2a1.png" />
+
+<br />
+
+:::note
+Alternatively, you can also set it up manually by giving information bellow.
+<br />
+Network Details<br />
+Network Name: Astar Network Mainnet<br />
+Network URL: https://evm.astar.network<br />
+Chain ID: 592<br />
+Currency Symbol: astr<br />
+Block Explorer URL: https://blockscout.com/astar
+
+:::

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';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>

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';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>

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!

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';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>