Skip to content

About

lampo (lightning in Italian) is a experimental implementation of a tiny lightning node

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

653 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lampo

Fast and modular lightning network implementation for all usages, written in Rust.

Crates

This is the complete list of crates supported right now:

Crate Description Version
lampod-cli Lampo Daemon command line interface to run the daemon unrelated
lampo-cli Simple Lampo command line interface to interact with the daemon unrelated

How to Install

To install all the requirements and the Lampo binary, you need to have rust installed, and then run the following command:

make install

After you have lampod-cli and lampo-cli available, the first time you run lampod-cli with signet network, it will create a new wallet:

➜  ~ lampod-cli --network signet
✓ Wallet Generated, please store these words in a safe way
 wallet-keys  maple have fitness decide food joy flame coast stereo front grab stumble

Note

Store your wallet words securely. You can use them later to restore the wallet with --restore-wallet. If you do not store your words anywhere, your funds will be lost the next time Lampo starts!

The second time you run the same command, it will start the Lampo daemon (lampod), which will show continuous logs of the node's activity:

➜  ~ lampod-cli --network signet
[2025-08-27T10:15:23Z INFO  lampod] WARN lampod_cl1 Loading from existing wallet. [lampod-cli/src/main.rs:159] 
... (continuous log output) ...

Please note that you need to have a lampo.conf in the path ~/.lampo/signet. Run the following command to use the example config file:

cp lampo.example.conf ~/.lampo/signet/lampo.conf

A newly generated wallet jumps its checkpoint to the chain tip (fast-sync, on by default) so it does not scan from genesis. A mnemonic restore never takes that automatic jump, even when its local database is new, because the seed may own historical funds. Use reindex=<height> in lampo.conf for a known birthday.

Then you can query the node with the following command:

➜  ~ lampo-cli --network signet getinfo
{
  "node_id": "035b889551a44e502cd0cd6657acf067336034986cd6639b222cd4be563a7fc205",
  "peers": 0,
  "channels": 0
}

To run integration tests:

make integration

Simulation

Pre-production soak harness lives in simulations/ (regtest only). See simulations/README.md, AGENTS.md, and CLAUDE.md for Phase 1 recovery/stress and Phase 2 N-node chaos soak gates.

Contributing guidelines

Please read our Contributing guide.

Community

Determined to maintain clarity, we’ve chosen specific channels for communication:

  • Developers, join us on Zulip.
  • Community members, our Twitter community awaits your insights.
  • For technical questions and feature requests, dive into our GitHub discussions.

About

lampo (lightning in Italian) is a experimental implementation of a tiny lightning node

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages