Bytom交易說明（賬戶管理模式）

本文轉載自查看原文 2018-08-22 09:46 961 區塊鏈/ Go/ Bytom交易說明/ 比原鏈

比原項目倉庫：

Github地址：https://github.com/Bytom/bytom

Gitee地址：https://gitee.com/BytomBlockchain/bytom

該部分主要針對用戶使用bytom自帶的賬戶模式發送交易

1、構建交易

API接口 build-transaction，代碼api/transact.go#L120

以標准的非BTM資產轉賬交易為例，資產ID為全F表示BTM資產，在該示例中BTM資產僅作為手續費，該交易表示花費99個特定的資產到指定地址中。其中構建交易的輸入請求json格式如下：

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 20000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 99,
      "asset_id": "42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f",
      "type": "spend_account"
    },
    {
      "amount": 99,
      "asset_id": "42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f",
      "address": "sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me",
      "type": "control_address"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

對應源代碼的請求對象如下：

// BuildRequest is main struct when building transactions
type BuildRequest struct {
	Tx        *types.TxData            `json:"base_transaction"`
	Actions   []map[string]interface{} `json:"actions"`
	TTL       json.Duration            `json:"ttl"`
	TimeRange uint64                   `json:"time_range"`
}

結構字段說明如下：

Tx 交易的TxData部分，該字段為預留字段，為空即可
TTL 構建交易的生存時間（單位為毫秒），意味着在該時間范圍內，已經緩存的utxo不能用於再一次build交易，除非剩余的utxo足以構建一筆新的交易，否則會報錯。當ttl為0時會被默認設置為600s，即5分鍾
TimeRange 時間戳，意味着該交易將在該時間戳（區塊高度）之后不會被提交上鏈，為了防止交易在網絡中傳輸延遲而等待太久時間，如果交易沒有在特定的時間范圍內被打包，該交易便會自動失效
Actions 交易的actions結構，所有的交易都是由action構成的，map類型的interface{}保證了action類型的可擴展性。其中action中必須包含type字段，用於區分不同的action類型，action主要包含input和output兩種類型，其詳細介紹如下：
- input action 類型：
  - issue 發行資產
  - spend_account 以賬戶的模式花費utxo
  - spend_account_unspent_output 直接花費指定的utxo
- output action 類型：
  - control_address 接收方式為地址模式
  - control_program 接收方式為（program）合約模式
  - retire 銷毀資產

注意事項：

一個交易必須至少包含一個input和output（coinbase交易除外，因為coinbase交易是由系統產生，故不在此加以描述），否則交易將會報錯。
除了BTM資產（所有交易都是以BTM資產作為手續費）之外，其他資產在構建input和output時，所有輸入和輸出的資產總和必須相等，否則交易會報出輸入輸出不平衡的錯誤信息。
交易的手續費：所有inputs的BTM資產數量 - 所有outputs的BTM資產數量
交易中的資產amount都是neu為單位的，BTM的單位換算如下：1 BTM = 1000 mBTM = 100000000 neu

action簡介

下面對構建交易時用到的各種action類型進行詳細說明：

issue

issueAction結構體源代碼如下：

type issueAction struct {
	assets *Registry
	bc.AssetAmount
}

type AssetAmount struct {
	AssetId *AssetID `protobuf:"bytes,1,opt,name=asset_id,json=assetId" json:"asset_id,omitempty"`
	Amount  uint64   `protobuf:"varint,2,opt,name=amount" json:"amount,omitempty"`
}

結構字段說明如下：

assets 主要用於資產的管理，無需用戶設置參數
AssetAmount 表示用戶需要發行的資產ID和對應的資產數目，這里的AssetID需要通過create-asset創建，並且這里不能使用BTM的資產ID

issueAction的json格式為：

{
  "amount": 100000000,
  "asset_id": "3152a15da72be51b330e1c0f8e1c0db669269809da4f16443ff266e07cc43680",
  "type": "issue"
}

例如發行一筆資產的交易示例如下：
（該交易表示發行數量為900000000個assetID的42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f的資產到接收地址sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me中, 其中手續費為20000000neu的BTM資產）

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 20000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "amount": 900000000,
      "asset_id": "42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f",
      "type": "issue"
    },
    {
      "amount": 900000000,
      "asset_id": "42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f",
      "address": "sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me",
      "type": "control_address"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

spend_account

spendAction結構體源代碼如下：

type spendAction struct {
	accounts *Manager
	bc.AssetAmount
	AccountID   string  `json:"account_id"`
	ClientToken *string `json:"client_token"`
}

type AssetAmount struct {
	AssetId *AssetID `protobuf:"bytes,1,opt,name=asset_id,json=assetId" json:"asset_id,omitempty"`
	Amount  uint64   `protobuf:"varint,2,opt,name=amount" json:"amount,omitempty"`
}

結構字段說明如下：

accounts 主要用於賬戶的管理，無需用戶設置參數
AccountID 表示需要花費資產的賬戶ID
AssetAmount 表示花費的資產ID和對應的資產數目
ClientToken 表示Reserve用戶UTXO的限制條件，目前不填或為空即可

spendAction的json格式為：

{
  "account_id": "0BF63M2U00A04",
  "amount": 2000000000,
  "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
  "type": "spend_account"
}

例如轉賬一筆資產的交易示例如下：
（該交易表示通過賬戶的方式轉賬100000000neu的BTM資產到地址sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me中, 其中手續費20000000neu = 輸入BTM資產數量 - 輸出BTM資產數量）

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 120000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "amount": 100000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "address": "sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me",
      "type": "control_address"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

spend_account_unspent_output

spendUTXOAction結構體源代碼如下：

type spendUTXOAction struct {
	accounts *Manager
	OutputID *bc.Hash `json:"output_id"`
	ClientToken *string `json:"client_token"`
}

結構字段說明如下：

accounts 主要用於賬戶的管理，無需用戶設置參數
OutputID 表示需要花費的UTXO的ID，可以根據list-unspent-outputs查詢可用的UTXO，其中OutputID對應該API返回結果的id字段
ClientToken 表示Reserve用戶UTXO的限制條件，目前不填或為空即可

spendUTXOAction的json格式為：

{
  "type": "spend_account_unspent_output",
  "output_id": "58f29f0f85f7bd2a91088bcbe536dee41cd0642dfb1480d3a88589bdbfd642d9"
}

例如通過花費UTXO的方式轉賬一筆資產的交易示例如下：
（該交易表示通過直接花費UTXO的方式轉賬100000000neu的BTM資產到地址sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me中, 其中手續費 = 輸入BTM資產的UTXO值 - 輸出BTM資產數量）

{
  "base_transaction": null,
  "actions": [
    {
      "output_id": "58f29f0f85f7bd2a91088bcbe536dee41cd0642dfb1480d3a88589bdbfd642d9",
      "type": "spend_account_unspent_output"
    },
    {
      "amount": 100000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "address": "sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me",
      "type": "control_address"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

control_address

controlAddressAction結構體源代碼如下：

type controlAddressAction struct {
	bc.AssetAmount
	Address string `json:"address"`
}

type AssetAmount struct {
	AssetId *AssetID `protobuf:"bytes,1,opt,name=asset_id,json=assetId" json:"asset_id,omitempty"`
	Amount  uint64   `protobuf:"varint,2,opt,name=amount" json:"amount,omitempty"`
}

結構字段說明如下：

Address 表示接收資產的地址，可以根據 create-account-receiver API接口創建地址
AssetAmount 表示接收的資產ID和對應的資產數目

controlAddressAction的json格式為：

{
  "amount": 100000000,
  "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
  "address": "bm1q50u3z8empm5ke0g3ngl2t3sqtr6sd7cepd3z68",
  "type": "control_address"
}

例如轉賬一筆資產的交易示例如下：
（該交易表示通過賬戶的方式轉賬100000000neu的BTM資產到地址sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me中, 其中control_address類型表示以地址作為接收方式）

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 120000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "amount": 100000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "address": "sm1qxe4jwhkekgnxkezu7xutu5gqnnpmyc8ppq98me",
      "type": "control_address"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

control_program

controlProgramAction結構體源代碼如下：

type controlProgramAction struct {
	bc.AssetAmount
	Program json.HexBytes `json:"control_program"`
}

type AssetAmount struct {
	AssetId *AssetID `protobuf:"bytes,1,opt,name=asset_id,json=assetId" json:"asset_id,omitempty"`
	Amount  uint64   `protobuf:"varint,2,opt,name=amount" json:"amount,omitempty"`
}

結構字段說明如下：

Program 表示接收資產的合約腳本，可以根據 create-account-receiver API接口創建接收program（返回結果的 program 和 address 是一一對應的）
AssetAmount 表示接收的資產ID和對應的資產數目

controlProgramAction的json格式為：

{
  "amount": 100000000,
  "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
  "control_program":"0014a3f9111f3b0ee96cbd119a3ea5c60058f506fb19",
  "type": "control_program"
}

例如轉賬一筆資產的交易示例如下：
（該交易表示通過賬戶的方式轉賬100000000neu的BTM資產到接收program（跟address是一一對應的）0014a3f9111f3b0ee96cbd119a3ea5c60058f506fb19中, 其中control_program類型表示以program作為接收方式）

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 120000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "amount": 100000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "control_program": "0014a3f9111f3b0ee96cbd119a3ea5c60058f506fb19",
      "type": "control_program"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

retire

retireAction結構體源代碼如下：

type retireAction struct {
	bc.AssetAmount
}

type AssetAmount struct {
	AssetId *AssetID `protobuf:"bytes,1,opt,name=asset_id,json=assetId" json:"asset_id,omitempty"`
	Amount  uint64   `protobuf:"varint,2,opt,name=amount" json:"amount,omitempty"`
}

結構字段說明如下：

AssetAmount 表示銷毀的資產ID和對應的資產數目

retireAction的json格式為：

{
  "amount": 900000000,
  "asset_id": "3152a15da72be51b330e1c0f8e1c0db669269809da4f16443ff266e07cc43680",
  "type": "retire"
}

例如銷毀一筆資產的交易示例如下：
（該交易表示通過賬戶的方式將100000000neu的BTM資產銷毀, retire表示銷毀指定數量的資產）

{
  "base_transaction": null,
  "actions": [
    {
      "account_id": "0ER7MEFGG0A02",
      "amount": 120000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "spend_account"
    },
    {
      "amount": 100000000,
      "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
      "type": "retire"
    }
  ],
  "ttl": 0,
  "time_range": 0
}

build-transaction的輸入構造完成之后，便可以通過http的調用方式進行發送交易，構建交易請求成功之后返回的json結果如下：

{
  "allow_additional_actions": false,
  "raw_transaction": "070100020161015f1190c60818b4aff485c865113c802942f29ce09088cae1b117fc4c8db2292212ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8099c4d599010001160014a86c83ee12e6d790fb388345cc2e2b87056a077301000161015fb018097c4040c8dd86d95611a13c24f90d4c9d9d06b25f5c9ed0556ac8abd73442275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f80a094a58d1d0101160014068840e56af74038571f223b1c99f1b60caaf456010003013effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80bfffcb9901011600140b946646626c55a52a325c8bb48de792284d9b7200013e42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f9d9f94a58d1d01160014c8b4391bab4923a83b955170d24ee4ca5b6ec3fb00013942275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f6301160014366b275ed9b2266b645cf1b8be51009cc3b260e100",
  "signing_instructions": [
    {
      "position": 0,
      "witness_components": [
        {
          "keys": [
            {
              "derivation_path": [
                "010100000000000000",
                "0100000000000000"
              ],
              "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
            }
          ],
          "quorum": 1,
          "signatures": null,
          "type": "raw_tx_signature"
        },
        {
          "type": "data",
          "value": "d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd5"
        }
      ]
    },
    {
      "position": 1,
      "witness_components": [
        {
          "keys": [
            {
              "derivation_path": [
                "010100000000000000",
                "0800000000000000"
              ],
              "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
            }
          ],
          "quorum": 1,
          "signatures": null,
          "type": "raw_tx_signature"
        },
        {
          "type": "data",
          "value": "05cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe61540535419"
        }
      ]
    }
  ]
}

對應響應對象的源代碼如下：

// Template represents a partially- or fully-signed transaction.
type Template struct {
	Transaction         *types.Tx             `json:"raw_transaction"`
	SigningInstructions []*SigningInstruction `json:"signing_instructions"`

	// AllowAdditional affects whether Sign commits to the tx sighash or
	// to individual details of the tx so far. When true, signatures
	// commit to tx details, and new details may be added but existing
	// ones cannot be changed. When false, signatures commit to the tx
	// as a whole, and any change to the tx invalidates the signature.
	AllowAdditional bool `json:"allow_additional_actions"`
}

結構字段說明如下：

Transaction 交易相關信息，該字段包含TxData和bc.Tx兩個部分：
- TxData 表示給用戶展示的交易數據部分，該部分對用戶可見
  - Version 交易版本
  - SerializedSize 交易序列化之后的size
  - TimeRange 交易提交上鏈的最大時間戳（區塊高度）（主鏈區塊高度到達該時間戳（區塊高度）之后，如果交易沒有被提交上鏈，該交易便會失效）
  - Inputs 交易輸入
  - Outputs 交易輸出
- bc.Tx 表示系統中處理交易用到的轉換結構，該部分對用戶不可見，故不做詳細描述
SigningInstructions 交易的簽名信息
- Position 對input action簽名的位置
- WitnessComponents 對input action簽名需要的數據信息，其中build交易的signatures為null，表示沒有簽名; 如果交易簽名成功，則該字段會存在簽名信息。該字段是一個interface接口，主要包含3種不同的類型：
  - SignatureWitness 對交易模板Template中交易input action位置的合約program進行哈希，然后對hash值進行簽名
    - signatures （數組類型）交易的簽名，sign-transaction執行完成之后才會有值存在
    - keys （數組類型）包含主公鑰xpub和派生路徑derivation_path，通過它們可以在簽名階段找到對應的派生私鑰child_xprv，然后使用派生私鑰進行簽名
    - quorum 賬戶key 的個數，必須和上面的keys的長度相等。如果quorum 等於1，則表示單簽賬戶，否則為多簽賬戶
    - program 簽名的數據部分，program的hash值作為簽名數據。如果program為空，則會根據當前交易ID和對應action位置的InputID兩部分生成一個hash，然后把它們作為指令數據自動構造一個program
  - RawTxSigWitness 對交易模板Template的交易ID和對應input action位置的InputID(該字段位於bc.Tx中)進行哈希，然后對hash值進行簽名
    - signatures （數組類型）交易的簽名，sign-transaction執行完成之后才會有值存在
    - keys （數組類型）包含主公鑰xpub和派生路徑derivation_path，通過它們可以在簽名階段找到對應的派生私鑰child_xprv，然后使用派生私鑰進行簽名
    - quorum 賬戶key的個數，必須和上面的keys 的長度相等。如果quorum 等於1，則表示單簽賬戶，否則為多簽賬戶
  - DataWitness 該類型無需簽名，驗證合約program的附加數據
AllowAdditional 是否允許交易的附加數據，如果為true，則交易的附加數據會添加到交易中，但是不會影響交易的執行的program腳本，對簽名結果不會造成影響; 如果為false，則整個交易作為一個整體進行簽名，任何數據的改變將影響整個交易的簽名

估算手續費

估算手續費接口estimate-transaction-gas是對build-transaction的結果進行手續費的預估，估算的結果需要重新加到build-transaction的結果中，然后對交易進行簽名和提交。其主要流程如下：

  build - estimate - build - sign - submit

估算手續費的輸入請求json格式如下：

{
  "transaction_template": {
    "allow_additional_actions": false,
    "raw_transaction": "070100020161015f1190c60818b4aff485c865113c802942f29ce09088cae1b117fc4c8db2292212ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8099c4d599010001160014a86c83ee12e6d790fb388345cc2e2b87056a077301000161015fb018097c4040c8dd86d95611a13c24f90d4c9d9d06b25f5c9ed0556ac8abd73442275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f80a094a58d1d0101160014068840e56af74038571f223b1c99f1b60caaf456010003013effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80bfffcb9901011600140b946646626c55a52a325c8bb48de792284d9b7200013e42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f9d9f94a58d1d01160014c8b4391bab4923a83b955170d24ee4ca5b6ec3fb00013942275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f6301160014366b275ed9b2266b645cf1b8be51009cc3b260e100",
    "signing_instructions": [
      {
        "position": 0,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0100000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": null,
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd5"
          }
        ]
      },
      {
        "position": 1,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0800000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": null,
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "05cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe61540535419"
          }
        ]
      }
    ]
  }
}

