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);