Transaction Failed
This error occurs when a client submits a transaction that was well-formed but was not included into the ledger due to some other failure. For example, a transaction may fail if:
- The source account for transaction cannot pay the minimum fee.
- The sequence number is incorrect.
- One of the contained operations has failed such as a payment operation that overdraws the paying account.
In almost every case, this error indicates that the transaction submitted in the initial request will never succeed. There is one exception: a transaction that fails with the tx_bad_seq result code (as expressed in the result_code field of the error) may become valid in the future if the sequence number it used was too high.
Attributes
As with all errors Frontier returns, transaction_failed follows the Problem Details for HTTP APIs draft specification guide and thus has the following attributes:
| Attribute | Type | Description |
|---|---|---|
| Type | URL | The identifier for the error. This is a URL that can be visited in the browser. |
| Title | String | A short title describing the error. |
| Status | Number | An HTTP status code that maps to the error. |
| Detail | String | A more detailed description of the error. |
| Instance | String | A token that uniquely identifies this request. Allows server administrators to correlate a client report with server log files. |
In addition, the following additional data is provided in the extras field of the error:
| Attribute | Type | Description |
|---|---|---|
envelope_xdr |
String | A base64-encoded representation of the TransactionEnvelope XDR whose failure triggered this response. |
result_xdr |
String | A base64-encoded representation of the TransactionResult XDR returned by digitalbits-core when submitting this transactions. |
result_codes.transaction |
String | The transaction result code returned by digitalbits-core. |
result_codes.operations |
Array | An array of strings, representing the operation result codes for each operation in the submitted transaction, if available. |
Example
{
"type": "https://developer.digitalbits.io/frontier/reference/errors/transaction-failed.html",
"title": "Transaction Failed",
"status": 400,
"details": "...",
"instance": "d3465740-ec3a-4a0b-9d4a-c9ea734ce58a",
"extras": {
"envelope_xdr": "...",
"result_xdr": "...",
"result_codes": {
"transaction": "tx_failed",
"operations": [ "op_bad_auth" ]
}
}
}
Related
Edit this doc in GitHub