From 1cba41d75eeeb2eebe4a974ea78e1c45d546a9ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Zemanovi=C4=8D?= Date: Fri, 9 Sep 2022 09:46:38 +0200 Subject: [PATCH] docs/dev/pos-integration: more about rewards products and commissions --- .../dev/src/explore/design/ledger/pos-integration.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/dev/src/explore/design/ledger/pos-integration.md b/documentation/dev/src/explore/design/ledger/pos-integration.md index 4e21bc10f8..14c41d39ef 100644 --- a/documentation/dev/src/explore/design/ledger/pos-integration.md +++ b/documentation/dev/src/explore/design/ledger/pos-integration.md @@ -17,9 +17,9 @@ All [the data relevant to the PoS system](https://specs.namada.net/economics/pro - `validator/{validator_address}/total_deltas`: sum of self-bonds and delegations to this validator, may contain negative delta values when unbonding - `validator/{validator_address}/total_unbonded`: sum of unbonded bonds from this validator, needed to determine the amount slashed in each epoch that it affects when a slash is applied - `validator/{validator_address}/voting_power` - - `validator/{validator_address}/validator_rewards_product`: a multiplier of the `total_deltas` that yields the updated amount with staking rewards added to this validator - - `validator/{validator_address}/delegation_rewards_product`: similar to `validator_rewards_product`, but with delegation commissions are subtracted - - `validator/{validator_address}/commissions`: the total amount of delegations commissions collected by this validator + - `validator/{validator_address}/validator_rewards_product`: a rewards product that is used to find the updated amount for self-bonds with staking rewards added to this validator - the past epoched data has to be kept indefinitely + - `validator/{validator_address}/delegation_rewards_product`: similar to `validator_rewards_product`, but for delegations with commissions subtracted - the past epoched data also has to be kept indefinitely + - `validator/{validator_address}/commissions`: the total amount of delegations commissions collected by this validator - this doesn't need to epoched data, just an accumulator of the total - `validator/{validator_address}/commission_rate`: a validator chosen commission rate that is a fraction of delegation rewards charged by this validator - `slash/{validator_address}` (optional): a list of slashes, where each record contains epoch and slash rate - `bond/{bond_source}/{bond_validator} (optional)`