Installation

The packages

npm install @lightninglabs/wavelength-react-native @lightninglabs/wavelength-react

New Architecture and Expo

This package is New Architecture only; it does not support the legacy architecture. Enable the New Architecture in your app before installing.

Expo apps need a development build, not Expo Go: the native wallet runtime is a compiled module that Expo Go cannot load. npx expo run:android and npx expo run:ios both produce development builds that include it.

iOS pods

pod install runs as part of expo run:ios or a standard React Native build; you do not need to run it separately in the common case. If pod install fails with a locale-related error, set LANG=en_US.UTF-8 before retrying.

Native runtime binaries

Download Wavewalletdk.aar and Wavewalletdk.xcframework.tar.gz from the wavelength release tagged with the RUNTIME_MANIFEST_VERSION that @lightninglabs/wavelength-core exports, then stage them from the installed package directory:

The release ships the raw gomobile output, whose headers use the Objective-C modules syntax. clang rejects that while compiling this package’s Objective-C++ glue, so the framework is unpacked into a scratch directory, rewritten there, and swapped in only at the end. A failed extraction then leaves whatever you already had staged intact:

cd node_modules/@lightninglabs/wavelength-react-native

TMP="$(mktemp -d ./.stage-XXXXXX)"
tar -xzf ~/Downloads/Wavewalletdk.xcframework.tar.gz \
  -C "$TMP" Wavewalletdk.xcframework
extracted=$?

find "$TMP/Wavewalletdk.xcframework" -name '*.h' \
  -exec sed -i.orig 's|@import Foundation;|#import <Foundation/Foundation.h>|' {} +
find "$TMP/Wavewalletdk.xcframework" -name '*.h.orig' -delete

# Swap in only if tar succeeded, since pasted commands do not stop at the first
# error and the removal below is destructive. A truncated archive still leaves
# a directory behind, so tar's exit status is the test, not the framework's
# existence. The podspec check confirms the cd above landed, so a paste from
# the wrong directory cannot delete something else's ios/.
if [ "$extracted" -eq 0 ] && [ -f ~/Downloads/Wavewalletdk.aar ] &&
   [ -f WavelengthReactNative.podspec ]; then
  mkdir -p android/libs
  cp ~/Downloads/Wavewalletdk.aar android/libs/
  # Replace rather than unpacking over: tar merges into an existing directory
  # and would leave slices from an earlier revision behind.
  rm -rf ios/Wavewalletdk.xcframework
  mv "$TMP/Wavewalletdk.xcframework" ios/
else
  echo "staging failed; previous binaries left in place" >&2
fi
rm -rf "$TMP"

Working from a checkout of the SDK repository instead, its bindings:fetch script does all of this for you, and bindings:local builds the binaries from a wavelength source checkout (for an unreleased daemon revision).

Next steps

• Quickstart: wire up the provider, create a wallet, and send your first payment.
• Requirements: confirm the platform, OS, and passkey requirements.