Installation

The packages

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

@lightninglabs/wavelength-react-native

The native transport: a Turbo Module wrapping the wallet runtime compiled into your app binary. Re-exports the entire core surface, so it is the only wallet import an app needs besides the hooks package.

@lightninglabs/wavelength-react

React provider and hooks. Transport-agnostic: it takes an injected client and depends only on core.

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

Next steps

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