SubmitTransaction
Submits a previously issued transaction group that has been signed by the user.
Request Parameters
Name | Type | Description |
---|---|---|
unsigned | string[] | The array of transactions that have not been signed (the transactions returned with an empty signers array). |
signed | string[] | 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.
Name | Type | Description |
---|---|---|
txIds | string[] | The array of transaction ids of the transactions that have been submitted. |
txGroupId | string | A transaction group ID which identifies the submitted transaction group. |
Validation errors
Returned when the parameters are invalid.
Name | Content |
---|---|
Status code | 400 |
errorId | INVALID_PARAMS |
message | Validation errors in SubmitTransaction request. |
errors | Array of strings containing additional informations. |
Not issued by provider
Returned when the parameters are invalid.
Name | Content |
---|---|
Status code | 400 |
errorId | NOT_ISSUED |
message | Submitted 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="
}