#on-chain #signer #lightning #validation #output #version #htlc

no-std vls-core

A library for implementing a Lightning signer, which externalizes and secures cryptographic operations

21 releases

0.12.0 Aug 9, 2024
0.12.0-rc.2 Jun 26, 2024
0.11.0 Feb 29, 2024
0.11.0-rc.1 Nov 29, 2023
0.2.1 Mar 20, 2023

#10 in #on-chain

Download history 274/week @ 2024-07-17 630/week @ 2024-07-24 504/week @ 2024-07-31 659/week @ 2024-08-07 300/week @ 2024-08-14 255/week @ 2024-08-21 405/week @ 2024-08-28 274/week @ 2024-09-04 181/week @ 2024-09-11 240/week @ 2024-09-18 522/week @ 2024-09-25 478/week @ 2024-10-02 531/week @ 2024-10-09 538/week @ 2024-10-16 206/week @ 2024-10-23 220/week @ 2024-10-30

1,557 downloads per month
Used in 11 crates (8 directly)

Apache-2.0

1MB
27K SLoC

Validating Lightning Signer

Please see the VLS Project Overview for more information. Our web site.

Limitations

The following remain to be implemented:

  • vlsd2 --recover-to can only handle a simple force-close by us. It cannot sweep a force-close or a breach by the peer. It also cannot sweep HTLC outputs.
  • there is no facility to recover from loss of signer state.
  • on-chain tracking is not fully implemented, so a malicious node can steal funds by failing to remedy a breach (for example)

Additional Crates

Development Information

Additional HOWTO Documentation

We recommend using the nightly version of Rust only in specific cases, such as for cargo fmt and no-std. Otherwise, we explicitly recommend using the stable version.

Formatting Code

Enable formatting precommit hooks:

./scripts/enable-githooks

For some reason, the ignore configuration for rustfmt is only available on the nightly channel, even though it's documented as stable.

rustup install nightly

cargo +nightly fmt

Building Validating Lightning Signer

Build VLS and related crates:

cargo build

Running Unit Tests

cargo test

To enable logging for a failing test (adjust log level to preference):

RUST_LOG=trace cargo test

Using llvm-cov for Code Coverage

Dependencies:

cargo +stable install cargo-llvm-cov --locked

Run coverage:

./scripts/run-llvm-cov

Changing linker to mold instead of ld:

cp .cargo/config.sample.toml .cargo/config.toml

Benchmarks

Running Benchmarks

cargo bench -p vls-core --bench secp_bench

Note that you might need to add --features=test_utils if you want to run all benches in vls-core.

Without optimizations:

cargo bench -p vls-core --bench secp_bench --profile=dev

Expect something like:

    test fib1_bench        ... bench:           1 ns/iter (+/- 0)
    test fib_bench         ... bench:      17,247 ns/iter (+/- 198)
    test hash_bench        ... bench:         258 ns/iter (+/- 2)
    test secp_create_bench ... bench:      49,981 ns/iter (+/- 642)
    test sign_bench        ... bench:      25,692 ns/iter (+/- 391)
    test verify_bench      ... bench:      31,705 ns/iter (+/- 1,445)

i.e. around 30 microseconds per secp256k1 crypto operation. We also see that creating a secp context is expensive, but not prohibitively so.

Dependencies

~20–34MB
~475K SLoC