GitBook: [master] 194 pages and 3 assets modified

Author: rhazberries

.gitbook/assets/screen-shot-2020-07-25-at-11.18.51-pm.png

@@ -2,8 +2,6 @@
 
 * [Introduction](README.md)
 * [Wallets](wallets/README.md)
-  * [Harmony Wallet \(Harmony Browser Extension\)](wallets/chrome-extension.md)
-  * [Trust Wallet](wallets/trustwallet.md)
   * [Ledger](wallets/ledger/README.md)
     * [Download & Setup](wallets/ledger/download-and-setup.md)
     * [Ledger with HMY CLI](wallets/ledger/using-with-hmy-cli.md)
@@ -16,7 +14,8 @@
     * [Create/Import/Export Wallet](wallets/mathwallet/create-import-wallet.md)
     * [Sending Transactions via Math Wallet](wallets/mathwallet/send-tx.md)
     * [Staking Transactions via Math Wallet](wallets/mathwallet/staking-transactions.md)
-  * [Command-line Tools](wallets/harmony-cli/README.md)
+  * [Harmony Chrome Extension](wallets/chrome-extension.md)
+  * [Harmony CLI](wallets/harmony-cli/README.md)
     * [Download & Setup](wallets/harmony-cli/download-setup.md)
     * [Create or Import Wallet](wallets/harmony-cli/create-import-wallet.md)
     * [Sending Transactions](wallets/harmony-cli/send-tx.md)
@@ -31,16 +30,17 @@
     * [Download & setup](wallets/safepal/download-and-setup.md)
     * [Create/import account](wallets/safepal/create-import-account.md)
     * [Send transaction](wallets/safepal/send-transaction.md)
+  * [Trust Wallet](wallets/trustwallet.md)
   * [Wallet Management](wallets/wallet-management/README.md)
     * [Private Key Management](wallets/wallet-management/key-management.md)
-    * [Missing Funds on Exchange](wallets/wallet-management/missing-funds-on-exchange.md)
+    * [Missing Funds on Exchanges](wallets/wallet-management/missing-funds-on-exchange.md)
 * [Delegators](delegator/README.md)
   * [Staking Dashboard](delegator/staking-dashboard/README.md)
+    * [Walkthrough](delegator/staking-dashboard/choosing-a-validator.md)
     * [Staking Transactions](delegator/staking-dashboard/staking-transactions.md)
     * [Sending Transactions](delegator/staking-dashboard/sending-transactions.md)
     * [Open Staking — Frequently Asked Questions](delegator/staking-dashboard/open-staking-frequently-asked-questions.md)
-  * [Dashboard Walkthrough](delegator/choosing-a-validator.md)
-  * [Delegation on Harmony \(video\)](delegator/delegator-journey.md)
+  * [Informational Videos](delegator/delegator-journey.md)
 * [Validators](validators/README.md)
   * [Terms & Concepts](validators/definitions/README.md)
     * [Validator, BLS key, Instance](validators/definitions/validator-keys-and-bids/README.md)
@@ -79,21 +79,20 @@
     * [Changing Validator Information](validators/managing-your-validator/changing-validator-information.md)
     * [Delegating To A Validator](validators/managing-your-validator/delegating-to-a-validator.md)
     * [Undelegating From A Validator](validators/managing-your-validator/undelegating-to-a-validator.md)
-    * [Seeing Stakers](validators/managing-your-validator/seeing-stakers.md)
+    * [Check Your Delegations](validators/managing-your-validator/seeing-stakers.md)
     * [Collecting Rewards](validators/managing-your-validator/collecting-rewards.md)
     * [Adding A Validator Logo](validators/managing-your-validator/adding-a-validator-logo.md)
-  * [Staking Dashboard](validators/staking-dashboard.md)
-  * [Validator Info Doc](validators/validator-info-doc.md)
+  * [Staking Dashboard Basics](validators/staking-dashboard.md)
+  * [Validator Information Terms](validators/validator-info-doc.md)
+  * [Validator Security Tips](validators/validator-security.md)
+  * [Network Status Monitoring](validators/network-status.md)
   * [Troubleshooting](validators/validator-troubleshooting/README.md)
