0g-chain/x/incentive/spec
drklee3 3375484f79
Update deprecated Cosmos methods (#1530)
* Use cosmossdk.io/errors for deprecated error methods

* Update error registration with cosmossdk.io/errors

* Use cosmossdk.io/math for deprecated sdk.Int alias

* Fix modified proto file

* Update sdk.Int usage in swap hooks

* Update e2e test deprecated method usage
2023-04-05 16:21:59 -07:00
..
01_concepts.md Improve incentive sync documentation (#1417) 2022-12-10 02:09:58 +00:00
02_state.md update incentive spec (#982) 2021-08-06 08:12:08 -06:00
03_messages.md update incentive spec (#982) 2021-08-06 08:12:08 -06:00
04_events.md refactor to MsgClaimHardReward (#879) 2021-03-15 12:03:15 -06:00
05_params.md update incentive spec (#982) 2021-08-06 08:12:08 -06:00
06_hooks.md Update deprecated Cosmos methods (#1530) 2023-04-05 16:21:59 -07:00
07_begin_block.md update incentive spec (#982) 2021-08-06 08:12:08 -06:00
README.md Refactor incentive accumulators to be the same (#970) 2021-07-22 13:53:18 +01:00

incentive

  1. Concepts
  2. State
  3. Messages
  4. Events
  5. Params
  6. Hooks
  7. BeginBlock

Abstract

x/incentive is an implementation of a Cosmos SDK Module that allows for governance controlled user incentives for users who take certain actions, such as opening a collateralized debt position (CDP). Governance proposes an array of rewards, with each item representing a collateral type that will be eligible for rewards. Each collateral reward specifies the number of coins awarded per second, the length of rewards periods. Governance can alter the collateral rewards using parameter change proposals as well as adding or removing collateral types. All changes to parameters would take place in the next period. User rewards are opt in, ie. users must claim rewards in order to receive them. If users fail to claim rewards before the claim period expiry, they are no longer eligible for rewards.

Dependencies

This module uses hooks to update user rewards. Currently, incentive implements hooks from the cdp, hard, swap, and staking (comsos-sdk) modules. All rewards are paid out from the kavadist module account.