How to deploy Fungible token on WAX blockchain

Prerequisites

• cdt: Contract development toolkit for developing the contract
• leap: Include the cleos command line tool to interact with the blockchain.

Build token contract

For easier to setup and deploy, original token contract has been copied from wax-contract to this repo. Prebuilt contract store on build folder.

In case you want to build contract:

$ cdt-cpp -abigen -R eosio.token/ricardian eosio.token/src/eosio.token.cpp -o ./build/eosio.token.wasm -I eosio.token/include --no-missing-ricardian-clause

Deploy contract

1. Create contract account

Note Contract account need at least 160kb to store contract and setup table, make sure you buy enough RAM.

$ cleos system newaccount eosio tokenexample EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV --stake-net "10.00000000 WAX" --stake-cpu "10.00000000 WAX" --buy-ram-kbytes 160 --transfer

2. Deploy token contract

$ cleos set contract tokenexample . build/eosio.token.wasm build/eosio.token.abi -p tokenexample

3. Check deploy contract

$ cleos get code tokenexample
code hash: 64ac1483b2ff62a4d36173882dca2a278c50e11136b70370123da6775e63659b

Configure token

1. Create new token

Call action create of token contract:

• require contract permission
• parameters:
  • issuer: issuer account, account has permission to issue and retire token
  • maximum_supply: maximum supply of token, make sure that you have correct number since it can not be changed

$ cleos push action tokenexample create '["tokenissuer", "1000000000.0000 EXP"]' -p tokenexample

2. Issue token

Call action issue of token contract:

• require issuer permission
• parameters:
  • to: token receiver
  • quantity: quantity to issue
  • memo

$ cleos push action tokenexample issue '["tokenissuer", "1000000.0000 EXP", "first issue"]' -p tokenissuer

Get stat table to check issued amount:

$ cleos get table tokenexample EXP stat
{
  "rows": [{
      "supply": "1000000.0000 EXP",
      "max_supply": "1000000000.0000 EXP",
      "issuer": "tokenexample"
    }
  ],
  "more": false,
  "next_key": ""
}

Check token balance:

$ cleos get table tokenexample tokenissuer accounts
{
  "rows": [{
      "balance": "1000000.0000 EXP"
    }
  ],
  "more": false,
  "next_key": ""
}

3. Burn token

Call retire action of token contract:

• require issuer permission
• issuer balance must greater than burn amount
• parameters:
  • quantity: burning quantity
  • memo

$ cleos push action tokenexample retire '["1.0000 EXP", "first burn"]' -p tokenissuer

Check token stat after burn:

$ cleos get table tokenexample EXP stat
{
  "rows": [{
      "supply": "999999.0000 EXP",
      "max_supply": "1000000000.0000 EXP",
      "issuer": "tokenexample"
    }
  ],
  "more": false,
  "next_key": ""
}