Move rgb assets methods to rln level

Author: rmn-boiko

bindings/wasm-sdk/SDK_WASM_ENDPOINT_MATRIX.md

@@ -45,14 +45,14 @@ Core SDK behavior has been rewritten in wasm where native runtime assumptions do
 | `send_rgb` | `sendBegin` + `sendEndValue/Json` | runtime-backed | Two-step PSBT flow. |
 | `send_rgb_from_groups` | `walletSendRgbFromGroupsValue` / `walletSendRgbFromGroupsJson` and wallet-handle `sendRgbFromGroupsValue` / `sendRgbFromGroupsJson` | runtime-backed | Adapter implemented on wallet surfaces via real `send_begin` orchestration; legacy SDK-only `sendRgbFromGroups*` remains compatibility-only/unsupported on wasm facade. |
 | `init` | `initValue` / `initJson` | runtime-backed | Stateful wasm lifecycle initialization (`password+mnemonic` bootstrap) with stable validation/error contracts and runtime-session authority propagation (`initialized=true`, `authorized=false`). |
-| `unlock` | `unlock` | runtime-backed | Runtime-backed lifecycle unlock with request parsing, init precondition, password validation, and runtime-session authorization transition (`authorized=true`). |
+| `unlock` | `unlock` | runtime-backed | Runtime-backed lifecycle unlock with request parsing, init precondition, password validation, runtime-session authorization transition (`authorized=true`), and default RGB wallet bootstrap from lifecycle mnemonic (auto-attached to newly created nodes). |
 | `lock` | `lock` | runtime-backed | Runtime-backed lifecycle lock with init precondition and deterministic authorization transition (`authorized=false`) so runtime managers reject locked sessions until next unlock. |
 | `connect_peer` | `connectPeer` | runtime-backed | Runtime-backed websocket peer-connect path with secp256k1/`host:port` validation and runtime-event application through shared transport pipeline. On `ldk_bridge`, peer state is runtime-manager authoritative and reconnect aliases reactivate persisted peers (`started=true`), with JSON/text alias compatibility for event/id fields and separator-normalized kinds. |
 | `disconnect_peer` | `disconnectPeer` | runtime-backed | Runtime-backed disconnect path with secp256k1 validation and `peer_disconnected` transport transition application, including stale channel cleanup and runtime-manager-authoritative state transitions on `ldk_bridge`. |
 | `close_channel` | `closeChannel` | runtime-backed | Runtime-backed channel-close transition via `channel_closed` transport event path with runtime-manager-authoritative application on `ldk_bridge`, runtime-ready guard parity, and stable not-found contract. Extended options path (`closeChannelWithOptions`) supports native-like peer/session validation, virtual-session status transitions (`active -> abandon_pending -> abandoned`), and `force=true` rejection for trusted virtual channels. |
 | `create_utxos` | `createUtxosBegin` + `createUtxosEnd/Json` | runtime-backed | Two-step PSBT flow. |
-| `issue_asset_nia` | `walletIssueAssetNiaValue` / `walletIssueAssetNiaJson` and wallet-handle `issueAssetNiaValue` / `issueAssetNiaJson` | runtime-backed | Wired to `rgb-lib-wasm` `Wallet::issue_asset_nia`; legacy SDK-only `issueAssetNia*` remains compatibility-only/unsupported on wasm facade. |
-| `issue_asset_cfa` | `walletIssueAssetCfaValue` / `walletIssueAssetCfaJson` and wallet-handle `issueAssetCfaValue` / `issueAssetCfaJson` | runtime-backed | Wired via `rgb-lib-wasm` `Wallet::issue_asset_ifa` compatibility mapping; legacy SDK-only `issueAssetCfa*` remains compatibility-only/unsupported on wasm facade. |
+| `issue_asset_nia` | node/facade `issueAssetNiaValue` / `issueAssetNiaJson` | runtime-backed | Node-level adapter wired to `rgb-lib-wasm` `Wallet::issue_asset_nia`; default wallet is bootstrapped on `unlock`, auto-attached to created nodes, and lazily attached on first issuance call if missing (manual `attachWallet` still supported to override). |
+| `issue_asset_cfa` | node/facade `issueAssetCfaValue` / `issueAssetCfaJson` | runtime-backed | Node-level adapter wired via `rgb-lib-wasm` `Wallet::issue_asset_ifa` compatibility mapping; default wallet is bootstrapped on `unlock`, auto-attached to created nodes, and lazily attached on first issuance call if missing (manual `attachWallet` still supported to override). |
 | `issue_asset_uda` | `walletIssueAssetUdaValue` / `walletIssueAssetUdaJson` and wallet-handle `issueAssetUdaValue` / `issueAssetUdaJson` | unsupported-by-design | Explicit unsupported contract: `rgb-lib-wasm` currently has no UDA issuance primitive; legacy SDK-only `issueAssetUda*` remains compatibility-only/unsupported on wasm facade. |
 | `keysend` | `keysendValue` / `keysendJson` | runtime-backed | Runtime-backed payment send path enforcing native min amount parity (`SDK_HTLC_MIN_MSAT`), destination pubkey validation, RGB payload validation (`asset_id` format + `asset_amount > 0`), and no-route failure transitions through runtime payment-status events. On `ldk_bridge`, delivery requires connected destination peer state (`peer.started=true`). |
 | `send_btc` | `sendBtcBegin` + `sendBtcEnd` | runtime-backed | Two-step PSBT flow. |
