更新时间:2023-11-27 GMT+08:00

共享版

表1 可用波场API列表-wallet

API方法

类型

说明

计算单元(CU)

/wallet/validateaddress

POST

检查地址是否格式正确。

5

/wallet/broadcasttransaction

POST

广播签名后的交易。

5

/wallet/broadcasthex

POST

直接广播 protobuf 序列化后的十六进制 Transaction。

4

/wallet/createtransaction

POST

创建交易。

9

/wallet/createaccount

POST

激活一个链上账户。

10

/wallet/getaccount

POST

查询一个账号的信息,包括TRX余额、TRC10余额、质押以获取资源情况、投票情况以及权限等。

9

/wallet/updateaccount

POST

修改账户的名称。

9

/wallet/accountpermissionupdate

POST

修改账户权限。

12

/wallet/getaccountresource

POST

查询账户的资源信息(带宽、能量)。

7

/wallet/getaccountnet

POST

查询账户带宽信息。

7

/wallet/unfreezebalance

POST

解锁在Stake1.0期间质押的TRX,释放所得到的带宽或能量以及TP,同时会自动取消所有投票。

5

/wallet/getdelegatedresource

POST

查看在stake1.0阶段一个账户代理给另外一个账户的资源情况。

5

/wallet/getdelegatedresourceaccountindex

POST

查看在stake1.0阶段一个账户给哪些账户代理了资源,以及哪些账户为该账户代理了资源。

40

/wallet/freezebalancev2

POST

在Stake2.0质押机制下,质押TRX以获取带宽或者能量,同时根据质押额度获得等值投票权(TP)。

10

/wallet/unfreezebalancev2

POST

解锁通过Stake2.0机制质押的TRX,释放所相应数量的带宽和能量,同时回收相应数量的投票权(TP)。

7

/wallet/delegateresource

POST

在Stake 2.0 机制下,将带宽或者能量资源代理给其它账户。

5

/wallet/undelegateresource

POST

在Stake 2.0机制下,取消为目标地址代理的带宽或者能量。

7

/wallet/withdrawexpireunfreeze

POST

提取已过锁定期的解质押的本金。

7

/wallet/getavailableunfreezecount

POST

查询Stake2.0机制下,当前解质押剩余次数。

5

/wallet/getcanwithdrawunfreezeamount

POST

查询在某时间点可以提取的解质押本金数量。

6

/wallet/getcandelegatedmaxsize

POST

查询目标地址中指定类型资源的可代理数量,单位为sun。

7

/wallet/getdelegatedresourcev2

POST

查询在Stake2.0机制下,某地址代理给目标地址的资源情况。

5

/wallet/getdelegatedresourceaccountindexv2

POST

查询在Stake2.0阶段,某地址的资源委托索引账号。

40

/wallet/getblock

POST

根据区块高度或者区块哈希查询区块头信息或者整个区块信息。

392

/wallet/getblockbynum

POST

通过高度查询区块内容。

192

/wallet/getblockbyid

POST

通过区块ID(即区块哈希)查询区块。

392

/wallet/getblockbylatestnum

POST

查询最新的若干个区块。

941

/wallet/getblockbylimitnext

POST

查询指定范围的区块。

392

/wallet/getnowblock

GET

查询最新块。

542

/wallet/gettransactionbyid

POST

按交易哈希查询交易。

52

/wallet/gettransactioninfobyid

POST

查询交易的 Info 信息,包括交易的 fee 信息、所在区块和虚拟机log等。

19

/wallet/gettransactioninfobyblocknum

POST

获取特定区块的所有交易 Info 信息。

139

/wallet/getchainparameters

GET

查询当前所有提案参数,超级代表可以提议修改这些参数。

13

/wallet/getenergyprices

GET

查询历史能量单价。

8

/wallet/getbandwidthprices

GET

查询历史带宽单价。

6

/wallet/getburntrx

GET

查询自从第54号委员会提议生效后,因链上交易手续费而销毁的TRX数量。

6

/wallet/getapprovedlist

POST

根据交易内容和签名信息计算得到为交易签名的账户地址列表,可用交易验签。

20

/wallet/getassetissuebyaccount

POST

查询账户发行的TRC10通证。

523

/wallet/getassetissuebyid

POST

根据ID查询TRC10通证。

9

/wallet/getassetissuebyname

POST

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

570

/wallet/getassetissuelist

GET

查询所有TRC10通证列表。

4706

/wallet/getassetissuelistbyname

POST

根据名称返回同名的所有TRC 10代币列表。

509

/wallet/getpaginatedassetissuelist

POST

分页查询TRC10通证列表。

784

/wallet/transferasset

POST

转账TRC10通证。

20

/wallet/createassetissue

POST

发行TRC10通证。

20

/wallet/participateassetissue

POST

参与TRC10通证发行。

20

/wallet/unfreezeasset

