Merge pull request #328 from dongcarl/fine
[rust-lightning] / README.md
1 Rust-Lightning, not Rusty's Lightning!
2 =====
3
4 Documentation can be found at [docs.rs](https://docs.rs/lightning/)
5
6 Currently somewhere near 20% towards usable, published to see if there is any
7 real interest from folks in using a lightning rust library.
8
9 The goal is to provide a full-featured but also incredibly flexible lightning
10 implementation, allowing the user to decide how they wish to use it. With that
11 in mind, everything should be exposed via simple, composable APIs. The user
12 should be able to decide whether they wish to use their own threading/execution
13 models, allowing usage inside of existing library architectures, or allow us to
14 handle that for them. Same goes with network connections - if the user wishes
15 to use their own networking stack, they should be able to do so! This all means
16 that we should provide simple external interfaces which allow the user to drive
17 all execution, while implementing sample execution drivers that create a
18 full-featured lightning daemon by default.
19
20 For security reasons, do not add new dependencies. Really do not add new
21 non-optional/non-test/non-library dependencies. Really really do not add
22 dependencies with dependencies. Do convince Andrew to cut down dependency usage
23 in rust-bitcoin.
24
25 Notes on coding style:
26  * Use tabs. If you want to align lines, use spaces. Any desired alignment
27    should display fine at any tab-length display setting.
28
29 License is Apache-2.0.