Skip to main content

sendTransaction

Submit a real transaction to the Stellar network. This is the only way to make changes "on-chain".

Unlike Horizon, this does not wait for transaction completion. It simply validates and enqueues the transaction. Clients should call getTransaction to learn about transaction success/failure.

This supports all transactions, not only smart contract-related transactions.

Parameters

  • <xdr.TransactionEnvelope> - The signed transaction to broadcast (serialized in base64)

Returns

  • <object>
    • hash: <hash> The transaction hash (in an hex-encoded string).
    • status: <status> - The current status of the transaction by hash, one of:
      • PENDING - The transaction has been accepted by stellar-core.
      • DUPLICATE - The transaction has already been submitted to stellar-core.
      • TRY_AGAIN_LATER - The transaction was not included in the previous 4 ledgers and is banned from the next few ledgers.
      • ERROR - An error occurred from submitting the transaction to stellar-core.
    • latestLedger: <string> - The latest ledger known to Soroban-RPC at the time it handled the sendTransaction() request.
    • latestLedgerCloseTime: <string> - The unix timestamp of the close time of the latest ledger known to Soroban-RPC at the time it handled the sendTransaction() request.
    • errorResultXdr: <xdr.TransactionResult> - (optional) If the transaction status is ERROR, this will be a base64 encoded string of the raw TransactionResult XDR struct containing details on why stellar-core rejected the transaction.

Examples

Request

{
"jsonrpc": "2.0",
"id": 8675309,
"method": "sendTransaction",
"params": {
"transaction": "AAAAAgAAAABzdv3ojkzWHMD7KUoXhrPx0GH18vHKV0ZfqpMiEblG1gAAp18AAAAAAAAAAgAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAHN2/eiOTNYcwPspSheGs/HQYfXy8cpXRl+qkyIRuUbWAAAAGAAAAAEAAAABAAAAAPVf8W9m9DNgJmuV22+P7AHXYDEFQwauSks4BZj2z9EUAAAAAO3beL34UBBpCfUUPCfcnqX8YQKn41UhnKu6BInkVe9lAAAAAAAAAAEAAAABAAAAB+3beL34UBBpCfUUPCfcnqX8YQKn41UhnKu6BInkVe9lAAAAAQAAAAbhq+vRxjISTR62JpK1SAnzz1cZKpSpkRlwLJH6ZrzssgAAABQAAUKLAAAUkAAAAIAAAACoAAAAAAAAACEAAAAAAAAAARG5RtYAAABA+Vy3k86bNEP7rP8hb3cY1QWYhRa3CnF7jqHUj22Rd++2a0YwCKrMbofTUOb21GP6aFZwfKVvaokS22u1to5xDw=="
}
}

Response

{
"jsonrpc": "2.0",
"id": 8675309,
"result": {
"hash": "a01441a4d0b80769d2c2d97dcd28d13e9036065da14ea83731424d77efc50894",
"status": "PENDING",
"latestLedger": "45075181",
"latestLedgerCloseTime": "1677115742"
}
}