-    * [Why am I not elected in the EPOS Committee](validators/validator-troubleshooting/why-am-i-not-elected-in-the-epos-committee.md)
+    * [My validator is not elected](validators/validator-troubleshooting/why-am-i-not-elected-in-the-epos-committee.md)
     * [Frequently Asked Questions \(FAQ\)](validators/validator-troubleshooting/frequently-asked-questions-faq.md)
-  * [Monitoring & Security](validators/extras/README.md)
-    * [Validator Security](validators/extras/validator-security.md)
-    * [Network Status](validators/extras/network-status.md)
   * [Tools](validators/tools/README.md)
     * [Telegram Bots](validators/tools/telegram-bots.md)
     * [Dashboards](validators/tools/dashboards.md)
-    * [Calculators](validators/tools/calculators.md)
+    * [Reward Calculators](validators/tools/calculators.md)
     * [Text User Interface \(TUI\)](validators/tools/text-user-interface-tui.md)
     * [Mobile Apps](validators/tools/mobile-apps/README.md)
       * [One Validator Dashboard](validators/tools/mobile-apps/one-validator-dashboard.md)

.gitbook/assets/screen-shot-2020-07-25-at-9.34.32-pm.png

@@ -1,12 +1,12 @@
 ---
-description: How to maximize returns under the EPOS mechanism
+description: Media content for staking on Harmony
 ---
 
-# Delegation on Harmony \(video\)
+# Informational Videos
 
-Harmony's revolutionary Effective Proof of Stake mechanism \([https://youtu.be/M8c06bxWyQc](https://www.youtube.com/watch?v=M8c06bxWyQc)\) is the fairest yet for allowing open participation in a public blockchain. 
 
-{% embed url="https://www.youtube.com/watch?time\_continue=4&v=k3cwL2tB3DI&feature=emb\_logo" caption="OPEN STAKING: The Delegator Journey on Harmony Protocol" %}
+
+{% embed url="https://www.youtube.com/watch?time\_continue=4&v=k3cwL2tB3DI&feature=emb\_logo" caption="" %}
 
 {% embed url="https://www.youtube.com/watch?v=U8\_6bJZqGpQ&list=PLAzkb1vJXQOR3ZEl25MKiz5-CMw6xVkaW&index=2" %}
 

.gitbook/assets/screen-shot-2020-07-25-at-9.37.37-pm.png

