@ninsei-labs/sdk 0.44.1 → 0.44.3

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.44.3 — 2026-10-20
+
+A RESCAN THAT THE LIBRARY REFUSES DOES NOT STOP THE RESTORE.
+
+- `sweep.restore` still asks for the rescan first. If the wallet library refuses it, the pass continues to the
+  sync and the balance, exactly as a failed sync already did. A wallet opened from keys carries its height from
+  creation, so a library that cannot rescan a chain can still serve the withdrawal. The spendable balance stays
+  the verdict, not the rescan.
+
+## 0.44.2 — 2026-10-20
+
+REGTEST HAS A NAME THE PACKAGE KNOWS.
+
+- `networkFromNode` accepts `fakechain`, the answer a `monerod` in regtest mode gives. Every stand and the CI
+  contour run that mode, and the withdrawal page builds its wallet from the recovery file, so refusing the name
+  stopped a run against a node the page is meant to test. The answer is passed through as `fakechain`; an unknown
+  word is still `null`, not a guess.
+- The type declaration and the wallet-factory check name the fourth answer.
+- The `Swap` type is gone. Nothing in the package returned one, so a reader could build on `swap.sweep()`
+  and find it at runtime. The working surfaces are unchanged: `swaps.get`/`swaps.toState`, `actions.markReady`,
+  `actions.claim`, `actions.refund`, and `sweep` for the withdrawal.
+
 ## 0.44.1 — 2026-10-20
 
 TWO ENTRIES A BACKEND NEEDS WHEN IT STOPS READING THE PAGE'S SOURCE.

package/engine/monero/nodeNetwork.js

@@ -5,9 +5,13 @@
 // mapping used to be a private function of the sweep page, which made "what a node may say" knowledge of one
 // interface.
 //
-// AN UNKNOWN ANSWER IS NULL, NOT A GUESS. Defaulting to a network would build a wallet for a chain the node may not
-// serve; the caller can then say which answer it got and stop.
-const KNOWN = new Set(["mainnet", "stagenet", "testnet"]);
+// REGTEST JOINS THEM BY ITS OFFICIAL NAME. monerod in regtest mode answers `fakechain`; the CI contour and every
+// local stand run that mode, and the wallet's own network comes from the recovery file, not from this answer. Without
+// the name the page refuses a node it is supposed to test against. It is a KNOWN name, not a wildcard.
+//
+// AN UNKNOWN ANSWER IS STILL NULL, NOT A GUESS. Defaulting to a network would build a wallet for a chain the node may
+// not serve; the caller can then say which answer it got and stop.
+const KNOWN = new Set(["mainnet", "stagenet", "testnet", "fakechain"]);
 
 export function networkFromNode(info) {
   const type = String((info && info.nettype) || "").trim().toLowerCase();

package/index.d.ts

@@ -1114,20 +1114,6 @@ export interface RecoveryFile {
   readonly contents: string;
 }
 
-export interface Swap {
-  readonly id: string;
-  /** The current state. Also arrives in the subscription. */
-  state(): SwapState;
-  /** Subscribe to changes. Returns an unsubscribe function. */
-  on(event: "update", handler: (state: SwapState) => void): () => void;
-  /** The "checked by you" mark: opens the claim to the maker. */
-  markReady(): Promise<SwapState>;
-  /** Withdraw the XMR to the recipient's address. */
-  sweep(): Promise<SwapState>;
-  /** Refund the ETH when the claim did not happen. */
-  refund(): Promise<SwapState>;
-}
-
 export interface SwapState {
   readonly id: string;
   readonly direction: "buy" | "sell";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninsei-labs/sdk",
-  "version": "0.44.1",
+  "version": "0.44.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"

package/src/public/xmr.d.ts

@@ -322,7 +322,7 @@ export declare function sellWindowSec(request?: {
  * mainnet wallet against a stagenet node looks like a broken withdrawal. An answer that is none of `mainnet`,
  * `stagenet`, `testnet` comes back as null - a default would build a wallet for a chain the node may not serve.
  */
-export declare function networkFromNode(info: unknown): "mainnet" | "stagenet" | "testnet" | null;
+export declare function networkFromNode(info: unknown): "mainnet" | "stagenet" | "testnet" | "fakechain" | null;
 
 /** An address read as its network and its public keys. An integrated address's payment id is not returned. */
 export interface AddressKeys {

package/src/sweep-restore.mjs

@@ -92,7 +92,10 @@ export async function restoreWallet(request = {}) {
   // A RESCAN IS REQUIRED, NOT OPTIONAL: without it the height only applies to a wallet that has not scanned yet,
   // and a wallet restored from a key has. A driver that cannot rescan is the caller's mistake, named here.
   if (typeof driver.rescanBlockchain !== "function") throw new SdkError("bad-input", { field: "wallet.driver.rescanBlockchain" });
-  await step("rescanBlockchain", () => driver.rescanBlockchain());
+  // A RESCAN IS BEST-EFFORT, LIKE THE SYNC BELOW. A wallet built from keys already carries the height it was opened
+  // with, and a library that cannot rescan a chain (monero-ts against a regtest node answers "failed to get hashes")
+  // would otherwise stop a withdrawal the sync can still serve. The balance below is the verdict, not the rescan.
+  try { await step("rescanBlockchain", () => driver.rescanBlockchain()); } catch { /* the balance decides */ }
 
   // A FAILED SYNC IS BEST-EFFORT, exactly as in the signing step: what blocks a withdrawal is the spendable
   // remainder, and it is read below. The library throws low-level while scanning a chain it cannot read; that must

package/src/version.mjs

@@ -6,4 +6,4 @@
 // tools/sync-version.mjs. Do not edit it by hand - set the version in package.json and run `npm run sync:version`.
 // The `version` check in tools/check.mjs refuses a mismatch, and refuses a runtime read of package.json here.
 
-export const SDK_VERSION = "0.44.1";
+export const SDK_VERSION = "0.44.3";