cln-plugins/clearnet
dependabot[bot] 0f5d3321b8 build(deps): bump cryptography from 48.0.1 to 50.0.0 in /clearnet
Bumps [cryptography](https://github.com/pyca/cryptography) from 48.0.1 to 50.0.0.
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/48.0.1...50.0.0)

---
updated-dependencies:
- dependency-name: cryptography
  dependency-version: 50.0.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-06 12:08:52 +02:00
..
clearnet.py clearnet: update shebang dependency versions 2026-05-12 22:12:19 +02:00
manifest.json clearnet: add reckless manifest 2026-07-24 15:18:49 +02:00
pyproject.toml build(deps): bump the all-dependencies group across 3 directories with 6 updates 2026-05-12 22:12:19 +02:00
README.md python plugins: add note for systemd and uv 2025-12-22 15:27:54 +01:00
test_clearnet.py format python files with ruff 2024-07-10 12:13:42 -05:00
uv.lock build(deps): bump cryptography from 48.0.1 to 50.0.0 in /clearnet 2026-08-06 12:08:52 +02:00

clearnet enforcer plugin

This plugin aims to prefer usage over clearnet connections. It does so by disconnecing TOR connections when there are known and usable clearnet addresses.

Installation

You need uv to run this plugin like a binary. After uv is installed you can simply run

lightning-cli plugin start /path/to/clearnet.py

If you use systemd to start CLN, you must have uv in the PATH that systemd uses, which is likely different than the PATH from your shell. Most uv installation methods install uv into your user's home directory (~/.local/bin or ~/.cargo/bin), which systemd cannot access.

You can either:

Option 1: Install uv system-wide (recommended):

curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh

Option 2: Copy your existing user installation:

sudo cp "$(command -v uv)" /usr/local/bin/uv

Option 3: Configure your systemd service to use a custom PATH (see systemd documentation).

To verify uv is accessible to systemd:

sudo systemd-run --user --wait command -v uv

This should output /usr/local/bin/uv.

For general plugin installation instructions see the repos main README.md

Options

Methods

clearnet-enforce [peer_id]

Tries to enforce clearnet on all peer or on a given peer_id