AstarNetwork · Juminstock · Jun 3, 2025 · May 14, 2025 · May 21, 2025 · May 21, 2025
diff --git a/.gitignore b/.gitignore
@@ -21,6 +21,7 @@ yarn-error.log*
 
 # yarn v2
 .yarn/*
+.yarnrc.yml
 !.yarn/cache # Uncomment for zero-install
 !.yarn/releases
 !.yarn/plugins

diff --git a/.yarn/releases/yarn-1.22.19.cjs b/.yarn/releases/yarn-1.22.19.cjs
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
@@ -53,6 +53,12 @@ An address can only stake on a maximum of 16 contracts (dApps).
 
 <Figure src={require('/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/img/Vote_Page.png').default } width="100%" /> 
 
+:::important
+
+**Your available balance** represents the balance available for staking and includes tokens locked in governance.
+
+:::
+
 2) You can choose up to 16 projects that you would like to support;  
 After making your selection, click `Done` to proceed to the next step;
 

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
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 sidebar_label: Arthswap
 title: Buying ASTR on a DEX using Arthswap
 ---

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
@@ -0,0 +1,7 @@
+---
+sidebar_position: 1
+sidebar_label: Get ASTR tokens
+title: Get ASTR tokens on a DEX or CEX
+---
+
+## Introduction
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/_category_.json b/docs/use/how-to-guides/soneium/dapp-staking/_category_.json
@@ -0,0 +1,5 @@
+{
+    "label": "dApp Staking",
+    "position": 2
+}
+
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/images/astake-soneium.jpeg b/docs/use/how-to-guides/soneium/dapp-staking/images/astake-soneium.jpeg
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/images/neemo-soneium.jpeg b/docs/use/how-to-guides/soneium/dapp-staking/images/neemo-soneium.jpeg
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/index.md b/docs/use/how-to-guides/soneium/dapp-staking/index.md
@@ -0,0 +1,22 @@
+---
+title: How to do staking on Soneium
+---
+
+## 1. Overview
+
+This section provides a practical guide to **Astar dApp Staking** on **Soneium** and how to participate in the mechanism. It also explains the applications that offer this service and the important role the **ASTR** token plays in the entire process. You’ll learn about **Astar Network’s** revolutionary staking mechanism.
+
+## 2. What you'll learn
+
+- What **Astar dApp Staking** is and how it works on **Soneium**
+- The applications that offer this service on Soneium
+- How to use your ASTR tokens on Soneium to stake
+
+> You’ll dive into the exciting world of Astar’s dApp Staking on Soneium! Whether you’re a user, developer, or dApp owner, this system rewards both creators and consumers while offering funding opportunities.
+
+## 3. Learn more
+
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/stake-on-soneium.md b/docs/use/how-to-guides/soneium/dapp-staking/stake-on-soneium.md
@@ -0,0 +1,117 @@
+---
+sidebar_position: 1
+sidebar_label: How to stake on Soneium
+title: How to stake on Soneium
+description: Step-by-step guide to staking on Soneium.
+---
+
+import Figure from "/src/components/figure"
+
+## 1. Overview
+
+In this guide, you’ll learn how to participate in **Astar dApp Staking** on **Soneium** using [**Neemo Finance**](https://neemo.finance/) or [**Astake**](https://www.astake.dev/). This practical guide will explain how you can take part in this mechanism using your **ASTR**.
+
+To complete this tutorial, you’ll need:
+
+- A wallet that supports the **EVM** format (we’ll use [**Zerion**](https://zerion.io/))
+- The **Soneium network** added to your wallet so you can view your funds
+- **ASTR** tokens on the Soneium network in your wallet
+
+:::info Wallet Setup
+
+To configure your wallet with the Soneium network, follow [**this guide**](https://docs.soneium.org/docs/users/wallets) from the official docs.
+
+:::
+:::tip Get ASTR tokens
+
+If you want to acquire ASTR tokens on the Soneium using your local currency, use [**Alchemy Pay**](https://ramp.alchemypay.org/#/index).
+
+Also, learn how to transfer tokens to Soneium from Astar [**here**](/docs/use/how-to-guides/soneium/transfer-tokens/from-astar-to-soneium.md). If you hold assets on other chains, learn how to transfer them to Soneium [**here**](/docs/use/how-to-guides/soneium/transfer-tokens/from-ethereum-to-soneium.md).
+
+:::
+
+This guide assumes you already:
+
+- Have your wallet set up with the **Soneium network**.
+- Have **ASTR** tokens available in your wallet.
+- Have some **ETH** to cover  gas fees.
+
+We’ll now walk through the full transfer process step by step.
+
+:::caution Disclaimer
+
+Neemo Finance and Astake are independent projects and are **not affiliated with or operated by Astar Foundation**. Users are strongly advised to **conduct their own research** and contact the respective project teams for more information **before interacting with these dApps**. The Astar Foundation **disclaims all responsibility** for any issues, losses, or risks that may arise from the use of third-party projects.
+
+:::
+
+## 2. Neemo Finance
+
+<Figure caption="" src={require('/docs/use/how-to-guides/soneium/dapp-staking/images/neemo-soneium.jpeg').default} width="100%" />
+
+### 1. What is Neemo Finance
+
+[**Neemo Finance**](https://neemo.finance/) is a liquid staking and restaking protocol built on the **Soneium** network. It enables users to stake their **ASTR** tokens through the **Astar dApp Staking** mechanism, earning rewards while maintaining liquidity. By staking ASTR, users receive **nsASTR**, a liquid staking token that appreciates over time as it accrues staking rewards. This integration allows users to participate in **DeFi applications** on Soneium without sacrificing staking benefits.
+
+### 2. Key features
+
+- **Integration with Astar dApp Staking:** Neemo Finance is built on Soneium but maintains a direct connection with Astar Network, enabling access to the Astar dApp Staking mechanism.
+
+- **Liquid Staking with nsASTR:** Stake ASTR and receive nsASTR, which can be used across various DeFi protocols on Soneium.
+
+- **DeFi Integration:** Neemo collaborates with protocols like QuickSwap, Sake Finance, and Kyo Finance, allowing users to maximize their yields by utilizing nsASTR in various DeFi strategies.
+
+:::tip Neemo docs
+
+If you want to learn more about Neemo Finance, explore their official documentation [**here**](https://docs.neemo.finance/).
+
+:::
+
+### 3. Video tutorial 
+
+To wrap up, here’s a video tutorial that will guide you through the step-by-step process of staking on Soneium using **Neemo Finance**. Feel free to ask your questions in our [**official Astar Discord**](https://discord.com/invite/AstarNetwork).
+
+<iframe 
+  width="100%" 
+  height="400" 
+  src="https://www.youtube.com/embed/JO3Cj_pfl8U"
+  title="Transfer ASTR from Soneium to Astar L1" 
+  frameBorder="0" 
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" 
+  allowFullScreen
+/>
+
+## 3. Astake
+
+<Figure caption="" src={require('/docs/use/how-to-guides/soneium/dapp-staking/images/astake-soneium.jpeg').default} width="100%" />
+
+### 1. What is Astake
+
+[**Astake**](https://www.astake.dev/) is built on a secure, reliable framework, making it simple for users to take part in **Astar dApp Staking**. Their protocol is designed enhance the overall liquidity and stability of the ecosystem. By leveraging advanced security measures and a user-friendly interface, Astake aims to become an integral part of **Astar**'s and **Soneium**’s financial landscape. It's a liquid staking protocol that uses **ASTR**.
+
+### 2. Key features
+
+- **Built on Astar dApp Staking:** Astake integrates directly with the Astar dApp Staking mechanism, allowing users to earn staking rewards by supporting dApps on both Soneium and Astar.
+
+- **Liquid Staking with wstASTR:** Stake ASTR and receive wstASTR, a non-rebasing, ERC-4626-based liquid staking token. Its value increases over time, and it can be used in DeFi without interrupting staking rewards.
+
+- **Secure, DeFi-Ready & Easy to Use:** Audited by PeckShield and designed with user experience in mind, Astake provides a secure and intuitive interface. wstASTR is supported by DeFi protocols like Sake, Kyo, and SoneX to unlock extra yield.
+
+:::tip Astake docs
+
+If you want to learn more about Astake, explore their official documentation [**here**](https://astakes-organization.gitbook.io/doc).
+
+:::
+
+### 3. Video tutorial 
+
+To wrap up, here’s a video tutorial that will guide you through the step-by-step process of staking on Soneium using **Astake**. Feel free to ask your questions in our [**official Astar Discord**](https://discord.com/invite/AstarNetwork).
+
+<iframe 
+  width="100%" 
+  height="400" 
+  src="https://www.youtube.com/embed/141xc3R2kbk"
+  title="Transfer ASTR from Soneium to Astar L1" 
+  frameBorder="0" 
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" 
+  allowFullScreen
+/>
diff --git a/docs/use/how-to-guides/soneium/dapp-staking/troubleshooting.md b/docs/use/how-to-guides/soneium/dapp-staking/troubleshooting.md
@@ -0,0 +1,79 @@
+---
+sidebar_position: 2
+sidebar_label: Troubleshooting
+title: Stake Troubleshooting Guide
+description: Resolve common staking issues on Soneium.
+---
+
+import Figure from "/src/components/figure"
+
+This guide addresses common issues encountered when staking **ASTR** tokens on **Soneium** using platforms like **Neemo Finance** and **Astake**.
+
+## 1. Why don't I see my nsASTR or wstASTR tokens after staking?
+
+**Issue:** After staking ASTR, the corresponding liquid staking tokens (nsASTR or wstASTR) are not visible in your wallet.
+
+**Solution:**
+
+- **Add Token Manually:** Ensure you've added the token to your wallet using the correct contract address.
+  - For **nsASTR**, refer to Neemo Finance's documentation.
+  - For **wstASTR**, refer to Astake's documentation.
+- **Network Selection:** Confirm that your wallet is connected to the **Soneium** network.
+- **Wallet Compatibility:** Use wallets that support custom tokens and networks, such as MetaMask or Zerion.
+
+## 2. My staking transaction is pending or failed. What should I do?
+
+**Issue:** Staking transactions remain pending or have failed.
+
+**Possible Causes & Solutions:**
+
+- **Insufficient Gas Fees:** Ensure you have enough ETH in your wallet to cover gas fees.
+- **Network Congestion:** High network traffic can delay transactions. Wait and try again later.
+- **Token Approval Missing:** Before staking, you must approve the token for transfer. Check if you've granted the necessary permissions.
+
+## 3. I can't unstake my tokens. Why?
+
+**Issue:** Unable to unstake nsASTR or wstASTR tokens.
+
+**Possible Causes & Solutions:**
+
+- **Lock-up Period:** Some staking platforms have a lock-up period. Check the specific terms on Neemo Finance or Astake.
+- **Unstaking Process:** Ensure you're following the correct unstaking procedure as outlined in the platform's documentation.
+- **Platform-Specific Issues:** Refer to the platform's support channels for assistance.
+
+## 4. How do I verify the status of my staking transaction?
+
+**Solution:**
+
+- **Soneium Block Explorer:** Use the [Soneium Block Explorer](https://soneium.blockscout.com/) to check transaction statuses.
+- **Wallet Transaction History:** Most wallets provide a transaction history where you can see pending, successful, or failed transactions.
+- **Platform Interface:** If you used a staking platform, their interface might offer transaction tracking features.
+
+## 5. My wallet doesn't support custom networks. What should I do?
+
+**Issue:** Your current wallet doesn't allow adding custom networks, preventing interaction with Soneium.
+
+**Solution:**
+
+- **Import Wallet into a Compatible One:** Transfer your wallet credentials (seed phrase or private key) into a wallet that supports custom networks, such as MetaMask or Zerion.
+
+## 6. I sent tokens to the wrong address. Can I recover them?
+
+**Issue:** Tokens were sent to an incorrect or unintended address.
+
+**Explanation:**
+
+- **Irreversible Transactions:** Blockchain transactions are immutable. Once confirmed, they cannot be reversed.
+- **Contact Recipient:** If you know the owner of the address, you can request them to return the tokens.
+- **Preventive Measures:** Always double-check addresses before confirming transactions to avoid such issues.
+
+## 7. Where can I get further assistance or report issues?
+
+**Resources:**
+
+- **Official Documentation:** [Soneium Docs](https://docs.soneium.org/)
+- **Soneium Website:** [Soneium](https://soneium.org/en/)
+- **Community Support:** Join the [Astar Network Discord](https://discord.com/invite/AstarNetwork) for community assistance.
+- **Platform Support:**
+  - [Neemo Finance Documentation](https://docs.neemo.finance/)
+  - [Astake Documentation](https://astakes-organization.gitbook.io/doc)
diff --git a/docs/use/how-to-guides/soneium/index.md b/docs/use/how-to-guides/soneium/index.md
@@ -4,17 +4,51 @@ sidebar_label: Soneium
 title: Interact with Soneium
 ---
 
-### What is Soneium
+## 1. What is Soneium
 
-[Soneium](https://soneium.org/) is a public blockchain ecosystem developed by Sony Block Solutions Labs, designed to transcend internet boundaries and bring innovative ideas to the mainstream.
+[**Soneium**](https://soneium.org/) is a public blockchain ecosystem developed by [**Sony Block Solutions Labs**](https://sonyblocksolutionslabs.com/en/), designed to transcend internet boundaries and bring innovative ideas to the mainstream.
 
-As a joint venture between [Sony Group](https://www.sony.com/en/) and [Startale](https://startale.com/en), Soneium leverages Sony's global reach and Startale's blockchain expertise to create a versatile and scalable platform that empowers developers, creators, and communities across various sectors.
+As a joint venture between [**Sony Group**](https://www.sony.com/en/) and [**Startale**](https://startale.com/en), Soneium leverages Sony's global reach and Startale's blockchain expertise to create a versatile and scalable platform that empowers developers, creators, and communities across various sectors.
 
 This Superchain aims to evoke emotion, empower creativity, and make blockchain more accessible and practical for global users, offering innovative applications in entertainment, gaming, finance, and beyond. Soneium simplifies blockchain experiences, driving mass adoption and unlocking unlimited potential for users worldwide.
 
-For a more detailed explanation of [Soneium](https://soneium.org/), refer to the comprehensive presentation in the [Soneium Documentation](https://docs.soneium.org/).
+For a more detailed explanation of [**Soneium**](https://soneium.org/), refer to the comprehensive presentation in the [**Soneium Documentation**](https://docs.soneium.org/).
 
-### Pages of interest:
+## 2. Relationship with Astar Network
+
+With the launch of the Soneium mainnet, Astar Network extends its reach into the Ethereum Layer-2 space. This integration empowers **ASTR holders** to actively engage with a growing ecosystem of decentralized applications (**dApps**).
+
+- **Astar Network**: A Polkadot-native chain now entering Ethereum via Soneium.
+- **Soneium**: A Layer-2 blockchain by Sony Block Solutions Labs, focused on user-friendly Web3 apps.
+- **ASTR Token**: Astar’s native token now powers key utilities across Soneium, from DeFi to gaming.
+
+## 3. ASTR utility on Soneium
+
+### 1. DeFi & Financial use cases
+- **Stake & borrow**: ASTR can be used as collateral (e.g. in Untitled Bank, Sake Finance).
+- **Swap & earn**: Platforms like Uniswap, Quickswap, SoneX, and Velodrome support ASTR for LPs and trading.
+- **Options & liquidity**: SuperVol and Avalon Labs provide more advanced trading use.
+
+### 2. Gaming & Consumer Apps
+- **Purchase assets**: ASTR unlocks NFTs, skins, power-ups (e.g. Elfin, Modd.io).
+- **Play-to-earn**: Compete and earn ASTR in games like Overtrip, Legends of Venari, and ARCAS.
+- **Reward systems**: Apps like Metadomo, Yay!, and Tiltplay.
+
+### 3. Marketplaces & NFTs
+- **Spend ASTR**: Use it as currency in NFT platforms like Sonova and Posse Studios.
+- **Earn ASTR**: As rewards or points in apps like Biru and Arkada.
+
+## 4. Why Bridge ASTR to Soneium
+
+Bridging ASTR to Soneium unlocks:
+- New dApps and DeFi tools
+- Exclusive gaming content
+- NFT marketplaces
+- Token-based rewards
+
+> ASTR is the gateway to Soneium’s thriving Layer-2 economy.
+
+## 5. Learn more
 
 import DocCardList from '@theme/DocCardList';
 import {useCurrentSidebarCategory} from '@docusaurus/theme-common';

diff --git a/docs/use/how-to-guides/soneium/transfer-tokens/_category_.json b/docs/use/how-to-guides/soneium/transfer-tokens/_category_.json
@@ -0,0 +1,5 @@
+{
+    "label": "Transfer tokens",
+    "position": 1
+}
+