Implement "Unvest" ACTION

[DenisCarriere]

Purpose

Introduce the unvest ACTION to enable the revocation of unallocated vested staked tokens from a designated account that meets specific vesting preconditions set by the system contract. This action requires the return of these tokens to the eosio system account.

Feedback provided by

• @DenisCarriere
• @nsjames
• Tim Weston / Rob

unvest ACTION Specification

/**
 * Facilitates the removal of vested staked tokens from an account, ensuring that these tokens are reallocated to the system's pool.
 *
 * @param account - the target account from which tokens are to be unvested.
 * @param stake_net_quantity - the amount of NET tokens to unvest.
 * @param stake_cpu_quantity - the amount of CPU tokens to unvest.
 */
[[eosio::action]]
void unvest(const name account, const asset stake_net_quantity, const asset stake_cpu_quantity);

Preconditions

• System authentication through require_auth(eosio) is mandatory.
• The stake_net_quantity must not surpass the net_weight attributed to the account in userres.
• The stake_cpu_quantity must not exceed the cpu_weight linked to the account in userres.
• The unvested tokens will be transferred directly to the eosio system account.
• Normal unstaking periods will be disregarded during this process.
• The voting weight associated with the account will be recalibrated subsequent to the token unvesting.
• Unvest action can only be applied to b1 account

References

• changebw

Note: changes should be pushed to Antelope Reference contracts https://github.com/AntelopeIO/reference-contracts

[DenisCarriere]

Implemented via AntelopeIO/reference-contracts@d664b5a