DART SDK
XRC20 Token Standard
XRC20 is the technical standard for fungible tokens issued on the XDC blockchain. XRC20 tokens have the property that makes each token exactly similar to one another in type and value. These tokens are blockchain-based assets that hold similar value and can easily be sent and received.
Read Methods
name() → string
Returns the name of the token.
symbol() → string
Returns the symbol of the token, usually a shorter version of the name.
decimals() → uint8
Returns the number of decimals used to get its user representation. For example, if decimal equals 2, a balance of 505 tokens should be displayed to a user as 5,05 (505 / 10 ** 2).
Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei.
totalSupply() → uint256
Returns the number of tokens in existence.
balanceOf(address account) → uint256
Returns the number of tokens owned by the account.
allowance(address owner, address spender) → uint256
Returns the remaining number of tokens that the spender will be allowed to spend on behalf of the owner through transferFrom
. It is zero by default.
Write Methods
approve(address spender, uint256 amount)
Sets amount as the allowance of spender over the caller’s tokens.
transfer(address recipient, uint256 amount)
Moves tokens from the caller’s account to the recipient.
transferFrom(address sender, address recipient, uint256 amount)
Moves tokens from sender to recipient using the allowance mechanism. The amount is deducted from the caller’s allowance.
increaseAllowance(address spender, uint256 addedValue)
Automatically increases the allowance granted to spender by the caller.
decreaseAllowance(address spender, uint256 addedValue)
Automatically decreases the allowance granted to spender by the caller.
Usage
Add XDC3DART = "1.0.0" to your pubspec.yaml
:
Run the following command to install all the packages and dependencies:
Create an instance of XRC20
Now, you can interact with the XRC20 read methods.
name() → string
Returns the name of the token.
balanceOf(address token,address account) → BigInt
Returns the amount of tokens owned byaccount
.
For write methods:
transfer(address token, address recipient, BigInt amount)
→ Moves amount tokens from the caller’s account to recipient. It will return a transaction hash.
approve(address token, address spender, BigInt amount)
→ Sets amount as the allowance of spender over the caller’s tokens. It will return a transaction hash.
For increaseAllowance
we need an instance of XRC20 and the private key of the owner
increaseAllowance(XifninAccount account, address token, address owner, address spender, BigInt increase_amount)
For decreaseAllowance
we need an instance of XRC20 and the private key of the owner
decreaseAllowance(XifninAccount account, address token, address owner, address spender, BigInt decrease_amount)
Last updated