TRC10通证 (Asset)

getAssetIssueByAccount

查询账户发行的 TRC10 通证。

用法

getAssetIssueByAccount(address)

参数

参数	描述	类型
address	发行者账户地址，Base58check 格式或 HEX 格式	String

返回值

AssetIssueList 对象。

示例

wrapper.getAssetIssueByAccount("TD9tMPSfBJ3To8s71vdBz2BLT2wwBNWyLc");

执行结果：

assets {
    owner_address: "A\"\355b\226~\320\322\030k/\3069\327\227-\027*\225\310U"
    name: "lsp1"
    abbr: "saf1"
    total_supply: 100000000
    frozen_supply {
      frozen_amount: 1
      frozen_days: 1
    }
    trx_num: 1
    precision: 6
    num: 1000
    start_time: 1609833139923
    end_time: 1610833137923
    description: "newlsp"
    url: "sadf"
    free_asset_net_limit: 1
    public_free_asset_net_limit: 2
    id: "1000204"
  }

getAssetIssueById

根据 ID 查询 TRC10 通证。

用法

getAssetIssueById(assetId)

参数

参数	描述	类型
assetId	TRC10 通证 id	String

返回值

AssetIssueContract 对象。

示例

wrapper.getAssetIssueById("1000200");

执行结果：

owner_address: "Aw\326^\303g\274`\360\216\276\327\302k\023\274\226\232S\364\217"
  name: "lsp"
  abbr: "saf"
  total_supply: 1
  frozen_supply {
    frozen_amount: 1
    frozen_days: 1
  }
  trx_num: 1
  precision: 1
  num: 1000
  start_time: 1609826985753
  end_time: 1610826983753
  description: "stest-assetissue"
  url: "7777772e6578616d706c652e636f6d"
  free_asset_net_limit: 100000
  public_free_asset_net_limit: 1
  id: "1000200"

getAssetIssueList

查询所有 TRC10 通证列表。

用法

getAssetIssueList()

参数

无

返回值

AssetIssueList 对象。

示例

wrapper.getAssetIssueList();

执行结果：

assets {
    owner_address: "A~\225\344_Z`\314E\362\320\257\343~\351\367\177\270\316\237\377"
    name: "tronlink_token"
    abbr: "tronlink_token"
    total_supply: 1000000000000000
    frozen_supply {
      frozen_amount: 1
      frozen_days: 1
    }
    trx_num: 1
    precision: 6
    num: 1
    start_time: 1574757000000
    end_time: 1757595000000
    description: "Description"
    url: "https://blog.csdn.net/u010270891/article/details/82978260"
    free_asset_net_limit: 1000
    public_free_asset_net_limit: 2000
    id: "1000001"
  }
 ...

getPaginatedAssetIssueList

分页查询 TRC10 通证列表。

用法

getPaginatedAssetIssueList(offset, limit)

参数

参数	描述	类型
offset	起始条目偏移值	long
limit	每页结果数	long

返回值

AssetIssueList 对象。

示例

wrapper.getPaginatedAssetIssueList(0,20);

执行结果：

assets {
    owner_address: "A\250\251\006\315\235^\177\363\344r\323L\245hD\034\356\264\317["
    name: "00Dice"
    abbr: "0x0"
    total_supply: 1000000000000000000
    trx_num: 1000000
    precision: 6
    num: 100000000
    start_time: 1592841600000
    end_time: 1592928000000
    description: "\347\224\250\344\272\216\346\265\213\350\257\225"
    url: "https://www.baidu.com"
    id: "1000052"
  }
  ...

TransferTrc10

转账 TRC10 通证。

用法

transferTrc10(fromAddress, toAddress, tokenId, amount)

参数

参数	描述	类型
fromAddress	转出地址，HEX 格式或 Base58check 格式	String
toAddress	接收地址，HEX 格式或 Base58check 格式	String
tokenId	通证 ID 作为字符串，HEX 格式	int
amount	转账通证数量	int

返回值

TransactionExtention，包括执行结果。

异常

IllegalException，转账 TRC10 失败时抛出此异常。

示例

TransactionExtention transactionExtention = wrapper.transferTrc10("TLtrDb1udekjDumnrf3EVeke3Q6pHkZxjm", "TP8LKAf3R3FHDAcrQXuwBEWmaGrrUdRvzb",
                    1000016, 1_000_000);
Transaction signedTxn = wrapper.signTransaction(transactionExtention);
String ret = wrapper.broadcastTransaction(signedTxn);

执行结果：

ad42e2116d30cd55c9c9bb6b01ba940cdc411ca5c052454c66951f58eef79372

createAssetIssue

发行 TRC10 通证。

用法

createAssetIssue(ownerAddress, name, abbr, totalSupply, trxNum, icoNum, startTime, endTime, url, freeAssetNetLimit, publicFreeAssetNetLimit, precision, frozenSupply, description)

参数

参数	描述	类型
ownerAddress	发行人地址，Base58check 格式或 HEX 格式	String
name	通证名称，HEX 格式或 UTF8 字符串（visible 指定）	String
abbr	通证缩写，即通证代币符号。HEX 格式或 UTF8 字符串（visible 指定）	String
totalSupply	通证发行总量	long
trxNum	通证和 TRX 的最小单位兑换比	int
icoNum	-	int
startTime	通证发行开始时间	long
endTime	通证发行结束时间	long
url	通证的官方网站地址	String
freeAssetNetLimit	通证的总免费带宽	long
publicFreeAssetNetLimit	每个通证拥有者能使用的免费带宽数	long
precision	通证的精度，默认为6，最小是0，最大是6	int
frozenSupply	通证发行者发行的时候指定质押的通证数	-
description	通证描述，HEX 格式或 UTF8 字符串	String

