CW20

Requires a localnet to be running.

Download contract bytecode

curl -Lso cw20_base.wasm \
https://github.com/CosmWasm/cw-plus/releases/download/v2.0.0/cw20_base.wasm

Store contract

Upload the contract bytecode so that it can be instantiated (next step).

FROM=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl

nibid tx wasm store cw20_base.wasm \
--from $FROM \
--gas auto \
--gas-adjustment 1.5 \
--gas-prices 0.025unibi \
--yes | tx

Take note of the code id for the next step, e.g.

{
  "type": "store_code",
  "attributes": [
    {
      "key": "code_checksum",
      "value": "4d8e90dd340993033f1b9e8e3a3ee7f8673c582ca9bcdd8c8cf3c7470d6537d5",
      "index": true
    },
    {
      "key": "code_id",
      "value": "2", // <-- take note of this
      "index": true
    }
  ]
}

Instantiate cw4 contract

Create a contract instance from the uploaded bytecode. Use the code id from the previous step.

CODE_ID=2 # code id from last step
FROM=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl

cat << EOF | jq | tee instantiage_args.json
{
    "name": "Tutorial Token",
    "symbol": "TUT",
    "decimals": 6,
    "initial_balances": [],
    "mint": {
        "minter": "$FROM"
    }
}
EOF

nibid tx wasm instantiate $CODE_ID \
"$(cat instantiage_args.json)" \
--admin "$FROM" \
--label "contract label" \
--from $FROM \
--gas auto \
--gas-adjustment 1.5 \
--gas-prices 0.025unibi \
--yes | tx

Save the contract address for the next steps, e.g.

{
  "type": "instantiate",
  "attributes": [
    {
      "key": "_contract_address",
      "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
      "index": true
    },
    {
      "key": "code_id",
      "value": "2",
      "index": true
    }
  ]
}

(Optional) Queries

Query token info

CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a

nibid q wasm contract-state smart \
$CONTRACT_ADDRESS \
'{"token_info": {}}' | jq ".data"

Output:

{
  "name": "Tutorial Token",
  "symbol": "TUT",
  "decimals": 6,
  "total_supply": "0"
}

Query minter info

CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a

nibid q wasm contract-state smart \
$CONTRACT_ADDRESS \
'{"minter": {}}' | jq ".data"

Mint some tokens

Only nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl can mint tokens because we specified that address in the instantiation step. If no minter were specified, no tokens can ever be minted.

FROM=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl
CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a

cat << EOF | jq | tee mint_args.json
{
    "mint": {
        "recipient": "$FROM",
        "amount": "100"
    }
}
EOF

nibid tx wasm execute \
$CONTRACT_ADDRESS \
"$(cat mint_args.json)" \
--from $FROM \
--gas auto \
--gas-adjustment 1.5 \
--gas-prices 0.025unibi \
--yes | tx

Example output

