bumpfee

bumpfee "txid" ( options )

Increases the fee of an opt-in RBF transaction (T) by replacing it with a new transaction (B).

An opt-in RBF transaction with the given txid must already be present in the wallet.

The additional fee will be covered by either reducing the change outputs or adding new inputs if necessary. If the original transaction does not have a change output, a new one may be added.

All inputs from the original transaction will be included in the replacement transaction.

The command will fail if the wallet or mempool contains any transaction that spends one of T’s outputs.

By default, the new fee is calculated automatically using the estimatesmartfee RPC. The user can specify a confirmation target for the estimatesmartfee calculation. Alternatively, the user may specify a fee rate for the new transaction in sat/vB.

At a minimum, the new fee rate must be high enough to cover the additional relay fee (incrementalfee returned by getnetworkinfo) to ensure the transaction enters the node’s mempool.

Argument #1 – txid

Type: string, required

The txid to be bumped

Argument #2 – options

Type: json object, optional

{
  "conf_target": n,          (numeric, optional, default=wallet -txconfirmtarget) Confirmation target in blocks

  "fee_rate": amount,        (numeric or string, optional, default=not set, fall back to wallet fee estimation)
                             Specify a fee rate in sat/vB instead of relying on the built-in fee estimator.
                             Must be at least 1.000 sat/vB higher than the current transaction fee rate.
                             WARNING: before version 0.21, fee_rate was in BTCE/kvB. As of 0.21, fee_rate is in sat/vB.

  "replaceable": bool,       (boolean, optional, default=true) Whether the new transaction should still be
                             marked bip-125 replaceable. If true, the sequence numbers in the transaction will
                             be left unchanged from the original. If false, any input sequence numbers in the
                             original transaction that were less than 0xfffffffe will be increased to 0xfffffffe
                             so the new transaction will not be explicitly bip-125 replaceable (though it may
                             still be replaceable in practice, for example if it has unconfirmed ancestors which
                             are replaceable).

  "estimate_mode": "str",    (string, optional, default=unset) The fee estimate mode, must be one of (case insensitive):
                             "unset"
                             "economical"
                             "conservative"
}

Result

{                    (json object)
  "psbt" : "str",    (string) The base64-encoded unsigned PSBT of the new transaction. Only returned when wallet private keys are disabled. (DEPRECATED)
  "txid" : "hex",    (string) The id of the new transaction. Only returned when wallet private keys are enabled.
  "origfee" : n,     (numeric) The fee of the replaced transaction.
  "fee" : n,         (numeric) The fee of the new transaction.
  "errors" : [       (json array) Errors encountered during processing (may be empty).
    "str",           (string)
    ...
  ]
}

Examples

Bump the fee, get the new transaction’stxid:

bitcoinevo-cli bumpfee <txid>