https://github.com/lightninglabs/dust-tool
dust exposure tool
https://github.com/lightninglabs/dust-tool
Last synced: over 1 year ago
JSON representation
dust exposure tool
- Host: GitHub
- URL: https://github.com/lightninglabs/dust-tool
- Owner: lightninglabs
- Created: 2021-09-30T21:47:30.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-10-04T20:02:04.000Z (almost 5 years ago)
- Last Synced: 2025-03-28T22:34:45.917Z (over 1 year ago)
- Language: Go
- Size: 45.9 KB
- Stars: 6
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dust Exposure Tool
## Building
- Requires Go 1.16
- Run the following command:
```
$ go build
```
## DustAcceptor mode
- The dust tool can intercept malicious `open_channel` requests with high `dust_limit_satoshis` values.
- Simply run it like so:
```
./dust-tool -network= -macpath= -host=
```
- You should see output like this:
```
2021/09/30 18:06:47 Creating dust acceptor, no output will be recorded unless it errors out.
```
## Channel Close recommendations
- The dust tool can also give channel close recommendations based on a confirmed channel's `dust_limit_satoshis` and `max_accepted_htlcs` values.
- Simply run it like so, optionally specifying `-dustexposure` in satoshis:
```
./dust-tool -network= -macpath= -host= -check-chans -dustexposure=1000000
```
- If a potentially risky channel is found, you should receive output like this:
```
2021/09/30 18:12:59 Evaluating set of channels for dust exposure
2021/09/30 18:12:59 Consider closing chanpoint(e2b43845a099c7ab98345a4604b24d7fbb4c19cec97911a9c1c250b57c762220:0), dust exposure(0.0483 BTC) higher than threshold(0.0049 BTC)
```
- If no output is returned, you are safe for the dust threshold specified!
## Help
```
Usage of ./dust-tool:
-check-chans
whether to check existing channels for dust_limit_satoshis exposure
-dustexposure uint
sets the dust threshold in satoshis for channel close recommendations - must be specified with checkchans (default 600000)
-host string
host of the target lnd node (default "localhost:10009")
-macpath string
path of admin.macaroon for the target lnd node (default "/path/admin.macaroon")
-network string
the network the lnd node is running on (default "mainnet")
-tlspath string
path to the TLS cert of the target lnd node (default "/path/tls.cert")
```