document disabling utxo_freeze_threshold

electrum/simple_config.py

@@ -59,6 +59,18 @@ class SimpleConfig(Logger):
  1. Command line options.
  2. User configuration (in the user's config directory)
  They are taken in order (1. overrides config options set in 2.)
+
+ Options are set and read using `getconfig` and `setconfig` as
+ ```
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ $ ./run_electrum -o setconfig unconf_utxo_freeze_threshold 1234
+ true
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ 1234
+ $ ./run_electrum -o setconfig unconf_utxo_freeze_threshold null
+ true
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ ```
  """
 
  def __init__(self, options=None, read_user_config_function=None,

electrum/wallet.py

@@ -1715,6 +1715,27 @@ def _is_coin_small_and_unconfirmed(self, utxo: PartialTxInput) -> bool:
  In particular, this test triggers for large "dusting transactions"
  that are used for advertising purposes by some entities.
  see #6960
+ If this happens in error, you can manually un-freeze the coins in the
+ Coins tab (View | Show Coins, then navigate to the now-visible tab). If
+ it happens repeatedly, you can disable this test using `setconfig`:
+ ```
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ $ ./run_electrum -o setconfig unconf_utxo_freeze_threshold 1234
+ true
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ 1234
+ $ ./run_electrum -o setconfig unconf_utxo_freeze_threshold null
+ true
+ $ ./run_electrum -o getconfig unconf_utxo_freeze_threshold
+ ```
+ It is also possible (but not recommended) to disable this by manually
+ editing the config file. To do this, set
+ ```
+ "unconf_utxo_freeze_threshold": 0
+ ```
+ in ~/.electrum/config. Make sure to back up your config file first as
+ JSON syntax is somewhat difficult to get right, and the config file
+ will be overwritten with defaults if you get it wrong.
  """
  # confirmed UTXOs are fine; check this first for performance:
  block_height = utxo.block_height