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

波场API列表

表1 可用波场API列表-jsonrpc

API方法

类型

说明

流控值(次/s)

eth_accounts

POST

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

1000

eth_blocknumber

POST

获取最新区块号。

1000

eth_call

POST

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

1000

eth_chainId

POST

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

1000

eth_coinbase

POST

获取当前节点的witness address。

1000

eth_estimateGas

POST

通过triggerConstantContract预估能量消耗。

1000

eth_gasPrice

POST

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

1000

eth_getBalance

POST

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

1000

eth_getBlockByHash

POST

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

50

eth_getBlockByNumber

POST

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

50

eth_getBlockTransactionCountByHash

POST

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

1000

eth_getBlockTransactionCountByNumber

POST

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

1000

eth_getCode

POST

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

400

eth_getStorageAt

POST

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

1000

eth_getTransactionByBlockHashAndIndex

POST

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

1000

eth_getTransactionByBlockNumberAndIndex

POST

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

1000

eth_getTransactionByHash

POST

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

1000

eth_getTransactionReceipt

POST

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

1000

eth_getWork

POST

获取当前区块的哈希。

1000

eth_protocolVersion

POST

获取java-tron block版本。

1000

eth_syncing

POST

获取节点的同步状态。

1000

eth_newFilter

POST

创建一个事件过滤器对象,监听事件。

1000

eth_newBlockFilter

POST

创建一个过滤器,当有新块到达时获得通知。

1000

eth_getFilterChanges

POST

返回自上次轮询以来发生的事件列表。

1000

eth_getFilterLogs

POST

返回符合过滤条件的所有事件。

10

eth_uninstallFilter

POST

取消一个过滤器,当不再需要监控时需取消过滤器。

1000

eth_getLogs

POST

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

10

net_listening

POST

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

1000

net_peerCount

POST

返回当前节点所连接的peer节点数量。

1000

net_version

POST

返回创世块的哈希值。

1000

web3_clientVersion

POST

返回当前节点的版本。

1000

web3_sha3

POST

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

1000

buildTransaction

POST

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

1000

表2 可用波场API列表-gRPC

API方法

说明

流控值(次/s)

BroadcastTransaction

广播签名后的交易。

1000

CreatetTansaction

创建交易。(请使用CreateTransaction2)

1000

CreateTransaction2

创建交易。

1000

CreateAccount

激活一个链上账户。(请使用CreateAccount2)

1000

CreateAccount2

激活一个链上账户。

1000

GetAccount

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

600

UpdateAccount

修改账户的名称。(请使用UpdateAccount2)

1000

UpdateAccount2

修改账户的名称。

1000

VoteWitnessAccount

对超级代表进行投票,返回投票的 Transaction, 需要签名后广播。(请使用VoteWitnessAccount2)

1000

VoteWitnessAccount2

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

1000

UpdateSetting

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

1000

UpdatEenergyLimit

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

1000

CreateAssetIssue

发行TRC10通证。(请使用CreateAssetIssue2)

1000

CreateAssetIssue2

发行TRC10通证。

1000

UpdateWitness

修改witness配置信息中的 URL,需要签名后广播。(请使用UpdateWitness2)

1000

UpdateWitness2

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

1000

CreateWitness

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

1000

CreateWitness2

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

1000

TransferAsset

转账TRC10通证。(请使用TransferAsset2)

1000

TransferAsset2

转账TRC10通证。

1000

ParticipateAssetIssue

参与TRC10通证发行。(请使用ParticipateAssetIssue2)

1000

ParticipateAssetIssue2

参与TRC10通证发行。

1000

FreezeBalance2

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

1000

FreezeBalanceV2

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

1000

UnfreezeBalance

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

1000

UnfreezeBalance2

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

1000

UnfreezeBalanceV2

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

1000

UnfreezeAsset

解锁已经结束质押期的 TRC10通证。(请使用UnfreezeAsset2)

1000

UnfreezeAsset2

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

1000

WithdrawBalance

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

1000

WithdrawBalance2

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

1000

WithdrawExpireUnfreeze

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

1000

DelegateResource

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

1000

CancelAllUnfreezeV2

取消所有未完成的解质押,将过期的解质押金额提取到账户余额中,将未过期的解质押金额重新质押。

1000

UpdateAsset

修改TRC10通证基本信息。(请使用UpdateAsset2)

1000

UpdateAsset2

修改TRC10通证基本信息。

1000

ProposalCreate

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

1000

ProposalApprove

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

1000

ProposalDelete

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

1000

ExchangeCreate

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

1000

ExchangeInject

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

1000

ExchangeWithdraw

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

1000

ExchangeTransaction

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

