欢迎来到

波场TRON开发者指南

在这里

您将找到最全面的指南与文档

助力您完美使用

【TRON Developer Guide 】

经常使用的API：

● 获取钱包的一般信息（类似于比特币getinfo）GetAccount

● 获取地址的余额（类似于比特币getbalance）GetAccount

● 创建一个新地址（类似于比特币getnewaddress）您可以在本地系统上创建一个地址。并且可以通过调用RPC-API createAccount，TransferAsset，或 CreateTransaction（TransferContract）在blockchain上创建一个新的地址， 以使从现有的帐户转移到新的地址。

● 按地址检索交易历史列表（类似于比特币列表交易）GetTransactionsFromThisGetTransactionsToThis

● 检查地址是否有效（正则表达式或API命令）

● 本地检查---在本地decode58check后，你会得到一个21字节的字节数组，从0x41（主网）或0xa0（testnet）开始。

● 如果要验证区块链中是否存在某个地址，可以调用 GetAccount。

获取帐户信息

接口语句：

rpc GetAccount（帐户）返回（帐户）{}

节点：完整节点和功能节点

参数：帐户：键入地址。

退货：帐户：返回所有帐户信息。

功能：查询余额清单。 显示帐户返回中的所有资产信息。

TRX转账

接口语句：

rpc CreateTransaction（TransferContract）返回（转账）{}

节点：完整节点

参数：TransferContract：发送方和接收方的地址以及传输量（单位是sun）。

退还：交易：退回转让合同交易; 收到钱包签名后请求交易。

功能：转账。 创建转帐交易。

交易广播

接口语句：

rpc BroadcastTransaction（Transaction）返回（返回）{}

节点：Full Node

参数：交易：由钱包签署的交易。 在波场网络中，需要改变区块链状态的操作在交易中被封装。

返回：返回：成功或失败。 在广播之前，将启动交易并发送反馈。 注意：返回成功并不一定意味着完成交易。

功能/函数：转让，投票，发币或参与通证发行。 将签名的交易信息发送到节点，并在见证节点验证后将其广播到整个网络。

创建帐户

接口语句： rpc CreateAccount（AccountCreateContract）返回（交易）{} 节点：Full Node

参数：AccountCreateContract：帐户类型和帐户地址。

返回：交易：退回创建账户的交易。 获得钱包签名后请求广播。

功能/函数：创建帐户。 注册钱包时创建帐户（或选择其他方式）。

帐户更新

接口语句： rpc UpdateAccount（AccountUpdateContract）返回（事务）{} 节点：完整节点 参数：AccountUpdateContract：帐户名称和地址。

退货：交易：退回帐户更新交易。 在钱包签署交易后请求广播。 功能：帐户名称更新。

投票

接口声明： RPC VoteWitnessAccount（VoteWitnessContract）返回（事务）{}

节点：全节点

参数： VoteWitnessContract：选举人地址和候选人的列表，它包括候选地址和票数接收。

退货：交易：退回投票交易。 在钱包签署交易后请求广播。

功能：投票。 硬币持有人只能投票给超级代表候选人，其票数不得超过冻结余额（另请参阅：Balance Freeze）。

令牌发行

接口语句： rpc CreateAssetIssue（AssetIssueContract）返回（事务）{}

节点：完整节点 参数：AssetIssueContract：发行方地址，令牌名称，总大写，到TRX的汇率，开始日期，有效期，衰减系数，投票，详细说明，网址，最大带宽消耗，总带宽消耗和冻结令牌。

返回：交易：返回令牌发行的交易。 在钱包签署交易后请求交易广播。 功能：代币发行。 所有用户都可以以1024 TRX为代价发放代币。 成功发布后，用户可以在指定的到期日之前与TRX交换代币。

样本：

assetissue密码abc 1000000 1 1 2018-5-31 2018-6-30 abcdef a.com 1000 1000000 200000 180 300000 365

使用上述命令，发出名为abc的代币总资本为100万令牌，汇率为1：1到trx。 它的发售时间是2018年5月31日至6月30日。 它被描述为abcdef，可以在a.com上找到。

每个帐户每天最多可以从发卡行的帐户中收取1000个带宽点。 每天从发行方收取的最大带宽点数为1000,000。 200,000个令牌将被锁定180天，而另外300,000个令牌将被锁定365天。

SR候选人查询列表

接口语句： rpc ListWitnesses（EmptyMessage）返回（WitnessList）{}

节点：完整节点和Solidity节点 参数：EmptyMessage：null。

返回：见证列表：证人名单，包括候选人的详细信息。

功能：在投票前查询所有候选人，返回每个候选人的详细信息供用户参考。

超级代表申请

