sendrawtransaction

Back to rawtransactions

Summary

Submit a raw transaction (serialized, hex-encoded) to local node and network.

Description

Submit a raw transaction (serialized, hex-encoded) to local node and network.

The transaction will be sent unconditionally to all peers, so using sendrawtransaction for manual rebroadcast may degrade privacy by leaking the transaction's origin, as nodes will normally not rebroadcast non-wallet transactions already in their mempool.

A specific exception, RPC_TRANSACTION_ALREADY_IN_UTXO_SET, may throw if the transaction cannot be added to the mempool.

Related RPCs: createrawtransaction, signrawtransactionwithkey

Arguments

  • hexstring (STR_HEX, required): The hex string of the raw transaction
  • maxfeerate (AMOUNT): Reject transactions whose fee rate is higher than the specified value, expressed in QBT/kvB. Fee rates larger than 1QBT/kvB are rejected. Set to 0 to accept any fee rate.
  • maxburnamount (AMOUNT): Reject transactions with provably unspendable outputs (e.g. 'datacarrier' outputs that use the OP_RETURN opcode) greater than the specified value, expressed in QBT. If burning funds through unspendable outputs is desired, increase this value. This check is based on heuristics and does not guarantee spendability of outputs.

Results

  • value (STR_HEX): The transaction hash in hex

Examples

Create a transaction
qbit-cli createrawtransaction "[{\"txid\" : \"mytxid\",\"vout\":0}]" "{\"myaddress\":0.01}"
Sign the transaction, and get back the hex
qbit-cli signrawtransactionwithwallet "myhex"
Send the transaction (signed hex)
qbit-cli sendrawtransaction "signedhex"
As a JSON-RPC call
curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "sendrawtransaction", "params": ["signedhex"]}' -H 'content-type: application/json' http://127.0.0.1:8352/