cln-plugins/archived/sauron
dependabot[bot] 2eb216902f build(deps): bump cryptography
Bumps the uv group with 1 update in the /archived/sauron directory: [cryptography](https://github.com/pyca/cryptography).


Updates `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
  dependency-group: uv
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-06 12:09:56 +02:00
..
tests sauron: archive plugin 2026-05-13 13:12:43 +02:00
.gitignore sauron: archive plugin 2026-05-13 13:12:43 +02:00
art.py sauron: archive plugin 2026-05-13 13:12:43 +02:00
pyproject.toml build(deps): bump cryptography 2026-08-06 12:09:56 +02:00
README.md sauron: archive plugin 2026-05-13 13:12:43 +02:00
sauron.py sauron: archive plugin 2026-05-13 13:12:43 +02:00
uv.lock build(deps): bump cryptography 2026-08-06 12:09:56 +02:00

Sauron

A Bitcoin backend plugin relying on Esplora.

About

It allows C-lightning to run without needing a local bitcoind, and can be either self-hosted (Esplora is Open Source, and self hosting it is basically a docker one-liner).

This is still a WIP, so is the API C-lightning side. So not to be used for real.

Run

You need to:

  • have uv installed
  • disable the default Bitcoin backend (bcli)
  • register sauron
  • provide the API endpoint you want to use

Here is a fully reptilian example running against blockstream.info:

lightningd --mainnet --disable-plugin bcli --plugin $PWD/sauron.py --sauron-api-endpoint https://blockstream.info/api/

Here is an example running against mutinynet.com:

lightningd --signet --disable-plugin bcli --plugin $PWD/sauron.py --sauron-api-endpoint https://mutinynet.com/api/

You can use also proxy your requests through Tor by specifying a SOCKS proxy to use with the --sauron-tor-proxy startup option, in the form address:port.

Hidden services are also supported :

lightningd --testnet --disable-plugin bcli --plugin $PWD/sauron.py --sauron-tor-proxy localhost:9050 --sauron-api-endpoint http://explorerzydxu5ecjrkwceayqybizmpjjznk5izmitf2modhcusuqlid.onion/testnet/api/

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.