接口语句： rpc CreateWitness（WitnessCreateContract）返回（事务）{} 节点：完整节点

参数：WitnessCreateContract：帐户地址和URL。

返回：交易：返回候选申请的交易。 在钱包签署交易后请求广播。

功能：在区块链上创建帐户的所有用户都可以申请成为TRON的超级代表候选人。

SR候选人信息更新

接口语句： rpc UpdateWitness（WitnessUpdateContract）返回（事务）{}

节点：完整节点 参数：WitnessUpdateContract：帐户地址和URL。 

返回：Transaction：返回SR应用程序的事务。 在钱包签署交易后请求广播。 功能：更新SR的URL。

代币转移

接口语句： rpc TransferAsset（TransferAssetContract）返回（事务）{}

节点：完整节点 参数：TransferAssetContract：代币名称，发件人地址，收件人地址和代币数量。

返回：交易：返回代币转移的交易。 在钱包签署交易后请求广播。

功能：令牌传输。 创建代币传输事务。

代币提供参与

接口语句：

 rpc ParticipateAssetIssue（ParticipateAssetIssueContract）返回（事务）{} 

节点：完整节点 参数：ParticipateAssetIssueContract：参与者地址，发行者地址，代币名称和代币数量（在阳光下） 。

退货：交易：退回参与代币发售的交易。 在钱包签署交易后请求广播。

功能：代币提供参与

节点查询

接口语句： rpc ListNodes（EmptyMessage）返回（NodeList）{}

节点：完整节点和Solidity节点 参数：EmptyMessage：null

返回：NodeList：返回一个列表节点，包括其IP和端口。

功能：列出当前节点的IP和端口。

查询所有代币列表

接口语句： rpc GetAssetIssueList（EmptyMessage）返回（AssetIssueList）{}

节点：完整节点和Solidity节点

参数：EmptyMessage：null

返回：AssetIssueList：AssetIssueContract列表包含所有已发行代币的信息。

功能：查询所有已发行代币的列表。 显示所有已发布的代币以供用户参考。

由帐户发出的查询代币

接口语句： rpc GetAssetIssueByAccount（Account）返回（AssetIssueList）{} 节点：完整节点和Solidity节点 参数：帐户：地址

返回：AssetIssueList： AssetIssueContract 包含的列表所有已发行代币的信息。

功能：查询给定帐户发出的所有代币。

通过代币名称查询代币信息

接口声明： RPC GetAssetIssueByName（BytesMessage）返回（AssetIssueContract）{}

节点：全节点和密实度节点 参数： BytesMessage：代币名称

返回： AssetIssueContract：有关代币的信息

功能：使用名称查询代币信息。 TRON的网络确保了代币名称的独占性。

按时间戳查询当前代币

接口语句：

 rpc GetAssetIssueListByTimestamp（NumberMessage）返回（AssetIssueList）{}

节点：Solidity节点

参数：NumberMessage：当前时间戳（自1970年以来的毫秒数）。

返回：AssetIssueList：AssetIssueContract列表，包括代币的详细信息。 功能：按时间戳通过timestam发出的令牌列出已发布代币的列表。 显示当前节点以供用户参考。

获取当前阻止

接口语句： rpc GetNowBlock（EmptyMessage）返回（Block）{}

节点：完整节点和Solidity节点 参数：EmptyMessage：null

返回：块：当前块的信息。 功能：查询最新的块

逐块高度获取

接口语句： rpc GetBlockByNum（NumberMessage）返回（Block）{} 节点：完整节点和Solidity节点

参数：NumberMessage：块高度

返回：块：块信息

功能：在指定高度访问块，否则返回到生成块。

获取交易总数

接口语句： rpc TotalTransaction（EmptyMessage）返回（NumberMessage）{}

节点：完整节点和Solidity节点

参数：EmptyMessage：null

返回：NumberMessage：总数交易。

功能：查询交易总数。

按ID查询交易

接口语句： rpc getTransactionById（BytesMessage）返回（事务）{}

节点：Solidity节点

参数：BytesMessage：事务ID或哈希

返回：事务：查询事务

功能：通过ID查询交易明细，这是交易的哈希。

按时间戳查询事务

接口语句： rpc getTransactionsByTimestamp（TimeMessage）返回（TransactionList）{}

节点：Solidity节点

参数：TimeMessage：开始时间和结束时间。

返回：TransactionList：事务列表。

功能：按开始和结束时间查询交易。

按地址查询事务启动

接口语句： rpc getTransactionsFromThis（Account）返回（TransactionList）{}

节点：Solidity节点

参数：帐户：发起人的帐户（地址）。

返回：TransactionList：事务列表。

