TRC21 Exchange/Wallet integration
This tutorial will walk through integrating TRC21 tokens to applications (e.g., wallet, exchange)
Prerequisites
TRC21 Contract Interface:
1
function totalSupply() external view returns (uint256);
2
function balanceOf(address who) external view returns (uint256);
3
function estimateFee(uint256 value) external view returns (uint256);
4
function issuer() external view returns (address);
5
function allowance(address owner, address spender) external view returns (uint256);
6
function transfer(address to, uint256 value) external returns (bool);
7
function approve(address spender, uint256 value) external returns (bool);
8
function transferFrom(address from, address to, uint256 value) external returns (bool);
9
10
event Transfer(address indexed from, address indexed to, uint256 value);
11
event Approval(address indexed owner, address indexed spender, uint256 value);
12
event Fee(address indexed from, address indexed to, address indexed issuer, uint256 value);
Copied!
Users are recommended to refer to the TRC21 Specification for more details about the TRC21 token standard.
Follow the steps below to interact with the smart contract by using the Web3 library and Node.
Initialize Web3 provider
As a first step, we need to initialize a Web3 provider by connecting to TomoChain Full node RPC endpoint.
Look at the TomoChain Networks page to get more information of the TomoChain Testnet/Mainnet RPC network.
1
const Web3 = require('web3')
2
const web3 = new Web3('https://rpc.tomochain.com')
3
const chainId = 88
Copied!
Unlock wallet
Unlock the wallet before interacting with TRC21 token contracts
Example
1
// Unlock wallet by private key
2
const account = web3.eth.accounts.privateKeyToAccount(pkey)
3
const holder = account.address
4
web3.eth.accounts.wallet.add(account)
5
web3.eth.defaultAccount = holder
Copied!
Initialize Web3 TRC21 Contract
1
const trc21Abi = require('./TRC21.json')
2
const address = '[enter_your_contract_address]'
3
const trc21 = new web3.eth.Contract(trc21Abi,
4
address, {gasPrice: 250000000, gas: 2000000 })
Copied!
Check balance
Call function
balanceOf() from TRC21 contract to check the token balance for an address.Example
1
trc21.methods.balanceOf(holder).call()
2
.then((result) => {
3
console.log(result)
4
}).catch(e => console.log(e))
Copied!
Estimate fee
Before sending tokens, we need to check TX fee by calling
estimateFee function in TRC21 smart contract.Example
1
trc21.methods.estimateFee().call()
2
.then((result) => {
3
console.log(result)
4
}).catch(e => console.log(e))
Copied!
Note: this fee is the amount of the token that needs to be paid to send the TRC21 token applied to TomoZ
Transfer token
The Token holder needs to call function
transfer to send token to an addressExample
1
// send 500000000000000000000 tokens to this address (e.g decimals 18)
2
const to = "0xf8ac9d5022853c5847ef75aea0104eed09e5f402"
3
trc21.methods.transfer(to, '500000000000000000000').send({
4
from: holder,
5
gas: 2000000,
6
gasPrice: 250000000,
7
chainId: chainId
8
})
9
.then((result) => {
10
console.log(result)
11
}).catch(e => console.log(e))
Copied!
Checking TomoZ
Call
getTokenCapacity to https://scan.tomochain.com/address/0x8c0faeb5c6bed2129b8674f262fd45c4e9468bee#readContract. If the return value > 0, the token has successfully been enabled by the TomoZ protocol.Last modified 1yr ago