LaWallet SDK

Nostr-first TypeScript client and React hooks for LaWallet instances. Give your users a lightning address on your own domain, connect their wallets over NWC, and take payments — from your own webapp.

npm install @lawallet/sdk

import { LaWalletProvider, useClaimAddress } from '@lawallet/sdk/react'

function App() {
  return (
    <LaWalletProvider endpoint="https://wallet.example.com">
      <Claim />
    </LaWalletProvider>
  )
}

function Claim() {
  const flow = useClaimAddress()
  return (
    <form onSubmit={flow.handleSubmit}>
      <input
        value={flow.username}
        onChange={e => flow.setUsername(e.target.value)}
      />
      <button disabled={flow.submitDisabled}>
        Claim {flow.username}@{flow.domain}
      </button>
    </form>
  )
}

That form handles username availability, the operator's paid-registration path (invoice QR, WebLN, LUD-21 settlement polling, resume-after-refresh) and the claim itself. There is no login step to build: the user's Nostr key is the session.

React is an optional peer dependency — a Node backend importing @lawallet/sdk never pulls React into its dependency graph. Both entries share one implementation, so errors and classes are identical across them.

Every authenticated request is a kind-27235 NIP-98 event signed by the user's key, committing to the URL, method and body. No login endpoint, no session state, nothing to refresh — hand the client a signer and start calling. Signers are structural (getPublicKey + signEvent), so window.nostr (NIP-07), nostr-tools, @nostrify and NDK signers all work as-is.

Both run with no configuration against the public instance:

pnpm install && pnpm build
pnpm --filter lawallet-example-onboarding dev

• Getting started — install, quickstart, API coverage
• Authentication — signers, NIP-98, key custody
• React hooks — the provider and every hook, with examples
• Claim flow — free and paid address registration
• Admin provisioning — issuing addresses on a user's behalf
• NWC & routing — remote wallets and the four address modes

The repo ships Claude Code skills so an AI assistant integrates the SDK correctly instead of guessing at the API:

/plugin marketplace add lawalletio/sdk
/plugin install lawallet-sdk@lawallet-sdk

A LaWallet instance running v2.6.0 or newer — that release added the cross-origin access this SDK needs, the NIP-98 SSE token and the operator provisioning endpoint.

pnpm install
pnpm build        # required once: the examples consume packages/sdk/dist
pnpm test
pnpm typecheck

MIT © La Crypta