Skip to main content

SubmitTransaction

Submits a previously issued transaction group that has been signed by the user.

Request Parameters

NameTypeDescription
unsignedstring[]The array of transactions that have not been signed (the transactions returned with an empty signers array).
signedstring[]The array of transactions that have been signed by the user (with the keys of the accounts in the signers array).

Responses

Regular response

caution

SubmitTransaction will send the blockchain transaction to the network without waiting for it to be confirmed. It is important to poll for the transaction status using TransactionStatus API endpoint after it was submitted, ensuring its status is "confirmed". Normally, transactions are confirmed within 5-10 seconds.

NameTypeDescription
txIdsstring[]The array of transaction ids of the transactions that have been submitted.
txGroupIdstringA transaction group ID which identifies the submitted transaction group.

Validation errors

Returned when the parameters are invalid.

NameContent
Status code400
errorIdINVALID_PARAMS
messageValidation errors in SubmitTransaction request.
errorsArray of strings containing additional informations.

Not issued by provider

Returned when the parameters are invalid.

NameContent
Status code400
errorIdNOT_ISSUED
messageSubmitted transaction has not been issued by the provider.

Example Usage

const response = await fetch('https://delegator-dev01b.arringo.co/api-test/SubmitTransaction', {
method: 'POST',
body: JSON.stringify({
'unsigned': [
'iqNhbXTOAAMNQKNmZWXND6CiZnbOARs+s6NnZW6sdGVzdG5ldC12MS4womdoxCBIY7UYpLPITsgQ8i1PEIHLD3HwWaesIN7GL39w5Qk6IqNncnDEIFf6XgbUDCtqGRAmrNbaG0ZlsNwwbbQEj/F+TFh4QZbEomx2zgEbQpujcmN2xCAaKi/RLmgGeQhK61juqhCBLkFtPXinjMzTcNc10IaOTKNzbmTEIGvkIhQ8kyZFK6yPPqxPgOpyqgq3DUTTf62WCXzMNcePpHR5cGWjcGF5',
'iaRhcmN2xCAaKi/RLmgGeQhK61juqhCBLkFtPXinjMzTcNc10IaOTKJmds4BGz6zo2dlbqx0ZXN0bmV0LXYxLjCiZ2jEIEhjtRiks8hOyBDyLU8QgcsPcfBZp6wg3sYvf3DlCToio2dycMQgV/peBtQMK2oZECas1tobRmWw3DBttASP8X5MWHhBlsSibHbOARtCm6NzbmTEIBoqL9EuaAZ5CErrWO6qEIEuQW09eKeMzNNw1zXQho5MpHR5cGWlYXhmZXKkeGFpZM4DGUVQ'
],
'signed': [
'gqNzaWfEQF85xcpo7AhN39cJYHBnrVJobOb0hiu7A5pOG/QOXVr3I6BA1OltEliky33iP+V1opWC1ZKrF670OuGlJSIPMw+jdHhuiqRhYW10AaRhcmN2xCBr5CIUPJMmRSusjz6sT4DqcqoKtw1E03+tlgl8zDXHj6Jmds4BGz6zo2dlbqx0ZXN0bmV0LXYxLjCiZ2jEIEhjtRiks8hOyBDyLU8QgcsPcfBZp6wg3sYvf3DlCToio2dycMQgV/peBtQMK2oZECas1tobRmWw3DBttASP8X5MWHhBlsSibHbOARtCm6NzbmTEIF31eqX/L2cKuT4a+NfHsT//chu0l/1l/WhK/ut7D7japHR5cGWlYXhmZXKkeGFpZM4DGUVQ',
'gqNzaWfEQFegzpz7Ic84l8Z5WLO3c2FW6svViOtzd/iIeiEtl3P1LQpfoJI5S570FQhgPbQeMKmGs6t6AsSyqce2NzCY2QKjdHhuiqRhYW10zQnDpGFyY3bEIBoqL9EuaAZ5CErrWO6qEIEuQW09eKeMzNNw1zXQho5MomZ2zgEbPrOjZ2VurHRlc3RuZXQtdjEuMKJnaMQgSGO1GKSzyE7IEPItTxCByw9x8FmnrCDexi9/cOUJOiKjZ3JwxCBX+l4G1AwrahkQJqzW2htGZbDcMG20BI/xfkxYeEGWxKJsds4BG0Kbo3NuZMQgXfV6pf8vZwq5Phr418exP/9yG7SX/WX9aEr+63sPuNqkdHlwZaVheGZlcqR4YWlkzgMZRVA='
]
})
});
const data = await response.json();

Example Success Response

{
"txIds": [
"EJED3SAA3VSL65AFLMTBYIZK7WTGSJTEFJTT366643LXRHG2JPAA",
"E4DTKHC2COBNVZ6WKXZHNDRSHN65SBWJ7FCOTLZKPKQ5KDLOSJBQ",
"L6OJII4GFOTADQG55FQ7J6BRTF26PS7WODLRN5JA25YUBYQSTQ4Q",
"34N5XJNL2V7TQZRN3DYNIFL22U2MWTWSIA4EH4NDI4CHNGVBC75A"
],
"txGroupId": "V/peBtQMK2oZECas1tobRmWw3DBttASP8X5MWHhBlsQ="
}