交易接口

支持发送交易，包括转账、节点staking、节点注册、节点投票、节点领取奖励、调用合约等。

在发送交易前，请确保：

1.您已拥有一个链上账户。可通过getAccount查询此账户是否已经在链上创建。

2.获取链访问身份令牌，使用requestToken命令获取。

交易费用说明

在RPC API中，账户余额、交易保证金等TOP token单位为uTOP，1TOP=1*10^6 uTOP。

TOP Network链上发送交易会消耗一定的gas资源，如果账户余额大于等于100*10^6 uTOP，系统会免费赠与25,000 Tgas。

每笔交易都至少需要100,000 uTOP token作为交易保证金，否则交易将被丢弃。

在账户gas资源充足的情况下，交易保证金在交易成功后会立即退回到您的账户。如gas资源不足以支付交易费用，则需要从交易保证金中扣除一笔费用用来兑换gas资源以支付交易费用，扣除的TOP token将被销毁。

如交易保证金也不足以兑换足够的gas资源，那么交易最终将失败。

交易所消耗的资源详细信息请参见资源模型。

对于调用部署在Beacon系统合约的交易，系统还会自动从发送方账户里扣除100*10^6 uTOP token的服务费，并销毁。

需要扣除手续费的Beacon系统合约交易包括：

注册矿工、启动节点、更新矿工信息、增加矿工保证金、减少矿工保证金、修改矿工昵称、设置分红比例、更新矿工类型、赎回矿工保证金、注销矿工、发起提案、撤回提案、表决提案。

接口说明

请求方式

sendTransaction

请求参数

参数名称		是否必选	类型	说明
authorization		是	String	交易体签名。采用ECDSA数字签名算法。具体请参见交易签名。
challenge_proof		是	String	预留字段，空字符串。
ext		是	String	预留字段，空字符串。
from_ledger_id		是	Uint16	预留字段，为"0"。
last_tx_hash		是	String	交易发送方上次交易的xx64hash，用于交易的排序和去重。"0x"开头的hash。
last_tx_nonce		是	Uint64	交易发送方上次交易的nonce，用于交易的排序和去重。
note		是	String	交易备注。
premium_price		是	Uint32	预留字段，为"0"。
to_ledger_id		是	Uint16	预留字段，为"0"。
receiver_action			Object	交易接受方执行内容。
	action_authorization	是	String	action签名，json结构，当交易为部署合约交易时，此处需要输入合约的公钥信息，公钥用来验证合约账户与交易发送方账户是否匹配。
	action_ext	是	String	预留扩展字段，空字符串。
	action_hash	是	Uint32	整个action的xxhash32。默认为"0"，暂未使用。
	action_name	是	String	调用合约时，合约的函数名。系统合约函数请参见系统智能合约 API。非合约交易时，默认为空。
	action_param	是	String	接收方执行内容。不同action type执行内容的序列化请参见action param序列化。
	action_size	是	Uint16	action对象的大小。
	action_type	是	Uint16	接收方执行类型，不同的交易类型对应不同的action type，具体请参见交易协议中“tx_type与action_type说明”。 xaction_type_create_contract_account = 3, // 创建用户合约账户 xaction_type_run_contract = 5, // 调用智能合约 xaction_type_asset_in = 6, // 资产转入 xaction_type_pledge_token_vote = 21, //锁定TOP token兑换选票 xaction_type_redeem_token_vote = 22, // 解锁兑换选票的TOP token xaction_type_pledge_token = 23, //锁定TOP token兑换gas xaction_type_redeem_token = 24, //解锁兑换gas的TOP token
	tx_receiver_account_addr	是	String	交易接受方账户地址。
send_timestamp		是	Uint64	交易发送时间戳GMT。
sender_action			Object	交易发送方执行内容。
	action_authorization	是	String	action签名，json结构。
	action_ext	是	String	预留扩展字段，空字符串。
	action_hash	是	Uint32	整个action的xxhash32。默认为"0"，暂未使用。
	action_name	是	String	预留字段，空字符串。
	action_param	是	String	发送方执行内容。不同action type执行内容的序列化请参见action param序列化。
	action_size	是	Uint16	action对象的大小。
	action_type	是	Uint16	发送方执行类型，不同的交易类型对应不同的action type，具体请参见交易协议中“tx_type与action_type说明”。 xaction_type_asset_out = 0, // 资产转出。 xaction_type_source_null =1, // 源端不执行操作
	tx_sender_account_addr	是	String	交易发送方账户地址。
