Skip to content

MRC20 Integration Technical Guide#

This document explains the basics of interacting with an MRC20 contract with the metrixd and metrix-cli CLI command tool.

Full example from Qtum Qrc20.php

Intro#

We recommend that an exchange use one main address to store tokens for all users. Below MAIN_MRC_ADDRESS is the main address.

The address of the MRC20 token contract is TOKEN_CONTRACT_ADDRESS.

gas limit is DEFAULT_GAS_LIMIT, recommended value is 500000 gas price is DEFAULT_GAS_PRICE，recommended value is 0.00005000 TOKEN_DECIMALS is the decimals of the token, which varies per token. Here we set it 8.

We'll use the following utility functions:

Running METRIXD#

You should remember to enable the indexing service when starting metrixd, using the flags -logevents -txindex.

Interacting With MRC20#

In the CLI examples below, please substitute {} with actual addresses and values.

Getting Token Balance#

$userAddress is the deposit address

metrix-cli callcontract \
    {TOKEN_CONTRACT_ADDRESS} \
    70a08231{to32bytesArg(addressToHash160($userAddress))}

In the JSON output look for executionResult.output. This is the token balance.

Withdraw#

$userAddress is the withdraw address $amount the withdraw amount in unit token

metrix-cli sendtocontract \
    {TOKEN_CONTRACT_ADDRESS} \
    a9059cbb{to32bytesArg(addressToHash160($userAddress))}{to32bytesArg(addDecimals($amount)) \
    0 \
    {DEFAULT_GAS_LIMIT} \
    {DEFAULT_GAS_PRICE} \
    {MAIN_MRC_ADDRESS}

The command returns the txid of this transaction. You may use it to find information about this transaction (e.g. number of confirmations).

Generate a deposit address#

For an exchange, a user may use the same address for both MRX and other MRC20 tokens.

Use this command to generate a deposit address:

metrix-cli getnewaddress

Deposit and Witdraw Logs#

$startingBlock is where you want to start looking (inclursive) You can start looking from 0, but for better efficiency, you should remember where to start looking.

metrix-cli searchlogs \
    STARTING_BLOCK \
    999999999 \
    '{ "addresses": ["TOKEN_CONTRACT_ADDRESS"]}' \
    '{"topics": ["ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]}'

The event type filtered is the Transfer event:

event Transfer(address indexed _from, address indexed _to, uint256 _value)

Look through the logs to filter by to or from addresses.

Checking Confirmations#

Given a transaction id $txid:

metrix-cli gettransaction $txid

Use the property confirmations from output.