harmony-one / bounties

Bounty program is to help the community take part in the development of the Harmony blockchain. It covers from core feature to validator tooling, from dApp development to DeFi integration.
MIT License
59 stars 23 forks source link

[HIP] - 14 : Update Staking Portal ER/Uptime Metrics; Add Additional Information #102

Open johnashu opened 2 years ago

johnashu commented 2 years ago

https://talk.harmony.one/t/hip-14-update-staking-portal-er-uptime-metrics-add-additional-information/1824

Description

This proposal is to edit the expected return (ER) and uptime display data on the staking portal; as well as adding additional information for delegators.

Context

Background: Currently, there is much confusion concerning which expected return (ER) data is the most factual; both on the staking portal and smartstake. Validators use different metrics to advertise; often using erroneous data. The ER displayed upon clicking “Validators” on the staking portal is a 30 day average and often not a factual display of current expected return. Case in point is the inflated ER often seen after a new validator gets elected well under the minimum stake required. In addition, the latest expected return found on each validator’s page is the last epoch’s ER and can be much different than current. This disparity is usually the result of a drastic shift in shard population or management of keys; both factors are constantly changing. Smartstake individual validator ER data is not accurate and shouldn’t be used as there is a 4-5% difference between it and the staking portal data.

Uptime percentage displayed on the staking portal is also a 30 day average; this was affected greatly by the network attack which occurred during around epochs 600-605.

Regarding the additional info needed for delegators; currently there is no information on the staking portal informing delegators they will start earning rewards upon next epoch start. Information is also lacking informing them that upon un-delegating they will continue to earn rewards until the current epoch ends. Additionally, no information exists informing them that rewards are only displayed in whole numbers and not fractions.

Motivation: To provide the community one metric to ascertain current ER information. Ensuring there is only one metric available will eliminate confusion and false advertising; enabling delegators to make informed decisions when choosing a validator. To provide an uptime percentage that captures a length of time but isn’t so long it takes 30 days to recover from events out of validators’ control. To ensure delegators are informed while performing staking actions of the correct timeframes and reward appearances; alleviating premature un-delegations due to unnecessary frustration therefore preventing loss of rewards.

Specification: Remove the “latest expected return” from validators’ profiles on the staking portal and shorten the 30 day average displayed on the front list to 7 days. Shorten uptime percentage timeframe from 30 to 7 days as well. Coordinate with Smartstake on display options to include removal of ER information, masking ER data, or insertion of disclaimer statement advising members the data is not factual. Add information statement to wallet confirmation when performing staking actions to ensure members are aware of timeframes and reward whole number appearances.

Acceptance Criteria

Reward

TBD by core team after review of scope