https://github.com/niftynei/sitzprobe

Lightning network probe
https://github.com/niftynei/sitzprobe

Last synced: 29 days ago
JSON representation

Lightning network probe

• Host: GitHub
• URL: https://github.com/niftynei/sitzprobe
• Owner: niftynei
• License: other
• Created: 2019-01-23T23:29:38.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-01-25T22:59:41.000Z (almost 6 years ago)
• Last Synced: 2024-08-01T22:51:01.160Z (3 months ago)
• Language: Go
• Size: 18.6 KB
• Stars: 14
• Watchers: 3
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-lightning-network - Sitzprobe - A c-lightning plugin that actively sends test payments through the lightning network allowing finding and/or deprecating channels for the payments (Developer Resources / Libraries)
• awesome-lightning-network - Sitzprobe - A c-lightning plugin that actively sends test payments through the lightning network allowing finding and/or deprecating channels for the payments (Developer Resources / Libraries)

README

        
# Sitzprobe: a Lightning Network payment rehearsal utility

> *Sitzprobe*, noun: (from the German for seated rehearsal) is a rehearsal where the singers sing with the orchestra, focusing attention on integrating the two groups. It is often the first rehearsal where the orchestra and singers rehearse together. -[Wikipedia][wiki]

`sitzprobe` is a c-lightning plugin that actively sends test payments through the lightning network. The goal is to improve the health of the network by finding and deprecating channels that are not able to route payment.

### Installation

Download the source and build it 

```

git clone https://github.com/niftynei/sitzprobe.git

cd sitzprobe

go build

```

This should build a binary named `sitzprobe`. To run lightningd with `sitzprobe` enabled you can either add it to your `lightningd/plugin` directory, or pass it in as a runtime flag.

Option A: symlink to the lightningd plugin directory

```

ln -s sitzprobe /path/to/lightningd/sourcecode/plugin

# then run lightningd normally

./path/to/lightningd/sourcecode/lightningd/lightningd --sitzprobe-freq=20 --sitzprobe-amt=10

```

Option B: tell lightningd what plugins to use at runtime

```

lightningd --plugin=/path/to/sitzprobe --sitzprobe-freq=20 --sitzprobe-amt=10

```

### Options

`sitzprobe` provides two configurable options: 

  - `--sitzprobe-amt`: Amount to send as a test payment, in millisatoshi. Defaults to 1

  - `--sitzprobe-freq`: How frequently to send a test payment, in minutes. Defaults to 60

### Reporting

`sitzprobe` provides a report functionality, to tell you how the payment attempts are working. You can get back a json formatted report by running `sitzprobe-report`.

```

lightning-cli sitzprobe-report

```

### Contributing

Pull requests, issues and feature requests welcome.

[wiki]: https://en.wikipedia.org/wiki/Sitzprobe