tx_deposit		是	Uint32	交易保证金，最低为0.1*10^6 uTOP。
tx_expire_duration		是	Uint16	交易到期时长，超过则被丢弃，默认100s。
tx_len		是	Uint16	交易大小。交易消耗的gas与交易大小相关。
tx_random_nonce		是	Uint32	随机数字。预留字段，为"0"。
tx_structure_version		是	String	交易结构版本号。默认为"0"，暂未使用。
tx_type		是	Uint16	交易类型，不同的交易类型，action中action_param（执行内容）及action type（执行类型）不同。 xtransaction_type_create_contract_account = 1, // 创建合约账户 xtransaction_type_run_contract = 3, // 调用智能合约 xtransaction_type_transfer = 4, // 转账 xtransaction_type_vote = 20, //投票 xtransaction_type_abolish_vote = 21, //取消投票 xtransaction_type_pledge_token_gas = 22, // 锁定TOP token兑换gas xtransaction_type_redeem_token_gas = 23, // 解锁兑换gas锁定的TOP token xtransaction_type_pledge_token_vote = 27, // 锁定TOP token兑换选票 xtransaction_type_redeem_token_vote = 28, // 解锁兑换选票锁定的TOP token

返回参数

参数名称	类型	说明
tx_hash	String	本次交易hash，可用于查询交易结果。
tx_len	Uint16	交易大小，交易消耗的gas和交易大小相关。

请求样例

以转账交易为例：

curl -X POST --data 'target_account_addr=T00000LVb72cJ9LzaQbdR41Zvx7dsAL1oDFFGQrJ&body=%7b%22authorization%22%3a%220x015c5be7876376b09297f9247e34e1e921474f2f66c61700e57832546e6c1de918136abe1a56c346ebf2dce9358941df89d02fd5274222435e7bd0f756de1adf83%22%2c%22challenge_proof%22%3a%22%22%2c%22ext%22%3a%22%22%2c%22from_ledger_id%22%3a0%2c%22last_tx_hash%22%3a%220x909cd743c4dfe805%22%2c%22last_tx_nonce%22%3a2%2c%22note%22%3a%221231fsd%22%2c%22receiver_action%7b%22action_authorization%22%3a%22%22%2c%22action_ext%22%3a%22%22%2c%22action_hash%22%3a0%2c%22action_name%22%3a%22%22%2c+%22action_param%22%3a%220x000000008c00000000000000%22%2c%22action_size%22%3a78%2c%22action_type%22%3a6%2c%22tx_receiver_account_addr%22%3a%22T00000LazNzvyHLptzdPFkaynNHKqDY4qXZ2gCVh%22%7d%2c%22send_timestamp%22%3a1602820177%2c%22sender_action%22%3a%7b%22action_authorization%22%3a%22%22%2c%22action_ext%22%3a%22%22%2c%22action_hash%22%3a0%2c%22action_name%22%3a%22%22%2c%22action_param%22%3a%220x000000008c00000000000000%22%2c%22action_size%22%3a78%2c%22action_type%22%3a0%2c+%22tx_sender_account_addr%22%3a%22T00000LRaFyaGZ1isfcKnhLxPLoePFUmY2iyFGv6%22%7d%2c%22premium_price%22%3a0%2c%22to_ledger_id%22%3a0%2c%22tx_deposit%22%3a100000%2c%22tx_expire_duration%22%3a100%2c%22tx_len%22%3a322%2c%22tx_random_nonce%22%3a0%2c%22tx_structure_version%22%3a0%2c%22tx_type%22%3a4%7d%7d&method=getTransaction&sequence_id=8&identity_token=&version=1.0'  http://localhost:19081

返回样例

• 成功返回

{
	"errmsg": "ok",
	"errno": 0,
	"sequence_id": "2",
	"tx_hash": "0x34ca8f317107ce6b01c933b017f28e6cf0f84f2e31627a8349f167c1aa9ade10",
	"tx_len": 306
}
Please use command 'get transaction' to query transaction status later on!!!

TOP Network交易共识需要一定的时间，不会立刻返回交易共识结果，可通过get transaction查询交易详细信息查看交易共识最终结果。

• 失败返回

{
	"errmsg": "ok",
	"errno": 0,
	"sequence_id": "3",
	"tips": "Please use command 'get transaction' to query transaction status later on!!!",
	"tx_hash": "0xc73f6295bc5b6be1ace273d59504f4c97d1b01cd2d3301c47cf042e28795e35b",
	"tx_len": 306
}

同样的，交易失败的情况下，也不会直接返回交易共识结果，需要通过get transaction查询交易详细信息查看交易共识最终结果。