12 unstable releases (4 breaking)

0.9.0 Jan 25, 2023
0.9.0-rc.1 Dec 26, 2022
0.9.0-alpha.1 Nov 17, 2022
0.8.0 Jun 30, 2022
0.5.0 Nov 27, 2021

#28 in #lnp-bp

Download history 146/week @ 2023-12-18 81/week @ 2023-12-25 30/week @ 2024-01-01 99/week @ 2024-01-08 83/week @ 2024-01-15 90/week @ 2024-01-22 41/week @ 2024-01-29 81/week @ 2024-02-05 92/week @ 2024-02-12 53/week @ 2024-02-19 137/week @ 2024-02-26 107/week @ 2024-03-04 95/week @ 2024-03-11 108/week @ 2024-03-18 159/week @ 2024-03-25 340/week @ 2024-04-01

728 downloads per month
Used in 35 crates (2 directly)

MIT license

1.5K SLoC

LNP/BP Library

Build Tests Lints codecov

crates.io Docs unsafe forbidden MIT licensed

The repository represents a set of libraries implementing LNP/BP specifications https://github.com/LNP-BP/LNPBPs not fitting into a scope of other existing LNP/BP core libraries (client-side-validation, BP, LNP, RGB, invoicing). It can be used to simplify development of layer 2 & 3 solutions on top of Lightning Network and Bitcoin blockchain.

Currently, the repository contains the following crates:

  • lnpbp_bech32: library implementing LNPBP-14 standard of Bech32 encoding for client-side-validated data.
  • lnpbp_chain: library providing chain parameters for bitcoin-related blockchains;
  • lnpbp_elgamal: library implementing LNPBP-31 standard for ElGamal encryption using Secp256k1 curve;
  • LNPBP umbrella crate containing all aforementioned libraries.

Other libraries, implementing LNP/BP specifications, not included in this crate:

The current list of the projects based on these libraries include:

  • RGB Node
  • LNP Node enabling:
    • RGB extensions
    • DLC extensions
    • Lightspeed payments
    • Multi-peer channels
    • Faster lightning experiments (quicker adoption of eltoo, Taproot etc)
  • BP Node: Indexing service for bitcoin blockchain; more efficient & universal Electrum server replacement. In perspective - validating Bitcoin network node (using libbitcoinconsus)

Potentially, with LNP/BP libraries you can simplify the development of

  • Discreet log contracts
  • Implement experimental lightning features
  • Do complex multi-threaded or elastic/dockerized client-service microservice architectures

The development of the libraries is supported by LNP/BP Standards Association.


Clone and compile library

Minimum supported rust compiler version (MSRV): 1.59.0.

git clone https://github.com/lnp-bp/rust-lnpbp
cd rust-lnpbp
cargo build --release --all-features

The library can be found in target/release directory.

You can run full test suite with:

cargo test --workspace --all-features

Please refer to the cargo documentation for more detailed instructions.

Use library in other projects

Add these lines to your Cargo.toml file at the very end of the [dependecies] section:

lnpbp = "~0.5.0"
lnpbp_bech32 = "~0.5.0"
lnpbp_chain = "~0.5.0"
lnpbp_elgamal = "~0.5.0"


Contribution guidelines can be found in a separate CONTRIBUTING file

More information

Policy on Altcoins/Altchains

Altcoins and "blockchains" other than Bitcoin blockchain/Bitcoin protocols are not supported and not planned to be supported; pull requests targeting them will be declined.


See LICENCE file.


LNPBP library defining chain parameters.

Chains are bitcoin-enabled or aware blockchains, which include:

  • Bitcoin Mainnet
  • Different bitcoin testnets and signets
  • Bitcoin sidechains
  • Independent bitcoin-aware chains able to work with client-side-validation


~149K SLoC