EOS 1.3 Contract Development Toolkit Updates

Categories:

The EOSIO Contract Development Toolkit, which serves as the way to compile your smart contracts in the future, recently released the new 1.32 Version with quite some breaking changes. The changes were made to prepare the binary release of the toolkit, so you don’t have to compile the toolkit yourself anymore, and to clean up some code. For example, some oddities were removed from the EOS code like the N macro and other typedefs while making the creation of an ABI easier with the ACTION, TABLE and CONTRACT macros.

Furthermore, the eosio::contract constructor changed and with the EOSIO_ABI macro rename to EOSIO_DISPATCH and the removal of the currency class, it left many contract developers puzzled how to listen to eosio.token transfers in their smart contracts. The EOSIO.CDT v1.3 way to dispatch both your internal actions and listen to eosio.token::transfer actions looks like this:

// test.hpp
#include <eosiolib/eosio.hpp>
#include <eosiolib/asset.hpp>

#define EOS_SYMBOL symbol("EOS", 4)

CONTRACT test : public eosio::contract
{
  test(name receiver, name code, datastream<const char *> ds) 
  : contract(receiver, code, ds), games(receiver, receiver.value) {}

  public:
    struct init
    {
        init(){};
        eosio::name name;
        EOSLIB_SERIALIZE(init, (name))
    };

    ACTION init(eosio::name name);
    void transfer(
        eosio::name from,
        eosio::name to,
        eosio::asset quantity,
        std::string memo
    );
};

// test.cpp
#include "./test.hpp"

using namespace eosio;
using namespace std;

void test::init(name name)
{
    require_auth(_self);
}

void test::transfer(name from, name to, asset quantity, string memo)
{
    if (from == _self)
    {
        // we're sending money, do nothing additional
        return;
    }

    eosio_assert(to == _self, "contract is not involved in this transfer");
    eosio_assert(quantity.symbol.is_valid(), "invalid quantity");
    eosio_assert(quantity.amount > 0, "only positive quantity allowed");
    eosio_assert(quantity.symbol == EOS_SYMBOL, "only EOS tokens allowed");
}

extern "C" void apply(uint64_t receiver, uint64_t code, uint64_t action)
{
    if (code == "eosio.token"_n.value && action == "transfer"_n.value)
    {
        eosio::execute_action(
            eosio::name(receiver), eosio::name(code), &test::transfer
        );
    }
    else if (code == receiver)
    {
        switch (action)
        {
            EOSIO_DISPATCH_HELPER(test, (init))
        }
    }
}

I created a yeoman generator generator-eos that scaffolds new EOS smart contract projects and works with the latest version of EOS Contract Developer Toolkit. It runs using Node.js and includes some helpful NPM scripts like automatically creating actions to run based on your contract’s ABI.

Learn EOS Development Signup

Hi, I'm Christoph Michel 👋

I'm a , , and .

Currently, I mostly work in software security and do on an independent contractor basis.

I strive for efficiency and therefore track many aspects of my life.