@@ -0,0 +1,72 @@
+# Walkthrough
+
+In order to choose their validators and manage their delegation, delegators have access to a range of information on the Staking Dashboard.
+
+![Screen zoomed for demonstration purpose.](../../.gitbook/assets/image%20%28161%29.png)
+
+| **Portfolio Page** | Delegators can claim full rewards and monitor validators in their delegation portfolio.  |
+| :--- | :--- |
+| Staked | Amount of ONE delegated |
+| Available | Amount of ONE that available to delegate |
+| Rewards | Rewards yet to be claimed |
+| Portfolio allocation | Delegation amount across different validators |
+| Expected return | expected annual percentage return rate |
+| Returned in | Epochs left until undelegation funds will be accessible |
+| Reward \(up to date\)  | Unclaimed rewards |
+| Status  | Election status of the validator in current epoch |
+
+
+
+![Screen shot is zoomed for demonstration purpose.](../../.gitbook/assets/image%20%2876%29.png)
+
+| **Validator list** | Delegators can access necessary information of validators at a glance to choose desired validator\(s\). |
+| :--- | :--- |
+| Effective Median Stake | Median of ONE staked among the top elected slots |
+| Total Stake | Total ONE staked in the Harmony network  |
+| Current block height | current block height of Harmony blockchain |
+| All | All validators created & listed onchain |
+| Elected | Validator currently selected & eligible to sign blocks & earn rewards |
+| Not Elected | Validator currently not-selected to sign blocks due to low stake or insufficient uptime |
+| Expected return | Expected annual return rate |
+| Stake | Total ONE staked by the validator |
+| Fees | Commission on rewards charged by validator  |
+| Uptime \(AVG\) | Signing percentage for this validator's nodes  |
+| Status | Election status of validator in current epoch  |
+| Name | The validators' moniker |
+
+
+
+![Screen zoomed for demonstration purpose.](../../.gitbook/assets/image%20%28171%29.png)
+
+| **Validator Profile** | Delegators can check detailed information of a validator and delegate/undelegate this validator. |
+| :--- | :--- |
+| Delegated | Total ONE delegated to this validator |
+| Self stake | Amount of ONE staked by validator |
+| Max delegation | Maximum ONE stake allowed by the validator, including self-stake |
+| Validator since | Block number at which validator registered |
+| Fee | Commission on rewards charged by validator |
+| Max daily change | daily change in commission allowed for this validator |
+| Uptime \(AVG\) | Signing percentage for this validator's nodes |
+| Slots | Number of seats \(bls keys\) associated with the Validator |
+| Elected slots | Number of seats \(bls keys\) elected in the current committee |
+| Expected return | Expected annual return rate |
+| Lifetime rewards | all rewards collected by the validator |
+| Shards | Shards in which validator's BLS keys belong, shown order is based on time to add |
+| Stake & delegation history | Stake and delegation amount for the validator at every epoch |
+| Reward rate history | Expected annual percentage return rate for validator at every epoch |
+| Delegators | List of accounts that delegated to this validator and delegation amount |
+
+
+
+![](../../.gitbook/assets/image%20%28186%29.png)
+
+![](../../.gitbook/assets/image%20%28175%29.png)
+
+| **Analytics** | Delegator can access both intuitive and statistical information on the stake distribution among validators and 4 shards. |
+| :--- | :--- |
+| Slots | The slots occupied by this validator |
+| Bid | Bid per BLS key |
+| Effective | Validator's effective ONE staked |
+| total | Validator's total ONE staked |
+| Self stake | Amount of ONE staked by validator |
+

SUMMARY.md

@@ -15,15 +15,11 @@ SoccerPlayers is an NFT collectible game deployed on Harmony blockchain. It is l
 
 ![](../.gitbook/assets/harmony-soccer-2.png)
 
