submit_multisigned

[ソース]

submit_multisignedコマンドはマルチシグトランザクションを適用し、このトランザクションをネットワークに送信して、今後のレジャーに追加します。（submitコマンドを送信専用モードで使用して、マルチシグトランザクションをバイナリー形式で送信することもできます。)

このコマンドを使用するには、MultiSign Amendmentが有効になっている必要があります。

リクエストのフォーマット

リクエストのフォーマットの例:

{
   "id": "submit_multisigned_example",
   "command": "submit_multisigned",
   "tx_json": {
       "Account": "rEuLyBCvcw4CFmzv8RepSiAoNgF8tTGJQC",
       "Fee": "30000",
       "Flags": 262144,
       "LimitAmount": {
           "currency": "USD",
           "issuer": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
           "value": "100"
       },
       "Sequence": 2,
       "Signers": [{
           "Signer": {
               "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
               "SigningPubKey": "02B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF",
               "TxnSignature": "30450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A022048C323B0BED19A988BDBEFA974B6DE8AA9DCAE250AA82BBD1221787032A864E5"
           }
       }, {
           "Signer": {
               "Account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
               "SigningPubKey": "028FFB276505F9AC3F57E8D5242B386A597EF6C40A7999F37F1948636FD484E25B",
               "TxnSignature": "30440220680BBD745004E9CFB6B13A137F505FB92298AD309071D16C7B982825188FD1AE022004200B1F7E4A6A84BB0E4FC09E1E3BA2B66EBD32F0E6D121A34BA3B04AD99BC1"
           }
       }],
       "SigningPubKey": "",
       "TransactionType": "TrustSet",
       "hash": "BD636194C48FD7A100DE4C972336534C8E710FD008C0F3CF7BC5BF34DAF3C3E6"
   }
}

リクエストには以下のパラメーターが含まれます。

`Field`	型	説明
`tx_json`	オブジェクト	`Signers`からなる配列が指定されたJSONフォーマットのトランザクション。成功させるには、署名の重みがSignerListの定数以上でなければなりません。
`fail_hard`	ブール値	（省略可、デフォルトではfalseです）trueで、かつトランザクションがローカルで失敗する場合は、このトランザクションの再試行や、他のサーバへのリレーは行わないでください。

レスポンスのフォーマット

処理が成功したレスポンスの例:

{
 "id": "submit_multisigned_example",
 "status": "success",
 "type": "response",
 "result": {
   "engine_result": "tesSUCCESS",
   "engine_result_code": 0,
   "engine_result_message": "The transaction was applied.Only final in a validated ledger.",
   "tx_blob": "1200142200040000240000000263D5038D7EA4C680000000000000000000000000005553440000000000B5F762798A53D543A014CAF8B297CFF8F2F937E868400000000000753073008114A3780F5CB5A44D366520FC44055E8ED44D9A2270F3E010732102B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF744730450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A022048C323B0BED19A988BDBEFA974B6DE8AA9DCAE250AA82BBD1221787032A864E58114204288D2E47F8EF6C99BCC457966320D12409711E1E0107321028FFB276505F9AC3F57E8D5242B386A597EF6C40A7999F37F1948636FD484E25B744630440220680BBD745004E9CFB6B13A137F505FB92298AD309071D16C7B982825188FD1AE022004200B1F7E4A6A84BB0E4FC09E1E3BA2B66EBD32F0E6D121A34BA3B04AD99BC181147908A7F0EDD48EA896C3580A399F0EE78611C8E3E1F1",
   "tx_json": {
     "Account": "rEuLyBCvcw4CFmzv8RepSiAoNgF8tTGJQC",
     "Fee": "30000",
     "Flags": 262144,
     "LimitAmount": {
       "currency": "USD",
       "issuer": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
       "value": "100"
     },
     "Sequence": 2,
     "Signers": [
       {
         "Signer": {
           "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
           "SigningPubKey": "02B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF",
           "TxnSignature": "30450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A022048C323B0BED19A988BDBEFA974B6DE8AA9DCAE250AA82BBD1221787032A864E5"
         }
       },
       {
         "Signer": {
           "Account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
           "SigningPubKey": "028FFB276505F9AC3F57E8D5242B386A597EF6C40A7999F37F1948636FD484E25B",
           "TxnSignature": "30440220680BBD745004E9CFB6B13A137F505FB92298AD309071D16C7B982825188FD1AE022004200B1F7E4A6A84BB0E4FC09E1E3BA2B66EBD32F0E6D121A34BA3B04AD99BC1"
         }
       }
     ],
     "SigningPubKey": "",
     "TransactionType": "TrustSet",
     "hash": "BD636194C48FD7A100DE4C972336534C8E710FD008C0F3CF7BC5BF34DAF3C3E6"
   }
 }
}

レスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれています。

`Field`	型	説明
`engine_result`	文字列	以下は、トランザクションの暫定的な結果を示すコードの例です。 `tesSUCCESS`
`engine_result_code`	整数	トランザクションの暫定的な結果を示し、`engine_result`と直接の相関関係にある数値コード
`engine_result_message`	文字列	人間が読み取れる形式の暫定的なトランザクション結果の説明
`tx_blob`	文字列	トランザクション全体の16進文字列表現
`tx_json`	オブジェクト	トランザクション全体のJSON表現

考えられるエラー

汎用エラータイプのすべて。
invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
srcActMalformed - tx_jsonのAccountフィールドが無効または欠落していました。
internal - 内部エラーが発生しました。これには、指定されているトランザクションJSONに対して署名が無効な場合も含まれます。