功能：按帐户地址查询交易启动。

按地址查询事务接收

接口语句： rpc getTransactionsToThis（Account）返回（NumberMessage）{}

节点：Solidity节点

参数：Account：收件人帐户（地址）。

返回：TransactionList：事务列表。

功能：查询一个给定帐户接受的所有交易。

冻结账户

接口语句： rpc FreezeBalance（FreezeBalanceContract）返回（事务）{}

节点：完整节点

参数：FreezeBalanceContract：地址，冻结的trx数量和冻结持续时间。 目前余额只能冻结3天。

退货：交易：退货包括余额交易。 钱包签收后请求交易广播。

功能：通过冷冻账户可以获得两件事： a。 带宽点。

b。 Tron Power。

解冻账户

接口语句 rpc UnfreezeBalance（UnfreezeBalanceContract）返回（事务）{}

节点：完整节点 参数：UnfreezeBalanceContract：地址。

返回：交易：返回解冻TRX交易。 钱包签收后请求交易广播。

功能：最新冻结后3天内可以解冻账户。 投票记录将在未冻结的账户时清算，而带宽点则不会。 冻结天平在3天后不会自动解冻。

块生产奖励兑换

接口语句： rpc WithdrawBalance（WithdrawBalanceContract）返回（事务）{} 

节点：完整节点

参数：WithdrawBalanceContract：地址 返回：事务：返回撤销TRX事务。 钱包签收后请求交易广播。

功能：此界面仅供超级代表使用。 超级代表可以在成功记账后获得奖励。 而不是保存到账户余额，奖励将在账户津贴中独立持有，每24小时允许1次提取账户余额。

解冻账户

接口语句：

rpc UnfreezeAsset（UnfreezeAssetContract）返回（事务）{}

节点：完整节点

参数：UnfreezeAssetContract：地址

返回：事务：返回解冻代币事务;在钱包签署交易后请求广播。

功能：代币发行人可以在发行期间解冻锁定供应。

查询下次维护时间

接口语句：

rpc GetNextMaintenanceTime（EmptyMessage）返回（NumberMessage）{}

节点：完整节点

参数：EmptyMessage：无需参数

返回：NumberMessage：下次维护时间

功能：获取下一个维护时间

查询交易信息

接口语句：

rpc GetTransactionInfoById（BytesMessage）返回（TransactionInfo）{} 节点：Solidity节点

参数：BytesMessage：事务ID

返回：TransactionInfo：事务信息。

功能：查询交易费，区块位置和区块的时间戳。

按ID查询块

接口语句：

rpc GetBlockById（BytesMessage）返回（Block）{} 节点：完整节点

参数：BytesMessage：块ID

返回：块：块

功能：逐块ID的查询

代币更新

接口语句：

rpc UpdateAsset（UpdateAssetContract）返回（事务）{} 节点：

完整节点

参数：UpdateAssetContract：发行方地址，代币描述，代币URL，每个帐户的最大带宽消耗和总带宽消耗。

退货：交易：退货交易;在钱包签署交易后请求广播。

功能：代币更新只能由代币发行者发起，以更新代币描述，URL，每个帐户的最大带宽消耗和总带宽消耗。

代币列表的分页查询

接口语句：

rpc GetPaginatedAssetIssueList（PaginatedMessage）返回（AssetIssueList）{} 节点：完整节点和Solidity节点。

参数：PaginatedMessage：起始索引（0）和每页显示的标记数。 返回：AssetIssueList：包含代币详细信息的AssetIssueContract的分页列表。

功能：显示代币信息的标记的标记列表供用户参考。

交易签名

接口语句：

rpc GetTransactionSign（TransactionSign）返回（事务）{} 

节点：完整节点

参数：TransactionSign：要签名的事务和要签名的私钥。

退货：交易：要签署的交易。

地址和私钥创建

接口语句：

rpc CreateAdresss（BytesMessage）返回（BytesMessage）{}

节点：完整节点

参数：BytesMessage：密码短语

返回：BytesMessage：address

TRX轻松转移

接口语句：

rpc EasyTransfer（EasyTransferMessage）返回（EasyTransferResponse）{}

节点：完整节点 参数：EasyTransferMessage：传输密码，toAddress和要传输的代币数量。

返回：EasyTransferResponse：转移的交易和广播的结果。

生成地址和私钥

接口语句：

rpc GenerateAddress（EmptyMessage）返回（AddressPrKeyPairMessage）{}

节点：完整节点和Solidity节点

参数：EmptyMessage：null。

返回：AddressPrKeyPairMessage：生成地址和私钥。

功能：地址和私钥生成。 请仅在受信任的脱机节点上调用此API以防止私钥泄露。