Tx broadcast relay

POST /v1/stellar/tx/broadcast is the planned convenience relay for a signed Stellar transaction envelope. It is not the current EVM raw-transaction endpoint.

Request and result

The request includes network and signedTransactionXdr, a base64-encoded signed envelope. It contains no customer secret key. The relay verifies network binding, bounds, allowed submission policy, and request size, then sends it to RPC. An acknowledgement contains the transaction hash and pending status. Confirmation records ledger, result, and contract events.

The user or wallet signs the transaction and required authorization entries. A fee sponsor may add its own approved sponsorship signature without changing customer-authorized actions. Plain base64 text is not proof of a valid signature.

Polling and retries

The proposed operation read returns pending, succeeded, failed, or unknown. Retry status queries safely. An unknown outcome must be reconciled before preparing another funds-moving transaction. A rebuilt envelope after a sequence or expiration change may require new authorization.

Deduplicate indexer updates and webhook delivery. Do not present the source submission hash as a confirmed bank payout or a completed bridge transfer. See errors.