token.iost
简介
代币合约, 用于代币创建,发行,转账和销毁, 支持冻结功能, 支持配置代币全称,小数位数,转账属性等。
基础信息
contract_id | token.iost |
language | native |
version | 1.0.0 |
接口描述
create (tokenSym, issuer, totalSupply, config)
创建代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符,合约内唯一 | string |
issuer | 发行者,具有发行代币权限 | string |
totalSupply | 总发行量,整数 | number |
config | 配置 | json |
tokenSym 长度应在 2~16 位, 使用 a-z, 0-9, _ 字符
config 支持的配置项举例如下:
{
"fullName": "iost token", // 代币全称, string
"canTransfer": true, // 是否可交易, bool
"decimal": 8 // 小数位数, number
}
issue (tokenSym, to, amount)
发行代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
to | 代币接收账户 | string |
amount | 金额 | string |
amount 金额为字符串类型, 可以是整数或小数, 如 "100", "1.22" 都是合法的金额
transfer (tokenSym, from, to, amount, memo)
代币转账.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币转出账户 | string |
to | 代币接收账户 | string |
amount | 金额 | string |
memo | 附加信息 | string |
transferFreeze (tokenSym, from, to, amount, ftime, memo)
转账并冻结代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币转出账户 | string |
to | 代币接收账户 | string |
amount | 金额 | string |
ftime | 解冻时间,Unix时间戳的毫秒数 | number |
memo | 附加信息 | string |
destroy (tokenSym, from, amount)
销毁代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币转出账户 | string |
amount | 金额 | string |
balanceOf (tokenSym, from)
获取代币余额.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币账户 | string |
supply (tokenSym)
获取代币发行量,即已经issue且没有destroy的代币总额.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
totalSupply(tokenSym)
获取代币总发行量.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
token721.iost
简介
不可交换代币合约, 用于不可交换代币创建,发行,转账和销毁.
基础信息
contract_id | token721.iost |
language | native |
version | 1.0.0 |
接口描述
create (tokenSym, issuer, totalSupply)
创建代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符,合约内唯一 | string |
issuer | 发行者,具有发行代币权限 | string |
totalSupply | 总发行量,整数 | number |
tokenSym 长度应在 2~16 位, 使用 a-z, 0-9, _ 字符
issue (tokenSym, to, metaData)
发行代币.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
to | 代币接收账户 | string |
metaData | 代币的meta数据 | string |
tokenID 为代币编号,在某一代币中,系统会为发行的每个代币生成一个代币编号,同种代币中编号不会重复.
transfer (tokenSym, from, to, tokenID)
代币转账.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币转出账户 | string |
to | 代币接收账户 | string |
tokenID | 代币ID | string |
balanceOf (tokenSym, from)
获取代币余额.
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
from | 代币账户 | string |
ownerOf (tokenSym, tokenID)
获取某个特定代币的拥有者
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
tokenID | 代币ID | string |
tokenOfOwnerByIndex(tokenSym, owner, index)
获取账户拥有的第index个代币
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
owner | 代币账户 | string |
index | 代币index,整数 | number |
tokenMetadata(tokenSym, tokenID)
获取代币的meta数据
参数名称 | 参数描述 | 参数类型 |
tokenSym | 代币标识符 | string |
tokenID | 代币ID | string |