Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

send_raw_transaction

Broadcast a signed transaction. The node validates against the current tip, inserts into mempool, and relays to peers.

Params

{ "tx_hex": "<canonical serialized transaction, hex>" }

Result

{ "tx_id": "fb8a634f...8c" }

tx_id is the protocol-canonical hash of the serialized form. Callers should reconstruct it locally and compare before trusting the value returned by the RPC server.

Errors

  • -32602 Failed to deserialize transaction: ... — malformed bytes
  • -32602 Trailing bytes after transaction: ... — extra bytes after tx body
  • -32602 Mempool pre-check failed: ... — duplicate tx, double-spend, etc.
  • -32602 Transaction validation failed: ... — consensus rule violation (missing UTXO, immature coinbase, fee too low, script failure, etc.)
  • -32603 Tip changed during validation, try again — retriable race

Rate-limited to 60 / min / IP. Body cap 2.5 MiB.

On success, the transaction is in the receiving node's local mempool. To verify propagation, query a different node or wait for inclusion in a block.