TRC10通证 (Asset)

getAssetIssueByAccount

查询账户发行的 TRC10 通证。

getAssetIssueByAccount(address)

参数

  1. address(String)*

发行者账户地址,Base58check 格式或 HEX 格式。

返回

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)

参数

  1. assetId(String)*

TRC10 通证 id。

返回

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)

参数

  1. offset(long)*

起始条目偏移值。

  1. 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)

参数

  1. fromAddress(String)*

转出地址,HEX 格式或 Base58check 格式。

  1. toAddress(String)*

接收地址,HEX 格式或 Base58check 格式。

  1. tokenId(int)*

通证 ID 作为字符串,HEX 格式。

  1. 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)

参数

  1. ownerAddress(String)*

发行人地址,Base58check 格式或 HEX 格式。

  1. name(String)*

通证名称,HEX 格式或 UTF8 字符串(visible 指定)。

  1. abbr(String)*

通证缩写,即通证代币符号。HEX 格式或 UTF8 字符串(visible 指定)。

  1. totalSupply(long)*

通证发行总量。

  1. trxNum(int)*

通证和 TRX 的最小单位兑换比。

  1. icoNum(int)*

  2. startTime(long)*

通证发行开始时间。

  1. endTime(long)*

通证发行结束时间。

  1. url(String)*

通证的官方网站地址。

  1. freeAssetNetLimit(long)*

通证的总免费带宽。

  1. publicFreeAssetNetLimit(long)*

每个通证拥有者能使用的免费带宽数。

  1. precision(int)*

通证的精度,默认为6,最小是0,最大是6。

  1. frozenSupply

通证发行者发行的时候指定质押的通证数。

  1. description(String)*

通证描述,HEX 格式或 UTF8 字符串。

返回

TransactionExtention 对象。

异常

IllegalException,发行 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)

参数

  1. toAddress(String)*

通证发行人的地址,HEX 格式或 Base58check 格式。

  1. ownerAddress(String)*

参与人的地址,HEX 格式或 Base58check 格式。

  1. assertName(String)*

TRC10 通证 ID。

  1. 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)

参数

  1. ownerAddress(String)*

解冻通证账号的地址,HEX 格式或 Base58check 格式。

返回

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)

参数

  1. ownerAddress(String)*

通证发行人的地址,HEX 格式或 Base58check 格式。

  1. description(String)*

通证的描述,HEX 格式或 UTF8 字符串。

  1. url(String)*

通证的官方网站,HEX 格式或 UTF8 字符串。

  1. newLimit(int)*

每个 TRC10 通证持有人的免费带宽。

  1. newPublicLimit(int)*

TRC10 通证的总免费带宽。

返回

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)

参数

  1. name(String)*

TRC10 通证名称。

返回

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)

参数

  1. name(String)*

TRC10 通证名称。

返回

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"