@@ -160,7 +160,7 @@ The endpoints below are intentionally unsupported-by-design and have explicit ra
 |---|---|---|---|
 | UDA issuance | legacy sdk `issueAssetUdaValue/Json`; wallet surfaces `walletIssueAssetUdaValue/Json` / handle `issueAssetUdaValue/Json` | Legacy RLN issuance adapter unavailable in wasm; `rgb-lib-wasm` does not expose UDA issuance primitive. | sdk facade, sdk wallet-facade, wallet-handle |
 | Legacy grouped transfer endpoint | legacy sdk `sendRgbFromGroupsValue/Json` | Legacy grouped SDK adapter unavailable in wasm facade; runtime-backed grouped send is available on wallet surfaces (`walletSendRgbFromGroups*` / handle). | sdk facade, wallet-handle (runtime-backed path) |
-| Native host-only virtual cleanup proofs | `openChannel*` / `closeChannel*` node surfaces | Wasm runtime implements virtual draft/session lifecycle + reconciliation and now enforces best-effort preflight guards from runtime payment ledger (`pending` HTLC block + net counterparty BTC/RGB value floor checks since session creation). Full native host-only proofs that depend on filesystem RGB temp artifacts and exact counterparty floor internals are still intentionally not replicated in browser runtime. | Node-level contract tests for virtual session lifecycle + validation are present |
+| Native host-only virtual cleanup proofs | `openChannel*` / `closeChannel*` node surfaces | Wasm runtime implements virtual draft/session lifecycle + reconciliation and enforces conservative preflight guards from runtime payment ledger (`pending/claimable/claiming` HTLC block + net counterparty BTC/RGB value floor checks since session creation). Full native host-only proofs that depend on filesystem RGB temp artifacts and exact counterparty floor internals are still intentionally not replicated in browser runtime. | Node-level contract tests for virtual session lifecycle + validation are present |
 
 ## Wasm-Only Node Runtime Helpers
 

bindings/wasm-sdk/examples/wasm-interop/README.md

