Eye of Satoshi is an open source Lightning watchtower, a service that watches the Lightning Network on behalf of a node operator and reacts when a channel counterparty tries to cheat. It is aimed at developers and node operators who run Lightning channels and want protection while they are offline.
Before you consider installing it, know this: the Python codebase has been discontinued in favour of its Rust counterpart, and its last code update dates to July 2022. The project remains available for study and reference, but readers looking for a production tool should review the newer codebase first.
What Is a Lightning Watchtower?
Lightning payment channels are two-party agreements that stay off the main Bitcoin blockchain. Each party holds signed commitment transactions that represent the current balance. A dishonest partner could, in principle, broadcast an old commitment that favors them.
To prevent this, the honest party must respond within a fixed window. A watchtower monitors the blockchain for such attempts. When it detects an outdated state, it broadcasts a penalty, sometimes called a justice transaction, that gives the honest side the funds.
The key idea is delegation. A node operator can stay offline, for instance during maintenance or a power outage, while a third party keeps watch. Because the tower only sees encrypted data it can act on, it does not need to know the channel balances.
Who Is Eye of Satoshi For?
The project targets people who already understand Lightning channels. Typical users include node operators running c-lightning or other implementations, developers researching watchtower protocols, and teams building their own monitoring services.
Casual users who simply want to send and receive Lightning payments through a mobile wallet have little need for a standalone tower. Their wallet provider typically handles channel safety in the background.
Because the codebase is no longer maintained, it is more useful as a learning resource than as infrastructure you rely on daily.
How Watchtowers Protect Against Channel Breaches
When a client registers with a tower, it sends an appointment containing a locator and an encrypted penalty transaction. The tower stores this data without learning the amounts or the identities behind it. The locator lets the tower find the matching breach on-chain without exposing the full transaction.
If a breach occurs, the tower decrypts the stored blob using the key that the breach reveals and broadcasts the penalty. This design limits what a server operator can learn about a client's channels.
Understanding this flow helps operators decide how much trust to place in any third-party tower, and what they should check when evaluating newer implementations.
Key features
Core watchtower server (teos)
Reference command line interface (cli)
Shared common library
c-lightning watchtower plugin
Supported coins
The documentation mentions support for the Lightning Network. The tool is not a wallet and does not hold coins, so the relevant question is which channel protocols it can protect rather than which tokens it stores.
How to install Eye of Satoshi on Windows
- 1
Check the project status
Visit the source repository on GitHub first and read the notice about the discontinued codebase. Decide whether the Python version fits your needs or whether you should use the newer Rust project instead.
- 2
Download from the official source
Download only from the official repository or its Releases page. Do not use mirrors or download links from unknown forums. The latest tagged version listed is v0.1.1rc1, a release candidate.
- 3
Verify the file
Compare the SHA-256 checksum of the downloaded archive with the value published on the release page. If no checksum or signature is provided for the file, treat that as a reason for extra caution.
- 4
Install the Python environment
Create an isolated Python environment, install the project's dependencies from its requirements file, and run the included tests if they are present. Keep the environment separate from your system Python to avoid conflicts.
-
Start and configure the tower
Follow the documentation to create a configuration file, set the data directory and network, and start the server. Confirm that it runs locally before exposing any network port.
How to use Eye of Satoshi
The Eye of Satoshi workflow has two roles: the operator running the tower and the client node that registers with it. The steps below outline the general flow. Consult the repository documentation for exact command syntax, since it may differ between versions.
- Set up a Python environment and confirm that the project starts without errors.
- Configure the server with your chosen data directory and Lightning network settings.
- Start the tower service and check its logs for successful initialization.
- On the client side, enable the watchtower plugin in a c-lightning node, pointing it to your tower's address.
- Use the command line interface to confirm the registration and check stored appointments.
- Monitor the logs over time to verify that appointments are being received and kept.
- Test the setup on a testnet channel before relying on it with real funds.
Pros & cons
- Open source code that can be read and audited
- Clear separation between server, client and shared components
- Includes a c-lightning plugin for practical integration
- Useful as a reference for the watchtower protocol design
- The codebase has been discontinued and is no longer actively maintained
- The latest version is a release candidate, not a stable release
- Windows support is not verified in the materials available; Docker and Unix-style setups are more typical
- Requires technical knowledge of Lightning channels and Python tooling
Is Eye of Satoshi safe?
Eye of Satoshi handles data that protects Lightning channel funds, so treat it with care. Download only from the official GitHub repository or its Releases page, and verify the SHA-256 checksum or signature before running anything. Never enter a seed phrase or private key into a third-party website or a tool you have not reviewed.
Because the project is discontinued, it may contain unpatched bugs or dependencies with known vulnerabilities. Run it on a test network first, keep it isolated from your main wallet machine, and check the latest version on the official website before any production use.
- Official source only. Download from github.com/talaia-labs/python-teos. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Eye of Satoshi is a narrow tool: it focuses on Lightning watchtower functionality rather than general blockchain access or wallet management. Many of the related programs in this catalog serve different purposes, such as blockchain data indexing, proof-of-work algorithms, or PSBT construction for Bitcoin transactions.
If your goal is Lightning channel protection, the more relevant comparison is with the newer Rust implementation that the maintainers recommend. For developers working on Bitcoin transaction tooling more broadly, a PSBT creator may be a more useful companion than a watchtower.
Specifications
- Price
- Free
- Type
- Open source
- License
- —
- Latest version
- v0.1.1rc1
- Last update
- 22 Jul 2022
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/talaia-labs/python-teos
Frequently asked questions
No. The repository states that this codebase has been discontinued in favour of its Rust counterpart. The last code update was in July 2022, so it should be treated as a reference rather than a current tool.
Windows is mentioned in the project documentation, but support is not verified. Docker and Unix-style environments are the more typical setups, so Windows users may need extra configuration and testing.
A watchtower monitors Lightning channels while the node owner is offline. If a channel partner broadcasts an outdated state, the tower can submit a penalty transaction to protect the honest party's funds.
Not necessarily. Many users rely on their wallet provider for channel safety. Node operators who run their own infrastructure and want protection during downtime are the main audience for standalone towers.
No. It is not a wallet. It stores encrypted penalty data for channel breaches and does not control your coins during normal operation.
Review the Rust counterpart referenced in the project notice. Evaluate its current maintenance status, release history and documentation before deploying it.
The project is listed as free and open source. Check the license file in the repository to understand the terms for use, modification and redistribution.
Verdict
Eye of Satoshi is an open source Lightning watchtower with a clear architecture and a useful plugin for c-lightning. However, the Python codebase has been discontinued, and its latest release is a candidate from 2022. It fits developers who want to study watchtower design or review historical code. Operators who need protection for live channels should look at the maintained Rust successor and verify its current state before deploying anything.