返回值

TransactionExtention 对象。

异常

llegalException，发行 TRC10 通证失败时抛出此异常。

示例

long start = System.currentTimeMillis() + 2000;
long end = System.currentTimeMillis() + 1000000000;
HashMap<String, String> frozenSupply = new HashMap<String, String>();
frozenSupply.put("1","1");
frozenSupply.put("2","1");
frozenSupply.put("3","2");
TransactionExtention transaction = wrapper.createAssetIssue("TJ3Zyr26kzS8wRGz7aWYGgenMcqkUuPzLf","name", "saf1",100000000L, 1, 1000,start,end,"7777772e6578616d706c652e636f6d",
                    100000L,1L,6,frozenSupply,"stest-assetissue");
Transaction signedTxn = wrapper.signTransaction(transaction);
String ret = wrapper.broadcastTransaction(signedTxn);

执行结果：

ff88e516799642161ca100bfcd3b67226793f003048c49e04aaaf48b8f5b6477

participateAssetIssue

参与 TRC10 通证发行。

用法

participateAssetIssue(toAddress, ownerAddress, assertName, amount)

参数

参数	描述	类型
toAddress	通证发行人的地址，HEX 格式或 Base58check 格式	String
ownerAddress	参与人的地址，HEX 格式或 Base58check 格式	String
assertName	TRC10 通证 ID	String
amount	参与的通证的量	long

返回值

TransactionExtention 对象。

异常

IllegalException，参与 TRC10 通证发行失败时抛出此异常。

示例

TransactionExtention transaction = wrapper.participateAssetIssue("TJ3Zyr26kzS8wRGz7aWYGgenMcqkUuPzLf","TLtrDb1udekjDumnrf3EVeke3Q6pHkZxjm","1000251", 1L);
Transaction signedTxn = wrapper.signTransaction(transaction);
String ret = wrapper.broadcastTransaction(signedTxn);

执行结果：

8ae5067d3b2b822e7de3cfeb5df19bb9d1c8af2de5d9163ddc96d81baf7af58b

unfreezeAsset

解锁已经结束质押期的 TRC10 通证。

用法

unfreezeAsset(ownerAddress)

参数

参数	描述	类型
ownerAddress	解冻通证账号的地址，HEX 格式或 Base58check 格式	String

返回值

TransactionExtention 对象。

异常

IllegalException，解冻 TRC10 通证失败时抛出此异常。

示例

TransactionExtention transaction = wrapper.unfreezeAsset("TJ3Zyr26kzS8wRGz7aWYGgenMcqkUuPzLf");
Transaction signedTxn = wrapper.signTransaction(transaction);
String ret = wrapper.broadcastTransaction(signedTxn);

执行结果：

3baeafe39df63f6125dabfc317977498fb6f30933da2c5e6610dcbee1cfc9437

updateAsset

修改 TRC10 通证基本信息。

用法

updateAsset(ownerAddress, description, url, newLimit, newPublicLimit)

参数

参数	描述	类型
ownerAddress	通证发行人的地址，HEX 格式或 Base58check 格式	String
description	通证的描述，HEX 格式或 UTF8 字符串	String
url	通证的官方网站，HEX 格式或 UTF8 字符串	String
newLimit	每个 TRC10 通证持有人的免费带宽	int
newPublicLimit	TRC10 通证的总免费带宽	int

返回值

TransactionExtention 对象。

异常

IllegalException，修改 TRC10 通证基本信息失败时抛出此异常。

示例

TransactionExtention transaction = wrapper.updateAsset("TD9tMPSfBJ3To8s71vdBz2BLT2wwBNWyLc","newname","sadf", 1,2);
Transaction signedTxn = wrapper.signTransaction(transaction);
String ret = wrapper.broadcastTransaction(signedTxn);

执行结果：

9a1234914e3ed5926d4f14584745514006be523adacd5cc208991018d5d31084

getAssetIssueByName

根据通证名称查询 TRC10 通证。

用法

getAssetIssueByName(name)

参数

参数	描述	类型
name	TRC10 通证名称	String

返回值

AssetIssueContract 对象。

示例

wrapper.getAssetIssueByName("name");

执行结果：

owner_address: "AX\224.\275P\223\324\313\344\241\365N\300\3470bXx\301{"
  name: "name"
  abbr: "saf1"
  total_supply: 100000000
  frozen_supply {
    frozen_amount: 1
    frozen_days: 1
  }
  ...
  trx_num: 1
  precision: 6
  num: 1000
  start_time: 1614768027088
  end_time: 1615768025088
  description: "stest-assetissue"
  url: "7777772e6578616d706c652e636f6d"
  free_asset_net_limit: 100000
  public_free_asset_net_limit: 1
  id: "1000251"

getAssetIssueListByName

根据通证名称查询所有 TRC10 通证的列表。

用法

getAssetIssueListByName(name)

参数

参数	描述	类型
name	TRC10 通证名称	String

返回值

AssetIssueList 对象。

示例

wrapper.getAssetIssueListByName("name");

执行结果：

owner_address: "AX\224.\275P\223\324\313\344\241\365N\300\3470bXx\301{"
  name: "name"
  abbr: "saf1"
  total_supply: 100000000
  frozen_supply {
    frozen_amount: 1
    frozen_days: 1
  }
  ...
  trx_num: 1
  precision: 6
  num: 1000
  start_time: 1614768027088
  end_time: 1615768025088
  description: "stest-assetissue"
  url: "7777772e6578616d706c652e636f6d"
  free_asset_net_limit: 100000
  public_free_asset_net_limit: 1
  id: "1000251"