Merge pull request #7 from UTEXO-Protocol/feat/rln-wasm

Feat/rln wasm

Author: bandrivskiy

.env.example

@@ -7,3 +7,18 @@ VITE_REGTEST_PROXY_RPC_URL=rpc://localhost:3000/json-rpc
 VITE_REGTEST_BITCOIND_URL=/bitcoind/wallet/miner
 VITE_REGTEST_BITCOIND_USER=user
 VITE_REGTEST_BITCOIND_PASS=password
+
+# APay UTEXO (signet) flow — LSP & APay page
+# Faucet RLN-node REST that funds BTC + sends the RGB top-up (required).
+# The browser reaches it through the Vite /faucet-signet proxy.
+VITE_SIGNET_FAUCET_URL=
+# Bearer token for the signet LSP APay routes (enableLightningAddress).
+VITE_SIGNET_LSP_BEARER=
+# Optional overrides (defaults: RN-demo asset id, /lsp-signet proxy →
+# https://lsp-signet.utexo.com).
+# VITE_SIGNET_ASSET_ID=rgb:...
+# VITE_SIGNET_LSP_URL=/lsp-signet
+# VITE_SIGNET_LSP_TARGET=https://lsp-signet.utexo.com
+# VITE_SIGNET_PROXY_WS=wss://...        # WS gateway for the wasm node's LDK P2P
+# VITE_SIGNET_INDEXER_URL=https://esplora-api.utexo.com
+# VITE_SIGNET_TRANSPORT=rpcs://rgb-proxy.utexo.com/json-rpc

.gitignore

@@ -24,3 +24,6 @@ npm-debug.log*
 
 # TypeScript
 *.tsbuildinfo
+
+# Local scripts
+scripts/start-lsp-web.sh

CLAUDE.md

@@ -18,22 +18,23 @@ Interactive React SPA that demos every function of the `@utexo/rgb-sdk-web` WASM
 
 ## Architecture
 
-**Startup flow**: `App.tsx` calls `initWasm()` (async WASM init), then `autoRestore()` to recover wallets from `sessionStorage`. The Zustand store in `src/store.ts` holds the live WASM wallet instances (`manager: WalletManager | null`, `utexo: UTEXOWallet | null`) plus an activity log. Wallet instances **must** live in Zustand (not React state) because WASM objects cannot be cloned/serialized.
+The SDK is **RLN-only** (the old rgb-lib-wasm `WalletManager` stack was removed). All wallets are backed by `rln-wasm-sdk`.
+
+**Startup flow**: `App.tsx` calls `initRlnWasm()` (async WASM init), then `autoRestore()` to recover wallets from `localStorage`. The Zustand store in `src/store.ts` holds live wallet instances (`type: 'utexo' | 'rln'`, instance `UTEXOWallet | RlnWalletManager`) plus an activity log. Instances **must** live in Zustand (not React state) — WASM objects cannot be cloned/serialized. Both wallet types restore via `*.create({ mnemonic, password, network, indexerUrl?, transportEndpoint?, proxyUrl?, nodeRuntimeId? })`, so the saved `WalletConfig` must include `password`. `create()` auto-connects to the indexer (saved `indexerUrl` or the network default) non-fatally — check `isOnline()` afterwards; no separate `goOnline()` call is needed.
 
 **Pages** (one route each in `App.tsx`):
 - `KeysPage` — `generateKeys`, `restoreKeys`, `deriveKeysFromMnemonic`, `bip39`
-- `WalletManagerPage` — full `WalletManager` lifecycle (create, go online, UTXO ops, BTC send)
-- `UtexoWalletPage` — `UTEXOWallet` (dual-layer wallet with optional transport endpoint)
-- `BitcoinPage` — BTC send (3-step PSBT), faucet funding, fee estimation
-- `RgbAssetsPage` — issue NIA/IFA assets, blind/witness receive invoices, send assets
-- `BackupPage` — file backup/restore, VSS cloud backup
+- `UtexoWalletPage` — **primary**: create + full `UTEXOWallet` surface (RGB on-chain + Lightning), backed by RLN
+- `UtexoBackupPage` (`/backup`) — file backup (`createBackup`/`getLastBackupBytes`/`restoreFromBackupBytes`) + VSS
+
+`BitcoinPage`, `RgbAssetsPage`, `RlnWalletPage`, and `RlnFlowGuidePage` were removed — they duplicated `UtexoWalletPage`'s coverage of BTC send, RGB issue/send/receive, and Lightning at the lower `RlnWalletManager`/`IRlnNodeBinding` layer. `UTEXOWallet` does not re-expose `sendBeginBatch`/`sendBatch`/`sendRgbFromGroups` (batch/group RGB send) — use `RlnWalletManager` directly for that if needed.
 
 **Reusable components** worth knowing:
 - `StepFlow.tsx` — 3-step Begin → Sign → Broadcast UI; steps unlock sequentially; has an "Auto" button that runs all 3 at once
 - `OutputBox.tsx` — `<pre>` display with Copy button
 - `Field.tsx`, `Section.tsx`, `Btn.tsx` — form/layout primitives
 
-**Session persistence** (`src/lib/session.ts`): saves `{ type, mnemonic, network, transportEndpoint, indexerUrl }` to `sessionStorage['rgb_wallet_session']`. Cleared when browser session ends.
+**Session persistence** (`src/lib/session.ts`): saves wallet entries (incl. `WalletConfig` with `password`) to `localStorage['rgb_wallet_sessions']`; active id in `sessionStorage['rgb_active_wallet_id']`.
 
 ## Critical Vite Config Rules
 
@@ -45,7 +46,7 @@ Interactive React SPA that demos every function of the `@utexo/rgb-sdk-web` WASM
 
 `optimizeDeps.exclude` must list `@utexo/rgb-sdk-web` and sibling packages — Vite's pre-bundler breaks async WASM init if they're included.
 
-`server.fs.allow` must include sibling monorepo paths (`../rgb-sdk-web`, `../rgb-lib-wasm`, `../rgb-sdk-core`) so Vite can serve their WASM files.
+`server.fs.allow` must include sibling monorepo paths (`../rgb-sdk-web`, `../rgb-sdk-core`, `../../utexo/rgb-lightning-node/bindings/wasm-sdk/pkg`) so Vite can serve their WASM files.
 
 ## SDK Patterns