docs: add docs for gov on tally (#291)

docs/bcfusion/users/gov.md

@@ -0,0 +1,122 @@
+import Tally1 from '../../assets/bcfusion/tally1.png';
+import Tally2 from '../../assets/bcfusion/tally2.png';
+import Tally3 from '../../assets/bcfusion/tally3.png';
+import Tally4 from '../../assets/bcfusion/tally4.png';
+import Tally5 from '../../assets/bcfusion/tally5.png';
+import Tally6 from '../../assets/bcfusion/tally6.png';
+import Tally7 from '../../assets/bcfusion/tally7.png';
+import Tally8 from '../../assets/bcfusion/tally8.png';
+import Tally9 from '../../assets/bcfusion/tally9.png';
+import Tally10 from '../../assets/bcfusion/tally10.png';
+import Tally11 from '../../assets/bcfusion/tally11.png';
+
+# Governance with Tally
+
+This document provides a guide on how to participate in governance on the BNB Smart Chain (BSC) using Tally. It
+covers the process of delegating voting power, creating proposals, voting on proposals, and executing proposals.
+
+BNB Chain DAOs are created on Tally both for the mainnet and testnet.
+
+* Testnet: https://www.tally.xyz/gov/bnb-chain-testnet
+* Mainnet: to be announced
+
+## Parameters
+
+There are several parameters which will affect the governance process on the BSC.
+Especilly, the governance process on the BSC only enabled after enough voting power is migrated from the Beacon Chain
+to the BSC (i.e., the `startGovThreshold` parameter).
+
+| Parameter               | Description                                                                      | Mainnet Value | Testnet Value |
+|-------------------------|----------------------------------------------------------------------------------|---------------|---------------|
+| votingDelay             | a fixed duration  after which users can vote to a proposal                       | 0 hour        | 0 hour        |
+| votingPeriod            | the voting period before tally                                                   | 7 days        | 1 day         |
+| proposalThreshold       | a fixed amount of gov BNB needed for a proposal                                  | 200 govBNB    | 100 govBNB    |
+| quorumNumberRator       | the percentage of the total voting power required to produce a final vote result | 10%           | 10%           |
+| startGovThreshold       | the total supply of gov token to enable the gov function                         | 10M BNB       | 10M BNB       |
+| minPeriodAfterTheQuorum | the time to add for voting when a proposal reaches quorum                        | 1 day         | 1 hour        |
+| timerlockDelay          | the timer locker duration to execute a proposal                                  | 1 day         | 6 hours       |
+
+## Governance Process Guide
+
+You need to connect to your Web3 wallet (e.g., TrustWallet, BEW, Metamask) for the following operations.
+
+### Delegate Voting Power
+
+After you have delegated your BNB to a BSC validator, you can start participating in the BSC governance.
+To participate in BSC governance, you first need to delegate your voting power to a validator or yourself if you wish to
+vote directly.
+
+<img src={Tally1} width="800"/>
+
+You can click the `My voting power` button on the top right corner of the screen to delegate your voting power.
+
+<img src={Tally2} width="800"/>
+
+You can delegate your voting power to yourself if you want to vote/create proposals directly, or to others if you want
+him/her to vote/create proposals on your behalf.
+
+<img src={Tally3} width="800"/>
+
+If you delegate the voting power to yourself, you will see the current number of your voting power to participate in the
+governance.
+
+### Create Proposals
+
+If you have sufficient voting power (i.e., greater than the `proposalThreshold`), you can create proposals on the BSC
+network. Be noted that a user can only has one proposal in ative/pending state at a time to prevent spamming.
+
+To create a proposal, click on the "Create new proposal" button on the top right corner of the screen.
+
+<img src={Tally11} width="800"/>
+
+After you have created a proposal, you can add a title, description, and a list of actions for the proposal.
+
+<img src={Tally4} width="800"/>
+
+A text proposal only requires a title and a description, and it will not be executed by the network for there is no action.
+
+<img src={Tally5} width="800"/>
+
+To add an action, click on the "Add action" button, and fill in the details of the action.
+
+- `Target Contract Address`: The contract address to be called by the proposal.
+- `ABI File`: The ABI file of the contract. You can upload the ABI file manually if the ABI file is not correctly
+  detected.
+- `Conctract Method`: The method of the contract to be called.
+- `Calldata`: The input data for the contract method. Which is optional.
+
+After you intpur all the details, click on the "Publish" will publish your proposal.
+
+<img src={Tally6} width="800"/>
+
+You can also cancel a proposal by clicking on the "Cancel proposal" button.
+
+### Vote on Proposals
+
+Once a proposal is live (i.e., after the `votingDelay` and before the `votingPeriod`), you can cast your vote to
+support or oppose the proposal. To vote on a proposal, click on the "Vote on chain" button.
+
+<img src={Tally7} width="800"/>
+
+You can cast `For`, or `Against`, or `Abstain` votes to the proposal.
+
+<img src={Tally8} width="400"/>
+
+### Execute Proposals
+
+If a proposal reaches the quorum (i.e., reaches the `quorumNumberRator` of the total voting power) and it passes
+(i.e., more than 50% of the voted voting power supports the proposal), it can be executed by the network.
+
+To execute a proposal, fistly the proposal needs to be queued by clicking the `Queue` button.
+
+<img src={Tally9} width="800"/>
+
+After the proposal is queued and exceeds the timelock duration (i.e, the `timerlockDelay` duration),
+it can be executed by anyone by clicking the `Execute` button.
+
+<img src={Tally10} width="800"/>
+
+### More References
+
+- [Delegations on Tally](https://docs.tally.xyz/knowledge-base/delegations-on-tally)
+- [Proposals on Tally](https://docs.tally.xyz/knowledge-base/proposals)

docs/bcfusion/users/stake-migration.md

@@ -40,11 +40,11 @@ connect.
 
 For mainnet, you can use BEW or [TrustWallet](https://trustwallet.com/browser-extension) to connect.
 
-<img src={Migrate1} width="400"/>
+<img src={Migrate1} width="600"/>
 
 Open `My Staking` page, Then you can find you existing delegations as the following.
 
-<img src={Migrate2} width="400"/>
+<img src={Migrate2} width="800"/>
 
 #### Step 2:  Choose the native BSC validators to migrate to.
 

docs/bcfusion/validators/creation.md

@@ -128,7 +128,8 @@ ${workspace}/bin/bnbcli \
 - `--chain-id ${BC_CHAIN_ID}`: Specifies the chain ID for the BC(BNB beacon chain). By default, the mainnet chain ID
   is `Binance-Chain-Tigris`. And the testnet chain ID is `Binance-Chain-Ganges`.
 
-- `--from ${ACCOUNT_NAME}`: Specifies the account name from which the sign will be performed.
+- `--from ${ACCOUNT_NAME}`: Specifies the account name from which the sign will be performed. The account should
+  be the operator of the validator created on the Beacon Chain.
 
 And you will get the output like this:
 

sidebars.js

@@ -306,6 +306,7 @@ const sidebars = {
                           {type:'doc', id:'bcfusion/users/timelocks', label:'Manage Your TimeLocks'},
                           {type:'doc', id:'bcfusion/users/stake-migration', label:'Manage Your Old Delegations'},
                           {type:'doc', id:'bcfusion/users/new-stake', label:'Manage Your New Delegations'},
+                          {type:'doc', id:'bcfusion/users/gov', label:'Participate in Governance'},
                       ]
                   },
                   {
@@ -321,6 +322,7 @@ const sidebars = {
                       items:[
                           {type:'doc', id:'bcfusion/validators/migrations', label:'Migrate Your Validators'},
                           {type:'doc', id:'bcfusion/validators/creation', label:'Create New Validators'},
+                          {type:'doc', id:'bcfusion/validators/key-management', label:'Key Management'},
                       ]
                   },
                   {