submit_multisigned - XRPL

Example code for the submit_multisigned JSON RPC method. Complete guide to using submit_multisigned JSON-RPC in the GetBlock Web3 documentation.

This method applies a multi-signed transaction and sends it to the network.

Parameters

Parameter

Type

Required

Description

tx_json

object

Yes

Multi-signed transaction JSON

fail_hard

boolean

Fail if local error

Request Example

curl

curl --location --request POST 'https://xrp.getblock.io/mainnet/' \
--header 'x-api-key: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "submit_multisigned",
    "params": [{
        "tx_json": {
            "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "TransactionType": "Payment",
            "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
            "Amount": "1000000",
            "Fee": "30",
            "Signers": []
        }
    }],
    "id": "getblock.io"
}'

submit_multisigned.js

const axios = require('axios');

const url = 'https://xrp.getblock.io/mainnet/';
const headers = {
    'x-api-key': 'YOUR-API-KEY',
    'Content-Type': 'application/json'
};

const payload = {
    jsonrpc: '2.0',
    method: 'submit_multisigned',
    params: [{
        tx_json: {
            Account: 'rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH',
            TransactionType: 'Payment',
            Destination: 'ra5nK24KXen9AHvsdFTKHSANinZseWnPcX',
            Amount: '1000000',
            Fee: '30',
            Signers: []
        }
    }],
    id: 'getblock.io'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));

submit_multisigned.py

import requests

url = "https://xrp.getblock.io/mainnet/"
headers = {
    "x-api-key": "YOUR-API-KEY",
    "Content-Type": "application/json"
}

payload = {
    "jsonrpc": "2.0",
    "method": "submit_multisigned",
    "params": [{
        "tx_json": {
            "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "TransactionType": "Payment",
            "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
            "Amount": "1000000",
            "Fee": "30",
            "Signers": []
        }
    }],
    "id": "getblock.io"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

submit_multisigned.rs

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    
    let payload = json!({
        "jsonrpc": "2.0",
        "method": "submit_multisigned",
        "params": [{
            "tx_json": {
                "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
                "TransactionType": "Payment",
                "Signers": []
            }
        }],
        "id": "getblock.io"
    });

    let response = client
        .post("https://xrp.getblock.io/mainnet/")
        .header("x-api-key", "YOUR-API-KEY")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);
    
    Ok(())
}

Response Example

response.json

{
    "result": {
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The transaction was applied.",
        "status": "success",
        "tx_json": {
            "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "TransactionType": "Payment"
        }
    }
}

Response Parameters

Field

Type

Description

engine_result

string

Transaction result

engine_result_code

integer

Result code

tx_blob

string

Transaction hex

tx_json

object

Transaction JSON

signer

array

Signer list

Use Cases

Multi-signature accounts
Shared custody
Organizational accounts

Error Handling

Error Code

Description

temINVALID

Invalid transaction

tefNOT_MULTI_SIGNING

Not multi-sig enabled

SDK Integration

xrpl.js (example)

const xrpl = require('xrpl');

// Multi-signing requires collecting signatures from multiple wallets
// See xrpl.js documentation for full multi-sign workflow

xrpl-py (example)

from xrpl.clients import JsonRpcClient
from xrpl.models.requests import SubmitMultisigned

client = JsonRpcClient("https://xrp.getblock.io/mainnet/")
# Collect signatures and submit

Previousping - XRPL Nextunsubscribe - XRPL

Last updated 5 days ago

Was this helpful?

hashtagParameters

hashtagRequest Example

hashtagResponse Example

hashtagResponse Parameters

hashtagUse Cases

hashtagError Handling

hashtagSDK Integration

Parameters

Request Example

Response Example

Response Parameters

Use Cases

Error Handling

SDK Integration