{
  "height": "18957",
  "txhash": "1A9223D2E570A5AE521A738BFF2A3346165723DB2287CD7B31167E2540150F25",
  "codespace": "",
  "code": 0,
  "data": "122E0A2C2F636F736D7761736D2E7761736D2E76312E4D736745786563757465436F6E7472616374526573706F6E7365",
  "raw_log": "[{\"msg_index\":0,\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"/cosmwasm.wasm.v1.MsgExecuteContract\"},{\"key\":\"sender\",\"value\":\"nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl\"},{\"key\":\"module\",\"value\":\"wasm\"}]},{\"type\":\"execute\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a\"}]},{\"type\":\"wasm\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a\"},{\"key\":\"action\",\"value\":\"mint\"},{\"key\":\"to\",\"value\":\"nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl\"},{\"key\":\"amount\",\"value\":\"100\"}]}]}]",
  "logs": [
    {
      "msg_index": 0,
      "log": "",
      "events": [
        {
          "type": "message",
          "attributes": [
            {
              "key": "action",
              "value": "/cosmwasm.wasm.v1.MsgExecuteContract"
            },
            {
              "key": "sender",
              "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl"
            },
            {
              "key": "module",
              "value": "wasm"
            }
          ]
        },
        {
          "type": "execute",
          "attributes": [
            {
              "key": "_contract_address",
              "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a"
            }
          ]
        },
        {
          "type": "wasm",
          "attributes": [
            {
              "key": "_contract_address",
              "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a"
            },
            {
              "key": "action",
              "value": "mint"
            },
            {
              "key": "to",
              "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl"
            },
            {
              "key": "amount",
              "value": "100"
            }
          ]
        }
      ]
    }
  ],
  "info": "",
  "gas_wanted": "165172",
  "gas_used": "128923",
  "tx": {
    "@type": "/cosmos.tx.v1beta1.Tx",
    "body": {
      "messages": [
        {
          "@type": "/cosmwasm.wasm.v1.MsgExecuteContract",
          "sender": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "contract": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "msg": {
            "mint": {
              "recipient": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
              "amount": "100"
            }
          },
          "funds": []
        }
      ],
      "memo": "",
      "timeout_height": "0",
      "extension_options": [],
      "non_critical_extension_options": []
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "@type": "/cosmos.crypto.secp256k1.PubKey",
            "key": "AvzwBOriY8sVwEXrXf1gXanhT9imlfWeUWLQ8pMxrRsg"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_DIRECT"
            }
          },
          "sequence": "10"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "unibi",
            "amount": "4130"
          }
        ],
        "gas_limit": "165172",
        "payer": "",
        "granter": ""
      },
      "tip": null
    },
    "signatures": [
      "D06IUsnySLTNEqRjOX+7IRGjAMn/yJ9g1lbaSVLlGBMVE+tU4CY2PxIm5l/1HoSVJ+XByi3AyHht76x0lzQiIQ=="
    ]
  },
  "timestamp": "2024-05-11T15:05:28Z",
  "events": [
    {
      "type": "coin_spent",
      "attributes": [
        {
          "key": "spender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "amount",
          "value": "4130unibi",
          "index": true
        }
      ]
    },
    {
      "type": "coin_received",
      "attributes": [
        {
          "key": "receiver",
          "value": "nibi17xpfvakm2amg962yls6f84z3kell8c5l8u8ezw",
          "index": true
        },
        {
          "key": "amount",
          "value": "4130unibi",
          "index": true
        }
      ]
    },
    {
      "type": "transfer",
      "attributes": [
        {
          "key": "recipient",
          "value": "nibi17xpfvakm2amg962yls6f84z3kell8c5l8u8ezw",
          "index": true
        },
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "amount",
          "value": "4130unibi",
          "index": true
        }
      ]
    },
    {
      "type": "message",
      "attributes": [
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "fee",
          "value": "4130unibi",
          "index": true
        },
        {
          "key": "fee_payer",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "acc_seq",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl/10",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "signature",
          "value": "D06IUsnySLTNEqRjOX+7IRGjAMn/yJ9g1lbaSVLlGBMVE+tU4CY2PxIm5l/1HoSVJ+XByi3AyHht76x0lzQiIQ==",
          "index": true
        }
      ]
    },
    {
      "type": "message",
      "attributes": [
        {
          "key": "action",
          "value": "/cosmwasm.wasm.v1.MsgExecuteContract",
          "index": true
        },
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "module",
          "value": "wasm",
          "index": true
        }
      ]
    },
    {
      "type": "execute",
      "attributes": [
        {
          "key": "_contract_address",
          "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "index": true
        }
      ]
    },
    {
      "type": "wasm",
      "attributes": [
        {
          "key": "_contract_address",
          "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "index": true
        },
        {
          "key": "action",
          "value": "mint",
          "index": true
        },
        {
          "key": "to",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "amount",
          "value": "100",
          "index": true
        }
      ]
    }
  ]
}

Query balance

CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a
USER=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl

cat << EOF | jq | tee query_balance_args.json
{
    "balance": {
        "address": "$USER"
    }
}
EOF

nibid q wasm contract-state smart \
$CONTRACT_ADDRESS \
"$(cat query_balance_args.json)" | jq ".data"

Output:

{
  "balance": "100"
}

Transfer tokens

FROM=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl
RECIPIENT=nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4
CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a

cat << EOF | jq | tee transfer_args.json
{
    "transfer": {
        "recipient": "$RECIPIENT",
        "amount": "15"
    }
}
EOF

nibid tx wasm execute \
$CONTRACT_ADDRESS \
"$(cat transfer_args.json)" \
--from $FROM \
--gas auto \
--gas-adjustment 1.5 \
--gas-prices 0.025unibi \
--yes | tx

Example output

