Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/node-lightning/node-lightning

Bitcoin Lighting Network implemented in Node.js
https://github.com/node-lightning/node-lightning

bitcoin bitcoin-lightning-network bolt11 bolt8 hacktoberfest lightning-network noise-protocol

Last synced: 4 days ago
JSON representation

Bitcoin Lighting Network implemented in Node.js

Host: GitHub
URL: https://github.com/node-lightning/node-lightning
Owner: node-lightning
License: mit
Created: 2018-04-12T20:10:36.000Z (over 6 years ago)
Default Branch: main
Last Pushed: 2023-11-27T13:39:17.000Z (about 1 year ago)
Last Synced: 2024-10-30T08:03:54.448Z (about 2 months ago)
Topics: bitcoin, bitcoin-lightning-network, bolt11, bolt8, hacktoberfest, lightning-network, noise-protocol
Language: TypeScript
Homepage:
Size: 4.61 MB
Stars: 138
Watchers: 10
Forks: 22
Open Issues: 40
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        


  



Node-Lightning (formerly LNTools)




[![Node.js CI](https://github.com/altangent/node-lightning/workflows/Node.js%20CI/badge.svg)](https://github.com/altangent/node-lightning/actions?query=workflow%3A%22Node.js+CI%22+branch%3Amaster)

[![codecov](https://codecov.io/gh/altangent/node-lightning/branch/master/graph/badge.svg)](https://codecov.io/gh/altangent/node-lightning)



## About the Project

Node-Lightning is an implementation of the Bitcoin Lightning Network in the Node.js runtime. The goal of this project is to implement the BOLT specifications to enable testing, research, and education. This project is not intended to replace or compete with the major implementations, though our hope is that the implementation will be fully functional.

This library contains the core packages and several examples. There is currently no runtime for this project.

The architecture philosophies for packages is:

1. _Minimize external dependencies_ - the Node.js ecosystem is rife with excess dependency usage. This project attempts to minimize the usage of external dependencies as much as possible (there are very few external modules in use at this point).

2. _Reduce complexity using semi-formalized state machines_ - the Lightning Network is a complex beast. It is very difficult to reason about code that has high cyclomatic complexity. To reduce cognitive load, allow for isolated testing, and enable composibility and extensibility, code is frequently broken into state machines and combined with concepts from [state charts](https://statecharts.github.io/). This library is not using metaprogramming techniques, though we are using many of the concepts. This enables the last point.

3. _Engineer for modular composibility_ - The goal is to enable composibility of various state machines which enables swapping out implementations or direct extensibility of complex processes.

The goal of this project is ambitious and there is a still a long road ahead. Refer to issues and the wiki for more information on how this project is structured and how you can [contribute](CONTRIBUTING.md).

## Structure and Modules

Node-Lightning is structured as a monorepo with individual packages existing inside of `packages`.

-   [@node-lightning/lightning](packages/lightning) - lightning specific code

-   [@node-lightning/bitcoin](packages/bitcoin) - tools for building and parsing Bitcoin blocks and transactions

-   [@node-lightning/bitcoind](packages/bitcoind) - bitcoind RPC and zeromq client

-   [@node-lightning/bufio](packages/bufio) - utilities for working with Buffers

-   [@node-lightning/chainmon](packages/chainmon) - transaction and block monitoring tools

-   [@node-lightning/checksum](packages/checksum) - implements checksums such as CRC32C

-   [@node-lightning/crypto](packages/crypto) - common cryptography utilities

-   [@node-lightning/gossip-rocksdb](packages/gossip-rocksdb) - stores gossip messages in RocksDB

-   [@node-lightning/invoice](packages/invoice) - encoding/decoding for invoices

-   [@node-lightning/logger](packages/logger) - logging utility

-   [@node-lightning/noise](packages/noise) - Noise Protocol socket/server

Examples of usage can be found inside `examples`

-   [examples/peer](examples/peer) - simple peer connection

-   [examples/gossip](examples/gossip) - gossip using gossip queries

-   [examples/graph](examples/graph) - full gossip, storage, and graph construction

## BOLT Status

Current status of [Lightning RFC](https://github.com/lightningnetwork/lightning-rfc) specification implementation:

-   [x] BOLT 1 - Base Protocol: [@node-lightning/lightning](packages/core)

-   [ ] BOLT 2 - Peer Protocol for Channel Management

-   [x] BOLT 3 - Bitcoin Transaction and Script Format: [@node-lightning/bitcoin](packages/bitcoin), [@node-lightning/lightning](packages/core)

-   [ ] BOLT 4 - Onion Routing Protocol

-   [ ] BOLT 5 - Recommendations for On-chain Transaction Handling

-   [x] BOLT 7 - P2P Node and Channel Discovery: [@node-lightning/lightning](packages/lightning)

-   [x] BOLT 8 - Encrypted and Authenticated Transport: [@node-lightning/noise](packages/noise)

-   [x] BOLT 9 - Assigned Feature Flags: [@node-lightning/lightning](packages/lightning)

-   [x] BOLT 10 - DNS Bootstrap and Assisted Node Location: [@node-lightning/lightning](packages/lightning)

-   [x] BOLT 11 - Invoice Protocol for Lightning Payments: [@node-lightning/invoice](packages/invoice)