對應響應對象的源代碼如下：

type request struct{
	TxTemplate txbuilder.Template `json:"transaction_template"`
}

// Template represents a partially- or fully-signed transaction.
type Template struct {
	Transaction         *types.Tx             `json:"raw_transaction"`
	SigningInstructions []*SigningInstruction `json:"signing_instructions"`

	// AllowAdditional affects whether Sign commits to the tx sighash or
	// to individual details of the tx so far. When true, signatures
	// commit to tx details, and new details may be added but existing
	// ones cannot be changed. When false, signatures commit to the tx
	// as a whole, and any change to the tx invalidates the signature.
	AllowAdditional bool `json:"allow_additional_actions"`
}

其中TxTemplate相關字段的說明見build-transaction的結果描述

調用estimate-transaction-gas接口成功之后返回的json結果如下：

{
  "total_neu": 5000000,
  "storage_neu": 3840000,
  "vm_neu": 1419000
}

對應響應對象的源代碼如下：

// EstimateTxGasResp estimate transaction consumed gas
type EstimateTxGasResp struct {
	TotalNeu   int64 `json:"total_neu"`
	StorageNeu int64 `json:"storage_neu"`
	VMNeu      int64 `json:"vm_neu"`
}

結構字段說明如下：

TotalNeu 預估的總手續費（單位為neu），該值直接加到build-transaction的BTM資產輸入action中即可
StorageNeu 存儲交易的手續費
VMNeu 運行虛擬機的手續費