1000

GetAssetIssueByAccount

查询账户发行的TRC10通证。

1000

GetAccountNet

查询账户带宽信息。

1000

GetAccountResource

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

1000

GetAssetIssueByName

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

200

GetAssetIssueListByName

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

200

GetAssetIssueById

根据ID查询TRC10通证。

1000

GetNowBlock

查询最新块。(请使用GetNowBlock2)

1000

GetNowBlock2

查询最新块。

1000

GetBlockByNum

通过高度查询区块内容。(请使用GetBlockByNum2)

15

GetBlockByNum2

通过高度查询区块内容。

15

GetTransactionCountByBlockNum

获取指定块中的交易计数。

1000

GetBlockById

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

15

GetBlockByLimitNext

查询指定范围的区块。(请使用GetBlockByLimitNext2)

10

GetBlockByLimitNext2

查询指定范围的区块。

10

GetBlockByLatestNum

查询最新的若干个区块。(请使用GetBlockByLatestNum2)

10

GetBlockByLatestNum2

查询最新的若干个区块。

10

GetTransactionById

按交易哈希查询交易。

1000

DeployContract

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

1000

GetContract

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

300

GetContractInfo

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

200

TriggerContract

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

1000

TriggerConstantContract

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

1000

EstimateEnergy

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

1000

ClearContractAbi

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

1000

ListWitnesses

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

250

GetDelegatedResource

查看在stake1.0阶段一个账户代理给另外一个账户的资源情况。(请使用GetDelegatedResourceV2)

1000

GetDelegatedResourceV2

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

1000

GetDelegatedResourceAccountIndex

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

1000

GetDelegatedResourceAccountIndexV2

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

1000

GetCanDelegatedMaxSize

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

1000

GetAvailableUnfreezeCount

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

1000

GetCanWithdrawUnfreezeAmount

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

1000

ListProposals

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

300

GetProposalById

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

1000

ListExchanges

查询所有交易对。

400

GetExchangeById

根据id查询交易对。

1000

GetChainParameters

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

1000

GetAssetIssueList

查询所有TRC10通证列表。

5

GetPaginatedAssetIssueList

分页查询TRC10通证列表。

20

GetNextMaintenanceTime

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

1000

GetTransactionInfoById

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

1000

AccountPermissionUpdate

修改账户权限。

1000

GetTransactionSignWeight

查询交易签权重。

1000

GetTransactionApprovedList

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

1000

GetNodeInfo

查询当前节点的信息。

700

GetRewardInfo

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

1000

GetBrokerageInfo

查询超级代表佣金比例。

1000

UpdateBrokerage

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

1000

GetTransactionInfoByBlockNum

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

150

GetBurnTrx

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

1000

GetTransactionFromPending

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

1000

GetTransactionListFromPending

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

1000

GetPendingSize

获取pending pool队列的大小。

1000

GetBlock

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

50

UnDelegateResource

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

1000

表3 可用波场API列表-gRPC solidity

API方法

说明

流控值(次/s)

GetAccount

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

600

ListWitnesses

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

250

GetAssetIssueList

查询所有TRC10通证列表。

5

GetPaginatedAssetIssueList

分页查询TRC10通证列表。

20

GetAssetIssueByName

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

200

GetAssetIssueListByName

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

200

GetAssetIssueById

根据ID查询TRC10通证。

1000

GetNowBlock

查询最新块。(请使用GetNowBlock2)

1000

GetNowBlock2

查询最新块。

1000

GetBlockByNum

通过高度查询区块内容。(请使用GetBlockByNum2)

15

GetBlockByNum2

通过高度查询区块内容。

15

GetTransactionCountByBlockNum

获取指定块中的交易计数。

1000

GetDelegatedResource

查看在stake1.0阶段一个账户代理给另外一个账户的资源情况。(请使用GetDelegatedResourceV2)

1000

GetDelegatedResourceV2

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

1000

GetDelegatedResourceAccountIndex

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

1000

GetDelegatedResourceAccountIndexV2

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

1000

GetCanDelegatedMaxSize

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

1000

GetAvailableUnfreezeCount

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

1000

GetCanWithdrawUnfreezeAmount

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

1000

GetExchangeById

根据id查询交易对。

1000

ListExchanges

查询所有交易对。

400

GetTransactionById

按交易哈希查询交易。

1000

GetTransactionInfoById

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

1000

GetRewardInfo

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

1000

GetBrokerageInfo

查询超级代表佣金比例。

1000

TriggerConstantContract

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

1000

EstimateEnergy

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

1000

GetTransactionInfoByBlockNum

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

150

GetBurnTrx

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

1000

GetBlock

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

50