submit_multisigned

Applies a multi-signed transaction and sends it to the network to be included in future ledgers. You can also submit multi-signed transactions in binary form using the submit method.

This method will use 80 Compute Units.

---

Reference: Here

Parameters

• tx_json (object, required) Transaction in JSON format with an array of Signers. To be successful, the weights of the signatures must be equal or higher than the quorum of the account's SignerList.

• fail_hard (boolean, optional) If true, and the transaction fails locally, do not retry or relay the transaction to other servers. The default is false.

Returns

• engine_result (string) Code indicating the preliminary result of the transaction, for example tesSUCCESS.

• engine_result_code (integer) Numeric code indicating the preliminary result of the transaction.

• engine_result_message (string) Human-readable explanation of the preliminary transaction result.

• tx_blob (string) The complete transaction in hex string format.

• tx_json (object) The complete transaction in JSON format.

// Result
// Illustrative example from xrpl.org; the request and response are not from a live submission
{
  "result": {
    "engine_result": "tesSUCCESS",
    "engine_result_code": 0,
    "engine_result_message": "The transaction was applied. Only final in a validated ledger.",
    "status": "success",
    "tx_blob": "1200142200040000240000000263D5038D7EA4C680000000000000000000000000005553440000000000B5F762798A53D543A014CAF8B297CFF8F2F937E8...",
    "tx_json": {
      "Account": "rEuLyBCvcw4CFmzv8RepSiAoNgF8tTGJQC",
      "Fee": "30000",
      "Flags": 262144,
      "LimitAmount": {
        "currency": "USD",
        "issuer": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "value": "100"
      },
      "Sequence": 2,
      "Signers": [
        {
          "Signer": {
            "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
            "SigningPubKey": "02B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF",
            "TxnSignature": "30450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A..."
          }
        },
        // ...
      ],
      "SigningPubKey": "",
      "TransactionType": "TrustSet",
      "hash": "BD636194C48FD7A100DE4C972336534C8E710FD008C0F3CF7BC5BF34DAF3C3E6"
    }
  }
}

mainnet

curl https://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"method":"submit_multisigned","params":[{"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"}}]}'

Over WebSocket, send {"id":1,"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"}} to wss://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE>.