2、簽名交易

API接口 sign-transaction，代碼api/hsm.go#L53

簽名交易的輸入請求json格式如下：

{
  "password": "123456",
  "transaction": {
    "allow_additional_actions": false,
    "raw_transaction": "070100020161015f1190c60818b4aff485c865113c802942f29ce09088cae1b117fc4c8db2292212ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8099c4d599010001160014a86c83ee12e6d790fb388345cc2e2b87056a077301000161015fb018097c4040c8dd86d95611a13c24f90d4c9d9d06b25f5c9ed0556ac8abd73442275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f80a094a58d1d0101160014068840e56af74038571f223b1c99f1b60caaf456010003013effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80bfffcb9901011600140b946646626c55a52a325c8bb48de792284d9b7200013e42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f9d9f94a58d1d01160014c8b4391bab4923a83b955170d24ee4ca5b6ec3fb00013942275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f6301160014366b275ed9b2266b645cf1b8be51009cc3b260e100",
    "signing_instructions": [
      {
        "position": 0,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0100000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": null,
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd5"
          }
        ]
      },
      {
        "position": 1,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0800000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": null,
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "05cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe61540535419"
          }
        ]
      }
    ]
  }
}

對應請求對象的源代碼如下：

type SignRequest struct {    //function pseudohsmSignTemplates request
	Password string             `json:"password"`
	Txs      txbuilder.Template `json:"transaction"`
}

