Bitcoin · Lightning · Ark · Self-custodial

Integrate bitcoin
in an afternoon.

Add self-custodial Bitcoin and Lightning payments to your web or mobile app. No node to run, no channels to manage, no liquidity to source. Your users hold their own keys, on their own devices.

Quick start Read the docs Try it live

App.tsx

$npm install @lightninglabs/wavelength-web @lightninglabs/wavelength-react

import { createWebWalletEngine, defaultConfig }
  from '@lightninglabs/wavelength-web';
import { WavelengthProvider }
  from '@lightninglabs/wavelength-react';

// Self-custodial wallet. No node, no channels.
const engine = createWebWalletEngine({
  config: defaultConfig('signet'),
  autoStart: true,
});

export function App() {
  return (
    <WavelengthProvider engine={engine}>
      <Balance />
      <SendButton />
    </WavelengthProvider>
  );
}

Choose how you integrate.

The same self-custodial wallet, five ways in.

Building with an AI agent?Build with agents

Capabilities

Everything you need.
Nothing you don't.

No node, no channels, no liquidity to manage. Wavelength handles the hard parts of Lightning for you.

Self-custodial
Users hold their own keys. Private keys never leave the user's device. No custodial risk, no trusted third parties.
Lightning via swaps
Instant Lightning payments with deep, reliable liquidity via Loop. No node to run and no channels to manage - routing is handled for you.
Unilateral exit anytime
Users can always exit to on-chain Bitcoin unilaterally - no cooperation required. True sovereignty, guaranteed by the protocol.
Runs where your app runs
In the browser via WebAssembly, or compiled into your React Native app. No server-side wallet process to operate.
Passkey auth
Secure wallet access via platform passkeys on web and mobile. No passwords, no seed phrase UX friction - biometric authentication built in.
Ark scaling
Ark protocol enables near-instant, low-fee off-chain payments with on-chain settlement guarantees. Scale without compromise.

Concepts

Understand the model.

Four concepts explain how Wavelength works under the hood.

3 Layers

One SDK. Three payment layers.

One coherent API over Bitcoin, Lightning, and Ark, with the same familiar invoice for every payment.

Bitcoin

On-chain BTC

Full custody. Receive to a native segwit address. Broadcast transactions. Trustless and final - the bedrock layer.

Lightning

Lightning via swaps

Instant payments via atomic swaps. No channels to manage. Pay any Lightning invoice directly from your Ark balance.

Ark

Ark scaling

VTXOs: virtual UTXOs that settle on-chain in batches. Fast, cheap, and still self-custodial. The scaling layer.

Ready to build?

Bitcoin payments used to mean standing up infrastructure. Now they are an API call. Start with the quickstart, then explore the guides.

Start the quickstart Try it live Browse guides

Integrate bitcoinin an afternoon.