diff --git a/x/auth/spec/05_vesting.md b/x/auth/spec/05_vesting.md index b15526ba60..858579b6f1 100644 --- a/x/auth/spec/05_vesting.md +++ b/x/auth/spec/05_vesting.md @@ -39,7 +39,7 @@ are included, the vesting will occur over the specified number of periods. For all vesting accounts, the owner of the vesting account is able to delegate and undelegate from validators, however they cannot transfer coins to another -account until those coins are vested. This specification allows for three +account until those coins are vested. This specification allows for four different kinds of vesting: - Delayed vesting, where all coins are vested once `ET` is reached. @@ -53,13 +53,15 @@ vesting account in that coins can be released in staggered tranches. For example, a periodic vesting account could be used for vesting arrangements where coins are relased quarterly, yearly, or over any other function of tokens over time. +- Permanent locked vesting, where coins are locked forever. Coins in this account can +still be used for delegating and for governance votes even while locked. ## Note Vesting accounts can be initialized with some vesting and non-vesting coins. -The non-vesting coins would be immediately transferable. The current -specification does not allow for vesting accounts to be created with normal -messages after genesis. All vesting accounts must be created at genesis, or as +The non-vesting coins would be immediately transferable. DelayedVesting and +ContinuousVesting accounts can be created with normal messages after genesis. +Other types of vesting accounts must be created at genesis, or as part of a manual network upgrade. The current specification only allows for _unconditional_ vesting (ie. there is no possibility of reaching `ET` and having coins fail to vest). @@ -132,6 +134,10 @@ type ViewKeeper interface { } ``` +### PermanentLockedAccount + ++++ https://github.com/cosmos/cosmos-sdk/blob/v0.40.0/proto/cosmos/vesting/v1beta1/vesting.proto#L78-L83 + ## Vesting Account Specification Given a vesting account, we define the following in the proceeding operations: @@ -614,3 +620,5 @@ linearly over time. all coins at a given time. - PeriodicVestingAccount: A vesting account implementation that vests coins according to a custom vesting schedule. +- PermanentLockedAccount: It does not ever release coins, locking them indefinitely. +Coins in this account can still be used for delegating and for governance votes even while locked. \ No newline at end of file