結構字段說明如下：

Password 簽名的密碼，根據密碼可以從節點服務器上解析出用戶的私鑰，然后用私鑰對交易進行簽名
Txs 交易模板，build-transaction的返回結果，結構類型為 txbuilder.Template，相關字段的說明見build-transaction的結果描述

簽名交易sign-transaction請求成功之后返回的json結果如下：

{
  "sign_complete": true,
  "transaction": {
    "allow_additional_actions": false,
    "raw_transaction": "070100020161015f1190c60818b4aff485c865113c802942f29ce09088cae1b117fc4c8db2292212ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8099c4d599010001160014a86c83ee12e6d790fb388345cc2e2b87056a0773630240273d5fc4fb06909fbc2968ea91c411fd20f690c88e74284ce2732052400129948538562fe432afd6cf17e590e8645b80edf80b9d9581d0a980d5f9f859e3880620d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd50161015fb018097c4040c8dd86d95611a13c24f90d4c9d9d06b25f5c9ed0556ac8abd73442275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f80a094a58d1d0101160014068840e56af74038571f223b1c99f1b60caaf4566302400cf0beefceaf9fbf1efadedeff7aee5b38ee7a25a20d78b630b01613bc2f8c9230555a6e09aaa11a82ba68c0fc9e98a47c852dfe3de851d93f9b2b7ce256f90d2005cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe6154053541903013effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80bfffcb9901011600140b946646626c55a52a325c8bb48de792284d9b7200013e42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f9d9f94a58d1d01160014c8b4391bab4923a83b955170d24ee4ca5b6ec3fb00013942275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f6301160014366b275ed9b2266b645cf1b8be51009cc3b260e100",
    "signing_instructions": [
      {
        "position": 0,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0100000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": [
              "273d5fc4fb06909fbc2968ea91c411fd20f690c88e74284ce2732052400129948538562fe432afd6cf17e590e8645b80edf80b9d9581d0a980d5f9f859e38806"
            ],
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd5"
          }
        ]
      },
      {
        "position": 1,
        "witness_components": [
          {
            "keys": [
              {
                "derivation_path": [
                  "010100000000000000",
                  "0800000000000000"
                ],
                "xpub": "de0db655c091b2838ccb6cddb675779b0a9a4204b122e61699b339867dd10eb0dbdc926882ff6dd75c099c181c60d63eab0033a4b0a4d0a8c78079e39d7ad1d8"
              }
            ],
            "quorum": 1,
            "signatures": [
              "0cf0beefceaf9fbf1efadedeff7aee5b38ee7a25a20d78b630b01613bc2f8c9230555a6e09aaa11a82ba68c0fc9e98a47c852dfe3de851d93f9b2b7ce256f90d"
            ],
            "type": "raw_tx_signature"
          },
          {
            "type": "data",
            "value": "05cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe61540535419"
          }
        ]
      }
    ]
  }
}