POST

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

20

/wallet/updateasset

POST

修改TRC10通证基本信息。

20

/wallet/getcontract

POST

查询链上的合约信息,包括合约的bytecode、 ABI、配置参数等。

84

/wallet/getcontractinfo

POST

查询链上的合约信息。与wallet/getcontract接口不同,该接口不仅返回bytecode还会返回合约的runtime bytecode。runtime bytecode相比bytecode,不包含构造函数以及构造函数的参数信息。

114

/wallet/triggersmartcontract

POST

调用智能合约,返回 TransactionExtention,需要签名后广播。

20

/wallet/triggerconstantcontract

POST

调用合约只读函数,也可以调用合约非只读函数,用于预判交易是否可以执行成功或者预估交易的能量消耗,也可以预估合约部署消耗的能量。

20

/wallet/deploycontract

POST

部署合约,返回 Transaction Extention,其中包含未签名的交易。

14

/wallet/updatesetting

POST

更新合约的 consume_user_resource_percent 配置,返回未签名交易,需要签名后广播。

20

/wallet/updateenergylimit

POST

更新合约的 origin_energy_limit,返回未签名交易,需要签名后广播。

20

/wallet/clearabi

POST

将合约的 ABI 设置为空。返回未签名交易,需要签名后广播。

20

/wallet/estimateenergy

POST

预估智能合约调用交易或部署交易执行成功需要提供的能量。

13

/wallet/createwitness

POST

申请成为超级代表, 返回申请超级代表的Transaction,需要签名后广播。

20

/wallet/updatewitness

POST

修改witness配置信息中的 URL,需要签名后广播。

20

/wallet/listwitnesses

GET

返回所有超级代表的列表。

20

/wallet/votewitnessaccount

POST

对超级代表进行投票,返回投票的 Transaction, 需要签名后广播。

20

/wallet/updateBrokerage

POST

更新 SR 佣金比例,需要签名后广播。

7

/wallet/getBrokerage

POST

查询超级代表佣金比例。

5

/wallet/getReward

POST

查询用户未被提取的投票奖励。

5

/wallet/withdrawbalance

POST

超级代表或用户提取奖励,每 24 小时可调用一次。超级代表将 allowance 中的余额提取到账户中,用户将投票奖励提取到自己的账户中。

20

/wallet/getnextmaintenancetime

GET

返回下个计票时间点的时间戳(毫秒)。

20

/wallet/proposalcreate

POST

创建提案交易,需要签名后广播。

5

/wallet/proposalapprove

POST

批准提案,需要签名后广播。

20

/wallet/proposaldelete

POST

删除提案,需要签名后广播。

20

/wallet/listproposals

GET

查询所有提案并返回提案信息。

116

/wallet/getproposalbyid

POST

根据ID查询提案并返回提案详细信息。

10

/wallet/exchangecreate

POST

创建交易对,需要签名后广播。警告:成功执行,签署和广播此 API 调用将从用户的帐户中扣除 1024 TRX。

20

/wallet/exchangeinject

POST

给交易对注资,注资后可以防止交易对价格波动太大,需要签名后广播。

20

/wallet/exchangewithdraw

POST

对交易对撤资,需要签名后广播。

20

/wallet/exchangetransaction

POST

参与交易对交易,需要签名后广播。

20

/wallet/getexchangebyid

POST

根据id查询交易对。

8

/wallet/listexchanges

GET

查询所有交易对。

79

/wallet/gettransactionlistfrompending

GET

获取pending pool中交易列表信息。

20

/wallet/gettransactionfrompending

POST

从pending pool中获取交易详细信息。

9

/wallet/getpendingsize

GET

获取pending pool队列的大小。

7

/wallet/getsignweight

POST

查询交易签名权重。

20

表2 可用波场API列表-walletsolidity

API方法

类型

说明

计算单元(CU)

/walletsolidity/gettransactionbyid

POST

按交易哈希查询交易(已固化状态)。

28

/walletsolidity/gettransactioninfobyid

POST

查询交易的 Info 信息,包括交易的 fee 信息、 所在区块、虚拟机log等(已固化状态)。

10

/walletsolidity/gettransactioninfobyblocknum

POST

获取特定区块的所有交易 Info 信息(已固化状态)。

18

/walletsolidity/getblock

POST

根据区块高度或者区块哈希查询区块头信息或者整个区块信息(已固化状态)。

392

/walletsolidity/getblockbyid

POST

通过区块ID(即区块哈希)查询区块(已固化状态)。

376

/walletsolidity/getblockbylatestnum

POST

查询最新的若干个区块(已固化状态)。

965

/walletsolidity/getblockbylimitnext

POST

查询指定范围的区块(已固化状态)。

376

/walletsolidity/getblockbynum

POST

查询确认指定块是否被固化。

192

/walletsolidity/getnowblock

GET

查询当前最新区块(已固化状态)。

