API 签名和广播示例

介绍

TRON 网络具有各种 API 调用,允许用户与区块链进行交互。可以在 API 参考页中找到这些API 调用,其中分别列出了调用FullNode节点的API、调用SolidityNode节点的API和通过TronWeb代码库进行调用的方式。有些API调用是用于查询链上数据,并不会创建交易,但有些API调用是可以创建交易并广播上链的,从而引发链上数据的状态修改。 本篇指南主要讲解的是后面的这一类交易,通过引导用户完成TRX Balance Freeze 的例子,来展示通过API完成交易创建、交易签名和交易广播的三步流程。

质押TRX交易示例

  1. 创建交易
    创建质押TRX交易使用的API是/wallet/freezebalance 。这个交易的功能是将用户地址中一定数量的TRX质押起来,来获取资源(带宽和能量)和投票权, 调用此API将创建一个质押TRX类型的交易,通过质押用户指定钱包地址内的TRX余额,并向钱包所有者提供带宽或能量和 TRON Power(投票权)。此API有4个参数,分别是:
  • owner_address 是Hex string格式的钱包地址。
  • frozen_balance 是整数格式的质押的TRX数量。
  • frozen_duration 是整数格式的质押时间(以天为单位),最少为3天。
  • resource 是质押TRX以期望获取资源的类型,可以是字符串格式的 "ENERGY"或"BANDWIDTH",但只能选择其中一种。

通过调用 API 来获取 JSON 数据来质押余额:

下面是执行该API后得到的JSON输出示例。此 JSON 输出将用于下一步的交易签名。

{  
   "transaction":{  
      "txID":"454f156bf1256587ff6ccdbc56e64ad0c51e4f8efea5490dcbc720ee606bc7b8",
      "raw_data":{  
         "contract":[  
            {  
               "parameter":{  
                  "value":{  
                     "amount":1000,
                     "owner_address":"41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
                     "to_address":"41d1e7a6bc354106cb410e65ff8b181c600ff14292"
                  },
                  "type_url":"type.googleapis.com/protocol.TransferContract"
               },
               "type":"TransferContract"
            }
         ],
         "ref_block_bytes":"267e",
         "ref_block_hash":"9a447d222e8de9f2",
         "expiration":1530893064000,
         "timestamp":1530893006233
      }
   },
   "privateKey":"your private key"
}
  1. 交易签名
    交易签名的API是/wallet/gettransactionsign,创建交易需要根据不同交易类型来选择不同的API,但交易签名的API只有这一个。它需要两个参数,分别是:
    transaction 参数:它是上一步的 JSON 输出。
    privateKey 参数:它是发起质押余额交易的地址私钥。
    提示:不推荐采用这种方式进行签名,尤其是在公共的网络环境中。本例仅仅是为了说明一笔交易从创建到上链的过程。

下面是执行签名后的JSON输出示例,可以看到已经带有了签名(signature)字段:

{  
   "signature":[  
      "8e6582cead9ef92d7731e356b0131dca2dfe18d701bdaecb5591781af5493391127d10b4864cf45a0f56b10ed97af102864cff8205e14c8bf29b0e50d85f681801"
   ],
   "txID":"ddcbaf061eaa2454975ae8faefbeb0b410329ef9e5bb43b64d4065a7d66720c7",
   "raw_data":{  
      "contract":[  
         {  
            "parameter":{  
               "value":{  
                  "resource":"ENERGY",
                  "frozen_duration":3,
                  "frozen_balance":1000000,
                  "owner_address":"41928c9af0651632157ef27a2cf17ca72c575a4d21"
               },
               "type_url":"type.googleapis.com/protocol.FreezeBalanceContract"
            },
            "type":"FreezeBalanceContract"
         }
      ],
      "ref_block_bytes":"ee08",
      "ref_block_hash":"7b2480cc92edd8a2",
      "expiration":1540253364000,
      "timestamp":1540253304828
   }
}
  1. 广播交易/wallet/broadcasttransaction API 调用接受一个参数,即交易签名的 JSON 输出数据。

下面是调用广播交易后的JSON输出示例,确认交易已经广播成功。

{"result": true}