@lightninglabs/wavelength-react-native 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2026 Lightning Labs and The Lightning Network Developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# @lightninglabs/wavelength-react-native
+
+The React Native transport for [Wavelength](https://wavelength.lightning.engineering): embed a
+self-custodial Lightning wallet directly in your app. Your users send and
+receive Lightning payments with no node to run, no channels to open, and no
+inbound liquidity to manage, while the keys stay on their own device. The
+wallet runtime is compiled into the app binary, so there is no backend to
+operate and nothing listening on a socket. Your app drives it through the
+same typed client contract as the web transport.
+
+## Requirements
+
+- React Native 0.76 or newer, with the **New Architecture enabled**. This
+  package is New Architecture only; it does not support the legacy
+  architecture.
+- iOS 15.1+.
+- Android minSdk 24.
+- Expo apps need a **development build**, not Expo Go: the native wallet
+  runtime is a compiled module that Expo Go cannot load.
+
+## Install
+
+```sh
+npm install @lightninglabs/wavelength-react-native @lightninglabs/wavelength-react
+```
+
+The native wallet runtime binaries (`Wavewalletdk.aar` and
+`Wavewalletdk.xcframework`) are not bundled inside the npm package. Get them one
+of two ways, then stage them into this package before running `pod install` or a
+Gradle build:
+
+- Download them from the paired
+  [wavelength release](https://github.com/lightninglabs/wavelength/releases).
+- Build them from a `wavelength` checkout with `scripts/fetch-bindings.sh`, which
+  compiles them from the daemon source named by `WAVELENGTH_DIR`.
+
+## Quick start
+
+```tsx
+import { WavelengthProvider, useWallet } from '@lightninglabs/wavelength-react';
+import { createNativeWalletEngine } from '@lightninglabs/wavelength-react-native';
+
+const engine = createNativeWalletEngine();
+
+export default function App() {
+  return (
+    <WavelengthProvider engine={engine}>
+      <Wallet />
+    </WavelengthProvider>
+  );
+}
+```
+
+`createNativeWalletEngine()` builds a `WalletEngine` backed by the wallet
+runtime compiled into your app; pass it to `WavelengthProvider` and use the
+same hooks (`useWallet`, `useWalletBalance`, `useWalletSend`,
+`useWalletReceive`, `useWalletDeposit`, `useWalletActivity`) documented in
+[`@lightninglabs/wavelength-react`](https://www.npmjs.com/package/@lightninglabs/wavelength-react).
+
+## Passkey wallets
+
+The transport ships a native passkey ceremony, so users can create and unlock
+a wallet with a platform passkey instead of a password:
+
+```tsx
+import { useWalletPasskey } from '@lightninglabs/wavelength-react';
+import { createNativePasskeyCeremony } from '@lightninglabs/wavelength-react-native';
+
+const ceremony = createNativePasskeyCeremony({ rpId: 'wallet.example.com' });
+
+function PasskeyButton() {
+  const passkey = useWalletPasskey(ceremony);
+  if (!passkey.supported) return null;
+  return (
+    <Button
+      title="Create with passkey"
+      disabled={passkey.createPending}
+      onPress={() => passkey.create('My Wallet App')}
+    />
+  );
+}
+```
+
+Passkeys bind to a relying-party domain (`rpId`) that must vouch for your
+app:
+
+- **Android:** serve
+  `https://<rpId>/.well-known/assetlinks.json` listing your app's package
+  name and signing-certificate SHA-256 fingerprint with both relations the
+  platform checks (`delegate_permission/common.handle_all_urls` and
+  `delegate_permission/common.get_login_creds`), and declare the association
+  in your app: an `asset_statements` string resource that includes that
+  assetlinks URL, referenced by a manifest `meta-data` entry. Without either
+  half the ceremony fails with "RP ID cannot be validated". At runtime the
+  device needs Android 9+ (API 28), Google Play services with a signed-in
+  Google account, and a device screen lock.
+- **iOS (experimental):** add the Associated Domains capability
+  (`webcredentials:<rpId>`) to your app and serve
+  `https://<rpId>/.well-known/apple-app-site-association` listing your Team
+  ID and bundle id. Requires iOS 18 or newer at runtime. The iOS ceremony is
+  implemented and unit-tested but has not yet been verified end to end;
+  treat it as experimental.
+
+`supportsPasskeyPrf()` (surfaced as `passkey.supported` by the hook) reports
+whether the platform prerequisites are present; a supported device can still
+decline the ceremony, which surfaces as a normal error.
+
+## Known limitations
+
+- Wallet runtime logs go to the platform log (Android logcat, iOS os_log),
+  not to JS-visible events. Use your platform's native log viewer while
+  debugging.

package/WavelengthReactNative.podspec

@@ -0,0 +1,24 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "WavelengthReactNative"
+  s.version      = package["version"]
+  s.summary      = "React Native transport for the Wavelength SDK."
+  s.homepage     = "https://github.com/lightninglabs/wavelength-sdk"
+  s.license      = { :type => "MIT" }
+  s.authors      = "Lightning Labs"
+  s.platforms    = { :ios => "15.1" }
+  s.source       = { :git => "https://github.com/lightninglabs/wavelength-sdk.git" }
+  s.source_files = "ios/**/*.{h,mm,swift}"
+  s.pod_target_xcconfig = { "DEFINES_MODULE" => "YES" }
+
+  # The gomobile-built daemon; staged by scripts/fetch-bindings.sh (gitignored).
+  s.vendored_frameworks = "ios/Wavewalletdk.xcframework"
+
+  # The Go runtime's DNS resolver links against libresolv (res_9_* symbols).
+  s.libraries = "resolv"
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,41 @@
+apply plugin: "com.android.library"
+apply plugin: "org.jetbrains.kotlin.android"
+apply plugin: "com.facebook.react"
+
+react {
+  jsRootDir = file("../src")
+  libraryName = "Wavelength"
+  codegenJavaPackageName = "engineering.lightning.wavelength.reactnative"
+}
+
+android {
+  namespace "engineering.lightning.wavelength.reactnative"
+  compileSdkVersion rootProject.hasProperty("compileSdkVersion") ? rootProject.ext.compileSdkVersion : 35
+
+  defaultConfig {
+    // The gomobile bindings are built with -androidapi 21; RN itself floors
+    // higher, so inherit the app's minSdk when present.
+    minSdkVersion rootProject.hasProperty("minSdkVersion") ? rootProject.ext.minSdkVersion : 24
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  // The gomobile-generated bindings, staged by scripts/fetch-bindings.sh.
+  api files("libs/Wavewalletdk.aar")
+  // Passkeys: Credential Manager plus its Play services provider binding.
+  implementation "androidx.credentials:credentials:1.6.0"
+  implementation "androidx.credentials:credentials-play-services-auth:1.6.0"
+  // GoogleApiAvailability/ConnectionResult for the passkeySupported probe;
+  // the binding above does not expose them on the compile classpath.
+  implementation "com.google.android.gms:play-services-base:18.7.2"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/engineering/lightning/wavelength/reactnative/WavelengthModule.kt

@@ -0,0 +1,291 @@
+package engineering.lightning.wavelength.reactnative
+
+import android.os.Build
+import androidx.core.content.ContextCompat
+import androidx.credentials.CreateCredentialResponse
+import androidx.credentials.CreatePublicKeyCredentialRequest
+import androidx.credentials.CreatePublicKeyCredentialResponse
+import androidx.credentials.CredentialManager
+import androidx.credentials.CredentialManagerCallback
+import androidx.credentials.GetCredentialRequest
+import androidx.credentials.GetCredentialResponse
+import androidx.credentials.GetPublicKeyCredentialOption
+import androidx.credentials.PublicKeyCredential
+import androidx.credentials.exceptions.CreateCredentialCancellationException
+import androidx.credentials.exceptions.CreateCredentialException
+import androidx.credentials.exceptions.CreateCredentialProviderConfigurationException
+import androidx.credentials.exceptions.GetCredentialCancellationException
+import androidx.credentials.exceptions.GetCredentialException
+import androidx.credentials.exceptions.GetCredentialProviderConfigurationException
+import androidx.credentials.exceptions.NoCredentialException
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.google.android.gms.common.ConnectionResult
+import com.google.android.gms.common.GoogleApiAvailability
+import engineering.lightning.wavewalletdk.mobile.Mobile
+import engineering.lightning.wavewalletdk.mobile.Subscription
+import java.io.File
+import java.util.concurrent.ExecutorService
+import java.util.concurrent.Executors
+
+// The thin JSON pipe between JS and the gomobile facade. Every facade verb runs on a
+// background executor because the facade's calls block (start until the
+// daemon serves, RPCs until they answer). All typing lives in TypeScript.
+class WavelengthModule(reactContext: ReactApplicationContext) :
+  NativeWavelengthSpec(reactContext) {
+
+  private val executor: ExecutorService = Executors.newCachedThreadPool()
+
+  override fun getName(): String = NAME
+
+  override fun getDefaultDataDir(promise: Promise) {
+    promise.resolve(File(reactApplicationContext.filesDir, "wavelength").absolutePath)
+  }
+
+  // passkeySupported is a cheap prerequisite probe (platform passkeys need
+  // API 28 and Play services); like the web probe, true does not guarantee
+  // the ceremony will yield a PRF output.
+  override fun passkeySupported(promise: Promise) {
+    val playServicesReady = GoogleApiAvailability.getInstance()
+      .isGooglePlayServicesAvailable(reactApplicationContext) ==
+      ConnectionResult.SUCCESS
+    promise.resolve(Build.VERSION.SDK_INT >= 28 && playServicesReady)
+  }
+
+  // passkeyCreate runs a WebAuthn registration through Credential Manager,
+  // which consumes and produces the standard WebAuthn JSON verbatim.
+  override fun passkeyCreate(requestJson: String, promise: Promise) {
+    val activity = currentActivity
+    if (activity == null) {
+      promise.reject(ERROR_CODE, "passkey ceremony requires a foreground activity")
+      return
+    }
+    try {
+      CredentialManager.create(reactApplicationContext).createCredentialAsync(
+        activity,
+        CreatePublicKeyCredentialRequest(requestJson),
+        null,
+        ContextCompat.getMainExecutor(activity),
+        object :
+          CredentialManagerCallback<CreateCredentialResponse, CreateCredentialException> {
+          override fun onResult(result: CreateCredentialResponse) {
+            val json =
+              (result as? CreatePublicKeyCredentialResponse)?.registrationResponseJson
+            if (json == null) {
+              promise.reject(ERROR_CODE, "credential provider returned an unexpected type")
+            } else {
+              promise.resolve(json)
+            }
+          }
+
+          override fun onError(e: CreateCredentialException) {
+            promise.reject(ERROR_CODE, passkeyErrorMessage(e), e)
+          }
+        },
+      )
+    } catch (e: Throwable) {
+      // Request construction validates the JSON eagerly; reject rather than
+      // crash when a caller bypasses the TypeScript ceremony with bad input.
+      promise.reject(ERROR_CODE, e.message ?: "passkey ceremony failed", e)
+    }
+  }
+
+  // passkeyGet runs a WebAuthn assertion through Credential Manager.
+  override fun passkeyGet(requestJson: String, promise: Promise) {
+    val activity = currentActivity
+    if (activity == null) {
+      promise.reject(ERROR_CODE, "passkey ceremony requires a foreground activity")
+      return
+    }
+    try {
+      CredentialManager.create(reactApplicationContext).getCredentialAsync(
+        activity,
+        GetCredentialRequest(listOf(GetPublicKeyCredentialOption(requestJson))),
+        null,
+        ContextCompat.getMainExecutor(activity),
+        object :
+          CredentialManagerCallback<GetCredentialResponse, GetCredentialException> {
+          override fun onResult(result: GetCredentialResponse) {
+            val json =
+              (result.credential as? PublicKeyCredential)?.authenticationResponseJson
+            if (json == null) {
+              promise.reject(ERROR_CODE, "credential provider returned an unexpected type")
+            } else {
+              promise.resolve(json)
+            }
+          }
+
+          override fun onError(e: GetCredentialException) {
+            promise.reject(ERROR_CODE, passkeyErrorMessage(e), e)
+          }
+        },
+      )
+    } catch (e: Throwable) {
+      // Request construction validates the JSON eagerly; reject rather than
+      // crash when a caller bypasses the TypeScript ceremony with bad input.
+      promise.reject(ERROR_CODE, e.message ?: "passkey ceremony failed", e)
+    }
+  }
+
+  // passkeyErrorMessage maps the Credential Manager exception taxonomy onto
+  // the ceremony's user-facing messages, matching the web ceremony's wording.
+  private fun passkeyErrorMessage(e: Exception): String = when (e) {
+    is CreateCredentialCancellationException -> "passkey registration was cancelled"
+    is GetCredentialCancellationException -> "passkey authentication was cancelled"
+    is NoCredentialException -> "no passkey is available on this device for this app"
+    is CreateCredentialProviderConfigurationException,
+    is GetCredentialProviderConfigurationException,
+    -> "no passkey provider is configured on this device"
+    else -> e.message ?: "passkey ceremony failed"
+  }
+
+  override fun call(method: String, paramsJson: String, promise: Promise) {
+    executor.execute {
+      try {
+        promise.resolve(dispatch(method, paramsJson))
+      } catch (e: Throwable) {
+        promise.reject(ERROR_CODE, e.message ?: "wavelength call failed", e)
+      }
+    }
+  }
+
+  // dispatch maps a verb name onto the generated Mobile entry points. The
+  // switch stays dumb on purpose because all typing lives in TypeScript.
+  private fun dispatch(method: String, paramsJson: String): String {
+    val params = paramsJson.toByteArray(Charsets.UTF_8)
+    return when (method) {
+      "start" -> { Mobile.start(paramsJson); "" }
+      "stop" -> { Mobile.stop(); "" }
+      "getInfo" -> Mobile.getInfo().toString(Charsets.UTF_8)
+      "status" -> Mobile.status().toString(Charsets.UTF_8)
+      "balance" -> Mobile.balance().toString(Charsets.UTF_8)
+      "createWallet" -> Mobile.createWallet(params).toString(Charsets.UTF_8)
+      "unlockWallet" -> Mobile.unlockWallet(params).toString(Charsets.UTF_8)
+      "openWalletFromPasskey" -> Mobile.openWalletFromPasskey(params).toString(Charsets.UTF_8)
+      "deposit" -> Mobile.deposit(params).toString(Charsets.UTF_8)
+      "receive" -> Mobile.receive(params).toString(Charsets.UTF_8)
+      "prepareSend" -> Mobile.prepareSend(params).toString(Charsets.UTF_8)
+      "sendPrepared" -> Mobile.sendPrepared(params).toString(Charsets.UTF_8)
+      "list" -> Mobile.list(params).toString(Charsets.UTF_8)
+      "exit" -> Mobile.exit(params).toString(Charsets.UTF_8)
+      "exitStatus" -> Mobile.exitStatus(params).toString(Charsets.UTF_8)
+      "exitSummary" -> Mobile.exitSummary(params).toString(Charsets.UTF_8)
+      "getExitPlan" -> Mobile.getExitPlan(params).toString(Charsets.UTF_8)
+      "sweepWallet" -> Mobile.sweepWallet(params).toString(Charsets.UTF_8)
+      "confirmedBalanceSat" -> Mobile.confirmedBalanceSat().toString()
+      "pendingInboundSat" -> Mobile.pendingInboundSat().toString()
+      "walletReady" -> Mobile.walletReady().toString()
+      "isRunning" -> Mobile.isRunning().toString()
+      else -> throw IllegalArgumentException("unknown wavelength verb: $method")
+    }
+  }
+
+  private var subscription: Subscription? = null
+
+  override fun startActivity(reqJson: String, promise: Promise) {
+    executor.execute {
+      try {
+        synchronized(this) {
+          if (subscription == null) {
+            val sub = Mobile.subscribe(reqJson.toByteArray(Charsets.UTF_8))
+            subscription = sub
+            Thread({ pump(sub) }, "wavelength-activity").apply {
+              isDaemon = true
+              start()
+            }
+          }
+        }
+        promise.resolve(null)
+      } catch (e: Throwable) {
+        promise.reject(ERROR_CODE, e.message ?: "wavelength subscribe failed", e)
+      }
+    }
+  }
+
+  override fun stopActivity(promise: Promise) {
+    executor.execute {
+      try {
+        val sub = synchronized(this) {
+          val active = subscription
+          // Detach before close returns so a queued start can't reuse a pump
+          // that's already stopping.
+          subscription = null
+          active
+        }
+        sub?.close()
+        promise.resolve(null)
+      } catch (e: Throwable) {
+        promise.reject(ERROR_CODE, e.message ?: "wavelength unsubscribe failed", e)
+      }
+    }
+  }
+
+  // pump drains the facade's pull subscription, forwarding each entry as a
+  // device event until the stream ends. Runs on its own daemon thread because
+  // next() blocks.
+  private fun pump(sub: Subscription) {
+    try {
+      while (true) {
+        val entry = try {
+          sub.next()
+        } catch (e: Exception) {
+          // Only the exact terminal "EOF" is a clean close; a substring match
+          // would misclassify real failures like "unexpected EOF" as clean
+          // ends and silently freeze the stream.
+          val stopped = synchronized(this) { subscription !== sub }
+          // An intentional stop has no terminal event. A replacement may
+          // already be open by the time this old pump unblocks.
+          if (stopped) {
+            break
+          }
+          if (e.message == "EOF") {
+            sendEvent("end", "")
+          } else {
+            sendEvent("error", e.message ?: "wavelength activity stream failed")
+          }
+          break
+        }
+        if (synchronized(this) { subscription !== sub }) {
+          break
+        }
+        sendEvent("entry", entry.toString(Charsets.UTF_8))
+      }
+    } catch (t: Throwable) {
+      // Emitting can fail while React tears down (a reload mid-stream);
+      // there is nobody left to notify, but this daemon thread must never
+      // crash the process.
+    } finally {
+      try {
+        sub.close()
+      } catch (ignored: Exception) {
+        // The subscription may already be closed; nothing further to do.
+      }
+      synchronized(this) {
+        if (subscription === sub) {
+          subscription = null
+        }
+      }
+    }
+  }
+
+  private fun sendEvent(kind: String, payload: String) {
+    val body = Arguments.createMap().apply {
+      putString("kind", kind)
+      putString("payload", payload)
+    }
+    reactApplicationContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit("wavelengthActivity", body)
+  }
+
+  override fun addListener(eventName: String) = Unit
+
+  override fun removeListeners(count: Double) = Unit
+
+  companion object {
+    const val NAME = "Wavelength"
+    const val ERROR_CODE = "wavelength_error"
+  }
+}

package/android/src/main/java/engineering/lightning/wavelength/reactnative/WavelengthPackage.kt

@@ -0,0 +1,28 @@
+package engineering.lightning.wavelength.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+// Registers the wavelength turbo module with the React runtime.
+class WavelengthPackage : BaseReactPackage() {
+
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? =
+    if (name == WavelengthModule.NAME) WavelengthModule(reactContext) else null
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider =
+    ReactModuleInfoProvider {
+      mapOf(
+        WavelengthModule.NAME to ReactModuleInfo(
+          WavelengthModule.NAME,
+          WavelengthModule.NAME,
+          false,
+          false,
+          false,
+          true,
+        ),
+      )
+    }
+}

package/dist/NativeWalletdk.d.ts

@@ -0,0 +1,31 @@
+import type { TurboModule } from 'react-native';
+/**
+ * The Turbo Module contract for the walletdk native bridge. The surface is a
+ * deliberately thin JSON pipe: `call` dispatches every facade verb by name
+ * with a JSON string in and a JSON string out, and the activity stream
+ * arrives as 'walletdkActivity' device events carrying
+ * `{ kind: 'entry' | 'end' | 'error', payload: string }`.
+ */
+export interface Spec extends TurboModule {
+    /** Invokes a facade verb by name with a JSON payload, returning JSON. */
+    call(method: string, paramsJson: string): Promise<string>;
+    /** Opens the activity subscription; entries arrive as device events. */
+    startActivity(reqJson: string): Promise<void>;
+    /** Closes the activity subscription; a no-op when none is open. */
+    stopActivity(): Promise<void>;
+    /** Resolves the platform default wallet data directory. */
+    getDefaultDataDir(): Promise<string>;
+    /** Reports whether the platform can run a passkey PRF ceremony. */
+    passkeySupported(): Promise<boolean>;
+    /** Runs a passkey registration ceremony; WebAuthn JSON in and out. */
+    passkeyCreate(requestJson: string): Promise<string>;
+    /** Runs a passkey assertion ceremony; WebAuthn JSON in and out. */
+    passkeyGet(requestJson: string): Promise<string>;
+    /** Required by NativeEventEmitter. */
+    addListener(eventName: string): void;
+    /** Required by NativeEventEmitter. */
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeWalletdk.d.ts.map

package/dist/NativeWalletdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeWalletdk.d.ts","sourceRoot":"","sources":["../src/NativeWalletdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;GAMG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,yEAAyE;IACzE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,wEAAwE;IACxE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mEAAmE;IACnE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,sEAAsE;IACtE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,mEAAmE;IACnE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,sCAAsC;IACtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sCAAsC;IACtC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAkE"}

package/dist/NativeWalletdk.js

@@ -0,0 +1,2 @@
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('Walletdk');

package/dist/NativeWavelength.d.ts

@@ -0,0 +1,31 @@
+import type { TurboModule } from 'react-native';
+/**
+ * The Turbo Module contract for the wavelength native bridge. The surface is
+ * a deliberately thin JSON pipe: `call` dispatches every facade verb by name
+ * with a JSON string in and a JSON string out, and the activity stream
+ * arrives as 'wavelengthActivity' device events carrying
+ * `{ kind: 'entry' | 'end' | 'error', payload: string }`.
+ */
+export interface Spec extends TurboModule {
+    /** Invokes a facade verb by name with a JSON payload, returning JSON. */
+    call(method: string, paramsJson: string): Promise<string>;
+    /** Opens the activity subscription; entries arrive as device events. */
+    startActivity(reqJson: string): Promise<void>;
+    /** Closes the activity subscription; a no-op when none is open. */
+    stopActivity(): Promise<void>;
+    /** Resolves the platform default wallet data directory. */
+    getDefaultDataDir(): Promise<string>;
+    /** Reports whether the platform can run a passkey PRF ceremony. */
+    passkeySupported(): Promise<boolean>;
+    /** Runs a passkey registration ceremony; WebAuthn JSON in and out. */
+    passkeyCreate(requestJson: string): Promise<string>;
+    /** Runs a passkey assertion ceremony; WebAuthn JSON in and out. */
+    passkeyGet(requestJson: string): Promise<string>;
+    /** Required by NativeEventEmitter. */
+    addListener(eventName: string): void;
+    /** Required by NativeEventEmitter. */
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeWavelength.d.ts.map

package/dist/NativeWavelength.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeWavelength.d.ts","sourceRoot":"","sources":["../src/NativeWavelength.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;GAMG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,yEAAyE;IACzE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,wEAAwE;IACxE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mEAAmE;IACnE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,sEAAsE;IACtE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,mEAAmE;IACnE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,sCAAsC;IACtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sCAAsC;IACtC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAoE"}

package/dist/NativeWavelength.js

@@ -0,0 +1,2 @@
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('Wavelength');

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+import { BaseWavelengthClient } from '@lightninglabs/wavelength-core';
+import type { ActivityStreamOptions, FacadeMethod, RuntimeConfig, WalletInfo } from '@lightninglabs/wavelength-core';
+/**
+ * The subset of the native Turbo Module the client depends on. Narrowed to an
+ * interface (rather than the generated Spec) so unit tests can inject a fake
+ * without loading react-native.
+ */
+export type WavelengthNativeModule = {
+    /** Invokes a facade verb by name with a JSON payload, returning JSON. */
+    call(method: string, paramsJson: string): Promise<string>;
+    /** Opens the native activity subscription. */
+    startActivity(reqJson: string): Promise<void>;
+    /** Closes the native activity subscription. */
+    stopActivity(): Promise<void>;
+    /** Resolves the platform default wallet data directory. */
+    getDefaultDataDir(): Promise<string>;
+};
+/**
+ * One 'wavelengthActivity' device event from the native side: an activity
+ * entry, a clean end of stream, or a stream error.
+ */
+export type NativeActivityEvent = {
+    /** The native pump's event kind. */
+    kind: 'entry' | 'end' | 'error';
+    /** The entry JSON for 'entry', the error message for 'error', else ''. */
+    payload: string;
+};
+/**
+ * Subscribes a listener to the native 'wavelengthActivity' events and
+ * returns an unsubscribe function. The factory wires this to
+ * NativeEventEmitter; unit tests supply their own.
+ */
+export type SubscribeToNativeEvents = (listener: (event: NativeActivityEvent) => void) => () => void;
+/**
+* The React Native transport: implements {@link BaseWavelengthClient}'s pipe
+* over the gomobile Turbo Module. JSON strings cross the RN bridge, then the
+* shared base client normalizes responses and streamed entries in TS.
+*/
+export declare class NativeWavelengthClient extends BaseWavelengthClient {
+    protected readonly serverTransport: "grpc";
+    private removeNativeListener;
+    private opChain;
+    private streamOpen;
+    private native;
+    private subscribeToNativeEvents;
+    constructor(native: WavelengthNativeModule, subscribeToNativeEvents: SubscribeToNativeEvents);
+    private enqueue;
+    ready(): Promise<void>;
+    start(config: RuntimeConfig): Promise<WalletInfo>;
+    protected invokeFacade<T = unknown>(method: FacadeMethod, params?: unknown): Promise<T>;
+    protected openActivityStream(opts: ActivityStreamOptions): Promise<void>;
+    stopActivity(): void;
+    private onNativeEvent;
+    dispose(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAGrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,qBAAqB,EAErB,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,yEAAyE;IACzE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,8CAA8C;IAC9C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,+CAA+C;IAC/C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,oCAAoC;IACpC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,KAC3C,MAAM,IAAI,CAAC;AAEd;;;;EAIE;AACJ,qBAAa,sBAAuB,SAAQ,oBAAoB;IAE9D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAG,MAAM,CAAU;IAErD,OAAO,CAAC,oBAAoB,CAA6B;IAGzD,OAAO,CAAC,OAAO,CAAoC;IAGnD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,uBAAuB,CAA0B;gBAGvD,MAAM,EAAE,sBAAsB,EAC9B,uBAAuB,EAAE,uBAAuB;IASlD,OAAO,CAAC,OAAO;IAQf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMP,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;cAOhD,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,MAAM,EAAE,YAAY,EACpB,MAAM,GAAE,OAAY,GACnB,OAAO,CAAC,CAAC,CAAC;cAkBG,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAmBhB,YAAY,IAAI,IAAI;IAwBpB,OAAO,CAAC,aAAa;IAgDrB,OAAO,IAAI,IAAI;CAOhB"}