-
Notifications
You must be signed in to change notification settings - Fork 22
Add Basic project description and README.md #29
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,56 @@ | ||
| # LDK-Server | ||
|
|
||
| **LDK-Server** is a fully-functional Lightning node in daemon form, built on top of | ||
| [LDK-Node](https://github.com/lightningdevkit/ldk-node), which itself provides a powerful abstraction over the | ||
| [Lightning Development Kit (LDK)](https://github.com/lightningdevkit/rust-lightning) and uses an in-built | ||
G8XSU marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| [Bitcoin Development Kit (BDK)](https://bitcoindevkit.org/) wallet. | ||
|
|
||
| The primary goal of **LDK-Server** is to provide an efficient, stable, and API-first solution for deploying and managing | ||
G8XSU marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| a Lightning Network node. With its streamlined setup, **LDK-Server** enables users to easily set up, configure, and run | ||
| a Lightning node while exposing a robust, language-agnostic API via [Protocol Buffers (Protobuf)](https://protobuf.dev/). | ||
|
|
||
| ### Features | ||
|
|
||
| - **Out-of-the-Box Lightning Node**: | ||
| - Deploy a Lightning Network node with minimal configuration, no coding required. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Not sure if it should be mentioned here or elsewhere, but might be worth stating what can be configured somewhere.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It is mentioned in "Configuration" section right before ## building
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I mean at a more high-level like you can provide your own
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fine to leave out now if we don't have a way of configuring that, of course.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We can't configure |
||
|
|
||
| - **API-First Design**: | ||
| - Exposes a well-defined API using Protobuf, allowing seamless integration with HTTP-clients or applications. | ||
|
|
||
| - **Powered by LDK**: | ||
| - Built on top of LDK-Node, leveraging the modular, reliable, and high-performance architecture of LDK. | ||
|
|
||
| - **Effortless Integration**: | ||
| - Ideal for embedding Lightning functionality into payment processors, self-hosted nodes, custodial wallets, or other Lightning-enabled | ||
| applications. | ||
|
|
||
| ### Project Status | ||
|
|
||
| 🚧 **Work in Progress**: | ||
| - **APIs Under Development**: Expect breaking changes as the project evolves. | ||
| - **Potential Bugs and Inconsistencies**: While progress is being made toward stability, unexpected behavior may occur. | ||
| - **Improved Logging and Error Handling Coming Soon**: Current error handling is rudimentary(specially for CLI), and usability improvements are actively being worked on. | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should we already speak about more of the planned features, e.g., LSP service integration? Or rather not to not spill the beans just yet?
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think it's fine to include that.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There are many features planned or upcoming. I didn't mention those because it wouldn't be exhaustive.
G8XSU marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| - **Pending Testing**: Not tested, hence don't use it for production! | ||
|
|
||
| We welcome your feedback and contributions to help shape the future of LDK-Server! | ||
|
|
||
|
|
||
| ### Configuration | ||
| Refer `./ldk-server/ldk-server.config to see available configuration options. | ||
|
|
||
| ### Building | ||
| ``` | ||
| git clone https://github.com/lightningdevkit/ldk-server.git | ||
| cargo build | ||
| ``` | ||
|
|
||
| ### Running | ||
| ``` | ||
| cargo run --bin ldk-server ./ldk-server/ldk-server.config | ||
| ``` | ||
|
|
||
| Interact with the node using CLI: | ||
| ``` | ||
| ./target/debug/ldk-server-cli -b localhost:3002 onchain-receive # To generate onchain-receive address. | ||
| ./target/debug/ldk-server-cli -b localhost:3002 help # To print help/available commands. | ||
| ``` | ||
Uh oh!
There was an error while loading. Please reload this page.