NAME¶

bitcoin-tx - a tool for creating and modifying bitcoin transactions

SYNOPSIS¶

bitcoin-tx [options] <hex-tx> [commands]
bitcoin-tx [options] -create [commands]

DESCRIPTION¶

Bitcoin Knots bitcoin-tx utility version v29.3.0.knots20260210

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

-signetblocktime

Difficulty adjustment will target a block time of the given amount in seconds (only for custom signet networks, must have -signetchallenge set; defaults to 10 minutes)

-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-2026 The Bitcoin Knots developers Copyright (C) 2009-2026 The Bitcoin Core developers

Please contribute if you find Bitcoin Knots useful. Visit <https://bitcoinknots.org/> for further information about the software. The source code is available from <https://github.com/bitcoinknots/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-wallet(1), bitcoin-util(1), bitcoin-qt(1)