bitcoin-tx - Man Page
manual page for bitcoin-tx v29.0.0
Synopsis
bitcoin-tx [options] <hex-tx> [commands]
bitcoin-tx [options] -create [commands]
Description
Bitcoin Core bitcoin-tx utility version v29.0.0
The bitcoin-tx tool is used for creating and modifying bitcoin transactions.
bitcoin-tx can be used with "<hex-tx> [commands]" to update a hex-encoded bitcoin transaction, or with "-create [commands]" to create a hex-encoded bitcoin transaction.
Options
- -create
Create new, empty TX.
- -help
Print this help message and exit (also -h or -?)
- -json
Select JSON output
- -txid
Output only the hex-encoded transaction id of the resultant transaction.
- -version
Print version and exit
Debugging/Testing options:
Chain selection options:
- -chain=<chain>
Use the chain <chain> (default: main). Allowed values: main, test, testnet4, signet, regtest
- -signet
Use the signet chain. Equivalent to -chain=signet. Note that the network is defined by the -signetchallenge parameter
- -signetchallenge
Blocks must satisfy the given script to be considered valid (only for signet networks; defaults to the global default signet test network challenge)
- -signetseednode
Specify a seed node for the signet network, in the hostname[:port] format, e.g. sig.net:1234 (may be used multiple times to specify multiple seed nodes; defaults to the global default signet test network seed node(s))
- -testnet
Use the testnet3 chain. Equivalent to -chain=test. Support for testnet3 is deprecated and will be removed in an upcoming release. Consider moving to testnet4 now by using -testnet4.
- -testnet4
Use the testnet4 chain. Equivalent to -chain=testnet4.
- Commands:
delin=N
Delete input N from TX
delout=N
Delete output N from TX
in=TXID:VOUT(:SEQUENCE_NUMBER)
Add input to TX
locktime=N
Set TX lock time to N
nversion=N
Set TX version to N
outaddr=VALUE:ADDRESS
Add address-based output to TX
outdata=[VALUE:]DATA
Add data-based output to TX
outmultisig=VALUE:REQUIRED:PUBKEYS:PUBKEY1:PUBKEY2:....[:FLAGS]
Add Pay To n-of-m Multi-sig output to TX. n = REQUIRED, m = PUBKEYS. Optionally add the "W" flag to produce a pay-to-witness-script-hash output. Optionally add the "S" flag to wrap the output in a pay-to-script-hash.
outpubkey=VALUE:PUBKEY[:FLAGS]
Add pay-to-pubkey output to TX. Optionally add the "W" flag to produce a pay-to-witness-pubkey-hash output. Optionally add the "S" flag to wrap the output in a pay-to-script-hash.
outscript=VALUE:SCRIPT[:FLAGS]
Add raw script output to TX. Optionally add the "W" flag to produce a pay-to-witness-script-hash output. Optionally add the "S" flag to wrap the output in a pay-to-script-hash.
replaceable(=N)
Sets Replace-By-Fee (RBF) opt-in sequence number for input N. If N is not provided, the command attempts to opt-in all available inputs for RBF. If the transaction has no inputs, this option is ignored.
sign=SIGHASH-FLAGS
Add zero or more signatures to transaction. This command requires JSON registers:prevtxs=JSON object, privatekeys=JSON object. See signrawtransactionwithkey docs for format of sighash flags, JSON objects.
- Register Commands:
load=NAME:FILENAME
Load JSON file FILENAME into register NAME
set=NAME:JSON-STRING
Set register NAME to given JSON-STRING
Copyright
Copyright (C) 2009-2025 The Bitcoin Core developers
Please contribute if you find Bitcoin Core useful. Visit <https://bitcoincore.org/> for further information about the software. The source code is available from <https://github.com/bitcoin/bitcoin>.
This is experimental software. Distributed under the MIT software license, see the accompanying file COPYING or <https://opensource.org/licenses/MIT>
See Also
bitcoind(1), bitcoin-cli(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)
Referenced By
bitcoin-cli(1), bitcoind(1), bitcoin-qt(1), bitcoin-util(1), bitcoin-wallet(1).