Post Transaction
Posts a new transaction to the Stellar Network. Note that creating a valid transactions and signing it properly should be the responsibility of your client library.
Also note, this endpoint is presently a very thin wrapper around the raw transaction submission endpoint in stellar-core. This endpoint will probably change quite soon to reflect more of the design choices made by the rest of horizon
Request
POST /transactions
Arguments
name | loc | notes | example | description |
---|---|---|---|---|
tx |
body | required | 899b2840ed5636c56ddc5f14b23975f79f1ba2388d2694e4c56ecdddc960e5ef 0000000a000000000000000100000000ffffffff000000010000000000000000 500e14fe9d7dc549e30244da424cfbcabe2166a55237897473d3f7358a086b48 00000000000009184e72a000000000000000000000000000000009184e72a000 00000001899b28402e992cc5fc6d7e0f888b7afa173a35d3ce87526bc37d8171 e2d9ee7f2715d1d4146a9026b13396ab8e7392f947caba1b00d398801b4644ae 5238f96f96ec7605 |
Example
curl https://horizon-testnet.stellar.org/transactions \
-X POST \
-F "tx=899b2840ed5636c56ddc5f14b23975f79f1ba2388d2694e4c56ecdddc960e5ef0000000a000000000000000100000000ffffffff000000010000000000000000500e14fe9d7dc549e30244da424cfbcabe2166a55237897473d3f7358a086b4800000000000009184e72a000000000000000000000000000000009184e72a00000000001899b28402e992cc5fc6d7e0f888b7afa173a35d3ce87526bc37d8171e2d9ee7f2715d1d4146a9026b13396ab8e7392f947caba1b00d398801b4644ae5238f96f96ec7605"
Response
This endpoint returns a resource that represents the result of initial submission of the provided transaction to stellar-core.
Attributes
Name | Type | |
---|---|---|
hash |
string | A hex-encoded hash of the submitted transaction. |
result |
string | Distilled summary of the result. See “Result” section below. |
submission_result |
string | A hex-encoded TransactionResult XDR object. |
Result
The result
attribute of a response from this endpoint can be one of the following values:
result |
|
---|---|
malformed | The transaction was suffiently malformed that we could not interpet it. |
already_finished | The hash for this transaction hash is either in the history database or is in the stellar core database. |
received | The transaction was submitted and received by stellar core, and will be included in consideration for a validared ledger |
failed | The submission to stellar core failed, and was not recieved by the network. Refer to the submission_result for details. |
connection_failed | Horizon could not connect to stellar core. |
Example
{
"hash": "802da5683737972e5a0a6d8d4960bb43a7be64a1dbc00549eeb31729f94c75f2",
"result": "failed",
"submission_result": "0000000000000000fffffffb"
}
Problems
This endpoint should only respond with [standard errors][se].