4.交易
在区块链上更新数据是通过向网络宣布交易来完成的。
4.1 交易生命周期
以下是交易的生命周期描述：
- 交易创建
- 以区块链可接受的格式创建交易。
- 签名
- 使用帐户的私钥签署交易。
- 宣告
- 向网络上的任何节点宣布已签名的交易。
- 未确认状态交易
- 节点接受的交易作为未确认状态交易传播到所有节点。
- 如果为交易设置的最高费用不足以满足为每个节点设置的最低费用，则不会将其传播到该节点。
- 节点接受的交易作为未确认状态交易传播到所有节点。
- 确认交易
- 当一个未确认的交易包含在后续的新区块中（大约每 30 秒生成一次），它就成为一个已批准的交易。
- 回滚
- 节点间无法达成共识的交易回滚到未确认状态。
- 已过期或已超出缓存的交易将被截断。
- 节点间无法达成共识的交易回滚到未确认状态。
- 完成
- 一旦区块被投票节点的终结过程终结，交易就可以被视为最终交易，数据不能再回滚。
什么是块?
块大约每 30 秒生成一次，并逐块与其他节点同步，优先考虑支付较高费用的交易。 如果同步失败，则回滚，网络重复此过程，直到所有节点达成共识。
4.2 交易创建
首先，从创建最基本的转账交易开始。
将交易转移给Bob
创建要发送到的 Bob 地址。
bob = sym.Account.generateNewAccount(networkType);
console.log(bob.address);
> Address {address: 'TDWBA6L3CZ6VTZAZPAISL3RWM5VKMHM6J6IM3LY', networkType: 152}
创建交易。
tx = sym.TransferTransaction.create(
sym.Deadline.create(epochAdjustment), //Deadline:Expiry date
sym.Address.createFromRawAddress("TDWBA6L3CZ6VTZAZPAISL3RWM5VKMHM6J6IM3LY"),
[],
sym.PlainMessage.create("Hello Symbol!"), //Message
networkType //Testnet/Mainnet classification
).setMaxFee(100); //Fees
每个设置解释如下。
到期日
2 小时是 SDK 的默认设置。 最多可以指定 6 小时。
sym.Deadline.create(epochAdjustment,6)
信息
在信息字段中，最多可以将 1023 个字节附加到交易。 二进制数据也可以作为原始数据发送。
空消息
sym.EmptyMessage
纯信息
sym.PlainMessage.create("Hello Symbol!")
加密信息
sym.EncryptedMessage('294C8979156C0D941270BAC191F7C689E93371EDBC36ADD8B920CF494012A97BA2D1A3759F9A6D55D5957E9D');
当您使用加密消息时，会附加一个标志（标记）到消息上，表示"指定的消息已加密"。探索器和钱包将使用该标志作为参考，以隐藏它或不解密该消息。加密本身不是由该方法实现的。
原始数据
sym.RawMessage.create(uint8Arrays[i])
最高费用
尽管支付少量额外费用可以更好地确保交易成功，但对网络费用有一些了解也是一个好主意。 该账户指定了它在创建交易时愿意支付的最高费用。 另一方面，节点尝试一次只将费用最高的交易收割到一个区块中。 这意味着，如果有许多其他交易愿意支付更多费用，则该交易将需要更长的时间才能获得批准。 反之，如果有很多其他交易想要少付，而你的最高手续费较大，那么交易将以低于你设置的最高金额的手续费进行处理。
支付的费用由交易规模 x 费用乘数决定。 如果它是 176 字节并且您的 maxFee 设置为 100，则 17600µXYM = 0.0176XYM 是您允许作为交易费用支付的最大值。 有两种指定方式：feeMultiplier = 100 或 maxFee = 17600。
指定费用乘数为100
tx = sym.TransferTransaction.create(
,,,,
networkType
).setMaxFee(100);
指定为最大费用 = 17600
tx = sym.TransferTransaction.create(
,,,,
networkType,
sym.UInt64.fromUint(17600)
);
我们将使用指定费用乘数为100的方法。
4.3 签名和广播
使用私钥签署您创建的交易并将其公布给任何节点。
签名
signedTx = alice.sign(tx,generationHash);
console.log(signedTx);
示例演示
> SignedTransaction
hash: "3BD00B0AF24DE70C7F1763B3FD64983C9668A370CB96258768B715B117D703C2"
networkType: 152
payload:
"AE00000000000000CFC7A36C17060A937AFE1191BC7D77E33D81F3CC48DF9A0FFE892858DFC08C9911221543D687813ECE3D36836458D2569084298C09223F9899DF6ABD41028D0AD4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD20000000001985441F843000000000000879E76C702000000986F4982FE77894ABC3EBFDC16DFD4A5C2C7BC05BFD44ECE0E000000000000000048656C6C6F2053796D626F6C21"
signerPublicKey: "D4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD2"
type: 16724
需要使用帐户和生成的哈希值对交易进行签名。
生成哈希
- 测试网
- 7FCCD304802016BEBBCD342A332F91FF1F3BB5E902988B352697BE245F48E836
- 主网
- 57F7DA205008026C776CB6AED843393F04CD458E0AA2D9F1D5F31A402072B2D6
生成的哈希值唯一标识区块链网络。 通过交织网络的各个哈希值来创建已签署的交易，以便它们不能使用相同的私钥在其他网络中使用。
广播
res = await txRepo.announce(signedTx).toPromise();
console.log(res);
> TransactionAnnounceResponse {message: 'packet 9 was pushed to the network via /transactions'}
就像上面的脚本一样，将发送一个回应："封包n已推送到网络"，这意味着该交易已被节点接受。 然而，这仅仅意味着交易的格式没有异常。 为了最大化节点的响应速度，Symbol会在验证交易内容之前返回接收到的结果并断开连接。回应值仅仅是此信息的收据。如果格式出现错误，则消息回应如下：
如果广播失败，回应的样本输出如下：
Uncaught Error: {"statusCode":409,"statusMessage":"Unknown Error","body":"{\"code\":\"InvalidArgument\",\"message\":\"payload has an invalid format\"}"}
4.4 确认
状态确认
检查节点接受的交易状态。
tsRepo = repo.createTransactionStatusRepository();
transactionStatus = await tsRepo.getTransactionStatus(signedTx.hash).toPromise();
console.log(transactionStatus);
示例演示
> TransactionStatus
group: "confirmed"
code: "Success"
deadline: Deadline {adjustedValue: 11989512431}
hash: "661360E61C37E156B0BE18E52C9F3ED1022DCE846A4609D72DF9FA8A5B667747"
height: undefined
当被确认时，输出会显示 group: "confirmed"。
如果接受但发生错误，输出将显示如下。重写交易并尝试再次广播它。
> TransactionStatus
group: "failed"
code: "Failure_Core_Insufficient_Balance"
deadline: Deadline {adjustedValue: 11990156766}
hash: "A82507C6C46DF444E36AC94391EA2D0D7DD1A218948DED465A7A4F9D1B53CA0E"
height: undefined
如果该交易未被接受，则输出将显示以下的ResourceNotFound错误。
Uncaught Error: {"statusCode":404,"statusMessage":"Unknown Error","body":"{\"code\":\"ResourceNotFound\",\"message\":\"no resource exists with id '18AEBC9866CD1C15270F18738D577CB1BD4B2DF3EFB28F270B528E3FE583F42D'\"}"}
当交易中指定的最高手续费小于节点设置的最低手续费时，或者需要公告为聚合交易的交易被公告为单笔交易时，就会出现该错误。
批准确认
批准该块的交易大约需要 30 秒。
通过探索器进行检查。
使用可以通过signedTx.hash检索的哈希值在探索器中搜索。
console.log(signedTx.hash);
> "661360E61C37E156B0BE18E52C9F3ED1022DCE846A4609D72DF9FA8A5B667747"
- 主网
- https://symbol.fyi/transactions/661360E61C37E156B0BE18E52C9F3ED1022DCE846A4609D72DF9FA8A5B667747
- 测试网
- https://testnet.symbol.fyi/transactions/661360E61C37E156B0BE18E52C9F3ED1022DCE846A4609D72DF9FA8A5B667747
检查SDK
txInfo = await txRepo.getTransaction(signedTx.hash,sym.TransactionGroup.Confirmed).toPromise();
console.log(txInfo);
示例演示
> TransferTransaction
deadline: Deadline {adjustedValue: 12883929118}
maxFee: UInt64 {lower: 17400, higher: 0}
message: PlainMessage {type: 0, payload: 'Hello Symbol!'}
mosaics: []
networkType: 152
payloadSize: 174
recipientAddress: Address {address: 'TDWBA6L3CZ6VTZAZPAISL3RWM5VKMHM6J6IM3LY', networkType: 152}
signature: "7A3562DCD7FEE4EE9CB456E48EFEEC687647119DC053DE63581FD46CA9D16A829FA421B39179AABBF4DE0C1D987B58490E3F95C37327358E6E461832E3B3A60D"
signer: PublicAccount {publicKey: '0E5C72B0D5946C1EFEE7E5317C5985F106B739BB0BC07E4F9A288417B3CD6D26', address: Address}
> transactionInfo: TransactionInfo
hash: "DA4B672E68E6561EAE560FB89B144AFE1EF75D2BE0D9B6755D90388F8BCC4709"
height: UInt64 {lower: 330012, higher: 0}
id: "626413050A21EB5CD286E17D"
index: 1
merkleComponentHash: "DA4B672E68E6561EAE560FB89B144AFE1EF75D2BE0D9B6755D90388F8BCC4709"
type: 16724
version: 1
注意事项
即使在区块中确认了一笔交易，如果发生回滚，该交易的确认仍有可能被撤销。 在一个块被批准后，随着批准过程对几个块的进行，发生回滚的可能性会降低。 此外，等待由投票节点执行的敲定区块，确保记录的数据是确定的。
示例脚本
在广播交易之后，查看以下脚本以跟踪链的状态非常有用。
hash = signedTx.hash;
tsRepo = repo.createTransactionStatusRepository();
transactionStatus = await tsRepo.getTransactionStatus(hash).toPromise();
console.log(transactionStatus);
txInfo = await txRepo.getTransaction(hash,sym.TransactionGroup.Confirmed).toPromise();
console.log(txInfo);
4.5 交易纪录
获取 Alice 发送和接收的交易历史列表。
result = await txRepo.search(
{
group:sym.TransactionGroup.Confirmed,
embedded:true,
address:alice.address
}
).toPromise();
txes = result.data;
txes.forEach(tx => {
console.log(tx);
})
示例演示
> TransferTransaction
type: 16724
networkType: 152
payloadSize: 176
deadline: Deadline {adjustedValue: 11905303680}
maxFee: UInt64 {lower: 200000000, higher: 0}
recipientAddress: Address {address: 'TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ', networkType: 152}
signature: "E5924A1EB653240A7220405A4DD4E221E71E43327B3BA691D267326FEE3F57458E8721907188DB33A3F2A9CB1D0293845B4D0F1D7A93C8A3389262D1603C7108"
signer: PublicAccount {publicKey: 'BDFAF3B090270920A30460AA943F9D8D4FCFF6741C2CB58798DBF7A2ED6B75AB', address: Address}
> message: RawMessage
payload: ""
type: -1
> mosaics: Array(1)
0: Mosaic
amount: UInt64 {lower: 10000000, higher: 0}
id: MosaicId
id: Id {lower: 760461000, higher: 981735131}
> transactionInfo: TransactionInfo
hash: "308472D34BE1A58B15A83B9684278010F2D69B59E39127518BE38A4D22EEF31D"
height: UInt64 {lower: 301717, higher: 0}
id: "6255242053E0E706653116F9"
index: 0
merkleComponentHash: "308472D34BE1A58B15A83B9684278010F2D69B59E39127518BE38A4D22EEF31D"
交易类型如下。
{0: 'RESERVED', 16705: 'AGGREGATE_COMPLETE', 16707: 'VOTING_KEY_LINK', 16708: 'ACCOUNT_METADATA', 16712: 'HASH_LOCK', 16716: 'ACCOUNT_KEY_LINK', 16717: 'MOSAIC_DEFINITION', 16718: 'NAMESPACE_REGISTRATION', 16720: 'ACCOUNT_ADDRESS_RESTRICTION', 16721: 'MOSAIC_GLOBAL_RESTRICTION', 16722: 'SECRET_LOCK', 16724: 'TRANSFER', 16725: 'MULTISIG_ACCOUNT_MODIFICATION', 16961: 'AGGREGATE_BONDED', 16963: 'VRF_KEY_LINK', 16964: 'MOSAIC_METADATA', 16972: 'NODE_KEY_LINK', 16973: 'MOSAIC_SUPPLY_CHANGE', 16974: 'ADDRESS_ALIAS', 16976: 'ACCOUNT_MOSAIC_RESTRICTION', 16977: 'MOSAIC_ADDRESS_RESTRICTION', 16978: 'SECRET_PROOF', 17220: 'NAMESPACE_METADATA', 17229: 'MOSAIC_SUPPLY_REVOCATION', 17230: 'MOSAIC_ALIAS', 17232: 'ACCOUNT_OPERATION_RESTRICTION'
消息类型如下。
{0: 'PlainMessage', 1: 'EncryptedMessage', 254: 'PersistentHarvestingDelegationMessage', -1: 'RawMessage'}
4.6 聚合交易
聚合事务可以将多个事务合并为一个。 Symbol 的公共网络支持包含多达 100 个内部交易（涉及多达 25 个不同的联署人）的聚合交易。 后续章节涵盖的内容包括需要了解聚合事务的函数。 本章只介绍最简单的聚合事务。
一个案例只需要发起人的签名
bob = sym.Account.generateNewAccount(networkType);
carol = sym.Account.generateNewAccount(networkType);
innerTx1 = sym.TransferTransaction.create(
undefined, //Deadline
bob.address, //Destination of the transaction
[],
sym.PlainMessage.create("tx1"),
networkType
);
innerTx2 = sym.TransferTransaction.create(
undefined, //Deadline
carol.address, //Destination of the transaction
[],
sym.PlainMessage.create("tx2"),
networkType
);
aggregateTx = sym.AggregateTransaction.createComplete(
sym.Deadline.create(epochAdjustment),
[
innerTx1.toAggregate(alice.publicAccount), //Publickey of the sender account
innerTx2.toAggregate(alice.publicAccount) //Publickey of the sender account
],
networkType,
[],
sym.UInt64.fromUint(1000000)
);
signedTx = alice.sign(aggregateTx,generationHash);
await txRepo.announce(signedTx).toPromise();
首先，创建要包含在聚合交易中的交易。 目前没有必要指定截止日期。 列举时，将生成的交易添加到聚合中，并指定发送方帐户的公钥。 请注意，发送方和签名帐户不总是匹配的。 这是因为可能会出现"Alice 签署 Bob 发送的交易"等场景，这将在后续章节中进行解释。 这是在 Symbol 区块链上使用交易的最重要概念。 本章中的交易由Alice发送和签署，因此聚合绑定交易上的签名也指定了Alice。
4.7 使用提示
存在证明
「帐户」章节介绍了如何使用帐户对数据进行签署和验证。 将这些数据放入在区块链上得到确认的交易中，就不可能删除一个帐户证明某些数据在某个时间存在的事实。 可以认为它具有与有关方拥有时间戳电子签名相同的含义。 （法律决策由专家决定）
区块链以这种"账户已经证明的不可磨灭的事实"的存在来更新交易等数据。 区块链也可以用作证明某个事实的知识证明，而这个事实此时还没有被任何人知道。 本节描述了两种模式，其中已经证明存在的数据可以放在交易中。
数字数据哈希值（SHA256）输出方式
文件的存在可以通过在区块链中记录其摘要值来证明。
各操作系统中文件使用SHA256计算哈希值的方法如下。
#Windows
certutil -hashfile WINfilepath SHA256
#Mac
shasum -a 256 MACfilepath
#Linux
sha256sum Linuxfilepath
拆分大数据
由于交易的有效载荷只能包含 1023 个字节。大数据被拆分并打包到有效负载中以进行聚合交易。
bigdata = 'C00200000000000093B0B985101C1BDD1BC2BF30D72F35E34265B3F381ECA464733E147A4F0A6B9353547E2E08189EF37E50D271BEB5F09B81CE5816BB34A153D2268520AF630A0A0E5C72B0D5946C1EFEE7E5317C5985F106B739BB0BC07E4F9A288417B3CD6D26000000000198414140770200000000002A769FB40000000076B455CFAE2CCDA9C282BF8556D3E9C9C0DE18B0CBE6660ACCF86EB54AC51B33B001000000000000DB000000000000000E5C72B0D5946C1EFEE7E5317C5985F106B739BB0BC07E4F9A288417B3CD6D26000000000198544198205C1A4CE06C45B3A896B1B2360E03633B9F36BF7F22338B000000000000000066653465353435393833444430383935303645394533424446434235313637433046394232384135344536463032413837364535303734423641303337414643414233303344383841303630353343353345354235413835323835443639434132364235343233343032364244444331443133343139464435353438323930334242453038423832304100000000006800000000000000B2D4FD84B2B63A96AA37C35FC6E0A2341CEC1FD19C8FFC8D93CCCA2B028D1E9D000000000198444198205C1A4CE06C45B3A896B1B2360E03633B9F36BF7F2233BC089179EBBE01A81400140035383435344434373631364336433635373237396800000000000000B2D4FD84B2B63A96AA37C35FC6E0A2341CEC1FD19C8FFC8D93CCCA2B028D1E9D000000000198444198205C1A4CE06C45B3A896B1B2360E03633B9F36BF7F223345ECB996EDDB9BEB1400140035383435344434373631364336433635373237390000000000000000B2D4FD84B2B63A96AA37C35FC6E0A2341CEC1FD19C8FFC8D93CCCA2B028D1E9D5A71EBA9C924EFA146897BE6C9BB3DACEFA26A07D687AC4A83C9B03087640E2D1DDAE952E9DDBC33312E2C8D021B4CC0435852C0756B1EBD983FCE221A981D02';
let payloads = [];
for (let i = 0; i < bigdata.length / 1023; i++) {
payloads.push(bigdata.substr(i * 1023, 1023));
}
console.log(payloads);