最終更新:
編集

submit_multisigned

[ソース]

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

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

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

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

{
   "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_jsonAccountフィールドが無効または欠落していました。
  • internal - 内部エラーが発生しました。これには、指定されているトランザクションJSONに対して署名が無効な場合も含まれます。