Implement "Buy RAM Burn" ACTION

[DenisCarriere]

Purpose

Create buyramburn ACTION where any account can buy RAM and immediately burn the RAM bytes received.

Currently, the only way to purchase & buy RAM is to:

1. Buy RAM
2. Listen for inline action logbuyram to know how much bytes were purchased
3. Burn RAM bytes

Or

1. Compute buy RAM bytes
2. Buy RAM with EOS
3. Burn RAM based on pre-computed bytes

This buyramburn ACTION would eliminate the requirement of listening on logbuyram or pre-computing the Bancor RAM buying output.

Feedback provided by

• @DenisCarriere
• @nsjames
• Tim Weston / Rob

buyramburn ACTION

/**
 * Buy RAM and immediately burn RAM.
 * An inline transfer from payer to system contract of tokens will be executed.
 *
 * @param payer - the payer of buy RAM & burn.
 * @param quantity - the quantity of tokens to buy RAM & burn with.
 * @param memo - the memo string to accompany the transaction.
 */
[[eosio::action]]
void buyramburn( const name& payer, const asset& quantity, const std::string& memo );

Preconditions

• require_auth(payer)
• must provide quantity above 0 amount
• returns action_return_buyram
• no additional logging requirements since actions can be covered by logbuyram & logramchange

References

• buyramself
• ramburn

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

[DenisCarriere]

Implemented via: AntelopeIO/reference-contracts#62