wavelength-react-native

Integrate a self-custodial Lightning wallet into React Native and Expo apps.

4|4|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-react-native-lightninglabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wavelength-react-native
Source: https://github.com/lightninglabs/wavelength-sdk/tree/main/skills/wavelength-react-native
Command: npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-react-native-lightninglabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @lightninglabs/wavelength-react-native, @lightninglabs/wavelength-react.

What problem does it solve? Embedding a Lightning wallet in a mobile app normally requires running a node, managing channels, and operating backend infrastructure. This Skill guides the integration of the Wavelength SDK so the wallet runtime compiles directly into the app binary, keeping keys on the user's device with no server to operate. ## Core Features & Use Cases - Native Wallet Engine Setup: Create the engine with createNativeWalletEngine() from @lightninglabs/wavelength-react-native and inject it into <WavelengthProvider> from @lightninglabs/wavelength-react. - Native Runtime Staging: Stage the Wavewalletdk.aar and Wavewalletdk.xcframework binaries from the paired wavelength release before the first build, including the iOS header rewrite required by clang. - Passkey Protection: Wire createNativePasskeyCeremony({ rpId }) into useWalletPasskey, with assetlinks.json on Android and Associated Domains on iOS. - Use Case: A developer building an Expo app adds Lightning payments by creating a development build, staging the native binaries, wiring the provider, and confirming the engine phase reaches ready and an invoice can be created. ## Quick Start Ask the assistant to integrate the Wavelength Lightning wallet into your React Native or Expo app following the quickstart guide.

Frequently Asked Questions about wavelength-react-native

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Lightning wallet to a React Native app?

Install @lightninglabs/wavelength-react-native and @lightninglabs/wavelength-react, create the engine once at module scope with createNativeWalletEngine(), and pass it to <WavelengthProvider engine={...}>. The wallet runtime compiles into the app binary, so no node or backend is needed.

How do I set up passkey protection for a mobile Lightning wallet?

Pass createNativePasskeyCeremony({ rpId }) from wavelength-react-native into useWalletPasskey(ceremony). The rpId domain needs an assetlinks.json on Android and an apple-app-site-association file plus Associated Domains entitlement on iOS.

Can I use the Wavelength React Native SDK with Expo Go?

No, Expo Go cannot load the compiled native wallet runtime. You need an Expo development build created with npx expo run:android or npx expo run:ios, which bundles the native module into the app.

What React Native version does the Wavelength SDK require?

The SDK requires React Native 0.76 or newer with the New Architecture enabled; the legacy architecture is not supported. Platform minimums are iOS 15.1 and Android minSdk 24.

Why does my iOS build fail with the Wavewalletdk framework?

Clang rejects gomobile's @import statements in the generated headers, so the xcframework headers must be rewritten before replacing ios/Wavewalletdk.xcframework. Follow the installation guide or run the bindings:fetch script from the SDK repository.