-
-
-##  ​[OneMoji](https://peekpi.github.io/onemoji/dist/)**​** <a id="onemoji"></a>
+## [OneMoji](https://peekpi.github.io/onemoji/dist/)
 
 _Disclaimer: this game is ported from_ [_Nyftimoji_](https://niftymoji.com/)_, an Ethereum based game, for non-commercial purposes._‌
 
-You can use 20 $one tokens to mint an emoji token \(HRC 721 token\) using smart contract. The lucky number you input and the block hash will decide which emoji you are going to get from a library of 3,470 emojis.
-
-
+You can use 20 $ONE tokens to mint an emoji token \(HRC 721 token\) using smart contract. The lucky number you input and the block hash will decide which emoji you are going to get from a library of 3,470 emojis.
 
 ![](../.gitbook/assets/onemoji-2%20%281%29.png)
 

delegator/delegator-journey.md

@@ -24,5 +24,3 @@ Harmony’s Effective Proof-of-Stake \(EPoS\) is the first staking mechanism in
 
 {% page-ref page="validator-troubleshooting/" %}
 
-{% page-ref page="extras/" %}
-

delegator/staking-dashboard/choosing-a-validator.md

@@ -38,7 +38,7 @@ The CLI will prompt you to enter your BLS key file password.
 
 `--name` will be the name displayed on the Staking Explorer **\(string\)**
 
-`--identity` is additional information for the validator **\(string\)**
+`--identity` unique identifier for the validator **\(string\)**
 
 `--details` is the description of the validator **\(string\)**
 
@@ -63,7 +63,11 @@ The CLI will prompt you to enter your BLS key file password.
 {% endhint %}
 
 {% hint style="info" %}
-rate, max-rate max-change-rate takes value between 0 and 1 with 0.1 = 10%
+`--rate`, `--max-rate`, and `--max-change-rate` accepts numbers between 0 and 1 representing percentages
+{% endhint %}
+
+{% hint style="info" %}
+If you have a Keybase account, we recommend you use your Keybase public key fingerprint as your validator's identity. The field is unique, ensuring that other validator's can not attempt to impersonate you. This data will also help with some awesome integrations & features in the future!
 {% endhint %}
 
 ### When does the validator participate in election? <a id="when-does-the-validator-become-active"></a>
@@ -83,15 +87,15 @@ Example output:
 ```
 
 {% hint style="warning" %}
-If you don't want to participate in the election anymore, you can turn your validator inactive using an [Edit Validator transaction](https://docs.harmony.one/home/validators/managing-your-validator/changing-validator-information) with`--active false.`
+If you do not wish to participate anymore, you can turn your validator inactive using an [Edit Validator transaction](https://docs.harmony.one/home/validators/managing-your-validator/changing-validator-information) with`--active false.`
 {% endhint %}
 
 ## Checking Validator Information <a id="checking-validator-information"></a>
 
-Use the format command **./hmy --node="https://api.s0.t.hmny.io" blockchain validator information \[ONE ADDRESS\]** to check your validator information:
+Example command:
 
 ```bash
-./hmy --node="https://api.s0.t.hmny.io" blockchain validator information one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd
+./hmy blockchain validator information one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd --node="https://api.s0.t.hmny.io"
 ```
 
 Example output:
@@ -175,7 +179,7 @@ Example output:
 ```
 
 {% hint style="warning" %}
-If your validator does not sign more than 2/3 of the blocks in an epoch, the validator will be removed from the pool of eligible validators.
+If your validator has signed less than 66% of the blocks in an epoch, it will be removed from the pool of eligible validators.
 
 In order to be included in the pool again, you will have to use send an [Edit Validator transaction](creating-a-validator.md) with `--active true`.
 {% endhint %}

showcases/apps.md

@@ -1,3 +1,7 @@
+---
+description: Upload a custom logo to be displayed on your Staking Dashboard profile
+---
+
 # Adding A Validator Logo
 
 ### Uploading A Custom Logo <a id="uploading-a-custom-logo"></a>
@@ -6,13 +10,17 @@
 
 2. Add your logo by creating the logo image name using your Harmony one address as the file name and placing it inside "validators" folder. The logo image needs to be a .jpg file with 256x256 pixels or 512x512 pixels.  
 
-Exemple: validators/one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy.jpg
+Example: validators/one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy.jpg
 
 {% hint style="danger" %}
-Do not upload the .jpg file name in the root repository. It needs be be inside folder "validators".
+Do not upload the .jpg file in the main repository directory. It must be inside the "validators" directory.
 {% endhint %}
 
 3. Create a pull request for your changes. A Harmony team member will review the image & approve it.
 
 ![](https://blobs.gitbook.com/assets%2F-M-IDt7HenNiPUXWT_3k%2F-M1q8Eka44xqHjcC7U5S%2F-M1qUcrcCDBse9V2-zhm%2FScreen%20Shot%202020-03-07%20at%2011.34.55%20AM.png?alt=media&token=1c53a6a9-ce60-414e-9c57-21f9d6e7b731)
 
+### Keybase
+
+If you have a Keybase account & have put your PGP public key finger print as your "identity", your Keybase profile picture will automatically be used for your validator image!
+

validators/README.md

@@ -1,3 +1,7 @@
+---
+description: How to update your validator information
+---
+
 # Changing Validator Information
 
 You can edit your validator’s information using the CLI with the following command.
@@ -38,8 +42,8 @@ Sending the command without the arguments will leave those fields of your valida
 {% endhint %}
 
 {% hint style="danger" %}
-`--max-rate` and `--max-change-rate` cannot be changed later.
+`--max-rate` and `--max-change-rate` cannot be changed after creation.
 
-`--min-self-delegation` has to be at least 10,000 ONE.
+`--min-self-delegation` must be minimum 10,000 ONE.
 {% endhint %}
 

validators/first-time-setup/creating-a-validator.md

@@ -1,3 +1,7 @@
+---
+description: How to see your current validator information
+---
+
 # Checking Validator Information
 
 ## Using the Binary:
@@ -97,6 +101,6 @@
 {% hint style="warning" %}
 If your validator does not sign more than 2/3 of the blocks in an epoch, the validator will be removed from the pool of eligible validators.
 
-In order to be included in the pool again, you will have to use send an [Edit Validator transaction](https://docs.harmony.one/validators/validator/managing-your-validator/changing-your-validator-profile) with `--active true.`
+In order to be included in the pool again, you will have to use send an [Edit Validator transaction](changing-validator-information.md) with `--active true.`
 {% endhint %}
 

validators/managing-your-validator/adding-a-validator-logo.md

@@ -1,6 +1,10 @@
+---
+description: How to collect your rewards
+---
+
 # Collecting Rewards
 
-You can collect your block rewards with the following command.
+You can collect your rewards with the following command.
 
 ## Using the Binary:
 

validators/managing-your-validator/changing-validator-information.md

@@ -1,3 +1,7 @@
+---
+description: How to delegate tokens to a validator
+---
+
 # Delegating To A Validator
 
 You can delegate tokens to a validator using the following command.

validators/managing-your-validator/checking-validator-information.md

@@ -1,23 +1,27 @@
-# Seeing Stakers
+---
+description: How to see your delegators
+---
+
+# Check Your Delegations
 
 You can see the number of delegations to your validator with the following command.
 
 ## Using the Binary:
 
 ```bash
-./hmy --node="https://api.s0.t.hmny.io" blockchain delegation by-validator [VALIDATOR ADDRESS]
+./hmy blockchain delegation by-validator [VALIDATOR ADDRESS] --node="https://api.s0.t.hmny.io"
 ```
 
 ## Using the Shell Wrapper:
 
 ```bash
-./hmy.sh -- node="https://api.s0.t.hmny.io" blockchain delegation by-validator [VALIDATOR ADDRESS]
+./hmy.sh -- blockchain delegation by-validator [VALIDATOR ADDRESS] --node="https://api.s0.t.hmny.io"
 ```
 
-### Example:
+## Example:
 
 ```bash
-./hmy node="https://api.s0.t.hmny.io" blockchain delegation by-validator one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade
+./hmy blockchain delegation by-validator one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade --node="https://api.s0.t.hmny.io"
 ```
 
 #### Output:

validators/managing-your-validator/collecting-rewards.md

@@ -1,3 +1,7 @@
+---
+description: How to undelegate your tokens from a validator
+---
+
 # Undelegating From A Validator
 
 You can un-delegate tokens from a validator using the following command:

validators/managing-your-validator/delegating-to-a-validator.md

@@ -0,0 +1,8 @@
+# Network Status Monitoring
+
+You can check the status of Harmony Mainnet & Testnet [here](https://monitor.hmny.io/status)!
+
+
+
+
+

validators/managing-your-validator/seeing-stakers.md

@@ -1,20 +1,22 @@
-# Staking Dashboard
+# Staking Dashboard Basics
 
 Here is the Staking Explorer link:  [https://staking.harmony.one/welcome](https://staking.harmony.one/welcome)
 
 ![](../.gitbook/assets/image%20%28137%29.png)
 
-Using the Staking Explorer is an easy way to stake, delegate, send funds and control all information associated with the validators.
+The Staking Explorer is an easy way to stake, delegate, send funds and view all information of Harmony validators.
 
-First you need to login into an account , you can create new address or using an existing address, for example your validator account that you created using CLI
+You can explore the dashboard without using your ONE address, but the ONE address you use will be used for any transactions. 
+
+You can log into an account using the Harmony Chrome Extension, MathWallet Chrome Extension, or Ledger Nano S. 
 
 ![](../.gitbook/assets/image%20%2874%29.png)
 
-After you login, there are several option available, for example you can check all available validators that you can delegate
+After logging in, you can view network analytics, a list of validators, validator profiles, and other information to help you decide who to delegate to.
 
 ![](../.gitbook/assets/image%20%2898%29.png)
 
-For each transation/delegation you will need to confirm it, for that you can use several ways, using Harmony Browser Extension or ledger nano S.
+Every transaction or delegation must be signed. You can use the Harmony Chrome Extension, which supports Ledger Nano S.
 
 **Harmony Browser Extension:** [https://docs.harmony.one/home/wallets/chrome-extension](https://docs.harmony.one/home/wallets/chrome-extension)