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 deleted file mode 100644 index f9186d5fbd6..00000000000 Binary files a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/Project.png and /dev/null 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 deleted file mode 100644 index 1086df84824..00000000000 Binary files a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page.png and /dev/null 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 deleted file mode 100644 index 24bc5727c9f..00000000000 Binary files a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_owner_page_2.png and /dev/null 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 deleted file mode 100644 index d0ecab6f804..00000000000 Binary files a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/dApp_rewards.png and /dev/null differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-1.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-1.png new file mode 100644 index 00000000000..c079ce91c0e Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-1.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-2.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-2.png new file mode 100644 index 00000000000..4cedf09f191 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-2.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-3.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-3.png new file mode 100644 index 00000000000..8cd6040a06b Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-3.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-4.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-4.png new file mode 100644 index 00000000000..92b57e88bbc Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-4.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-5.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-5.png new file mode 100644 index 00000000000..ae29831ec7a Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-5.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-6.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-6.png new file mode 100644 index 00000000000..31308b4a3c8 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-6.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-7.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-7.png new file mode 100644 index 00000000000..7527f3e2378 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-7.png differ diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-8.png b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-8.png new file mode 100644 index 00000000000..02c395cc878 Binary files /dev/null and b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/img/developer-dashboard-8.png differ 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 index 3ceb585f92d..d046d325545 100644 --- 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 @@ -1,38 +1,143 @@ --- sidebar_position: 3 +sidebar_label: Manage Your dApp +title: Manage Your dApp and Rewards +description: Step-by-step guide to complete your dApp registration, manage your project page, and claim dApp Staking rewards on Astar Portal. --- import Figure from "/src/components/figure" -# Manage dApp & claim rewards +## I. Overview -As a dApp owner, a new panel will appear in the Asset page of the Astar portal: **Your Project** ; +Once your dApp is whitelisted for dApp Staking, you need to complete the registration by submitting your project details. After that, your developer dashboard lets you monitor reward periods, claim earnings, and keep your project page up to date. -
+This guide covers: -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; +- Completing your project registration after whitelisting +- Filling in project information and submitting the listing +- Accessing and using your developer dashboard +- Claiming dApp Staking rewards +- Editing your project page and adding promotion cards -### Your Dashboard: +**Prerequisites:** -- **Current Tier (ranked):** The current tier (and where applicable, rank) to which your dApp has been assigned. See [Tier system](/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/index.md#tier-system-and-rewards) for more information; -- **Number of stakers:** Total of current stakers on your dApp; -- **Total Earned:** Total tokens received in the dApp Staking program; +- Your dApp has been approved and whitelisted through governance (see [How to Apply](/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/register-dapp.md)) +- An Astar Native (Substrate) wallet connected to the [Astar Portal](https://portal.astar.network/astar/assets) +- A small amount of ASTR for transaction fees -
+--- + +## II. Step-by-step Guide + +### 2.1. Step 1: Complete your registration + +After your contract is whitelisted, a **Congrats!!** banner appears on the **Your Assets** page: + +> *"Your contract is whitelisted on dApp Staking. Please submit details and you will be listed."* + +Click **Register now** to open the project information form. + +
+ +:::info Not seeing the banner? + +Make sure you are connected with the **owner wallet** (the Substrate address that was used during the governance approval). The banner only appears for the registered owner address. + +::: + +### 2.2. Step 2: Fill in your project information + +The **Project info** form lets you define how your project appears to stakers across the Portal. + +Fill in the following fields: + +1. **Name** — your project's display name +2. **Project URL** — a link to your website or product +3. **Contract address** — pre-filled with your registered smart contract address; do not change this unless instructed +4. **Description** — a full description of your project (supports Markdown; use the **Preview** tab to review) +5. **Project logo** — upload a logo image + +
+ +Scroll down to complete the remaining fields: + +6. **Images** — upload a banner image (recommended 16:9 ratio, under 1 MB) +7. **Builders information** — add your team members +8. **Communities** — add links to your community channels (Discord, Telegram, X, etc.) +9. **Is your project on** — select **WASM+EVM**, **WASM**, or **EVM** +10. **Choose main category** — select one: DeFi, NFT, Tooling, Utility, or Others +11. **Tags** — select all relevant tags that describe your project + +
+ +When all fields are complete, click **Save** in the top right corner. + +### 2.3. Step 3: Submit your listing + +A **"One more thing!"** modal will appear asking you to write a short description of up to **65 characters**. This short text is what stakers see on your dApp card in the rankings table. + +A live preview shows exactly how your card will appear before you confirm. + +
+ +Click **Submit** and sign the transaction with your wallet. Your project listing will be submitted onchain. -### Your Rewards: +### 2.4. Step 4: Verify your project is listed -Here you can see how many tokens you have earned for past periods and what you still have to `claim`; +Navigate to **Stake** in the left sidebar. Your project should now appear in the **dApp Rankings** table. Confirm the name, category, and staker count are correct. -
+
-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; +:::tip Public page -### Edit: +Click your project name in the rankings to open the public page that stakers see. Use this to verify all details look correct before promoting your listing. -- **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; +::: + +### 2.5. Step 5: Access your developer dashboard + +Go to **Assets** in the left sidebar. You will now see a **My Project** button next to **My Staking** in the top section of the page. Click it. + +
+ +### 2.6. Step 6: Review your reward periods + +The **My Project** panel shows: + +- Your project name and **Registered** status badge +- Your owner address and a **View public page** link +- **Your Rewards** table, listing each claimable period with the number of days and the ASTR amount available + +
+ +### 2.7. Step 7: Claim your rewards + +Scroll down in the rewards table to see all pending periods and the **Total** claimable amount. + +
+ +Click **Claim your rewards** and sign the transaction. All pending rewards across all listed periods are released in a single transaction. + +:::info Reward accrual + +dApp rewards are only earned while your project is in an active tier. A project must hold the required staking threshold (0.93% of total issuance for Tier 2, 0.35% for Tier 3) during the Build&Earn period to generate claimable dApp rewards. + +::: + +--- + +## III. Manage Your Project Page + +Two management options are available from the **My Project** panel on the right side of the dashboard. + +### 3.1. Edit project page + +Click **Edit Project Page** to update your project's name, description, logo, images, category, builders, or community links at any time. Changes take effect on the public page as soon as they are saved. + +### 3.2. Add a promotion card + +Click **Add a promotion card** to create a featured card that appears in the dApp Staking section of the Portal. Use this when running a campaign, launch event, or staking incentive that you want to highlight to the community. + +--- -
\ No newline at end of file +Have questions? Join the [**official Astar Discord**](https://discord.com/invite/AstarNetwork). 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 index 007f2c09385..f9490d0867d 100644 --- 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 @@ -55,6 +55,12 @@ Before applying, ensure your project meets the **latest Astar dApp Staking requi You will need a **native Astar wallet** (not Ledger or EVM-only) with some ASTR for gas fees. +:::tip + +Don't have an Astar wallet yet? Follow → [**this guide**](/docs/use/get-started/index.md) to set one up on Astar Network. + +::: + **Supported wallets**:
@@ -244,7 +250,7 @@ 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)*; +- Contract address *(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);