X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=README.md;h=27e2e51e142f2aff2aad9487149b05544aacc6f5;hb=07d5d868dfe064aadb28a7f7ca6002c16be9723d;hp=825c22c716380b2e71be5275842ac9507ad70cbd;hpb=52476c310c3ec9e37a37929c19bad0b8e5dc0f35;p=ldk-java diff --git a/README.md b/README.md index 825c22c7..27e2e51e 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ A release build of the Java bindings library for Linux is available in git. Thus To build the bindings locally, the bindings require some additional work which is still making its way upstream, for now it should be built against the -[rust-lightning 2021-03-java-bindings-base branch on git.bitcoin.ninja](https://git.bitcoin.ninja/?p=rust-lightning;a=shortlog;h=refs/heads/2021-03-java-bindings-base). +[rust-lightning 2022-10-112-java-bindings branch on git.bitcoin.ninja](https://git.bitcoin.ninja/?p=rust-lightning;a=shortlog;h=refs/heads/2022-10-112-java-bindings). Check that branch out locally as well as [ldk-c-bindings](https://github.com/lightningdevkit/ldk-c-bindings) and run the `genbindings.sh` script in ldk-c-bindings to build the required binaries. Thereafter, in this repo, run the `genbindings.sh` script with the first argument pointing to the ldk-c-bindings @@ -39,7 +39,7 @@ To build for Apple M1 (ie aarch64-apple-darwin), you probably want something lik Status ====== -The TypeScript Bindings are still in early development and generated code contains syntax errors. +## Java While the underlying library and C bindings are relatively mature, the Java bindings should be considered beta quality and some issues may still appear. Specifically, because the Java bindings @@ -53,6 +53,22 @@ exit there will likely be many false positives. While it will require some compl are likely some use-after-free or unkonwn-free bugs remaining. The debug-mode build links LLVM address sanitizer and will print diagnostic information in case of such issues. +## TypeScript + +The TypeScript bindings are functionally complete, but should be considered early alpha quality. +Some functions may error spuriously due to oversights or missing implementations. + +The TypeScript bindings require modern web standards, including support for `FinalizationRegistry` +and `WeakRef` (Chrome 84, Firefox 79, Safari 14.1/iOS 14.5 and Node 14.6) and WASM BigInt support +(Chrome 85, Firefox 78, Safari 14.1/iOS 14.5, and Node 15.0). + +For users of Node.JS environments you may wish to use the `lightningdevkit-node-net` package as +well to implement the required network handling to bridge the `lightningdevkit` package's +`SocketDescriptor` interface to Node.JS TCP Sockets. For those wishing to run a lightning node in +the browser you will need to provide your own bridge from `SocketDescriptor` to a WebSocket proxy. + +## General + The only known issue resulting in a use-after-free bug requires custom a custom ChannelKeys instance created as a part of a new channel. After the channel is created, the ChannelKeys object will not be freed while the parent ChannelManager exists, however if the ChannelManager is garbage collected