542

/walletsolidity/getaccount

POST

获取账户信息(已固化状态)。

9

/walletsolidity/getdelegatedresourcev2

POST

Stake 2.0 API:查询某地址代理给目标地址的资源情况(已固化状态)。

5

/walletsolidity/getavailableunfreezecount

POST

Stake 2.0 API: 查询当下解质押剩余次数(已固化状态)。

5

/walletsolidity/getcanwithdrawunfreezeamount

POST

Stake 2.0 API: 查询在某时间点可以提取的解质押本金数量(已固化状态)。

6

/walletsolidity/getdelegatedresourceaccountindexv2

POST

Stake 2.0 API:查询某地址的资源委托索引(已固化状态)。返回两个列表,一个是该帐户将资源委托给的地址列表(toAddress);另一个是将资源委托给该帐户的地址列表(fromAddress)。

7

/walletsolidity/getburntrx

GET

查询自从第54号委员会提议生效后,因链上交易手续费而销毁的TRX数量(已固化状态)。

5

/walletsolidity/triggerconstantcontract

POST

既可以调用合约只读函数(view 或 pure修饰的函数),用于查询合约已固化状态数据,也可以调用合约非只读函数,用于在已固化状态下预判交易是否可以执行成功或者预估交易的能量消耗。

20

/walletsolidity/estimateenergy

POST

在已固化状态下,预估智能合约交易执行成功需要提供的能量。

13

/walletsolidity/getassetissuebyid

POST

根据ID查询TRC10通证(已固化状态)。

34

/walletsolidity/getassetissuebyname

POST

根据通证名称查询TRC10通证(已固化状态)。

36

/walletsolidity/getassetissuelist

GET

查询所有TRC10通证列表(已固化状态)。

4183

/walletsolidity/getassetissuelistbyname

POST

根据名称返回同名的所有TRC10代币列表(已固化状态)。

495

/walletsolidity/getpaginatedassetissuelist

POST

分页查询TRC10通证列表(已固化状态)。

784

/walletsolidity/listwitnesses

GET

返回所有超级代表的列表(已固化状态)。

111

/walletsolidity/getexchangebyid

POST

根据id查询交易对(已固化状态)。

6

/walletsolidity/listexchanges

GET

查询所有交易对(已固化状态)。

79

/walletsolidity/getenergyprices

GET

查询历史能量单价。

17

/walletsolidity/getcandelegatedmaxsize

POST

Stake 2.0 API: 查询目标地址中指定类型资源的可代理数量(已固化状态),单位为sun。

7

/walletsolidity/gettransactioncountbyblocknum

POST

按区块号查询区块内交易数量(已固化状态)。

18

表3 可用波场API列表-jsonrpc

API方法

类型

说明

计算单元(CU)

eth_accounts

POST

返回客户端拥有的地址列表,tron将返回空列表。

13

eth_blockNumber

POST

获取最新区块号。

10

eth_call

POST

立即执行消息调用,而不在区块链上创建交易,即triggerConstantContract。

20

eth_chainId

POST

返回TRON chainId,TRON chainId为创世块哈希的最后四个字节。

1

eth_estimateGas

POST

通过triggerConstantContract预估能量消耗。

1000

eth_gasPrice

POST

获取当前的能量单价(以sun为单位)。

13

eth_getBalance

POST

获取给定地址的账户余额。

15

eth_getBlockByHash

POST

根据区块哈希获取区块信息。

45

eth_getBlockByNumber

POST

根据区块号获取区块信息。

20

eth_getBlockTransactionCountByHash

POST

根据区块哈希获取区块内的交易数量。

13

eth_getBlockTransactionCountByNumber

POST

根据区块号获取区块内的交易数量。

12

eth_getCode

POST

获取给定智能合约的runtime code。

40

eth_getStorageAt

POST

返回某地址的指定位置存储的内容,可用于获取某个合约中某个变量的值。

15

eth_getTransactionByBlockHashAndIndex

POST

根据区块哈希,获取区块的第index个交易。

17

eth_getTransactionByBlockNumberAndIndex

POST

根据区块号,获取区块的第index个交易。

18

eth_getTransactionByHash

POST

根据交易哈希获取交易信息。

40

eth_getTransactionReceipt

POST

查询交易的 Info 信息,包括交易的 fee 信息、所在区块和虚拟机log等。

19

eth_syncing

POST

获取节点的同步状态。

1

eth_getLogs

POST

返回与给定过滤条件匹配的所有事件。

75

net_listening

POST

查询客户端是否处于监听网络连接的状态。

1

net_version

POST

返回创世块的哈希值。

1

web3_clientVersion

POST

返回当前节点的版本。

1

web3_sha3

POST

计算给定数据的Keccak-256值(不是标准的SHA3-256)。

5

buildTransaction

POST

创建transaction,交易类型不同,参数不同。

13