Transaction Failed [Go SDK]
The transaction_failed
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 on 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.
This error returns a HTTP 400 Error.
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. |
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 transaction. |
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. |
Examples
No Source Account
{
"type": "https://digitalbits.org/frontier-errors/transaction_failed",
"title": "Transaction Failed",
"status": 400,
"detail": "The transaction failed when submitted to the digitalbits network. The `extras.result_codes` field on this response contains further details. Descriptions of each code can be found at: https://developers.digitalbits.io/guides/concepts/list-of-operations.html",
"extras": {
"envelope_xdr": "AAAAANNVpdQ9vctZdAJ67sFmNe1KDzaj51dAdkW3vKKM51H3AAAAZAAAAABJlgLSAAAAAAAAAAAAAAABAAAAAAAAAAEAAAAA01Wl1D29y1l0AnruwWY17UoPNqPnV0B2Rbe8ooznUfcAAAAAAAAAAAL68IAAAAAAAAAAAA==",
"result_codes": {
"transaction": "tx_no_source_account"
},
"result_xdr": "AAAAAAAAAAD////4AAAAAA=="
}
}
Bad Authentication
{
"type": "https://digitalbits.org/frontier-errors/transaction_failed",
"title": "Transaction Failed",
"status": 400,
"detail": "The transaction failed when submitted to the digitalbits network. The `extras.result_codes` field on this response contains further details. Descriptions of each code can be found at: https://developers.digitalbits.io/guides/concepts/list-of-operations.html",
"extras": {
"envelope_xdr": "AAAAAPORy3CoX6ox2ilbeiVjBA5WlpCSZRcjZ7VE9Wf4QVk7AAAAZAAAQz0AAAACAAAAAAAAAAAAAAABAAAAAAAAAAEAAAAA85HLcKhfqjHaKVt6JWMEDlaWkJJlFyNntUT1Z/hBWTsAAAAAAAAAAAL68IAAAAAAAAAAARN17BEAAABAA9Ad7OKc7y60NT/JuobaHOfmuq8KbZqcV6G/es94u9yT84fi0aI7tJsFMOyy8cZ4meY3Nn908OU+KfRWV40UCw==",
"result_codes": {
"transaction": "tx_bad_auth"
},
"result_xdr": "AAAAAAAAAGT////6AAAAAA=="
}
}
Related
Edit this doc in GitHub