Guides
Client SDK & React Hooks
Roadmap notes for the planned SDK and React Hooks packages.
Expected · June 2026
Status
React components and hooks already live in the codebase under apps/web/components/ and apps/web/lib/client/hooks/. They still need to be extracted and published as a standalone npm package — that migration is targeted for June 2026.
Overview
The current lawallet-nwc repository does not yet ship a published client SDK or React Hooks npm package.
This page documents the intended SDK and hooks direction described in the roadmap so the planned API surface stays visible while implementation catches up.
Planned React Hooks Package
The roadmap also calls for a React hooks package built on top of that SDK.
Planned hook areas:
| Hook | Purpose | Month |
|---|---|---|
useAddress | CRUD single lightning address | 2 |
useAddresses | List/search/filter with pagination | 2 |
useNWCConnection | Connect, disconnect, status polling | 2 |
useAuth | NIP-98 to JWT session flow | 2 |
useWallet | Wallet status and NWC state | 2 |
useCourtesyNWC | Courtesy NWC via lncurl | 3 |
useWebhooks | Webhook management | 5 |
useRedirect | Redirect configuration | 5 |
Lifecycle
| Month | SDK Milestone | Hooks Milestone |
|---|---|---|
| 2 | Core auth, address, and NWC coverage. | Base hooks for auth and address flows. |
| 3 | Frontend adoption and courtesy-NWC support. | Add useCourtesyNWC. |
| 5 | Redirect, webhook, and verification methods. | Expand hooks to match the newer API surface. |
| 6 | Full docs + API reference. | Full docs + usage examples. |