How to create, issue and transfer a token

Prerequisites

• You have clio installed on your machine and you have unlocked your wallet.

Steps

Step 1: Clone wire-system-contracts repo

Navigate to a directory of your choice and pull the source code.

git clone https://github.com/Wire-Network/wire-system-contracts --branch master --single-branch

cd CONTRACTS_DIR/wire-system-contracts/contracts/sysio.token

Step 2: Create Account for Contract

clio create account sysio sysio.token EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV

Step 3: Compile the Contract

cdt-cpp -I include -o sysio.token.wasm src/sysio.token.cpp --abigen

Step 4: Deploy the Token Contract

clio set contract sysio.token CONTRACTS_DIR/sysio.contracts/contracts/sysio.token --abi sysio.token.abi -p sysio.token@active

Expected output:

Reading WASM from ...
Publishing contract...
executed transaction: 69c68b1bd5d61a0cc146b11e89e11f02527f24e4b240731c4003ad1dc0c87c2c  9696 bytes  6290 us
#         sysio <= sysio::setcode               {"account":"sysio.token","vmtype":0,"vmversion":0,"code":"0061736d0100000001aa011c60037f7e7f0060047f...
#         sysio <= sysio::setabi                {"account":"sysio.token","abi":"0e656f73696f3a3a6162692f312e30000605636c6f73650002056f776e6572046e61...
warning: transaction executed locally, but may not be confirmed by the network yet         ]

Step 5: Create the Token

clio push action sysio.token create '[ "sysio", "1000000000.0000 SYS"]' -p sysio.token@active

Below is an alternate approach uses named arguments:

clio push action sysio.token create '{"issuer":"sysio", "maximum_supply":"1000000000.0000 SYS"}' -p sysio.token@active

info

This command creates a new token SYS with a precision of 4 decimals and a maximum supply of 1000000000.0000 SYS. This action requires authorization from the sysio.token contract, which is why we include the -p sysio.token@active flag to provide the necessary permission.

Expected output

executed transaction: 0e49a421f6e75f4c5e09dd738a02d3f51bd18a0cf31894f68d335cd70d9c0e12  120 bytes  1000 cycles
#   sysio.token <= sysio.token::create          {"issuer":"sysio","maximum_supply":"1000000000.0000 SYS"}

Step 6: Issue Tokens

The issuer can issue new tokens to the issuer account, in our case - sysio.

clio push action sysio.token issue '[ "sysio", "100.0000 SYS", "memo" ]' -p sysio@active

Expected output

executed transaction: a26b29d66044ad95edf0fc04bad3073e99718bc26d27f3c006589adedb717936  128 bytes  337 us
#   sysio.token <= sysio.token::issue           {"to":"sysio","quantity":"100.0000 SYS","memo":"memo"}
warning: transaction executed locally, but may not be confirmed by the network yet         ]

Step 7: Transfer Tokens

Now let's transfer some of sysio's tokens to bob's account.

clio push action sysio.token transfer '[ "sysio", "bob", "25.0000 SYS", "m" ]' -p sysio@active

Expected output

executed transaction: 60d334850151cb95c35fe31ce2e8b536b51441c5fd4c3f2fea98edcc6d69f39d  128 bytes  497 us
#   sysio.token <= sysio.token::transfer        {"from":"sysio","to":"bob","quantity":"25.0000 SYS","memo":"m"}
#         sysio <= sysio.token::transfer        {"from":"sysio","to":"bob","quantity":"25.0000 SYS","memo":"m"}
#           bob <= sysio.token::transfer        {"from":"sysio","to":"bob","quantity":"25.0000 SYS","memo":"m"}
warning: transaction executed locally, but may not be confirmed by the network yet         ]

Verify that bob received the tokens using clio get currency balance

clio get currency balance sysio.token bob SYS

Expected output:

25.00 SYS

Check sysio's balance and verify that tokens were indeed deducted from the account's balance.

clio get currency balance sysio.token sysio SYS

Expected output:

75.00 SYS