A pure C++-only TurboModule for lnd.
Easily embed and interact with the Lightning Network client lnd inside an app with a convenient API. This lib uses lnd's falafel bindings in order to run lnd embedded inside an app.
-
⚡️ Runs lnd embedded inside your app
-
🕺 Epic C++ TurboModule bindings for interacting with lnd, sharing the same source-code for all platforms
-
🤯 Convenient and simple API for all lnd gRPC methods and server/bidi streams
-
🤓 Type-safety and auto-complete for all protobufs, using protobuf-es
-
📦 Unopinionated core bindings for other protobuf libraries. Zero dependencies
-
👷♂️ Provide your own lnd binaries, or use our prebuilt ones
✅ Android
✅ iOS
✅ macOS
🤨 Linux via react-native-electron and NodeJS C++ Addon (planned)
🚫 Windows (planned)
🚫 Web
🚫 Jest mocks (planned)
An opinionated API react-native-turbo-lnd using protobuf-es bindings is
provided for lnd's protobufs, giving auto-complete and type-safety for all
protobufs and gRPC methods.
An unopinionated core API react-native-turbo-lnd/core to lnd's falafel
bindings is also available if you want to use another protobuf library.
This API let's you send and receive protobufs as base64-encoded strings,
which you can then encode/decode yourself.
Note
The opinionated API is still in development and may change in the future.
This lib requires new architecture enabled in your app. It will not work on the old architecture and there are no plans to support it.
- Install the package:
yarn add react-native-turbo-lnd
## If you wish to use the protobuf-es bindings:
yarn add @bufbuild/protobuf- Lnd binaries needs to be side-loaded manually for your app. Follow the instructions here for each platform:
Download the latest lnd-cgo-android.zip from hsjoberg/react-native-turbo-lnd/releases
containing lnd .so binaries and unzip the files to
<project root>/android/app/src/main/jniLibs.
The structure should look like this:
android/app/src/main/jniLibs
├── arm64-v8a
│ └── liblnd.so
├── armeabi-v7a
│ └── liblnd.so
├── x86
│ └── liblnd.so
└── x86_64
└── liblnd.so
Note: CMake will by default look for the files in
../../../android/app/src/main/jniLibs, starting from
<project root>/node_modules/react-native-turbo-lnd/cpp.
If you have another structure or wish to customize it, you can pass in
-DLND_JNILIBS_PATH to CMake. For example from your app/build.gradle:
defaultConfig {
// Other configs
externalNativeBuild {
cmake {
arguments "-DLND_JNILIBS_PATH=/your/path/here"
}
}
}
Download the latest liblnd-{ios|mac}.zip file from
hsjoberg/react-native-turbo-lnd/releases
and unzip it. Then rename liblnd-fat.a to liblnd.a and place it in
<project root>/{ios|macos}/liblnd.a. Navigate to the folder in Finder and drag
the liblnd.a file into the Xcode project root. Check "Copy items if needed".
Be sure to also select the correct app target.
Note: You may need to also add libresolv to the Xcode project. Go to your app
target in Xcode, then select the General tab. Find the "Frameworks, Libraries,
and Embedded Content" section and click on the "+" button. Search for the
libresolv.tbd file and add it.
Note
If you wish to compile your own lnd binaries, you can follow the instructions here.
- Done!
import { Button, View } from "react-native";
import { start, getInfo } from "react-native-turbo-lnd";
export default function App() {
const onPressStart = async () => {
await start(
`--lnddir="<TODO>" --noseedbackup --nolisten --bitcoin.active --bitcoin.mainnet --bitcoin.node=neutrino --feeurl="https://nodes.lightning.computer/fees/v1/btc-fee-estimates.json" --routing.assumechanvalid --tlsdisableautofill --neutrino.connect=192.168.10.120:19444`
);
}
const onPressGetInfo = async () => {
const info = await getInfo({});
console.log("syncedToChain", info.syncedToChain);
}
return (
<View>
<Button title="start" onPress={onPressStart} />
<Button title="getInfo" onPress={onPressGetInfo} />
</View>
)
}See the contributing guide to learn how to contribute to the repository and the development workflow.
MIT
Made with create-react-native-library