@@ -105,7 +105,7 @@ window.signPsbt = async (unsignedPsbt) => {
 ```
 
 In real usage, replace this with your wallet/hardware signer integration.
-5. The RGB transfer page now pre-fills defaults for:
+5. The RGB transfer page uses fixed constants in JS for:
    - `Indexer URL`: `http://127.0.0.1:3002`
    - `RGB transport endpoint`: `rpc://127.0.0.1:3000/json-rpc`
-   - sender/receiver `walletData` JSON generated at runtime via `rgbGenerateKeysValue("regtest")`
+   - sender/receiver RLN instances are initialized at runtime, each with generated keys and a generated wallet bootstrap

bindings/wasm-sdk/examples/wasm-interop/manual_js_rgb_asset_transfer.js

@@ -1,11 +1,17 @@
 import init, {
   RlnWasmInvoice,
   RlnWasmSdk,
-  rgbGenerateKeysValue,
+  rgbRestoreKeysValue,
 } from "../../pkg/rln_wasm_sdk.js";
 
 const DEFAULT_INDEXER_URL = "http://127.0.0.1:3002";
 const DEFAULT_TRANSPORT_ENDPOINT = "rpc://127.0.0.1:3000/json-rpc";
+const FIXED_LIFECYCLE_MNEMONIC =
+  "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
+const FIXED_SENDER_MNEMONIC =
+  "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
+const FIXED_RECEIVER_MNEMONIC =
+  "legal winner thank year wave sausage worth useful legal winner thank yellow";
 
 function log(message, data = undefined) {
   const out = document.getElementById("out");
@@ -33,23 +39,18 @@ function readPositiveInt(id, fallback) {
   return n;
 }
 
-function parseWalletData(id) {
-  const raw = readText(id);
-  if (!raw) {
-    throw new Error(`${id} cannot be empty`);
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (err) {
-    throw new Error(`${id} is not valid JSON: ${String(err)}`);
-  }
-  return JSON.stringify(parsed);
+function senderFundingHint(senderAddress) {
+  return {
+    sender_address: senderAddress,
+    action: "Fund this sender address on regtest and mine >= 1 block (recommended: 6).",
+    example_amount_btc: 1,
+    js_hook: "Optionally define window.regtestFund({ address, amountBtc, mineBlocks })",
+  };
 }
 
-function buildWalletDataFromGeneratedKeys(keys, role, seed) {
+function buildWalletDataFromGeneratedKeys(keys, role) {
   return {
-    data_dir: `/tmp/rln_wasm_${role}_${seed}`,
+    data_dir: `/tmp/rln_wasm_${role}_fixed`,
     bitcoin_network: "Regtest",
     database_type: "Sqlite",
     max_allocations_per_utxo: 5,
@@ -62,28 +63,20 @@ function buildWalletDataFromGeneratedKeys(keys, role, seed) {
   };
 }
 
-function ensureWalletDataInputsFilled() {
-  const senderWalletInput = document.getElementById("senderWalletData");
-  const receiverWalletInput = document.getElementById("receiverWalletData");
-  if (!senderWalletInput || !receiverWalletInput) {
-    return;
-  }
-  if (senderWalletInput.value.trim() && receiverWalletInput.value.trim()) {
-    return;
-  }
+async function createRlnInstance(role, walletMnemonic, transportEndpoint, lifecycle) {
+  const keys = rgbRestoreKeysValue("regtest", walletMnemonic);
+  const walletData = buildWalletDataFromGeneratedKeys(keys, role);
+  const walletDataJson = JSON.stringify(walletData);
 
-  const seed = Date.now().toString();
-  const senderKeys = rgbGenerateKeysValue("regtest");
-  const receiverKeys = rgbGenerateKeysValue("regtest");
-  const senderWalletData = buildWalletDataFromGeneratedKeys(senderKeys, "sender", seed);
-  const receiverWalletData = buildWalletDataFromGeneratedKeys(receiverKeys, "receiver", seed);
-
-  senderWalletInput.value = JSON.stringify(senderWalletData, null, 2);
-  receiverWalletInput.value = JSON.stringify(receiverWalletData, null, 2);
-  log("WalletData generated at runtime", {
-    sender_mnemonic_words: senderKeys.mnemonic.split(" ").length,
-    receiver_mnemonic_words: receiverKeys.mnemonic.split(" ").length,
-  });
+  const sdk = new RlnWasmSdk();
+  await sdk.initValue(lifecycle.password, lifecycle.mnemonic);
+  await sdk.unlock(JSON.stringify({ password: lifecycle.password }));
+
+  const node = sdk.createNodeHandle(transportEndpoint);
+  const wallet = await sdk.createWallet(walletDataJson);
+  node.attachWallet(wallet);
+
+  return { sdk, node, wallet };
 }
 
 async function signPsbt(unsignedPsbt) {
@@ -131,6 +124,28 @@ async function ensureRgbAllocations(walletHandle, online) {
   return after;
 }
 
+async function tryAutoFundSender(senderAddress, senderWallet, senderOnline) {
+  if (typeof window.regtestFund !== "function") {
+    return false;
+  }
+
+  await window.regtestFund({
+    address: senderAddress,
+    amountBtc: 1,
+    mineBlocks: 6,
+  });
+  await senderWallet.syncOnline(senderOnline);
+
+  const refreshed = senderWallet.getBtcBalanceValue();
+  const spendable =
+    refreshed &&
+    refreshed.vanilla &&
+    typeof refreshed.vanilla.spendable === "number"
+      ? refreshed.vanilla.spendable
+      : 0;
+  return spendable > 0;
+}
+
 function pickInvoiceString(invoiceResponse) {
   if (typeof invoiceResponse === "string") return invoiceResponse;
   if (invoiceResponse && typeof invoiceResponse.invoice === "string") {
@@ -160,30 +175,37 @@ async function run() {
 
   await init();
   log("WASM init", { ok: true });
-  ensureWalletDataInputsFilled();
 
-  const indexerUrl = readText("indexerUrl");
-  const transportEndpoint = readText("transportEndpoint");
+  const indexerUrl = DEFAULT_INDEXER_URL;
+  const transportEndpoint = DEFAULT_TRANSPORT_ENDPOINT;
   const issueAmount = readPositiveInt("issueAmount", 1000);
   const sendAmount = readPositiveInt("sendAmount", 100);
-
-  if (!indexerUrl) {
-    throw new Error("indexerUrl cannot be empty");
-  }
-  if (!transportEndpoint) {
-    throw new Error("transportEndpoint cannot be empty");
-  }
   if (sendAmount > issueAmount) {
     throw new Error("sendAmount cannot be greater than issueAmount");
   }
 
-  const senderWalletDataJson = parseWalletData("senderWalletData");
-  const receiverWalletDataJson = parseWalletData("receiverWalletData");
-
-  const sdk = new RlnWasmSdk();
-  const sender = await sdk.createWalletHandleAsync(senderWalletDataJson);
-  const receiver = await sdk.createWalletHandleAsync(receiverWalletDataJson);
-  log("Wallet handles created", { ok: true });
+  const lifecycle = {
+    password: "rln-fixed-password",
+    mnemonic: FIXED_LIFECYCLE_MNEMONIC,
+  };
+  const senderRln = await createRlnInstance(
+    "sender",
+    FIXED_SENDER_MNEMONIC,
+    transportEndpoint,
+    lifecycle
+  );
+  const receiverRln = await createRlnInstance(
+    "receiver",
+    FIXED_RECEIVER_MNEMONIC,
+    transportEndpoint,
+    lifecycle
+  );
+  const sender = senderRln.wallet;
+  const receiver = receiverRln.wallet;
+  const senderNode = senderRln.node;
+  const receiverNode = receiverRln.node;
+  log("Two RLN instances initialized and unlocked", { ok: true });
+  log("Using fixed endpoints", { indexerUrl, transportEndpoint });
   log("Wallet addresses", {
     sender_address: sender.getAddress(),
     receiver_address: receiver.getAddress(),
@@ -199,19 +221,35 @@ async function run() {
   await sender.syncOnline(senderOnline);
   await receiver.syncOnline(receiverOnline);
   log("Initial sync complete", { ok: true });
-  log("BTC balances before issue", {
+  const btcBefore = {
     sender: sender.getBtcBalanceValue(),
     receiver: receiver.getBtcBalanceValue(),
-  });
+  };
+  log("BTC balances before issue", btcBefore);
+  const senderSpendableBefore =
+    btcBefore.sender &&
+    btcBefore.sender.vanilla &&
+    typeof btcBefore.sender.vanilla.spendable === "number"
+      ? btcBefore.sender.vanilla.spendable
+      : 0;
+  if (senderSpendableBefore <= 0) {
+    const senderAddress = sender.getAddress();
+    const fundedViaHook = await tryAutoFundSender(senderAddress, sender, senderOnline);
+    if (!fundedViaHook) {
+      log("Sender wallet requires regtest funding", senderFundingHint(senderAddress));
+      throw new Error("Sender spendable BTC is zero. Fund sender wallet and rerun.");
+    }
+    log("Sender auto-funded via window.regtestFund", { ok: true });
+  }
   await ensureRgbAllocations(sender, senderOnline);
 
   const issueReq = {
     ticker: "TST",
-    name: "WASM RGB Demo",
+    name: "WASM RLN Demo",
     precision: 0,
     amounts: [issueAmount],
   };
-  const issued = sender.issueAssetNiaValue(issueReq);
+  const issued = senderNode.issueAssetNiaValue(issueReq);
   const assetId = issued.asset_id;
   log("Asset issued", issued);
 
@@ -228,6 +266,7 @@ async function run() {
   const invoiceObj = new RlnWasmInvoice(invoiceString);
   const invoiceData = invoiceObj.invoiceDataValue();
   log("Decoded RGB invoice", invoiceData);
+  log("Receiver node info", receiverNode.nodeInfoValue());
 
   const recipient = {
     recipient_id: invoiceData.recipient_id || invoiceData.recipientId,
@@ -275,38 +314,3 @@ if (runBtn) {
     });
   });
 }
-
-const indexerInput = document.getElementById("indexerUrl");
-if (indexerInput && !indexerInput.value.trim()) {
-  indexerInput.value = DEFAULT_INDEXER_URL;
-}
-
-const transportInput = document.getElementById("transportEndpoint");
-if (transportInput && !transportInput.value.trim()) {
-  transportInput.value = DEFAULT_TRANSPORT_ENDPOINT;
-}
-
-const senderWalletInput = document.getElementById("senderWalletData");
-const receiverWalletInput = document.getElementById("receiverWalletData");
-if (
-  senderWalletInput &&
-  receiverWalletInput &&
-  !senderWalletInput.value.trim() &&
-  !receiverWalletInput.value.trim()
-) {
-  // Generate once on page load for convenience.
-  // A new runtime-generated pair will also be created in run() when fields are empty.
-  const seed = Date.now().toString();
-  const senderKeys = rgbGenerateKeysValue("regtest");
-  const receiverKeys = rgbGenerateKeysValue("regtest");
-  senderWalletInput.value = JSON.stringify(
-    buildWalletDataFromGeneratedKeys(senderKeys, "sender", seed),
-    null,
-    2
-  );
-  receiverWalletInput.value = JSON.stringify(
-    buildWalletDataFromGeneratedKeys(receiverKeys, "receiver", seed),
-    null,
-    2
-  );
-}

bindings/wasm-sdk/examples/wasm-interop/rgb_asset_transfer_flow.html

@@ -42,25 +42,11 @@
   <body>
     <h1>RLN WASM RGB Asset Transfer Flow</h1>
     <p>
-      Browser PoC for wallet-level RGB transfer: <code>issueAssetNia</code> ->
+      Browser PoC for two RLN instances (sender + receiver): <code>issueAssetNia</code> ->
       <code>blindReceive</code> -> <code>sendBegin</code> -> sign PSBT ->
       <code>sendEnd</code>.
     </p>
 
-    <div class="row">
-      <label for="indexerUrl">Indexer URL</label>
-      <input id="indexerUrl" type="text" value="http://127.0.0.1:3002" />
-    </div>
-
-    <div class="row">
-      <label for="transportEndpoint">RGB transport endpoint</label>
-      <input
-        id="transportEndpoint"
-        type="text"
-        value="rpc://127.0.0.1:3000/json-rpc"
-      />
-    </div>
-
     <div class="row">
       <label for="issueAmount">Issue amount</label>
       <input id="issueAmount" type="number" value="1000" />
@@ -71,16 +57,6 @@ <h1>RLN WASM RGB Asset Transfer Flow</h1>
       <input id="sendAmount" type="number" value="100" />
     </div>
 
-    <div class="row">
-      <label for="senderWalletData">Sender walletData JSON</label>
-      <textarea id="senderWalletData" placeholder="Leave empty to auto-generate at runtime"></textarea>
-    </div>
-
-    <div class="row">
-      <label for="receiverWalletData">Receiver walletData JSON</label>
-      <textarea id="receiverWalletData" placeholder="Leave empty to auto-generate at runtime"></textarea>
-    </div>
-
     <div class="row">
       <button id="run">Run RGB Transfer Flow</button>
     </div>

bindings/wasm-sdk/src/ldk_runtime.rs

@@ -1263,12 +1263,9 @@ pub fn scaffold_ldk_runtime_manager(runtime_key: String) -> Rc<dyn LdkRuntimeMan
 }
 
 #[cfg(test)]
-pub fn reset_scaffold_runtime_storage_for_tests() {
-    SCAFFOLD_RUNTIME_STORAGE.with(|storage| storage.borrow_mut().clear());
-    RUNTIME_SESSION_AUTHORITY_STATE.with(|state| {
-        *state.borrow_mut() = RuntimeSessionAuthorityState::default();
-    });
-}
+mod test_utils;
+#[cfg(test)]
+pub(crate) use test_utils::reset_scaffold_runtime_storage_for_tests;
 
 #[cfg(test)]
 mod tests;

bindings/wasm-sdk/src/ldk_runtime/test_utils.rs

@@ -0,0 +1,8 @@
+use super::*;
+
+pub fn reset_scaffold_runtime_storage_for_tests() {
+    SCAFFOLD_RUNTIME_STORAGE.with(|storage| storage.borrow_mut().clear());
+    RUNTIME_SESSION_AUTHORITY_STATE.with(|state| {
+        *state.borrow_mut() = RuntimeSessionAuthorityState::default();
+    });
+}