@owney/sdk 0.7.28-beta.4 → 0.7.28-beta.6

package/dist/index.cjs

@@ -523,23 +523,33 @@ function rawPoolApyForChain(entry, chainId, tokenSymbol) {
 function historyCoverage(raw) {
   const chains = /* @__PURE__ */ new Map();
   const assets = /* @__PURE__ */ new Map();
+  const pairs = /* @__PURE__ */ new Map();
   for (const date of Object.keys(raw.history ?? {}).sort()) {
     void date;
     const seenChains = /* @__PURE__ */ new Set();
     const seenAssets = /* @__PURE__ */ new Set();
+    const seenPairs = /* @__PURE__ */ new Map();
     for (const p of (raw.history ?? {})[date].positions ?? []) {
       const balance = p.balance ?? 0;
       const apy = netApy(p.apy_withFee, p.apy, "apy_withFee");
       if (balance <= 0 || typeof apy !== "number") continue;
       seenChains.add(p.chainId);
-      if (p.tokenSymbol) seenAssets.add(p.tokenSymbol.toUpperCase());
+      if (p.tokenSymbol) {
+        const asset = p.tokenSymbol.toUpperCase();
+        seenAssets.add(asset);
+        seenPairs.set(`${p.chainId}:${asset}`, { chainId: p.chainId, asset });
+      }
     }
     for (const c of seenChains) chains.set(c, (chains.get(c) ?? 0) + 1);
     for (const a of seenAssets) assets.set(a, (assets.get(a) ?? 0) + 1);
+    for (const [key2, pair] of seenPairs) {
+      pairs.set(key2, { ...pair, days: (pairs.get(key2)?.days ?? 0) + 1 });
+    }
   }
   return {
     chains: [...chains].map(([chainId, days]) => ({ chainId, days })),
-    assets: [...assets].map(([asset, days]) => ({ asset, days }))
+    assets: [...assets].map(([asset, days]) => ({ asset, days })),
+    pairs: [...pairs.values()]
   };
 }
 function mapApyHistory(raw, chainId, tokenSymbol) {
@@ -584,6 +594,9 @@ function mapEntries(rawEntries, chainId) {
     // "Top up wallet" and for slightly less (gas). `Deposit` already exists in
     // the public HistoryAction union, so no consumer type change is needed.
     "Deposit to protocol": "Deposit",
+    // Withdrawing from an async vault (Superform) is logged under its own
+    // label and paid out later in a separate batch (ROUT-624).
+    "Request async withdrawal": "Withdraw",
     Rebalance: "Rebalance"
   };
   void chainId;
@@ -626,8 +639,9 @@ function mapEntries(rawEntries, chainId) {
       ];
     }
     const mappedAction = (entry.action ? actionMap[entry.action] : void 0) ?? entry.action;
+    const asyncRequest = entry.action === "Request async withdrawal";
     const rawAmount = entry?.positions?.[0]?.amount;
-    const hasAmount = mappedAction !== "Withdraw" && typeof rawAmount === "string" && rawAmount !== "" && rawAmount !== "0x" && rawAmount !== "0x0" && rawAmount !== "0";
+    const hasAmount = (mappedAction !== "Withdraw" || asyncRequest) && typeof rawAmount === "string" && rawAmount !== "" && rawAmount !== "0x" && rawAmount !== "0x0" && rawAmount !== "0";
     const mappedPositions = positions.filter((p) => p.protocol_name).map((p) => ({
       protocol: p.protocol_name,
       pool: p.pool ?? void 0,
@@ -641,6 +655,7 @@ function mapEntries(rawEntries, chainId) {
       newApy: newApy === null ? null : String(newApy),
       oldApy: oldApy === null ? null : String(oldApy),
       ...mappedPositions.length ? { positions: mappedPositions } : {},
+      ...asyncRequest ? { asyncRequest: true } : {},
       transactions: [
         {
           txHashes: entry.transactionHash ? [entry.transactionHash] : [],
@@ -1281,7 +1296,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
    */
   async resolveWithdrawnAmounts(entries, chainId, recipient) {
     const withdrawals = entries.filter(
-      (e) => e.action === "Withdraw" && e.transactions[0]?.txHashes[0]
+      (e) => e.action === "Withdraw" && !e.asyncRequest && e.transactions[0]?.txHashes[0]
     );
     if (withdrawals.length === 0) return;
     const client = this.getPublicClient(chainId);
@@ -1787,6 +1802,44 @@ var ZyfaiAgent = class _ZyfaiAgent {
       );
     }
   }
+  /**
+   * Read back what `setPoolSelection` wrote (ROUT-650). Zyfai keeps the saved
+   * pools per protocol/chain and the strategy per asset; both are read for the
+   * pairs and assets asked about. A pair still on autoselect, or one whose
+   * lookup fails, is left out so the caller falls back to its default for it.
+   */
+  async getPoolSelection(params) {
+    const [pairs, strategies] = await Promise.all([
+      Promise.all(
+        params.pairs.map(async ({ protocolId, chainId }) => {
+          try {
+            const current = await this.sdk.getSelectedPools(
+              protocolId,
+              chainId
+            );
+            if (current.autoselect) return null;
+            return { protocolId, chainId, pools: current.pools ?? [] };
+          } catch {
+            return null;
+          }
+        })
+      ),
+      Promise.all(
+        params.assets.map(async (asset) => {
+          try {
+            const current = await this.sdk.getUserDetails(asset);
+            return current.strategy ? { asset, strategy: current.strategy } : null;
+          } catch {
+            return null;
+          }
+        })
+      )
+    ]);
+    return {
+      pairs: pairs.filter((value) => value !== null),
+      strategies: strategies.filter((value) => value !== null)
+    };
+  }
   /**
    * True when `smartWallet` is the backend-managed pool wallet Zyfai assigned
    * to this EOA — the "new wallet" kind that is predeployed on the chains it
@@ -2884,6 +2937,33 @@ function swapChain(chainId) {
   return CHAINS[chainId];
 }
 
+// src/lib/swap/swap.gas-check.ts
+var CLASSIC_SWAP_GAS = 300000n;
+var APPROVE_GAS2 = 60000n;
+var isNative = (address) => address.toLowerCase().startsWith("0xeeee");
+async function swapGasShortfall(deps, quote) {
+  if (quote.rail !== "classic" || isNative(quote.src.address)) return null;
+  const gas = CLASSIC_SWAP_GAS + APPROVE_GAS2;
+  const [balance, gasPrice] = await Promise.all([
+    deps.readNativeBalance(),
+    deps.getMaxFeePerGas()
+  ]);
+  const required = gas * gasPrice;
+  return balance < required ? { chainId: quote.src.chainId, balance, required } : null;
+}
+function swapGasError(shortfall, nativeSymbol) {
+  return new OwneyError(
+    "SWAP_INSUFFICIENT_GAS",
+    `This swap needs a little ${nativeSymbol} for network fees, and your wallet has too little. Add some ${nativeSymbol}, or choose a different asset to receive.`,
+    {
+      chainId: shortfall.chainId,
+      symbol: nativeSymbol,
+      balance: shortfall.balance.toString(),
+      required: shortfall.required.toString()
+    }
+  );
+}
+
 // src/lib/swap/swap.arrival.ts
 var DEFAULT_TIMEOUT_MS = 18e4;
 var DEFAULT_POLL_MS = 4e3;
@@ -3400,8 +3480,8 @@ async function runClassic(deps, options) {
   onStage?.("quoting");
   debugLog("owney-sdk", "swap: fetching classic calldata");
   let { tx } = await deps.api.swapTx(swapTxRequest);
-  const isNative = BigInt(tx.value ?? "0") > 0n;
-  if (!isNative) {
+  const isNative2 = BigInt(tx.value ?? "0") > 0n;
+  if (!isNative2) {
     const needed = amount;
     const current = await deps.readAllowance(tx.to);
     debugLog("owney-sdk", "swap: allowance", {
@@ -4467,6 +4547,15 @@ function makeSponsoredCallsCallback(deps) {
 
 // src/client.ts
 var WALLET_CATCHUP_TIMEOUT_MS = 3e4;
+function shortfallBalance(error, asked) {
+  if (!(error instanceof OwneyError)) return void 0;
+  if (error.code !== "DEPOSIT_INSUFFICIENT_BALANCE") return void 0;
+  const seen = error.details?.balance;
+  if (typeof seen !== "string") return void 0;
+  const balance = BigInt(seen);
+  if (balance <= 0n || balance >= asked) return void 0;
+  return (asked - balance) * 100n <= asked ? balance : void 0;
+}
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
 }
@@ -5476,6 +5565,19 @@ var OwneySDK = class {
       chain: dstChain,
       transport: swapReadTransport(quote.dst.chainId, this.zyfaiRpcUrls)
     });
+    const walletPublic = (0, import_viem9.createPublicClient)({
+      chain: srcChain,
+      transport: (0, import_viem9.custom)(provider)
+    });
+    const signOnSource = (payload) => signWithChainRetry(
+      walletPublic,
+      wallet,
+      quote.src.chainId,
+      () => wallet.signTypedData({
+        account: state.walletAddress,
+        ...payload
+      })
+    );
     return {
       api: this.swapApi(),
       // Native-aware, like readSourceBalance below. Native ETH is never a
@@ -5516,10 +5618,7 @@ var OwneySDK = class {
         }
         return hash;
       },
-      signTypedData: (typedData) => wallet.signTypedData({
-        account: state.walletAddress,
-        ...typedData
-      }),
+      signTypedData: signOnSource,
       // Chain-bound like every other read here: the wallet provider's chain is
       // not ours to rely on mid-swap.
       readSourceBalance: async () => {
@@ -5576,10 +5675,7 @@ var OwneySDK = class {
           spender,
           value: amount,
           chainId: quote.src.chainId,
-          signTypedData: (payload) => wallet.signTypedData({
-            account: state.walletAddress,
-            ...payload
-          })
+          signTypedData: signOnSource
         }
       ),
       /**
@@ -5673,6 +5769,38 @@ var OwneySDK = class {
     const balance = await this.readTokenBalance(chainId, token);
     return (balance < received ? balance : received).toString();
   }
+  /**
+   * Deposit a swap's output, retrying once at the balance the deposit saw.
+   *
+   * `settleSwapDepositAmount` approves and THEN reads, but the read and the
+   * deposit's own pre-check can disagree: the approval is confirmed through
+   * the wallet's node, the read goes to a pinned RPC, and gas paid in WETH
+   * (MetaMask offers this to a wallet with no ETH) can land after either.
+   * ROUT-618 failed that way with the settle step in place.
+   *
+   * The pre-check reports the balance it saw, and that is the authority, so
+   * a shortfall is retried once at that figure. Only a small one: a node that
+   * has not caught up can read near zero, and depositing that would leave the
+   * rest of the swap stranded behind a "success".
+   */
+  async depositSwapOutput(options) {
+    const attempt = (amount) => this.deposit({
+      amount,
+      asset: options.asset,
+      ...options.agentId ? { agentId: options.agentId } : {}
+    });
+    try {
+      return {
+        deposit: await attempt(options.amount),
+        deposited: options.amount
+      };
+    } catch (error) {
+      const balance = shortfallBalance(error, BigInt(options.amount));
+      if (balance === void 0) throw error;
+      const deposited = balance.toString();
+      return { deposit: await attempt(deposited), deposited };
+    }
+  }
   async walletSeesBalance(chainId, token, amount) {
     const provider = this.requireConnectedProvider();
     const state = this.requireState();
@@ -5698,9 +5826,39 @@ var OwneySDK = class {
    * Runs a quoted swap. A named seam rather than an inline `executeSwap` call
    * so the deposit half of `swapAndDeposit` can be exercised on its own.
    */
-  runSwap(quote, options) {
+  async runSwap(quote, options) {
+    await this.checkSwapGas(quote);
     return executeSwap(this.buildSwapDeps(quote), { quote, ...options });
   }
+  /**
+   * Throws SWAP_INSUFFICIENT_GAS when the wallet cannot pay for this swap.
+   *
+   * Only the classic rail is ever refused: it is the one where the user sends
+   * the transactions. Call it on a preview quote to warn BEFORE a withdrawal
+   * moves anything — `withdrawAndSwap` repeats it on its own quote, but by
+   * then the funds have already left the agent (ROUT-622).
+   */
+  async checkSwapGas(quote) {
+    const state = this.requireState();
+    const chain = swapChain(quote.src.chainId);
+    if (!chain) return;
+    const pub = (0, import_viem9.createPublicClient)({
+      chain,
+      transport: swapReadTransport(quote.src.chainId, this.zyfaiRpcUrls)
+    });
+    const shortfall = await swapGasShortfall(
+      {
+        readNativeBalance: () => pub.getBalance({ address: state.walletAddress }),
+        // The 1559 ceiling, as the wrap reserve reads it.
+        getMaxFeePerGas: async () => {
+          const fees = await pub.estimateFeesPerGas();
+          return fees.maxFeePerGas ?? pub.getGasPrice();
+        }
+      },
+      quote
+    );
+    if (shortfall) throw swapGasError(shortfall, chain.nativeCurrency.symbol);
+  }
   /**
    * The half of the swap deps that only ever talks to the routing API.
    *
@@ -5772,8 +5930,15 @@ var OwneySDK = class {
       );
     }
     await this.ensureSwapChain(entry.chainId);
-    const deposit = await this.deposit({
-      amount: entry.received,
+    const token = entry.symbol === "WETH" ? SPONSORED_WETH_BY_CHAIN[entry.chainId] : void 0;
+    const amount = token ? await this.settleSwapDepositAmount(
+      entry.chainId,
+      token,
+      entry.symbol,
+      BigInt(entry.received)
+    ) : entry.received;
+    const { deposit } = await this.depositSwapOutput({
+      amount,
       asset: entry.symbol,
       ...entry.agentId ? { agentId: entry.agentId } : {}
     });
@@ -6013,12 +6178,12 @@ var OwneySDK = class {
         options.to.symbol,
         BigInt(swap.received)
       );
-      const deposit = await this.deposit({
+      const { deposit, deposited } = await this.depositSwapOutput({
         amount,
         asset: options.to.symbol,
         ...options.agentId ? { agentId: options.agentId } : {}
       });
-      return { swap, deposit, deposited: amount };
+      return { swap, deposit, deposited };
     } catch (error) {
       const pending = {
         id: `${quote.dst.chainId}-${options.to.symbol}-${Date.now()}`,
@@ -6122,6 +6287,7 @@ var OwneySDK = class {
         walletAddress: state.walletAddress
       });
       await this.ensureSwapChain(quote.src.chainId);
+      await this.checkSwapGas(quote);
       const swap = await executeSwap(this.buildSwapDeps(quote), {
         quote,
         walletAddress: state.walletAddress,
@@ -6632,6 +6798,25 @@ var OwneySDK = class {
     }
     await agent.setPoolSelection(params.selection);
   }
+  /**
+   * The pool selection saved on the user's account (ROUT-650), so the Pools
+   * step can show what applies now rather than the defaults. `pairs` and
+   * `assets` say which protocol/chain lists and strategies to read.
+   */
+  async getPoolSelection(params) {
+    await this.ensureAgentsInitialized();
+    const agent = this.getAgent(params.agentId ?? "zyfai");
+    if (!agent.getPoolSelection) {
+      throw new OwneyError(
+        "POOL_SELECTION_UNSUPPORTED",
+        `Agent ${agent.id} does not support pool customization`
+      );
+    }
+    return agent.getPoolSelection({
+      pairs: params.pairs,
+      assets: params.assets
+    });
+  }
   async getAccountApy({
     agentId,
     days,

package/dist/index.d.cts

@@ -563,6 +563,22 @@ type UserPoolSelectionRequest = {
     }>;
     selections: UserPoolSelection[];
 };
+/**
+ * What a user's account currently has saved (ROUT-650): each asset's strategy,
+ * plus the pool list of every protocol/chain pair frozen by an earlier Save.
+ * Pairs Zyfai still autoselects are left out, so "no entry" means "default".
+ */
+type SavedPoolSelection = {
+    strategies: Array<{
+        asset: "USDC" | "WETH";
+        strategy: string;
+    }>;
+    pairs: Array<{
+        protocolId: string;
+        chainId: number;
+        pools: string[];
+    }>;
+};
 /** One protocol with its pools for the deposit asset — what the Pools step
  *  renders: a protocol row that opens to a list of selectable pools. */
 type PoolCatalogProtocol = {
@@ -723,6 +739,14 @@ interface ApyCoverage {
         asset: string;
         days: number;
     }[];
+    /** Each asset on each chain, for a menu that offers the two together
+     *  (ROUT-647). The lists above cannot say this: USDC on Base and WETH on
+     *  Arbitrum put both chains and both assets in them, and no WETH on Base. */
+    pairs: {
+        chainId: number;
+        asset: string;
+        days: number;
+    }[];
 }
 interface AccountAgentApy {
     walletAddress: string;
@@ -802,6 +826,13 @@ interface AgentHistoryEntry {
     transactions: HistoryTransaction[];
     rebalanceLog: RebalanceLog[];
     positions?: AgentHistoryPosition[];
+    /**
+     * Set on a `Withdraw` that was only requested from an async vault
+     * (ROUT-624). The vault pays out in batches later, so the funds have not
+     * reached the wallet yet and `transactions[0].amount` is the amount
+     * requested.
+     */
+    asyncRequest?: true;
 }
 interface OwneyAgentHistory {
     data: AgentHistoryEntry[];
@@ -914,6 +945,17 @@ interface IAgent {
      * (ROUT-569)
      */
     setPoolSelection?(selection: UserPoolSelectionRequest): Promise<void>;
+    /**
+     * Read back what `setPoolSelection` saved, for the pairs and assets given,
+     * so the Pools step can open on the user's own choices. Optional. (ROUT-650)
+     */
+    getPoolSelection?(params: {
+        pairs: Array<{
+            protocolId: string;
+            chainId: number;
+        }>;
+        assets: Array<"USDC" | "WETH">;
+    }): Promise<SavedPoolSelection>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
     withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
     getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
@@ -1393,12 +1435,36 @@ declare class OwneySDK {
      *   where the sponsor covers the transfer and Permit2 never applies.
      */
     private settleSwapDepositAmount;
+    /**
+     * Deposit a swap's output, retrying once at the balance the deposit saw.
+     *
+     * `settleSwapDepositAmount` approves and THEN reads, but the read and the
+     * deposit's own pre-check can disagree: the approval is confirmed through
+     * the wallet's node, the read goes to a pinned RPC, and gas paid in WETH
+     * (MetaMask offers this to a wallet with no ETH) can land after either.
+     * ROUT-618 failed that way with the settle step in place.
+     *
+     * The pre-check reports the balance it saw, and that is the authority, so
+     * a shortfall is retried once at that figure. Only a small one: a node that
+     * has not caught up can read near zero, and depositing that would leave the
+     * rest of the swap stranded behind a "success".
+     */
+    private depositSwapOutput;
     private walletSeesBalance;
     /**
      * Runs a quoted swap. A named seam rather than an inline `executeSwap` call
      * so the deposit half of `swapAndDeposit` can be exercised on its own.
      */
     private runSwap;
+    /**
+     * Throws SWAP_INSUFFICIENT_GAS when the wallet cannot pay for this swap.
+     *
+     * Only the classic rail is ever refused: it is the one where the user sends
+     * the transactions. Call it on a preview quote to warn BEFORE a withdrawal
+     * moves anything — `withdrawAndSwap` repeats it on its own quote, but by
+     * then the funds have already left the agent (ROUT-622).
+     */
+    checkSwapGas(quote: SwapQuote): Promise<void>;
     /**
      * The half of the swap deps that only ever talks to the routing API.
      *
@@ -1758,6 +1824,19 @@ declare class OwneySDK {
         selection: UserPoolSelectionRequest;
         agentId?: AgentId;
     }): Promise<void>;
+    /**
+     * The pool selection saved on the user's account (ROUT-650), so the Pools
+     * step can show what applies now rather than the defaults. `pairs` and
+     * `assets` say which protocol/chain lists and strategies to read.
+     */
+    getPoolSelection(params: {
+        pairs: Array<{
+            protocolId: string;
+            chainId: number;
+        }>;
+        assets: Array<"USDC" | "WETH">;
+        agentId?: AgentId;
+    }): Promise<SavedPoolSelection>;
     getAccountApy({ agentId, days, tokenSymbol, chainId: scope, }: AccountApyOptions): Promise<OwneyAccountApy | AccountAgentApy>;
     /**
      * Get transaction history for a specific agent, or all agents.
@@ -1900,4 +1979,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 ApyCoverage, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type AvailablePool, 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 OrgPoolPolicy, type OrgPoolSelection, 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 OwneyWithdrawAllLeg, type OwneyWithdrawAllResult, type OwneyWithdrawResult, type PendingDeposit, type PoolCatalogProtocol, type PoolSelectionStrategy, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UserPoolSelection, type UserPoolSelectionRequest, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };
+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 ApyCoverage, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type AvailablePool, 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 OrgPoolPolicy, type OrgPoolSelection, 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 OwneyWithdrawAllLeg, type OwneyWithdrawAllResult, type OwneyWithdrawResult, type PendingDeposit, type PoolCatalogProtocol, type PoolSelectionStrategy, type RebalanceLog, type SavedPoolSelection, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UserPoolSelection, type UserPoolSelectionRequest, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.d.ts

@@ -563,6 +563,22 @@ type UserPoolSelectionRequest = {
     }>;
     selections: UserPoolSelection[];
 };
+/**
+ * What a user's account currently has saved (ROUT-650): each asset's strategy,
+ * plus the pool list of every protocol/chain pair frozen by an earlier Save.
+ * Pairs Zyfai still autoselects are left out, so "no entry" means "default".
+ */
+type SavedPoolSelection = {
+    strategies: Array<{
+        asset: "USDC" | "WETH";
+        strategy: string;
+    }>;
+    pairs: Array<{
+        protocolId: string;
+        chainId: number;
+        pools: string[];
+    }>;
+};
 /** One protocol with its pools for the deposit asset — what the Pools step
  *  renders: a protocol row that opens to a list of selectable pools. */
 type PoolCatalogProtocol = {
@@ -723,6 +739,14 @@ interface ApyCoverage {
         asset: string;
         days: number;
     }[];
+    /** Each asset on each chain, for a menu that offers the two together
+     *  (ROUT-647). The lists above cannot say this: USDC on Base and WETH on
+     *  Arbitrum put both chains and both assets in them, and no WETH on Base. */
+    pairs: {
+        chainId: number;
+        asset: string;
+        days: number;
+    }[];
 }
 interface AccountAgentApy {
     walletAddress: string;
@@ -802,6 +826,13 @@ interface AgentHistoryEntry {
     transactions: HistoryTransaction[];
     rebalanceLog: RebalanceLog[];
     positions?: AgentHistoryPosition[];
+    /**
+     * Set on a `Withdraw` that was only requested from an async vault
+     * (ROUT-624). The vault pays out in batches later, so the funds have not
+     * reached the wallet yet and `transactions[0].amount` is the amount
+     * requested.
+     */
+    asyncRequest?: true;
 }
 interface OwneyAgentHistory {
     data: AgentHistoryEntry[];
@@ -914,6 +945,17 @@ interface IAgent {
      * (ROUT-569)
      */
     setPoolSelection?(selection: UserPoolSelectionRequest): Promise<void>;
+    /**
+     * Read back what `setPoolSelection` saved, for the pairs and assets given,
+     * so the Pools step can open on the user's own choices. Optional. (ROUT-650)
+     */
+    getPoolSelection?(params: {
+        pairs: Array<{
+            protocolId: string;
+            chainId: number;
+        }>;
+        assets: Array<"USDC" | "WETH">;
+    }): Promise<SavedPoolSelection>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
     withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
     getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
@@ -1393,12 +1435,36 @@ declare class OwneySDK {
      *   where the sponsor covers the transfer and Permit2 never applies.
      */
     private settleSwapDepositAmount;
+    /**
+     * Deposit a swap's output, retrying once at the balance the deposit saw.
+     *
+     * `settleSwapDepositAmount` approves and THEN reads, but the read and the
+     * deposit's own pre-check can disagree: the approval is confirmed through
+     * the wallet's node, the read goes to a pinned RPC, and gas paid in WETH
+     * (MetaMask offers this to a wallet with no ETH) can land after either.
+     * ROUT-618 failed that way with the settle step in place.
+     *
+     * The pre-check reports the balance it saw, and that is the authority, so
+     * a shortfall is retried once at that figure. Only a small one: a node that
+     * has not caught up can read near zero, and depositing that would leave the
+     * rest of the swap stranded behind a "success".
+     */
+    private depositSwapOutput;
     private walletSeesBalance;
     /**
      * Runs a quoted swap. A named seam rather than an inline `executeSwap` call
      * so the deposit half of `swapAndDeposit` can be exercised on its own.
      */
     private runSwap;
+    /**
+     * Throws SWAP_INSUFFICIENT_GAS when the wallet cannot pay for this swap.
+     *
+     * Only the classic rail is ever refused: it is the one where the user sends
+     * the transactions. Call it on a preview quote to warn BEFORE a withdrawal
+     * moves anything — `withdrawAndSwap` repeats it on its own quote, but by
+     * then the funds have already left the agent (ROUT-622).
+     */
+    checkSwapGas(quote: SwapQuote): Promise<void>;
     /**
      * The half of the swap deps that only ever talks to the routing API.
      *
@@ -1758,6 +1824,19 @@ declare class OwneySDK {
         selection: UserPoolSelectionRequest;
         agentId?: AgentId;
     }): Promise<void>;
+    /**
+     * The pool selection saved on the user's account (ROUT-650), so the Pools
+     * step can show what applies now rather than the defaults. `pairs` and
+     * `assets` say which protocol/chain lists and strategies to read.
+     */
+    getPoolSelection(params: {
+        pairs: Array<{
+            protocolId: string;
+            chainId: number;
+        }>;
+        assets: Array<"USDC" | "WETH">;
+        agentId?: AgentId;
+    }): Promise<SavedPoolSelection>;
     getAccountApy({ agentId, days, tokenSymbol, chainId: scope, }: AccountApyOptions): Promise<OwneyAccountApy | AccountAgentApy>;
     /**
      * Get transaction history for a specific agent, or all agents.
@@ -1900,4 +1979,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 ApyCoverage, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type AvailablePool, 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 OrgPoolPolicy, type OrgPoolSelection, 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 OwneyWithdrawAllLeg, type OwneyWithdrawAllResult, type OwneyWithdrawResult, type PendingDeposit, type PoolCatalogProtocol, type PoolSelectionStrategy, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UserPoolSelection, type UserPoolSelectionRequest, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };
+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 ApyCoverage, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type AvailablePool, 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 OrgPoolPolicy, type OrgPoolSelection, 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 OwneyWithdrawAllLeg, type OwneyWithdrawAllResult, type OwneyWithdrawResult, type PendingDeposit, type PoolCatalogProtocol, type PoolSelectionStrategy, type RebalanceLog, type SavedPoolSelection, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UserPoolSelection, type UserPoolSelectionRequest, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.js

@@ -483,23 +483,33 @@ function rawPoolApyForChain(entry, chainId, tokenSymbol) {
 function historyCoverage(raw) {
   const chains = /* @__PURE__ */ new Map();
   const assets = /* @__PURE__ */ new Map();
+  const pairs = /* @__PURE__ */ new Map();
   for (const date of Object.keys(raw.history ?? {}).sort()) {
     void date;
     const seenChains = /* @__PURE__ */ new Set();
     const seenAssets = /* @__PURE__ */ new Set();
+    const seenPairs = /* @__PURE__ */ new Map();
     for (const p of (raw.history ?? {})[date].positions ?? []) {
       const balance = p.balance ?? 0;
       const apy = netApy(p.apy_withFee, p.apy, "apy_withFee");
       if (balance <= 0 || typeof apy !== "number") continue;
       seenChains.add(p.chainId);
-      if (p.tokenSymbol) seenAssets.add(p.tokenSymbol.toUpperCase());
+      if (p.tokenSymbol) {
+        const asset = p.tokenSymbol.toUpperCase();
+        seenAssets.add(asset);
+        seenPairs.set(`${p.chainId}:${asset}`, { chainId: p.chainId, asset });
+      }
     }
     for (const c of seenChains) chains.set(c, (chains.get(c) ?? 0) + 1);
     for (const a of seenAssets) assets.set(a, (assets.get(a) ?? 0) + 1);
+    for (const [key2, pair] of seenPairs) {
+      pairs.set(key2, { ...pair, days: (pairs.get(key2)?.days ?? 0) + 1 });
+    }
   }
   return {
     chains: [...chains].map(([chainId, days]) => ({ chainId, days })),
-    assets: [...assets].map(([asset, days]) => ({ asset, days }))
+    assets: [...assets].map(([asset, days]) => ({ asset, days })),
+    pairs: [...pairs.values()]
   };
 }
 function mapApyHistory(raw, chainId, tokenSymbol) {
@@ -544,6 +554,9 @@ function mapEntries(rawEntries, chainId) {
     // "Top up wallet" and for slightly less (gas). `Deposit` already exists in
     // the public HistoryAction union, so no consumer type change is needed.
     "Deposit to protocol": "Deposit",
+    // Withdrawing from an async vault (Superform) is logged under its own
+    // label and paid out later in a separate batch (ROUT-624).
+    "Request async withdrawal": "Withdraw",
     Rebalance: "Rebalance"
   };
   void chainId;
@@ -586,8 +599,9 @@ function mapEntries(rawEntries, chainId) {
       ];
     }
     const mappedAction = (entry.action ? actionMap[entry.action] : void 0) ?? entry.action;
+    const asyncRequest = entry.action === "Request async withdrawal";
     const rawAmount = entry?.positions?.[0]?.amount;
-    const hasAmount = mappedAction !== "Withdraw" && typeof rawAmount === "string" && rawAmount !== "" && rawAmount !== "0x" && rawAmount !== "0x0" && rawAmount !== "0";
+    const hasAmount = (mappedAction !== "Withdraw" || asyncRequest) && typeof rawAmount === "string" && rawAmount !== "" && rawAmount !== "0x" && rawAmount !== "0x0" && rawAmount !== "0";
     const mappedPositions = positions.filter((p) => p.protocol_name).map((p) => ({
       protocol: p.protocol_name,
       pool: p.pool ?? void 0,
@@ -601,6 +615,7 @@ function mapEntries(rawEntries, chainId) {
       newApy: newApy === null ? null : String(newApy),
       oldApy: oldApy === null ? null : String(oldApy),
       ...mappedPositions.length ? { positions: mappedPositions } : {},
+      ...asyncRequest ? { asyncRequest: true } : {},
       transactions: [
         {
           txHashes: entry.transactionHash ? [entry.transactionHash] : [],
@@ -1241,7 +1256,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
    */
   async resolveWithdrawnAmounts(entries, chainId, recipient) {
     const withdrawals = entries.filter(
-      (e) => e.action === "Withdraw" && e.transactions[0]?.txHashes[0]
+      (e) => e.action === "Withdraw" && !e.asyncRequest && e.transactions[0]?.txHashes[0]
     );
     if (withdrawals.length === 0) return;
     const client = this.getPublicClient(chainId);
@@ -1747,6 +1762,44 @@ var ZyfaiAgent = class _ZyfaiAgent {
       );
     }
   }
+  /**
+   * Read back what `setPoolSelection` wrote (ROUT-650). Zyfai keeps the saved
+   * pools per protocol/chain and the strategy per asset; both are read for the
+   * pairs and assets asked about. A pair still on autoselect, or one whose
+   * lookup fails, is left out so the caller falls back to its default for it.
+   */
+  async getPoolSelection(params) {
+    const [pairs, strategies] = await Promise.all([
+      Promise.all(
+        params.pairs.map(async ({ protocolId, chainId }) => {
+          try {
+            const current = await this.sdk.getSelectedPools(
+              protocolId,
+              chainId
+            );
+            if (current.autoselect) return null;
+            return { protocolId, chainId, pools: current.pools ?? [] };
+          } catch {
+            return null;
+          }
+        })
+      ),
+      Promise.all(
+        params.assets.map(async (asset) => {
+          try {
+            const current = await this.sdk.getUserDetails(asset);
+            return current.strategy ? { asset, strategy: current.strategy } : null;
+          } catch {
+            return null;
+          }
+        })
+      )
+    ]);
+    return {
+      pairs: pairs.filter((value) => value !== null),
+      strategies: strategies.filter((value) => value !== null)
+    };
+  }
   /**
    * True when `smartWallet` is the backend-managed pool wallet Zyfai assigned
    * to this EOA — the "new wallet" kind that is predeployed on the chains it
@@ -2854,6 +2907,33 @@ function swapChain(chainId) {
   return CHAINS[chainId];
 }
 
+// src/lib/swap/swap.gas-check.ts
+var CLASSIC_SWAP_GAS = 300000n;
+var APPROVE_GAS2 = 60000n;
+var isNative = (address) => address.toLowerCase().startsWith("0xeeee");
+async function swapGasShortfall(deps, quote) {
+  if (quote.rail !== "classic" || isNative(quote.src.address)) return null;
+  const gas = CLASSIC_SWAP_GAS + APPROVE_GAS2;
+  const [balance, gasPrice] = await Promise.all([
+    deps.readNativeBalance(),
+    deps.getMaxFeePerGas()
+  ]);
+  const required = gas * gasPrice;
+  return balance < required ? { chainId: quote.src.chainId, balance, required } : null;
+}
+function swapGasError(shortfall, nativeSymbol) {
+  return new OwneyError(
+    "SWAP_INSUFFICIENT_GAS",
+    `This swap needs a little ${nativeSymbol} for network fees, and your wallet has too little. Add some ${nativeSymbol}, or choose a different asset to receive.`,
+    {
+      chainId: shortfall.chainId,
+      symbol: nativeSymbol,
+      balance: shortfall.balance.toString(),
+      required: shortfall.required.toString()
+    }
+  );
+}
+
 // src/lib/swap/swap.arrival.ts
 var DEFAULT_TIMEOUT_MS = 18e4;
 var DEFAULT_POLL_MS = 4e3;
@@ -3370,8 +3450,8 @@ async function runClassic(deps, options) {
   onStage?.("quoting");
   debugLog("owney-sdk", "swap: fetching classic calldata");
   let { tx } = await deps.api.swapTx(swapTxRequest);
-  const isNative = BigInt(tx.value ?? "0") > 0n;
-  if (!isNative) {
+  const isNative2 = BigInt(tx.value ?? "0") > 0n;
+  if (!isNative2) {
     const needed = amount;
     const current = await deps.readAllowance(tx.to);
     debugLog("owney-sdk", "swap: allowance", {
@@ -4448,6 +4528,15 @@ function makeSponsoredCallsCallback(deps) {
 
 // src/client.ts
 var WALLET_CATCHUP_TIMEOUT_MS = 3e4;
+function shortfallBalance(error, asked) {
+  if (!(error instanceof OwneyError)) return void 0;
+  if (error.code !== "DEPOSIT_INSUFFICIENT_BALANCE") return void 0;
+  const seen = error.details?.balance;
+  if (typeof seen !== "string") return void 0;
+  const balance = BigInt(seen);
+  if (balance <= 0n || balance >= asked) return void 0;
+  return (asked - balance) * 100n <= asked ? balance : void 0;
+}
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
 }
@@ -5457,6 +5546,19 @@ var OwneySDK = class {
       chain: dstChain,
       transport: swapReadTransport(quote.dst.chainId, this.zyfaiRpcUrls)
     });
+    const walletPublic = createPublicClient2({
+      chain: srcChain,
+      transport: custom(provider)
+    });
+    const signOnSource = (payload) => signWithChainRetry(
+      walletPublic,
+      wallet,
+      quote.src.chainId,
+      () => wallet.signTypedData({
+        account: state.walletAddress,
+        ...payload
+      })
+    );
     return {
       api: this.swapApi(),
       // Native-aware, like readSourceBalance below. Native ETH is never a
@@ -5497,10 +5599,7 @@ var OwneySDK = class {
         }
         return hash;
       },
-      signTypedData: (typedData) => wallet.signTypedData({
-        account: state.walletAddress,
-        ...typedData
-      }),
+      signTypedData: signOnSource,
       // Chain-bound like every other read here: the wallet provider's chain is
       // not ours to rely on mid-swap.
       readSourceBalance: async () => {
@@ -5557,10 +5656,7 @@ var OwneySDK = class {
           spender,
           value: amount,
           chainId: quote.src.chainId,
-          signTypedData: (payload) => wallet.signTypedData({
-            account: state.walletAddress,
-            ...payload
-          })
+          signTypedData: signOnSource
         }
       ),
       /**
@@ -5654,6 +5750,38 @@ var OwneySDK = class {
     const balance = await this.readTokenBalance(chainId, token);
     return (balance < received ? balance : received).toString();
   }
+  /**
+   * Deposit a swap's output, retrying once at the balance the deposit saw.
+   *
+   * `settleSwapDepositAmount` approves and THEN reads, but the read and the
+   * deposit's own pre-check can disagree: the approval is confirmed through
+   * the wallet's node, the read goes to a pinned RPC, and gas paid in WETH
+   * (MetaMask offers this to a wallet with no ETH) can land after either.
+   * ROUT-618 failed that way with the settle step in place.
+   *
+   * The pre-check reports the balance it saw, and that is the authority, so
+   * a shortfall is retried once at that figure. Only a small one: a node that
+   * has not caught up can read near zero, and depositing that would leave the
+   * rest of the swap stranded behind a "success".
+   */
+  async depositSwapOutput(options) {
+    const attempt = (amount) => this.deposit({
+      amount,
+      asset: options.asset,
+      ...options.agentId ? { agentId: options.agentId } : {}
+    });
+    try {
+      return {
+        deposit: await attempt(options.amount),
+        deposited: options.amount
+      };
+    } catch (error) {
+      const balance = shortfallBalance(error, BigInt(options.amount));
+      if (balance === void 0) throw error;
+      const deposited = balance.toString();
+      return { deposit: await attempt(deposited), deposited };
+    }
+  }
   async walletSeesBalance(chainId, token, amount) {
     const provider = this.requireConnectedProvider();
     const state = this.requireState();
@@ -5679,9 +5807,39 @@ var OwneySDK = class {
    * Runs a quoted swap. A named seam rather than an inline `executeSwap` call
    * so the deposit half of `swapAndDeposit` can be exercised on its own.
    */
-  runSwap(quote, options) {
+  async runSwap(quote, options) {
+    await this.checkSwapGas(quote);
     return executeSwap(this.buildSwapDeps(quote), { quote, ...options });
   }
+  /**
+   * Throws SWAP_INSUFFICIENT_GAS when the wallet cannot pay for this swap.
+   *
+   * Only the classic rail is ever refused: it is the one where the user sends
+   * the transactions. Call it on a preview quote to warn BEFORE a withdrawal
+   * moves anything — `withdrawAndSwap` repeats it on its own quote, but by
+   * then the funds have already left the agent (ROUT-622).
+   */
+  async checkSwapGas(quote) {
+    const state = this.requireState();
+    const chain = swapChain(quote.src.chainId);
+    if (!chain) return;
+    const pub = createPublicClient2({
+      chain,
+      transport: swapReadTransport(quote.src.chainId, this.zyfaiRpcUrls)
+    });
+    const shortfall = await swapGasShortfall(
+      {
+        readNativeBalance: () => pub.getBalance({ address: state.walletAddress }),
+        // The 1559 ceiling, as the wrap reserve reads it.
+        getMaxFeePerGas: async () => {
+          const fees = await pub.estimateFeesPerGas();
+          return fees.maxFeePerGas ?? pub.getGasPrice();
+        }
+      },
+      quote
+    );
+    if (shortfall) throw swapGasError(shortfall, chain.nativeCurrency.symbol);
+  }
   /**
    * The half of the swap deps that only ever talks to the routing API.
    *
@@ -5753,8 +5911,15 @@ var OwneySDK = class {
       );
     }
     await this.ensureSwapChain(entry.chainId);
-    const deposit = await this.deposit({
-      amount: entry.received,
+    const token = entry.symbol === "WETH" ? SPONSORED_WETH_BY_CHAIN[entry.chainId] : void 0;
+    const amount = token ? await this.settleSwapDepositAmount(
+      entry.chainId,
+      token,
+      entry.symbol,
+      BigInt(entry.received)
+    ) : entry.received;
+    const { deposit } = await this.depositSwapOutput({
+      amount,
       asset: entry.symbol,
       ...entry.agentId ? { agentId: entry.agentId } : {}
     });
@@ -5994,12 +6159,12 @@ var OwneySDK = class {
         options.to.symbol,
         BigInt(swap.received)
       );
-      const deposit = await this.deposit({
+      const { deposit, deposited } = await this.depositSwapOutput({
         amount,
         asset: options.to.symbol,
         ...options.agentId ? { agentId: options.agentId } : {}
       });
-      return { swap, deposit, deposited: amount };
+      return { swap, deposit, deposited };
     } catch (error) {
       const pending = {
         id: `${quote.dst.chainId}-${options.to.symbol}-${Date.now()}`,
@@ -6103,6 +6268,7 @@ var OwneySDK = class {
         walletAddress: state.walletAddress
       });
       await this.ensureSwapChain(quote.src.chainId);
+      await this.checkSwapGas(quote);
       const swap = await executeSwap(this.buildSwapDeps(quote), {
         quote,
         walletAddress: state.walletAddress,
@@ -6613,6 +6779,25 @@ var OwneySDK = class {
     }
     await agent.setPoolSelection(params.selection);
   }
+  /**
+   * The pool selection saved on the user's account (ROUT-650), so the Pools
+   * step can show what applies now rather than the defaults. `pairs` and
+   * `assets` say which protocol/chain lists and strategies to read.
+   */
+  async getPoolSelection(params) {
+    await this.ensureAgentsInitialized();
+    const agent = this.getAgent(params.agentId ?? "zyfai");
+    if (!agent.getPoolSelection) {
+      throw new OwneyError(
+        "POOL_SELECTION_UNSUPPORTED",
+        `Agent ${agent.id} does not support pool customization`
+      );
+    }
+    return agent.getPoolSelection({
+      pairs: params.pairs,
+      assets: params.assets
+    });
+  }
   async getAccountApy({
     agentId,
     days,

package/package.json

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