對應響應對象的源代碼如下：

type signResp struct {
	Tx           *txbuilder.Template `json:"transaction"`
	SignComplete bool                `json:"sign_complete"`
}

結構字段說明如下：

Tx 簽名之后的交易模板txbuilder.Template，如果簽名成功則signatures會由null變成簽名的值，而raw_transaction的長度會變長，是因為bc.Tx部分添加了驗證簽名的參數信息
SignComplete 簽名是否完成標志，如果為true表示簽名完成，否則為false表示簽名未完成，單簽的話一般可能為簽名密碼錯誤; 而多簽的話一般為還需要其他簽名。簽名失敗只需將簽名的交易數據用正確的密碼重新簽名即可，無需再次build-transaction構建交易

3、提交交易

API接口 submit-transaction，代碼api/transact.go#L135

提交交易的輸入請求json格式如下：

{
  "raw_transaction": "070100020161015f1190c60818b4aff485c865113c802942f29ce09088cae1b117fc4c8db2292212ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8099c4d599010001160014a86c83ee12e6d790fb388345cc2e2b87056a0773630240273d5fc4fb06909fbc2968ea91c411fd20f690c88e74284ce2732052400129948538562fe432afd6cf17e590e8645b80edf80b9d9581d0a980d5f9f859e3880620d174db6506e35f2decb5be148c2984bfd0f6c67f043365bf642d1af387c04fd50161015fb018097c4040c8dd86d95611a13c24f90d4c9d9d06b25f5c9ed0556ac8abd73442275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f80a094a58d1d0101160014068840e56af74038571f223b1c99f1b60caaf4566302400cf0beefceaf9fbf1efadedeff7aee5b38ee7a25a20d78b630b01613bc2f8c9230555a6e09aaa11a82ba68c0fc9e98a47c852dfe3de851d93f9b2b7ce256f90d2005cdbcc705f07ad87521835bbba226ad7b430cc24e5e3f008edbe6154053541903013effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80bfffcb9901011600140b946646626c55a52a325c8bb48de792284d9b7200013e42275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f9d9f94a58d1d01160014c8b4391bab4923a83b955170d24ee4ca5b6ec3fb00013942275aacbeda1522cd41580f875c3c452daf5174b17ba062bf0ab71a568c123f6301160014366b275ed9b2266b645cf1b8be51009cc3b260e100"
}

對應源代碼的請求對象如下：

type SubmitRequest struct {    //function submit request
	Tx types.Tx `json:"raw_transaction"`
}

結構字段說明如下：

Tx 簽名完成之后的交易信息。這里需要注意該字段中的raw_transaction不是簽名交易sign-transaction的全部返回結果，而是簽名交易返回結果中transaction中的raw_transaction字段。

submit-transaction請求成功之后返回的json結果如下：

{
  "tx_id": "2c0624a7d251c29d4d1ad14297c69919214e78d995affd57e73fbf84ece361cd"
}

對應源代碼的響應對象如下：

type submitTxResp struct {
	TxID *bc.Hash `json:"tx_id"`
}

結構字段說明如下：

TxID 交易ID，當交易被提交到交易池之后會顯示該信息，否則表示交易失敗

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 STM32之spi管理模式 Azure 新的管理模式 —— Resource Manager 理解vuex的狀態管理模式架構海底撈核心管理模式解析！！ vue store之狀態管理模式理解Vue的狀態管理模式Vuex CJCMS系列---說說項目中的任務管理模式項目管理模式之如何去除SVN標記 php-fpm的執行方式 (進程管理模式) Github 新的項目管理模式——Projects