2023-02-25 11:39:52 +01:00
## chantools triggerforceclose
2024-04-28 16:03:00 +02:00
Connect to a Lightning Network peer and send specific messages to trigger a force close of the specified channel
2023-09-14 11:24:14 +02:00
### Synopsis
2024-04-28 16:03:00 +02:00
Asks the specified remote peer to force close a specific
channel by first sending a channel re-establish message, and if that doesn't
work, a custom error message (in case the peer is a specific version of CLN that
does not properly respond to a Data Loss Protection re-establish message).'
2023-02-25 11:39:52 +01:00
```
chantools triggerforceclose [flags]
```
### Examples
```
chantools triggerforceclose \
--peer 03abce...@xx .yy.zz.aa:9735 \
--channel_point abcdef01234...:x
```
### Options
```
2025-06-09 21:24:24 +02:00
--all_public_channels query all public channels from the Amboss API and attempt to trigger a force close for each of them
2024-10-28 13:18:05 +01:00
--apiurl string API URL to use (must be esplora compatible) (default "https://api.node-recovery.com")
2023-02-25 11:39:52 +01:00
--bip39 read a classic BIP39 seed and passphrase from the terminal instead of asking for lnd seed format or providing the --rootkey flag
--channel_point string funding transaction outpoint of the channel to trigger the force close of (< txid > :< txindex > )
-h, --help help for triggerforceclose
2025-06-08 14:24:13 +02:00
--hsm_secret string the hex encoded HSM secret to use for deriving the node key for a CLN node; obtain by running 'xxd -p -c32 ~/.lightning/bitcoin/hsm_secret'
2023-02-25 11:39:52 +01:00
--peer string remote peer address (< pubkey > @< host > [:< port > ])
--rootkey string BIP32 HD root key of the wallet to use for deriving the identity key; leave empty to prompt for lnd 24 word aezeed
2024-04-28 16:03:01 +02:00
--torproxy string SOCKS5 proxy to use for Tor connections (to .onion addresses)
2024-12-27 12:44:28 +01:00
--walletdb string read the seed/master root key to use for deriving the identity key from an lnd wallet.db file instead of asking for a seed or providing the --rootkey flag
2023-02-25 11:39:52 +01:00
```
### Options inherited from parent commands
```
2025-10-21 21:27:30 +02:00
--nologfile If set, no log file will be created. This is useful for testing purposes where we don't want to create a log file.
-r, --regtest Indicates if regtest parameters should be used
--resultsdir string Directory where results should be stored (default "./results")
-s, --signet Indicates if the public signet parameters should be used
-t, --testnet Indicates if testnet parameters should be used
2026-03-04 07:01:23 +01:00
--testnet4 Indicates if testnet4 parameters should be used
2023-02-25 11:39:52 +01:00
```
### SEE ALSO
* [chantools ](chantools.md ) - Chantools helps recover funds from lightning channels