{
  "height": "19108",
  "txhash": "E245D157C3026951ED9134B9E35ECBBB93D53250A011D35E8B46F0E7D0C9001C",
  "codespace": "",
  "code": 0,
  "data": "122E0A2C2F636F736D7761736D2E7761736D2E76312E4D736745786563757465436F6E7472616374526573706F6E7365",
  "raw_log": "[{\"msg_index\":0,\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"/cosmwasm.wasm.v1.MsgExecuteContract\"},{\"key\":\"sender\",\"value\":\"nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl\"},{\"key\":\"module\",\"value\":\"wasm\"}]},{\"type\":\"execute\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a\"}]},{\"type\":\"wasm\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a\"},{\"key\":\"action\",\"value\":\"transfer\"},{\"key\":\"from\",\"value\":\"nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl\"},{\"key\":\"to\",\"value\":\"nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4\"},{\"key\":\"amount\",\"value\":\"15\"}]}]}]",
  "logs": [
    {
      "msg_index": 0,
      "log": "",
      "events": [
        {
          "type": "message",
          "attributes": [
            {
              "key": "action",
              "value": "/cosmwasm.wasm.v1.MsgExecuteContract"
            },
            {
              "key": "sender",
              "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl"
            },
            {
              "key": "module",
              "value": "wasm"
            }
          ]
        },
        {
          "type": "execute",
          "attributes": [
            {
              "key": "_contract_address",
              "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a"
            }
          ]
        },
        {
          "type": "wasm",
          "attributes": [
            {
              "key": "_contract_address",
              "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a"
            },
            {
              "key": "action",
              "value": "transfer"
            },
            {
              "key": "from",
              "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl"
            },
            {
              "key": "to",
              "value": "nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4"
            },
            {
              "key": "amount",
              "value": "15"
            }
          ]
        }
      ]
    }
  ],
  "info": "",
  "gas_wanted": "160210",
  "gas_used": "125616",
  "tx": {
    "@type": "/cosmos.tx.v1beta1.Tx",
    "body": {
      "messages": [
        {
          "@type": "/cosmwasm.wasm.v1.MsgExecuteContract",
          "sender": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "contract": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "msg": {
            "transfer": {
              "recipient": "nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4",
              "amount": "15"
            }
          },
          "funds": []
        }
      ],
      "memo": "",
      "timeout_height": "0",
      "extension_options": [],
      "non_critical_extension_options": []
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "@type": "/cosmos.crypto.secp256k1.PubKey",
            "key": "AvzwBOriY8sVwEXrXf1gXanhT9imlfWeUWLQ8pMxrRsg"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_DIRECT"
            }
          },
          "sequence": "11"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "unibi",
            "amount": "4006"
          }
        ],
        "gas_limit": "160210",
        "payer": "",
        "granter": ""
      },
      "tip": null
    },
    "signatures": [
      "6CVh63mxzQra+LiiKtmV8i18RrFwOEbXBFbtfLEzpMNgQ3F94n1DADjN148Yo6tTH3gAHUBhGSRR51S3MAtQyQ=="
    ]
  },
  "timestamp": "2024-05-11T15:08:03Z",
  "events": [
    {
      "type": "coin_spent",
      "attributes": [
        {
          "key": "spender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "amount",
          "value": "4006unibi",
          "index": true
        }
      ]
    },
    {
      "type": "coin_received",
      "attributes": [
        {
          "key": "receiver",
          "value": "nibi17xpfvakm2amg962yls6f84z3kell8c5l8u8ezw",
          "index": true
        },
        {
          "key": "amount",
          "value": "4006unibi",
          "index": true
        }
      ]
    },
    {
      "type": "transfer",
      "attributes": [
        {
          "key": "recipient",
          "value": "nibi17xpfvakm2amg962yls6f84z3kell8c5l8u8ezw",
          "index": true
        },
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "amount",
          "value": "4006unibi",
          "index": true
        }
      ]
    },
    {
      "type": "message",
      "attributes": [
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "fee",
          "value": "4006unibi",
          "index": true
        },
        {
          "key": "fee_payer",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "acc_seq",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl/11",
          "index": true
        }
      ]
    },
    {
      "type": "tx",
      "attributes": [
        {
          "key": "signature",
          "value": "6CVh63mxzQra+LiiKtmV8i18RrFwOEbXBFbtfLEzpMNgQ3F94n1DADjN148Yo6tTH3gAHUBhGSRR51S3MAtQyQ==",
          "index": true
        }
      ]
    },
    {
      "type": "message",
      "attributes": [
        {
          "key": "action",
          "value": "/cosmwasm.wasm.v1.MsgExecuteContract",
          "index": true
        },
        {
          "key": "sender",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "module",
          "value": "wasm",
          "index": true
        }
      ]
    },
    {
      "type": "execute",
      "attributes": [
        {
          "key": "_contract_address",
          "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "index": true
        }
      ]
    },
    {
      "type": "wasm",
      "attributes": [
        {
          "key": "_contract_address",
          "value": "nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a",
          "index": true
        },
        {
          "key": "action",
          "value": "transfer",
          "index": true
        },
        {
          "key": "from",
          "value": "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl",
          "index": true
        },
        {
          "key": "to",
          "value": "nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4",
          "index": true
        },
        {
          "key": "amount",
          "value": "15",
          "index": true
        }
      ]
    }
  ]
}

Query balances

The first user's balance should be 85

CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a
USER=nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl

cat << EOF | jq | tee query_balance_args.json
{
    "balance": {
        "address": "$USER"
    }
}
EOF

nibid q wasm contract-state smart \
$CONTRACT_ADDRESS \
"$(cat query_balance_args.json)" | jq ".data"

The second user's balance should be 15

CONTRACT_ADDRESS=nibi1aakfpghcanxtc45gpqlx8j3rq0zcpyf49qmhm9mdjrfx036h4z5sxn9f7a
USER=nibi1gc6vpl9j0ty8tkt53787zps9ezc70kj88hluw4

cat << EOF | jq | tee query_balance_args.json
{
    "balance": {
        "address": "$USER"
    }
}
EOF

nibid q wasm contract-state smart \
$CONTRACT_ADDRESS \
"$(cat query_balance_args.json)" | jq ".data"