Implement "Issue Fixed" ACTION

[DenisCarriere]

Purpose

Introduce an issuefixed ACTION that enables the token issuer to allocate tokens up to a predetermined supply cap. This action will only issue the necessary quantity of tokens to bridge the gap between the existing supply and the specified cap, ensuring no excess issuance occurs.

Feedback provided by

• @DenisCarriere
• @nsjames
• Tim Weston / Rob

issuefixed ACTION

 /**
  * Issues only the necessary tokens to bridge the gap between the current supply and the targeted total.
  *
  * @param to - the account to issue tokens to, it must be the same as the issuer,
  * @param supply - the target total supply for the token.
  * @param memo - the memo string that accompanies the token issue transaction.
  */
 [[eosio::action]]
 void issuefixed( const name& to, const asset& supply, const string& memo );

Preconditions

• require_auth(issuer)
• supply must not exceed the maximum_supply of the token.
• supply must be greater than the current supply.
• supply.symbol must match the token's symbol.

References

• eosio.token::issue
• eosio.token::stat

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

[DenisCarriere]

Implemented via: AntelopeIO/reference-contracts@477b696