@owney/sdk 0.7.26-beta.5 → 0.7.26-beta.7

package/dist/index.cjs

@@ -26,10 +26,15 @@ __export(index_exports, {
   NotConnectedError: () => NotConnectedError,
   OwneyError: () => OwneyError,
   OwneySDK: () => OwneySDK,
+  clearWithdrawSwap: () => clearWithdrawSwap,
   createOwneySIWX: () => createOwneySIWX,
   listPendingDeposits: () => listPendingDeposits,
   listPendingSwaps: () => listOrders,
-  setOwneyDebug: () => setOwneyDebug
+  listWithdrawSwaps: () => listWithdrawSwaps,
+  saveWithdrawSwap: () => saveWithdrawSwap,
+  setOwneyDebug: () => setOwneyDebug,
+  subscribeWithdrawSwaps: () => subscribeWithdrawSwaps,
+  updateWithdrawSwap: () => updateWithdrawSwap
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -298,6 +303,15 @@ var DayFilterMapping = {
   "7D": 7
 };
 
+// src/lib/helpers/asset-aliases.ts
+function assetAliases(asset) {
+  const normalised = asset.toLowerCase();
+  return normalised === "weth" ? ["weth", "eth"] : [normalised];
+}
+function matchesAsset(symbol, asset) {
+  return assetAliases(asset).includes(symbol.toLowerCase());
+}
+
 // src/agents/zyfai/zyfai.mapper.ts
 var DECIMALS_BY_SYMBOL = {
   usdc: 6,
@@ -702,9 +716,8 @@ function computeAllocationApy(positions) {
 function earningsForToken(bucket, chainId, asset) {
   const tokens = bucket?.[String(chainId)];
   if (!tokens) return null;
-  const wanted = asset.toUpperCase();
   for (const [symbol, value] of Object.entries(tokens)) {
-    if (symbol.toUpperCase() !== wanted) continue;
+    if (!matchesAsset(symbol, asset)) continue;
     const amount = Number(value);
     return Number.isFinite(amount) ? amount : null;
   }
@@ -2329,7 +2342,7 @@ function createSwapApi(baseUrl, apiKey) {
       baseUrl,
       apiKey,
       `/tokens/search?${new URLSearchParams({
-        query: params.query,
+        ...params.query === void 0 ? {} : { query: params.query },
         // Omitted, the routing API searches every supported chain — which is
         // what a picker wants, since its rows already span all three.
         ...params.chainId === void 0 ? {} : { chainId: String(params.chainId) },
@@ -3122,6 +3135,10 @@ async function runSameChainFusion(deps, options, walletAddress) {
     quoteId: built.quoteId,
     ...built.extension ? { extension: built.extension } : {}
   });
+  try {
+    options.onOrderSubmitted?.(built.orderHash);
+  } catch {
+  }
   await runSameChainOrder(deps.sameChainRunner ?? deps.runner, {
     orderHash: built.orderHash,
     ...onStage ? { onStage } : {}
@@ -3220,6 +3237,10 @@ async function runFusion(deps, options, walletAddress) {
     ...built.extension ? { extension: built.extension } : {}
   });
   debugLog("owney-sdk", "swap: order submitted, polling escrows");
+  try {
+    options.onOrderSubmitted?.(built.orderHash);
+  } catch {
+  }
   try {
     await runFusionOrder(deps.runner, {
       orderHash: built.orderHash,
@@ -3334,8 +3355,8 @@ async function buildErc2612Permit(reads, input) {
   );
 }
 
-// src/lib/swap/swap.pending-deposit.ts
-var KEY_PREFIX3 = "owney.swap.pending-deposit";
+// src/lib/swap/swap.withdraw-swap.ts
+var KEY_PREFIX3 = "owney.swap.withdraw";
 var MAX_AGE_MS2 = 24 * 60 * 60 * 1e3;
 var storage3 = () => {
   if (typeof window === "undefined") return null;
@@ -3345,26 +3366,60 @@ var storage3 = () => {
     return null;
   }
 };
-var keyFor2 = (id) => `${KEY_PREFIX3}.${id}`;
-function savePendingDeposit(entry) {
+var keyFor2 = (orderHash) => `${KEY_PREFIX3}.${orderHash}`;
+var listeners = /* @__PURE__ */ new Set();
+function subscribeWithdrawSwaps(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+var notify = () => {
+  for (const listener of listeners) {
+    try {
+      listener();
+    } catch {
+    }
+  }
+};
+function saveWithdrawSwap(record) {
   const store = storage3();
   if (!store) return;
   try {
-    store.setItem(keyFor2(entry.id), JSON.stringify(entry));
+    store.setItem(keyFor2(record.orderHash), JSON.stringify(record));
   } catch {
     return;
   }
+  notify();
 }
-function clearPendingDeposit(id) {
+function updateWithdrawSwap(orderHash, patch) {
   const store = storage3();
   if (!store) return;
   try {
-    store.removeItem(keyFor2(id));
+    const raw = store.getItem(keyFor2(orderHash));
+    if (!raw) return;
+    const current = JSON.parse(raw);
+    const next = { ...current, ...patch };
+    if (next.status !== "swapping" && current.status === "swapping" && next.settledAt === void 0) {
+      next.settledAt = Date.now();
+    }
+    store.setItem(keyFor2(orderHash), JSON.stringify(next));
   } catch {
     return;
   }
+  notify();
 }
-function listPendingDeposits(now = Date.now()) {
+function clearWithdrawSwap(orderHash) {
+  const store = storage3();
+  if (!store) return;
+  try {
+    store.removeItem(keyFor2(orderHash));
+  } catch {
+    return;
+  }
+  notify();
+}
+function listWithdrawSwaps(now = Date.now()) {
   const store = storage3();
   if (!store) return [];
   const out = [];
@@ -3394,6 +3449,66 @@ function listPendingDeposits(now = Date.now()) {
   return out.sort((a, b) => b.createdAt - a.createdAt);
 }
 
+// src/lib/swap/swap.pending-deposit.ts
+var KEY_PREFIX4 = "owney.swap.pending-deposit";
+var MAX_AGE_MS3 = 24 * 60 * 60 * 1e3;
+var storage4 = () => {
+  if (typeof window === "undefined") return null;
+  try {
+    return window.localStorage;
+  } catch {
+    return null;
+  }
+};
+var keyFor3 = (id) => `${KEY_PREFIX4}.${id}`;
+function savePendingDeposit(entry) {
+  const store = storage4();
+  if (!store) return;
+  try {
+    store.setItem(keyFor3(entry.id), JSON.stringify(entry));
+  } catch {
+    return;
+  }
+}
+function clearPendingDeposit(id) {
+  const store = storage4();
+  if (!store) return;
+  try {
+    store.removeItem(keyFor3(id));
+  } catch {
+    return;
+  }
+}
+function listPendingDeposits(now = Date.now()) {
+  const store = storage4();
+  if (!store) return [];
+  const out = [];
+  try {
+    const keys = [];
+    for (let i = 0; i < store.length; i++) {
+      const key2 = store.key(i);
+      if (key2?.startsWith(`${KEY_PREFIX4}.`)) keys.push(key2);
+    }
+    for (const key2 of keys) {
+      const raw = store.getItem(key2);
+      if (!raw) continue;
+      try {
+        const parsed = JSON.parse(raw);
+        if (now - parsed.createdAt > MAX_AGE_MS3) {
+          store.removeItem(key2);
+          continue;
+        }
+        out.push(parsed);
+      } catch {
+        store.removeItem(key2);
+      }
+    }
+  } catch {
+    return out;
+  }
+  return out.sort((a, b) => b.createdAt - a.createdAt);
+}
+
 // src/lib/health-report.ts
 var ROUTING_API_BASE_URL2 = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function reportAgentFailure(apiKey, agentType, errorCode, baseUrl = ROUTING_API_BASE_URL2) {
@@ -3430,11 +3545,10 @@ async function withFailureReporting(apiKey, agentType, fn, baseUrl) {
 // src/lib/helpers/withdraw-helper.ts
 var import_viem6 = require("viem");
 function projectAgentBalancesForAsset(agents, aggregated, chainId, asset, decimals) {
-  const target = asset.toUpperCase();
   return agents.map((agent) => {
     const agentBalance = aggregated[agent.id];
     const tokenBalance = agentBalance?.tokens.find(
-      (t) => t.chainId === chainId && t.asset.toUpperCase() === target
+      (t) => t.chainId === chainId && matchesAsset(t.asset, asset)
     );
     if (!tokenBalance) return { agent, balance: 0n };
     return { agent, balance: (0, import_viem6.parseUnits)(tokenBalance.amount, decimals) };
@@ -4735,15 +4849,14 @@ var OwneySDK = class {
   async hasExistingBalance(agent, state, chainId, asset, requireReliableRead = false) {
     try {
       const balance = await agent.getBalances(state, chainId);
-      const target = asset.toLowerCase();
       const token = balance.tokens.find(
-        (t) => t.chainId === chainId && t.asset.toLowerCase() === target
+        (t) => t.chainId === chainId && matchesAsset(t.asset, asset)
       );
       const targetChainName = agent.supportedAssets.find((entry) => entry.chainId === chainId)?.chain?.trim().toUpperCase();
       const position = (balance.positions ?? []).find((p) => {
         const positionChain = p.chain.trim().toUpperCase();
         const matchesChain = positionChain === String(chainId) || targetChainName !== void 0 && positionChain === targetChainName;
-        return matchesChain && p.asset.toLowerCase() === target && Number(p.amount) > 0;
+        return matchesChain && matchesAsset(p.asset, asset) && Number(p.amount) > 0;
       });
       return !!token && Number(token.amount) > 0 || !!position;
     } catch (error) {
@@ -5148,6 +5261,25 @@ var OwneySDK = class {
   listPendingDeposits() {
     return listPendingDeposits();
   }
+  /**
+   * Backgrounded withdrawal swaps and how they ended, newest first.
+   *
+   * Nothing to act on — unlike `listPendingDeposits`, which describes a job the
+   * user can finish. This is a watch: the funds are in escrow and the only
+   * open question is where they land. See `swap.withdraw-swap.ts`.
+   */
+  listWithdrawSwaps() {
+    return listWithdrawSwaps();
+  }
+  /**
+   * Retire a settled record. The user has read the outcome.
+   *
+   * Only they do this — a record that disappears on its own takes with it the
+   * only thing telling someone where their money went.
+   */
+  dismissWithdrawSwap(orderHash) {
+    clearWithdrawSwap(orderHash);
+  }
   /**
    * Deposit a swap that already landed.
    *
@@ -5194,7 +5326,10 @@ var OwneySDK = class {
    */
   async resumePendingSwaps(options = {}) {
     const pending = listOrders();
-    if (pending.length === 0) return [];
+    if (pending.length === 0) {
+      await this.resumeSameChainSwaps(options);
+      return [];
+    }
     const runner = this.swapRunnerDeps();
     const results = [];
     for (const order of pending) {
@@ -5208,6 +5343,7 @@ var OwneySDK = class {
           } : {}
         });
         clearOrder(order.orderHash);
+        updateWithdrawSwap(order.orderHash, { status: "landed" });
         results.push({
           orderHash: order.orderHash,
           status: "completed"
@@ -5215,6 +5351,9 @@ var OwneySDK = class {
       } catch (error) {
         if (error instanceof OwneyError && (error.code === "SWAP_ORDER_REFUNDED" || error.code === "SWAP_ORDER_CANCELLED")) {
           clearOrder(order.orderHash);
+          updateWithdrawSwap(order.orderHash, { status: "refunded" });
+        } else {
+          updateWithdrawSwap(order.orderHash, { status: "unknown" });
         }
         results.push({
           orderHash: order.orderHash,
@@ -5223,8 +5362,56 @@ var OwneySDK = class {
         });
       }
     }
+    await this.resumeSameChainSwaps(options);
     return results;
   }
+  /**
+   * Pick up SAME-CHAIN orders a previous session left in the auction.
+   *
+   * They are not in the secret store and never will be: that store exists to
+   * keep preimages, and a same-chain fill needs none — the resolver takes the
+   * maker's tokens and delivers the taker's in one transaction. So the only
+   * record of one is the withdrawal record itself, which carries the order
+   * hash, and that is all a resume needs here.
+   *
+   * Gentler than the Fusion+ case in the way that matters. Nothing is
+   * escrowed, so an order nobody ever picks up leaves the wallet exactly as it
+   * was — this is catching up on news, not rescuing funds.
+   *
+   * Same-chain is read off the record rather than stored as a rail: a
+   * withdrawal whose source and destination share a chain could not have been
+   * anything else.
+   */
+  async resumeSameChainSwaps(options = {}) {
+    const running = listWithdrawSwaps().filter(
+      (record) => record.status === "swapping" && record.srcChainId === record.dstChainId
+    );
+    for (const record of running) {
+      const runner = {
+        // The chain bound in. That product keys its orders per chain, and the
+        // Fusion+ endpoint answers 404 for one — which would read as an order
+        // that vanished rather than one still in the auction.
+        orderStatus: (h) => this.swapApi().orderStatus(h, record.srcChainId),
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        now: () => Date.now()
+      };
+      try {
+        await runSameChainOrder(runner, {
+          orderHash: record.orderHash,
+          ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+          ...options.onStage ? {
+            onStage: (stage) => options.onStage(record.orderHash, stage)
+          } : {}
+        });
+        updateWithdrawSwap(record.orderHash, { status: "landed" });
+      } catch (error) {
+        const code = error instanceof OwneyError ? error.code : void 0;
+        updateWithdrawSwap(record.orderHash, {
+          status: code === "SWAP_ORDER_EXPIRED" || code === "SWAP_ORDER_CANCELLED" ? "refunded" : "unknown"
+        });
+      }
+    }
+  }
   /**
    * What the wallet actually holds, across every supported chain, restricted
    * to tokens a swap could use.
@@ -5271,13 +5458,16 @@ var OwneySDK = class {
    * tokens can share a ticker, and `providers` (how many token lists carry the
    * address) is the only usable signal for telling them apart. Surface it.
    *
-   * Returns nothing for a blank query rather than asking for the whole list.
+   * A blank query WITH a chainId lists that chain's catalogue instead of
+   * searching it — what a picker wants when someone selects a chain before
+   * typing anything. Blank with no chain returns nothing: that would be asking
+   * for the top of every catalogue at once, which is a download, not a list.
    */
   async searchSwapTokens(params) {
-    const query = params.query.trim();
-    if (!query) return { tokens: [] };
+    const query = params.query?.trim() ?? "";
+    if (!query && params.chainId === void 0) return { tokens: [] };
     return this.swapApi().searchTokens({
-      query,
+      ...query ? { query } : {},
       ...params.chainId === void 0 ? {} : { chainId: params.chainId },
       ...params.limit === void 0 ? {} : { limit: params.limit },
       ...params.direction === void 0 ? {} : { direction: params.direction }
@@ -5457,7 +5647,14 @@ var OwneySDK = class {
         walletAddress: state.walletAddress,
         direction: "withdraw",
         ...options.slippage === void 0 ? {} : { slippage: options.slippage },
-        ...options.onSwapProgress ? { onStage: options.onSwapProgress } : {}
+        ...options.onSwapProgress ? { onStage: options.onSwapProgress } : {},
+        ...options.onOrderSubmitted ? {
+          onOrderSubmitted: (orderHash) => options.onOrderSubmitted({
+            orderHash,
+            withdrawn,
+            expected: quote.dst.amount
+          })
+        } : {}
       });
       return { withdraw, withdrawn, swap };
     } catch (error) {
@@ -6216,8 +6413,8 @@ var import_siwe = require("siwe");
 var import_sdk2 = require("@zyfai/sdk");
 
 // src/agents/zyfai/zyfai.siwx-cache.ts
-var KEY_PREFIX4 = "owney.siwx.session";
-var storage4 = () => {
+var KEY_PREFIX5 = "owney.siwx.session";
+var storage5 = () => {
   if (typeof window === "undefined") return null;
   try {
     return window.localStorage;
@@ -6225,8 +6422,8 @@ var storage4 = () => {
     return null;
   }
 };
-var buildKey2 = (address) => `${KEY_PREFIX4}:${address.toLowerCase()}`;
-var legacyKeyPrefix2 = (address) => `${KEY_PREFIX4}:${address.toLowerCase()}:`;
+var buildKey2 = (address) => `${KEY_PREFIX5}:${address.toLowerCase()}`;
+var legacyKeyPrefix2 = (address) => `${KEY_PREFIX5}:${address.toLowerCase()}:`;
 var memorySiwxSessions = /* @__PURE__ */ new Map();
 var readLegacySiwxSession = (store, address) => {
   if (!store) return null;
@@ -6258,7 +6455,7 @@ var readLegacySiwxSession = (store, address) => {
 var readSiwxSession = (address, chainId) => {
   if (typeof window === "undefined") return null;
   const key2 = buildKey2(address);
-  const store = storage4();
+  const store = storage5();
   let raw = null;
   try {
     raw = store?.getItem(key2) ?? null;
@@ -6288,7 +6485,7 @@ var writeSiwxSession = (address, _chainId, session) => {
   if (typeof window === "undefined") return;
   const key2 = buildKey2(address);
   memorySiwxSessions.set(key2, session);
-  const store = storage4();
+  const store = storage5();
   try {
     store?.setItem(key2, JSON.stringify(session));
   } catch {
@@ -6297,7 +6494,7 @@ var writeSiwxSession = (address, _chainId, session) => {
 var clearSiwxSession = (address, _chainId) => {
   const key2 = buildKey2(address);
   memorySiwxSessions.delete(key2);
-  const store = storage4();
+  const store = storage5();
   try {
     store?.removeItem(key2);
   } catch {
@@ -6430,8 +6627,13 @@ function createOwneySIWX(config) {
   NotConnectedError,
   OwneyError,
   OwneySDK,
+  clearWithdrawSwap,
   createOwneySIWX,
   listPendingDeposits,
   listPendingSwaps,
-  setOwneyDebug
+  listWithdrawSwaps,
+  saveWithdrawSwap,
+  setOwneyDebug,
+  subscribeWithdrawSwaps,
+  updateWithdrawSwap
 });

package/dist/index.d.cts

@@ -785,6 +785,94 @@ declare class AgentChainIncompatibleError extends OwneyError {
     }>, connectedChainId: number);
 }
 
+/**
+ * Withdrawal swaps the user has walked away from, and how they ended.
+ *
+ * The deposit side has `swap.pending-deposit.ts` for the same shape of
+ * problem, but the two are not symmetrical. A pending deposit is a JOB: the
+ * money is in the wallet and an ordinary deposit finishes it. This is a
+ * WATCH — the funds are in escrow, nothing the user does moves them along,
+ * and the only question is where they ended up.
+ *
+ * That is the whole reason this exists. `withdrawAndSwap` used to hold the
+ * screen for the entire escrow lifecycle, which on a slow mainnet fill is
+ * minutes of a modal the user cannot leave (ROUT-242). Backgrounding it means
+ * the outcome arrives after the UI that started it has gone, so the outcome
+ * has to be written down somewhere the next render can find it.
+ *
+ * Only cross-chain swaps are recorded. A same-chain classic swap is one
+ * transaction and resolves in seconds; a same-chain fusion order has no stored
+ * preimages, so there would be nothing for a reloaded session to resume and
+ * the record would sit at `swapping` for ever.
+ *
+ * Kept deliberately separate from the secret store. Secrets are retired the
+ * moment an order reaches a verdict — that is a safety property, not a display
+ * one — and the record has to outlive them so the user can still be told what
+ * happened after they come back.
+ */
+/**
+ * `swapping` is the only non-terminal state. `unknown` is what a watch that
+ * gave up looks like: we stopped polling before the order spoke, so the order
+ * may well have filled. It is not a failure, and it must never be shown as
+ * one.
+ */
+type WithdrawSwapStatus = "swapping" | "landed" | "refunded" | "unknown";
+type WithdrawSwapRecord = {
+    /** Identity. One record per Fusion+ order. */
+    orderHash: string;
+    status: WithdrawSwapStatus;
+    /**
+     * What actually left the agent, smallest unit of the SOURCE asset.
+     *
+     * The measured figure, not the requested one — a "MAX" withdrawal has no
+     * requested figure at all, and this is what a refund gives back.
+     */
+    withdrawn: string;
+    srcSymbol: string;
+    srcChainId: number;
+    srcDecimals: number;
+    /**
+     * What the quote expected to arrive, smallest unit of the DESTINATION.
+     *
+     * `dst.amount` — the auction's start, not its floor. The bar reads "about",
+     * and quoting the floor understated every completed withdrawal by half a
+     * percent (ROUT-242, comment 16056).
+     */
+    expected: string;
+    dstSymbol: string;
+    dstChainId: number;
+    dstDecimals: number;
+    /** Measured arrival. Set only on `landed`, and shown in place of `expected`. */
+    received?: string;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Epoch ms, set when the status stopped being `swapping`. */
+    settledAt?: number;
+};
+declare function subscribeWithdrawSwaps(listener: () => void): () => void;
+/**
+ * Write the record as the order is submitted, alongside the secrets.
+ *
+ * Not after the swap resolves: the point is to survive the gap between submit
+ * and settle, which is exactly when the user closes the tab.
+ */
+declare function saveWithdrawSwap(record: WithdrawSwapRecord): void;
+/**
+ * Move a record to its outcome.
+ *
+ * A no-op for an order with no record, which is the normal case for deposit
+ * swaps — they share the secret store and so pass through the same resume
+ * loop, but they are not withdrawals and were never recorded here.
+ *
+ * `settledAt` is stamped here rather than by the caller so every writer agrees
+ * on what "settled" means: the moment the status stopped being `swapping`.
+ */
+declare function updateWithdrawSwap(orderHash: string, patch: Partial<Omit<WithdrawSwapRecord, "orderHash">>): void;
+/** The user has read the outcome. Only they do this. */
+declare function clearWithdrawSwap(orderHash: string): void;
+/** Every record, newest first, sweeping anything past MAX_AGE_MS. */
+declare function listWithdrawSwaps(now?: number): WithdrawSwapRecord[];
+
 /**
  * Swaps that landed but were never deposited.
  *
@@ -1071,6 +1159,21 @@ declare class OwneySDK {
      * describe. See `completePendingDeposit`.
      */
     listPendingDeposits(): ReturnType<typeof listPendingDeposits>;
+    /**
+     * Backgrounded withdrawal swaps and how they ended, newest first.
+     *
+     * Nothing to act on — unlike `listPendingDeposits`, which describes a job the
+     * user can finish. This is a watch: the funds are in escrow and the only
+     * open question is where they land. See `swap.withdraw-swap.ts`.
+     */
+    listWithdrawSwaps(): WithdrawSwapRecord[];
+    /**
+     * Retire a settled record. The user has read the outcome.
+     *
+     * Only they do this — a record that disappears on its own takes with it the
+     * only thing telling someone where their money went.
+     */
+    dismissWithdrawSwap(orderHash: string): void;
     /**
      * Deposit a swap that already landed.
      *
@@ -1106,6 +1209,24 @@ declare class OwneySDK {
         status: "completed" | "unfinished";
         error?: OwneyError;
     }[]>;
+    /**
+     * Pick up SAME-CHAIN orders a previous session left in the auction.
+     *
+     * They are not in the secret store and never will be: that store exists to
+     * keep preimages, and a same-chain fill needs none — the resolver takes the
+     * maker's tokens and delivers the taker's in one transaction. So the only
+     * record of one is the withdrawal record itself, which carries the order
+     * hash, and that is all a resume needs here.
+     *
+     * Gentler than the Fusion+ case in the way that matters. Nothing is
+     * escrowed, so an order nobody ever picks up leaves the wallet exactly as it
+     * was — this is catching up on news, not rescuing funds.
+     *
+     * Same-chain is read off the record rather than stored as a rail: a
+     * withdrawal whose source and destination share a chain could not have been
+     * anything else.
+     */
+    private resumeSameChainSwaps;
     /**
      * What the wallet actually holds, across every supported chain, restricted
      * to tokens a swap could use.
@@ -1137,12 +1258,16 @@ declare class OwneySDK {
      * tokens can share a ticker, and `providers` (how many token lists carry the
      * address) is the only usable signal for telling them apart. Surface it.
      *
-     * Returns nothing for a blank query rather than asking for the whole list.
+     * A blank query WITH a chainId lists that chain's catalogue instead of
+     * searching it — what a picker wants when someone selects a chain before
+     * typing anything. Blank with no chain returns nothing: that would be asking
+     * for the top of every catalogue at once, which is a download, not a list.
      */
     searchSwapTokens(params: {
-        /** Omit to search every supported chain. */
+        /** Omit to search every supported chain. Required to list one. */
         chainId?: number;
-        query: string;
+        /** Omit, with a chainId, to list the chain rather than search it. */
+        query?: string;
         limit?: number;
         /**
          * Which picker is asking. A withdrawal ends in the user's own wallet, so
@@ -1246,6 +1371,32 @@ declare class OwneySDK {
         /** Percent, classic rail only. Fusion+ prices through its auction. */
         slippage?: number;
         onSwapProgress?: (stage: SwapStage) => void;
+        /**
+         * Fires once the order is with the relayer, before the watch.
+         *
+         * Both resolver-filled rails reach it — cross-chain Fusion+ and the
+         * same-chain auction. Not the classic rail, which is one transaction with
+         * no order behind it and resolves in seconds either way.
+         *
+         * The seam a backgrounded withdrawal hangs off. Up to here the flow needs
+         * the user in front of it; past here it is polling that a later page load
+         * can take over — from the stored preimages on Fusion+, and from the
+         * order hash alone on the same-chain rail. So a caller may stop awaiting
+         * this promise and let the screen go. See `swap.withdraw-swap.ts` for what
+         * the caller should write down when it does.
+         *
+         * Carries the two figures a status bar cannot get anywhere else. The
+         * withdrawal has already happened by this point and `withdrawn` is what
+         * MEASURABLY arrived, which on a "MAX" withdrawal is the only figure that
+         * exists — and it is also what comes back if the order never fills.
+         */
+        onOrderSubmitted?: (submitted: {
+            orderHash: string;
+            /** Smallest unit of the agent's asset. */
+            withdrawn: string;
+            /** Smallest unit of the destination — the auction's start, not its floor. */
+            expected: string;
+        }) => void;
         /** How long to wait for the withdrawal to land before giving up on the swap. */
         arrivalTimeoutMs?: number;
     }): Promise<{
@@ -1447,4 +1598,4 @@ type StoredOrder = {
  */
 declare function listOrders(now?: number): StoredOrder[];
 
-export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type PendingDeposit, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type WithdrawOptions, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type PendingDeposit, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.d.ts

@@ -785,6 +785,94 @@ declare class AgentChainIncompatibleError extends OwneyError {
     }>, connectedChainId: number);
 }
 
+/**
+ * Withdrawal swaps the user has walked away from, and how they ended.
+ *
+ * The deposit side has `swap.pending-deposit.ts` for the same shape of
+ * problem, but the two are not symmetrical. A pending deposit is a JOB: the
+ * money is in the wallet and an ordinary deposit finishes it. This is a
+ * WATCH — the funds are in escrow, nothing the user does moves them along,
+ * and the only question is where they ended up.
+ *
+ * That is the whole reason this exists. `withdrawAndSwap` used to hold the
+ * screen for the entire escrow lifecycle, which on a slow mainnet fill is
+ * minutes of a modal the user cannot leave (ROUT-242). Backgrounding it means
+ * the outcome arrives after the UI that started it has gone, so the outcome
+ * has to be written down somewhere the next render can find it.
+ *
+ * Only cross-chain swaps are recorded. A same-chain classic swap is one
+ * transaction and resolves in seconds; a same-chain fusion order has no stored
+ * preimages, so there would be nothing for a reloaded session to resume and
+ * the record would sit at `swapping` for ever.
+ *
+ * Kept deliberately separate from the secret store. Secrets are retired the
+ * moment an order reaches a verdict — that is a safety property, not a display
+ * one — and the record has to outlive them so the user can still be told what
+ * happened after they come back.
+ */
+/**
+ * `swapping` is the only non-terminal state. `unknown` is what a watch that
+ * gave up looks like: we stopped polling before the order spoke, so the order
+ * may well have filled. It is not a failure, and it must never be shown as
+ * one.
+ */
+type WithdrawSwapStatus = "swapping" | "landed" | "refunded" | "unknown";
+type WithdrawSwapRecord = {
+    /** Identity. One record per Fusion+ order. */
+    orderHash: string;
+    status: WithdrawSwapStatus;
+    /**
+     * What actually left the agent, smallest unit of the SOURCE asset.
+     *
+     * The measured figure, not the requested one — a "MAX" withdrawal has no
+     * requested figure at all, and this is what a refund gives back.
+     */
+    withdrawn: string;
+    srcSymbol: string;
+    srcChainId: number;
+    srcDecimals: number;
+    /**
+     * What the quote expected to arrive, smallest unit of the DESTINATION.
+     *
+     * `dst.amount` — the auction's start, not its floor. The bar reads "about",
+     * and quoting the floor understated every completed withdrawal by half a
+     * percent (ROUT-242, comment 16056).
+     */
+    expected: string;
+    dstSymbol: string;
+    dstChainId: number;
+    dstDecimals: number;
+    /** Measured arrival. Set only on `landed`, and shown in place of `expected`. */
+    received?: string;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Epoch ms, set when the status stopped being `swapping`. */
+    settledAt?: number;
+};
+declare function subscribeWithdrawSwaps(listener: () => void): () => void;
+/**
+ * Write the record as the order is submitted, alongside the secrets.
+ *
+ * Not after the swap resolves: the point is to survive the gap between submit
+ * and settle, which is exactly when the user closes the tab.
+ */
+declare function saveWithdrawSwap(record: WithdrawSwapRecord): void;
+/**
+ * Move a record to its outcome.
+ *
+ * A no-op for an order with no record, which is the normal case for deposit
+ * swaps — they share the secret store and so pass through the same resume
+ * loop, but they are not withdrawals and were never recorded here.
+ *
+ * `settledAt` is stamped here rather than by the caller so every writer agrees
+ * on what "settled" means: the moment the status stopped being `swapping`.
+ */
+declare function updateWithdrawSwap(orderHash: string, patch: Partial<Omit<WithdrawSwapRecord, "orderHash">>): void;
+/** The user has read the outcome. Only they do this. */
+declare function clearWithdrawSwap(orderHash: string): void;
+/** Every record, newest first, sweeping anything past MAX_AGE_MS. */
+declare function listWithdrawSwaps(now?: number): WithdrawSwapRecord[];
+
 /**
  * Swaps that landed but were never deposited.
  *
@@ -1071,6 +1159,21 @@ declare class OwneySDK {
      * describe. See `completePendingDeposit`.
      */
     listPendingDeposits(): ReturnType<typeof listPendingDeposits>;
+    /**
+     * Backgrounded withdrawal swaps and how they ended, newest first.
+     *
+     * Nothing to act on — unlike `listPendingDeposits`, which describes a job the
+     * user can finish. This is a watch: the funds are in escrow and the only
+     * open question is where they land. See `swap.withdraw-swap.ts`.
+     */
+    listWithdrawSwaps(): WithdrawSwapRecord[];
+    /**
+     * Retire a settled record. The user has read the outcome.
+     *
+     * Only they do this — a record that disappears on its own takes with it the
+     * only thing telling someone where their money went.
+     */
+    dismissWithdrawSwap(orderHash: string): void;
     /**
      * Deposit a swap that already landed.
      *
@@ -1106,6 +1209,24 @@ declare class OwneySDK {
         status: "completed" | "unfinished";
         error?: OwneyError;
     }[]>;
+    /**
+     * Pick up SAME-CHAIN orders a previous session left in the auction.
+     *
+     * They are not in the secret store and never will be: that store exists to
+     * keep preimages, and a same-chain fill needs none — the resolver takes the
+     * maker's tokens and delivers the taker's in one transaction. So the only
+     * record of one is the withdrawal record itself, which carries the order
+     * hash, and that is all a resume needs here.
+     *
+     * Gentler than the Fusion+ case in the way that matters. Nothing is
+     * escrowed, so an order nobody ever picks up leaves the wallet exactly as it
+     * was — this is catching up on news, not rescuing funds.
+     *
+     * Same-chain is read off the record rather than stored as a rail: a
+     * withdrawal whose source and destination share a chain could not have been
+     * anything else.
+     */
+    private resumeSameChainSwaps;
     /**
      * What the wallet actually holds, across every supported chain, restricted
      * to tokens a swap could use.
@@ -1137,12 +1258,16 @@ declare class OwneySDK {
      * tokens can share a ticker, and `providers` (how many token lists carry the
      * address) is the only usable signal for telling them apart. Surface it.
      *
-     * Returns nothing for a blank query rather than asking for the whole list.
+     * A blank query WITH a chainId lists that chain's catalogue instead of
+     * searching it — what a picker wants when someone selects a chain before
+     * typing anything. Blank with no chain returns nothing: that would be asking
+     * for the top of every catalogue at once, which is a download, not a list.
      */
     searchSwapTokens(params: {
-        /** Omit to search every supported chain. */
+        /** Omit to search every supported chain. Required to list one. */
         chainId?: number;
-        query: string;
+        /** Omit, with a chainId, to list the chain rather than search it. */
+        query?: string;
         limit?: number;
         /**
          * Which picker is asking. A withdrawal ends in the user's own wallet, so
@@ -1246,6 +1371,32 @@ declare class OwneySDK {
         /** Percent, classic rail only. Fusion+ prices through its auction. */
         slippage?: number;
         onSwapProgress?: (stage: SwapStage) => void;
+        /**
+         * Fires once the order is with the relayer, before the watch.
+         *
+         * Both resolver-filled rails reach it — cross-chain Fusion+ and the
+         * same-chain auction. Not the classic rail, which is one transaction with
+         * no order behind it and resolves in seconds either way.
+         *
+         * The seam a backgrounded withdrawal hangs off. Up to here the flow needs
+         * the user in front of it; past here it is polling that a later page load
+         * can take over — from the stored preimages on Fusion+, and from the
+         * order hash alone on the same-chain rail. So a caller may stop awaiting
+         * this promise and let the screen go. See `swap.withdraw-swap.ts` for what
+         * the caller should write down when it does.
+         *
+         * Carries the two figures a status bar cannot get anywhere else. The
+         * withdrawal has already happened by this point and `withdrawn` is what
+         * MEASURABLY arrived, which on a "MAX" withdrawal is the only figure that
+         * exists — and it is also what comes back if the order never fills.
+         */
+        onOrderSubmitted?: (submitted: {
+            orderHash: string;
+            /** Smallest unit of the agent's asset. */
+            withdrawn: string;
+            /** Smallest unit of the destination — the auction's start, not its floor. */
+            expected: string;
+        }) => void;
         /** How long to wait for the withdrawal to land before giving up on the swap. */
         arrivalTimeoutMs?: number;
     }): Promise<{
@@ -1447,4 +1598,4 @@ type StoredOrder = {
  */
 declare function listOrders(now?: number): StoredOrder[];
 
-export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type PendingDeposit, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type WithdrawOptions, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type PendingDeposit, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.js

@@ -263,6 +263,15 @@ var DayFilterMapping = {
   "7D": 7
 };
 
+// src/lib/helpers/asset-aliases.ts
+function assetAliases(asset) {
+  const normalised = asset.toLowerCase();
+  return normalised === "weth" ? ["weth", "eth"] : [normalised];
+}
+function matchesAsset(symbol, asset) {
+  return assetAliases(asset).includes(symbol.toLowerCase());
+}
+
 // src/agents/zyfai/zyfai.mapper.ts
 var DECIMALS_BY_SYMBOL = {
   usdc: 6,
@@ -667,9 +676,8 @@ function computeAllocationApy(positions) {
 function earningsForToken(bucket, chainId, asset) {
   const tokens = bucket?.[String(chainId)];
   if (!tokens) return null;
-  const wanted = asset.toUpperCase();
   for (const [symbol, value] of Object.entries(tokens)) {
-    if (symbol.toUpperCase() !== wanted) continue;
+    if (!matchesAsset(symbol, asset)) continue;
     const amount = Number(value);
     return Number.isFinite(amount) ? amount : null;
   }
@@ -2294,7 +2302,7 @@ function createSwapApi(baseUrl, apiKey) {
       baseUrl,
       apiKey,
       `/tokens/search?${new URLSearchParams({
-        query: params.query,
+        ...params.query === void 0 ? {} : { query: params.query },
         // Omitted, the routing API searches every supported chain — which is
         // what a picker wants, since its rows already span all three.
         ...params.chainId === void 0 ? {} : { chainId: String(params.chainId) },
@@ -3097,6 +3105,10 @@ async function runSameChainFusion(deps, options, walletAddress) {
     quoteId: built.quoteId,
     ...built.extension ? { extension: built.extension } : {}
   });
+  try {
+    options.onOrderSubmitted?.(built.orderHash);
+  } catch {
+  }
   await runSameChainOrder(deps.sameChainRunner ?? deps.runner, {
     orderHash: built.orderHash,
     ...onStage ? { onStage } : {}
@@ -3195,6 +3207,10 @@ async function runFusion(deps, options, walletAddress) {
     ...built.extension ? { extension: built.extension } : {}
   });
   debugLog("owney-sdk", "swap: order submitted, polling escrows");
+  try {
+    options.onOrderSubmitted?.(built.orderHash);
+  } catch {
+  }
   try {
     await runFusionOrder(deps.runner, {
       orderHash: built.orderHash,
@@ -3314,8 +3330,8 @@ async function buildErc2612Permit(reads, input) {
   );
 }
 
-// src/lib/swap/swap.pending-deposit.ts
-var KEY_PREFIX3 = "owney.swap.pending-deposit";
+// src/lib/swap/swap.withdraw-swap.ts
+var KEY_PREFIX3 = "owney.swap.withdraw";
 var MAX_AGE_MS2 = 24 * 60 * 60 * 1e3;
 var storage3 = () => {
   if (typeof window === "undefined") return null;
@@ -3325,26 +3341,60 @@ var storage3 = () => {
     return null;
   }
 };
-var keyFor2 = (id) => `${KEY_PREFIX3}.${id}`;
-function savePendingDeposit(entry) {
+var keyFor2 = (orderHash) => `${KEY_PREFIX3}.${orderHash}`;
+var listeners = /* @__PURE__ */ new Set();
+function subscribeWithdrawSwaps(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+var notify = () => {
+  for (const listener of listeners) {
+    try {
+      listener();
+    } catch {
+    }
+  }
+};
+function saveWithdrawSwap(record) {
   const store = storage3();
   if (!store) return;
   try {
-    store.setItem(keyFor2(entry.id), JSON.stringify(entry));
+    store.setItem(keyFor2(record.orderHash), JSON.stringify(record));
   } catch {
     return;
   }
+  notify();
 }
-function clearPendingDeposit(id) {
+function updateWithdrawSwap(orderHash, patch) {
   const store = storage3();
   if (!store) return;
   try {
-    store.removeItem(keyFor2(id));
+    const raw = store.getItem(keyFor2(orderHash));
+    if (!raw) return;
+    const current = JSON.parse(raw);
+    const next = { ...current, ...patch };
+    if (next.status !== "swapping" && current.status === "swapping" && next.settledAt === void 0) {
+      next.settledAt = Date.now();
+    }
+    store.setItem(keyFor2(orderHash), JSON.stringify(next));
   } catch {
     return;
   }
+  notify();
 }
-function listPendingDeposits(now = Date.now()) {
+function clearWithdrawSwap(orderHash) {
+  const store = storage3();
+  if (!store) return;
+  try {
+    store.removeItem(keyFor2(orderHash));
+  } catch {
+    return;
+  }
+  notify();
+}
+function listWithdrawSwaps(now = Date.now()) {
   const store = storage3();
   if (!store) return [];
   const out = [];
@@ -3374,6 +3424,66 @@ function listPendingDeposits(now = Date.now()) {
   return out.sort((a, b) => b.createdAt - a.createdAt);
 }
 
+// src/lib/swap/swap.pending-deposit.ts
+var KEY_PREFIX4 = "owney.swap.pending-deposit";
+var MAX_AGE_MS3 = 24 * 60 * 60 * 1e3;
+var storage4 = () => {
+  if (typeof window === "undefined") return null;
+  try {
+    return window.localStorage;
+  } catch {
+    return null;
+  }
+};
+var keyFor3 = (id) => `${KEY_PREFIX4}.${id}`;
+function savePendingDeposit(entry) {
+  const store = storage4();
+  if (!store) return;
+  try {
+    store.setItem(keyFor3(entry.id), JSON.stringify(entry));
+  } catch {
+    return;
+  }
+}
+function clearPendingDeposit(id) {
+  const store = storage4();
+  if (!store) return;
+  try {
+    store.removeItem(keyFor3(id));
+  } catch {
+    return;
+  }
+}
+function listPendingDeposits(now = Date.now()) {
+  const store = storage4();
+  if (!store) return [];
+  const out = [];
+  try {
+    const keys = [];
+    for (let i = 0; i < store.length; i++) {
+      const key2 = store.key(i);
+      if (key2?.startsWith(`${KEY_PREFIX4}.`)) keys.push(key2);
+    }
+    for (const key2 of keys) {
+      const raw = store.getItem(key2);
+      if (!raw) continue;
+      try {
+        const parsed = JSON.parse(raw);
+        if (now - parsed.createdAt > MAX_AGE_MS3) {
+          store.removeItem(key2);
+          continue;
+        }
+        out.push(parsed);
+      } catch {
+        store.removeItem(key2);
+      }
+    }
+  } catch {
+    return out;
+  }
+  return out.sort((a, b) => b.createdAt - a.createdAt);
+}
+
 // src/lib/health-report.ts
 var ROUTING_API_BASE_URL2 = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function reportAgentFailure(apiKey, agentType, errorCode, baseUrl = ROUTING_API_BASE_URL2) {
@@ -3410,11 +3520,10 @@ async function withFailureReporting(apiKey, agentType, fn, baseUrl) {
 // src/lib/helpers/withdraw-helper.ts
 import { parseUnits } from "viem";
 function projectAgentBalancesForAsset(agents, aggregated, chainId, asset, decimals) {
-  const target = asset.toUpperCase();
   return agents.map((agent) => {
     const agentBalance = aggregated[agent.id];
     const tokenBalance = agentBalance?.tokens.find(
-      (t) => t.chainId === chainId && t.asset.toUpperCase() === target
+      (t) => t.chainId === chainId && matchesAsset(t.asset, asset)
     );
     if (!tokenBalance) return { agent, balance: 0n };
     return { agent, balance: parseUnits(tokenBalance.amount, decimals) };
@@ -4721,15 +4830,14 @@ var OwneySDK = class {
   async hasExistingBalance(agent, state, chainId, asset, requireReliableRead = false) {
     try {
       const balance = await agent.getBalances(state, chainId);
-      const target = asset.toLowerCase();
       const token = balance.tokens.find(
-        (t) => t.chainId === chainId && t.asset.toLowerCase() === target
+        (t) => t.chainId === chainId && matchesAsset(t.asset, asset)
       );
       const targetChainName = agent.supportedAssets.find((entry) => entry.chainId === chainId)?.chain?.trim().toUpperCase();
       const position = (balance.positions ?? []).find((p) => {
         const positionChain = p.chain.trim().toUpperCase();
         const matchesChain = positionChain === String(chainId) || targetChainName !== void 0 && positionChain === targetChainName;
-        return matchesChain && p.asset.toLowerCase() === target && Number(p.amount) > 0;
+        return matchesChain && matchesAsset(p.asset, asset) && Number(p.amount) > 0;
       });
       return !!token && Number(token.amount) > 0 || !!position;
     } catch (error) {
@@ -5134,6 +5242,25 @@ var OwneySDK = class {
   listPendingDeposits() {
     return listPendingDeposits();
   }
+  /**
+   * Backgrounded withdrawal swaps and how they ended, newest first.
+   *
+   * Nothing to act on — unlike `listPendingDeposits`, which describes a job the
+   * user can finish. This is a watch: the funds are in escrow and the only
+   * open question is where they land. See `swap.withdraw-swap.ts`.
+   */
+  listWithdrawSwaps() {
+    return listWithdrawSwaps();
+  }
+  /**
+   * Retire a settled record. The user has read the outcome.
+   *
+   * Only they do this — a record that disappears on its own takes with it the
+   * only thing telling someone where their money went.
+   */
+  dismissWithdrawSwap(orderHash) {
+    clearWithdrawSwap(orderHash);
+  }
   /**
    * Deposit a swap that already landed.
    *
@@ -5180,7 +5307,10 @@ var OwneySDK = class {
    */
   async resumePendingSwaps(options = {}) {
     const pending = listOrders();
-    if (pending.length === 0) return [];
+    if (pending.length === 0) {
+      await this.resumeSameChainSwaps(options);
+      return [];
+    }
     const runner = this.swapRunnerDeps();
     const results = [];
     for (const order of pending) {
@@ -5194,6 +5324,7 @@ var OwneySDK = class {
           } : {}
         });
         clearOrder(order.orderHash);
+        updateWithdrawSwap(order.orderHash, { status: "landed" });
         results.push({
           orderHash: order.orderHash,
           status: "completed"
@@ -5201,6 +5332,9 @@ var OwneySDK = class {
       } catch (error) {
         if (error instanceof OwneyError && (error.code === "SWAP_ORDER_REFUNDED" || error.code === "SWAP_ORDER_CANCELLED")) {
           clearOrder(order.orderHash);
+          updateWithdrawSwap(order.orderHash, { status: "refunded" });
+        } else {
+          updateWithdrawSwap(order.orderHash, { status: "unknown" });
         }
         results.push({
           orderHash: order.orderHash,
@@ -5209,8 +5343,56 @@ var OwneySDK = class {
         });
       }
     }
+    await this.resumeSameChainSwaps(options);
     return results;
   }
+  /**
+   * Pick up SAME-CHAIN orders a previous session left in the auction.
+   *
+   * They are not in the secret store and never will be: that store exists to
+   * keep preimages, and a same-chain fill needs none — the resolver takes the
+   * maker's tokens and delivers the taker's in one transaction. So the only
+   * record of one is the withdrawal record itself, which carries the order
+   * hash, and that is all a resume needs here.
+   *
+   * Gentler than the Fusion+ case in the way that matters. Nothing is
+   * escrowed, so an order nobody ever picks up leaves the wallet exactly as it
+   * was — this is catching up on news, not rescuing funds.
+   *
+   * Same-chain is read off the record rather than stored as a rail: a
+   * withdrawal whose source and destination share a chain could not have been
+   * anything else.
+   */
+  async resumeSameChainSwaps(options = {}) {
+    const running = listWithdrawSwaps().filter(
+      (record) => record.status === "swapping" && record.srcChainId === record.dstChainId
+    );
+    for (const record of running) {
+      const runner = {
+        // The chain bound in. That product keys its orders per chain, and the
+        // Fusion+ endpoint answers 404 for one — which would read as an order
+        // that vanished rather than one still in the auction.
+        orderStatus: (h) => this.swapApi().orderStatus(h, record.srcChainId),
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        now: () => Date.now()
+      };
+      try {
+        await runSameChainOrder(runner, {
+          orderHash: record.orderHash,
+          ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+          ...options.onStage ? {
+            onStage: (stage) => options.onStage(record.orderHash, stage)
+          } : {}
+        });
+        updateWithdrawSwap(record.orderHash, { status: "landed" });
+      } catch (error) {
+        const code = error instanceof OwneyError ? error.code : void 0;
+        updateWithdrawSwap(record.orderHash, {
+          status: code === "SWAP_ORDER_EXPIRED" || code === "SWAP_ORDER_CANCELLED" ? "refunded" : "unknown"
+        });
+      }
+    }
+  }
   /**
    * What the wallet actually holds, across every supported chain, restricted
    * to tokens a swap could use.
@@ -5257,13 +5439,16 @@ var OwneySDK = class {
    * tokens can share a ticker, and `providers` (how many token lists carry the
    * address) is the only usable signal for telling them apart. Surface it.
    *
-   * Returns nothing for a blank query rather than asking for the whole list.
+   * A blank query WITH a chainId lists that chain's catalogue instead of
+   * searching it — what a picker wants when someone selects a chain before
+   * typing anything. Blank with no chain returns nothing: that would be asking
+   * for the top of every catalogue at once, which is a download, not a list.
    */
   async searchSwapTokens(params) {
-    const query = params.query.trim();
-    if (!query) return { tokens: [] };
+    const query = params.query?.trim() ?? "";
+    if (!query && params.chainId === void 0) return { tokens: [] };
     return this.swapApi().searchTokens({
-      query,
+      ...query ? { query } : {},
       ...params.chainId === void 0 ? {} : { chainId: params.chainId },
       ...params.limit === void 0 ? {} : { limit: params.limit },
       ...params.direction === void 0 ? {} : { direction: params.direction }
@@ -5443,7 +5628,14 @@ var OwneySDK = class {
         walletAddress: state.walletAddress,
         direction: "withdraw",
         ...options.slippage === void 0 ? {} : { slippage: options.slippage },
-        ...options.onSwapProgress ? { onStage: options.onSwapProgress } : {}
+        ...options.onSwapProgress ? { onStage: options.onSwapProgress } : {},
+        ...options.onOrderSubmitted ? {
+          onOrderSubmitted: (orderHash) => options.onOrderSubmitted({
+            orderHash,
+            withdrawn,
+            expected: quote.dst.amount
+          })
+        } : {}
       });
       return { withdraw, withdrawn, swap };
     } catch (error) {
@@ -6202,8 +6394,8 @@ import { SiweMessage } from "siwe";
 import { ZyfaiSDK as ZyfaiSDK2 } from "@zyfai/sdk";
 
 // src/agents/zyfai/zyfai.siwx-cache.ts
-var KEY_PREFIX4 = "owney.siwx.session";
-var storage4 = () => {
+var KEY_PREFIX5 = "owney.siwx.session";
+var storage5 = () => {
   if (typeof window === "undefined") return null;
   try {
     return window.localStorage;
@@ -6211,8 +6403,8 @@ var storage4 = () => {
     return null;
   }
 };
-var buildKey2 = (address) => `${KEY_PREFIX4}:${address.toLowerCase()}`;
-var legacyKeyPrefix2 = (address) => `${KEY_PREFIX4}:${address.toLowerCase()}:`;
+var buildKey2 = (address) => `${KEY_PREFIX5}:${address.toLowerCase()}`;
+var legacyKeyPrefix2 = (address) => `${KEY_PREFIX5}:${address.toLowerCase()}:`;
 var memorySiwxSessions = /* @__PURE__ */ new Map();
 var readLegacySiwxSession = (store, address) => {
   if (!store) return null;
@@ -6244,7 +6436,7 @@ var readLegacySiwxSession = (store, address) => {
 var readSiwxSession = (address, chainId) => {
   if (typeof window === "undefined") return null;
   const key2 = buildKey2(address);
-  const store = storage4();
+  const store = storage5();
   let raw = null;
   try {
     raw = store?.getItem(key2) ?? null;
@@ -6274,7 +6466,7 @@ var writeSiwxSession = (address, _chainId, session) => {
   if (typeof window === "undefined") return;
   const key2 = buildKey2(address);
   memorySiwxSessions.set(key2, session);
-  const store = storage4();
+  const store = storage5();
   try {
     store?.setItem(key2, JSON.stringify(session));
   } catch {
@@ -6283,7 +6475,7 @@ var writeSiwxSession = (address, _chainId, session) => {
 var clearSiwxSession = (address, _chainId) => {
   const key2 = buildKey2(address);
   memorySiwxSessions.delete(key2);
-  const store = storage4();
+  const store = storage5();
   try {
     store?.removeItem(key2);
   } catch {
@@ -6415,8 +6607,13 @@ export {
   NotConnectedError,
   OwneyError,
   OwneySDK,
+  clearWithdrawSwap,
   createOwneySIWX,
   listPendingDeposits,
   listOrders as listPendingSwaps,
-  setOwneyDebug
+  listWithdrawSwaps,
+  saveWithdrawSwap,
+  setOwneyDebug,
+  subscribeWithdrawSwaps,
+  updateWithdrawSwap
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.7.26-beta.5",
+  "version": "0.7.26-beta.7",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",