diff --git a/docs/1.start/staking-guide.md b/docs/1.start/staking-guide.md index 99cb9b0..5d6ce98 100644 --- a/docs/1.start/staking-guide.md +++ b/docs/1.start/staking-guide.md @@ -2,6 +2,103 @@ title: Staking Guide --- -:::info Under Construction -_Elastos is nearing an upgrade that will alter the staking mechanics significantly. A new guide will be provided here when the changes go live on mainnet._ -::: +![image](/docs/assets/start/Featured-image-Staking-and-Voting.gif) + +# Elastos BPoS Guide + +Elastos recently upgraded to a new Elastic Consensus mechanism which features a novel Bonded Proof of Stake (BPoS) instead of the previous Delegated Proof of Stake (DPoS). In late 2021, Yipeng Su proposed the concept of BPoS to enhance the security and stability of both the Elastos main chain and its side chains. BPoS involves stakers and validators. This guide explains how to stake ELA and vote for validators in BPoS. + +## Table of Contents + +- [Staking and Voting Guidelines](#staking-and-voting-guidelines) +- [Getting Started](#getting-started) +- [Steps to Stake and Vote](#steps-to-stake-and-vote) +- [Claim Rewards](#claim-rewards) + +## Staking and Voting Guidelines + +- In BPoS, users must pledge their ELA for at least 10 days or 7,200 block heights, up to a maximum of 1,000 days or 720,000 block heights. +- One staked ELA can be converted into one equity token for voting. +- Rewards depend on the amount of ELA pledged and pledge time. +- Pledge time cannot be shortened but can be extended, not exceeding the expected expiration time of the node. +- Staking profits are automatically allocated: 25% to nodes and 75% to their stakers. +- 12 CR Council nodes cannot be voted for. +- Stakers must re-vote once the pledge time ends to continue earning rewards. + +## Getting Started + +### Download Essentials Wallet + +To participate in BPoS, download the flagship Elastos wallet, Essentials. All BPoS activities are managed through Essentials. Download the latest version for [Apple](link_to_apple) or [Android](link_to_android). + +### Get ELA on the Mainchain + +To participate in BPoS, users need main chain ELA for staking. You can purchase ELA on exchanges like Coinbase, Kucoin, Huobi, and Gate.io. Alternatively, use the Elastos DEX Glide Finance to buy ELA on the Elastos Smart Contract Chain (ESC). For other options, check the [Coingecko Markets page](link_to_coingecko) for ELA. + +Once you have purchased ELA, transfer it to your Essentials wallet to start staking and voting. Note that ELA on Coinbase is ERC-20; follow [this guide](link_to_erc20_guide) to convert it to mainchain ELA for BPoS. + +## Steps to Stake and Vote + +### 1. Staking + +![image](/docs/assets/start/ELA-staking-1.jpg) + +1.1. Log into your Essentials wallet and swipe three pages from the home page. Click on "ELA Staking" to start pledging your ELA for staking. + +1.2. Click the "Stake" option at the bottom left of the "ELA Staking" page. + +![image](/docs/assets/start/ELA-staking-2.jpg) + +1.3. Enter the desired ELA amount and confirm it before clicking "Stake." + +1.4. Once the transaction is sent successfully, your pledge is complete. + +### 2. Unstaking + +![image](/docs/assets/start/ELA-unstaking-1.jpg) + +2.1. Go to the "ELA Staking" page and click "Unstake" at the bottom. + +![image](/docs/assets/start/ELA-unstaking-2.jpg) + +2.2. Enter the ELA amount you want to retrieve and click "Unstake." ELA will be sent back to your Essentials wallet once the transaction is successful. + +Note: ELA used for voting cannot be unstaked before the expiration time. + +### 3. Vote for Validators + +![image](/docs/assets/start/Vote-for-supernode-1-768x512.jpg) + +3.1. Log into your Essentials wallet and swipe three pages from the home page. Click on the "BPoS Voting" page to start voting. + +3.2. On the "BPoS Voting" page, view information about validators and select the nodes you wish to vote for. + +![image](/docs/assets/start/Vote-for-supernode-2-768x512.jpg) + +3.3. Check the boxes beside your chosen nodes, confirm your selection, and click "CAST VOTES" at the bottom of the page. + +3.4. Enter the number of days pledged and votes for the selected node, then click "Cast Votes." + +3.5. After confirmation, go to the "BPoS Voting" page and click "My Votes" to view your voting details. + +### 4. Change Vote + +![image](/docs/assets/start/change-the-vote-1-768x524.jpg) + +4.1. To extend pledge time, select "My Votes" at the bottom of the page, then click "Update" to set a new pledge time. + +4.2. Enter the number of days for the extension and click "Update." + +Note: Pledge time can't be shortened, and votes can't be canceled or changed until the expiration date. + +## Claim Rewards + +![image](/docs/assets/start/Claim-ELA-rewards-768x497.jpg) + +1. Go to the "ELA Staking" page. + +2. Click "Withdraw" at the bottom of the page. + +3. Input the desired ELA reward amount. + +4. Click "Withdraw" to initiate the process of claiming your ELA rewards. diff --git a/website/static/docs/assets/start/Claim-ELA-rewards-768x497.jpg b/website/static/docs/assets/start/Claim-ELA-rewards-768x497.jpg new file mode 100644 index 0000000..f974081 Binary files /dev/null and b/website/static/docs/assets/start/Claim-ELA-rewards-768x497.jpg differ diff --git a/website/static/docs/assets/start/ELA-staking-1.jpg b/website/static/docs/assets/start/ELA-staking-1.jpg new file mode 100644 index 0000000..1b51e02 Binary files /dev/null and b/website/static/docs/assets/start/ELA-staking-1.jpg differ diff --git a/website/static/docs/assets/start/ELA-staking-2.jpg b/website/static/docs/assets/start/ELA-staking-2.jpg new file mode 100644 index 0000000..a9299a9 Binary files /dev/null and b/website/static/docs/assets/start/ELA-staking-2.jpg differ diff --git a/website/static/docs/assets/start/ELA-unstaking-1.jpg b/website/static/docs/assets/start/ELA-unstaking-1.jpg new file mode 100644 index 0000000..35306d6 Binary files /dev/null and b/website/static/docs/assets/start/ELA-unstaking-1.jpg differ diff --git a/website/static/docs/assets/start/ELA-unstaking-2.jpg b/website/static/docs/assets/start/ELA-unstaking-2.jpg new file mode 100644 index 0000000..aad8cf1 Binary files /dev/null and b/website/static/docs/assets/start/ELA-unstaking-2.jpg differ diff --git a/website/static/docs/assets/start/Featured-image-Staking-and-Voting.gif b/website/static/docs/assets/start/Featured-image-Staking-and-Voting.gif new file mode 100644 index 0000000..ff09a93 Binary files /dev/null and b/website/static/docs/assets/start/Featured-image-Staking-and-Voting.gif differ diff --git a/website/static/docs/assets/start/Vote-for-supernode-1-768x512.jpg b/website/static/docs/assets/start/Vote-for-supernode-1-768x512.jpg new file mode 100644 index 0000000..b0567c7 Binary files /dev/null and b/website/static/docs/assets/start/Vote-for-supernode-1-768x512.jpg differ diff --git a/website/static/docs/assets/start/Vote-for-supernode-2-768x512.jpg b/website/static/docs/assets/start/Vote-for-supernode-2-768x512.jpg new file mode 100644 index 0000000..db71204 Binary files /dev/null and b/website/static/docs/assets/start/Vote-for-supernode-2-768x512.jpg differ diff --git a/website/static/docs/assets/start/change-the-vote-1-768x524.jpg b/website/static/docs/assets/start/change-the-vote-1-768x524.jpg new file mode 100644 index 0000000..03625d5 Binary files /dev/null and b/website/static/docs/assets/start/change-the-vote-1-768x524.jpg differ