@owney/sdk 0.7.22-beta.1 → 0.7.22-beta.2

package/dist/{chunk-3HL52KM7.js → chunk-5W56YOBO.js}

@@ -205,6 +205,17 @@ async function permitIfShort(input) {
     s
   };
 }
+async function readStuckBalance(input) {
+  return input.chain.usdcBalanceOf(input.wallet.smartAccountAddress);
+}
+async function sweepStuckBalance(input) {
+  const stranded = await readStuckBalance(input);
+  if (stranded === 0n) return { amount: 0n };
+  const txHash = await input.wallet.sendCalls(
+    buildSweepCalls({ owner: input.wallet.ownerAddress, amount: stranded })
+  );
+  return { txHash, amount: stranded };
+}
 async function depositSponsored(input) {
   const { api, chain, wallet, amount } = input;
   const { vault, deploySalt, registerAfterDeposit } = await resolveVault(input);
@@ -251,7 +262,15 @@ async function withdrawSponsored(input) {
   if (owner.toLowerCase() !== wallet.smartAccountAddress.toLowerCase()) {
     throw new VaultNotSponsorableError(`SurfLiquid vault ${vault} is not owned by the smart account`);
   }
-  const withdrawHash = await wallet.sendCalls(buildWithdrawCalls({ vault, amount }));
+  let withdrawHash;
+  try {
+    withdrawHash = await wallet.sendCalls(buildWithdrawCalls({ vault, amount }));
+  } catch (redeemError) {
+    const stranded = await chain.usdcBalanceOf(wallet.smartAccountAddress);
+    if (stranded === 0n) throw redeemError;
+    const sweepHash = await wallet.sendCalls(buildSweepCalls({ owner: wallet.ownerAddress, amount: stranded }));
+    return { txHash: sweepHash, amount: stranded.toString() };
+  }
   try {
     const proceeds = await chain.usdcBalanceOf(wallet.smartAccountAddress);
     if (proceeds === 0n) return { txHash: withdrawHash, amount: "0" };
@@ -278,6 +297,8 @@ export {
   USDC_ABI,
   SubmittedError,
   VaultNotSponsorableError,
+  readStuckBalance,
+  sweepStuckBalance,
   depositSponsored,
   withdrawSponsored
 };

package/dist/index.cjs

@@ -803,6 +803,17 @@ async function permitIfShort(input) {
     s
   };
 }
+async function readStuckBalance(input) {
+  return input.chain.usdcBalanceOf(input.wallet.smartAccountAddress);
+}
+async function sweepStuckBalance(input) {
+  const stranded = await readStuckBalance(input);
+  if (stranded === 0n) return { amount: 0n };
+  const txHash = await input.wallet.sendCalls(
+    buildSweepCalls({ owner: input.wallet.ownerAddress, amount: stranded })
+  );
+  return { txHash, amount: stranded };
+}
 async function depositSponsored(input) {
   const { api, chain, wallet, amount } = input;
   const { vault, deploySalt, registerAfterDeposit } = await resolveVault(input);
@@ -849,7 +860,15 @@ async function withdrawSponsored(input) {
   if (owner.toLowerCase() !== wallet.smartAccountAddress.toLowerCase()) {
     throw new VaultNotSponsorableError(`SurfLiquid vault ${vault} is not owned by the smart account`);
   }
-  const withdrawHash = await wallet.sendCalls(buildWithdrawCalls({ vault, amount }));
+  let withdrawHash;
+  try {
+    withdrawHash = await wallet.sendCalls(buildWithdrawCalls({ vault, amount }));
+  } catch (redeemError) {
+    const stranded = await chain.usdcBalanceOf(wallet.smartAccountAddress);
+    if (stranded === 0n) throw redeemError;
+    const sweepHash = await wallet.sendCalls(buildSweepCalls({ owner: wallet.ownerAddress, amount: stranded }));
+    return { txHash: sweepHash, amount: stranded.toString() };
+  }
   try {
     const proceeds = await chain.usdcBalanceOf(wallet.smartAccountAddress);
     if (proceeds === 0n) return { txHash: withdrawHash, amount: "0" };
@@ -1266,6 +1285,24 @@ var init_surfliquid_agent = __esm({
           throw toOwneyError(error);
         }
       }
+      /** Funds a prior withdrawal's sweep left in the smart account (never reached the EOA). No session needed — pure read. */
+      async getStuckBalance(state) {
+        const wallet = await this.sponsoredWallet(state);
+        const { createSponsoredChain: createSponsoredChain2 } = await Promise.resolve().then(() => (init_surfliquid_smart_account(), surfliquid_smart_account_exports));
+        const amount = await readStuckBalance({ chain: createSponsoredChain2(this.config.rpcUrl), wallet });
+        return { amount: amount.toString(), smartAccountAddress: wallet.smartAccountAddress };
+      }
+      /** Sweep the stranded balance to the owner's EOA — one sponsored userOp, one signature. */
+      async recoverStuckBalance(state) {
+        const wallet = await this.sponsoredWallet(state);
+        const { createSponsoredChain: createSponsoredChain2 } = await Promise.resolve().then(() => (init_surfliquid_smart_account(), surfliquid_smart_account_exports));
+        try {
+          const { txHash, amount } = await sweepStuckBalance({ chain: createSponsoredChain2(this.config.rpcUrl), wallet });
+          return { txHash, type: "full", amount: amount.toString() };
+        } catch (error) {
+          throw toOwneyError(error);
+        }
+      }
       // --- IAgent: portfolio reads ---
       async vault(state) {
         const broker = await this.connect(state);
@@ -5027,6 +5064,31 @@ var OwneySDK = class {
     }
     return { agentResult: results, totalWithdrawn: withdrawn.toString() };
   }
+  /**
+   * Funds a prior withdrawal left stranded in the agent's smart account (the
+   * payout leg never reached the owner's EOA). Read-only — check once after
+   * connect. Agents without a smart account model report "0".
+   */
+  async getStuckBalance(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const agent = this.getAgent(agentId);
+    if (!agent.getStuckBalance) return { amount: "0", smartAccountAddress: "" };
+    return agent.getStuckBalance(state, chainId);
+  }
+  /** Sweep that stranded balance to the owner's EOA — one signature. No-op ("0") when nothing is stuck. */
+  async recoverStuckBalance(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const agent = this.getAgent(agentId);
+    if (!agent.recoverStuckBalance) return { type: "full", amount: "0" };
+    return withFailureReporting(
+      this.apiKey,
+      agent.id,
+      () => agent.recoverStuckBalance(state, chainId),
+      this.routingApiBaseUrl
+    );
+  }
   // --- Portfolio reads ---
   /**
    * Get the user's balances for a specific agent, or aggregated across all agents.

package/dist/index.d.cts

@@ -195,6 +195,13 @@ interface AgentWithdrawResult {
     /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
 }
+/** Funds a prior withdrawal left in the agent's smart account, awaiting recovery to the owner's EOA. */
+interface AgentStuckBalance {
+    /** Smallest-unit amount stuck in the smart account; "0" when nothing is stuck. */
+    amount: string;
+    /** The smart account holding the funds (for display / on-chain verification). */
+    smartAccountAddress: string;
+}
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
     /**
@@ -446,6 +453,14 @@ interface IAgent {
      * a write occurred (`false` = already enabled / not supported).
      */
     ensureAutoSelectProtocols?(state: ConnectionState, chainId: number, asset: "USDC" | "WETH"): Promise<boolean>;
+    /**
+     * Read funds a prior withdrawal left stranded in the agent's smart account
+     * (the payout leg never reached the owner's EOA). Optional capability — only
+     * agents with a per-user smart account model this. Checked once after connect.
+     */
+    getStuckBalance?(state: ConnectionState, chainId: number): Promise<AgentStuckBalance>;
+    /** Sweep that stranded balance to the owner's EOA. No-op (amount "0") when nothing is stuck. */
+    recoverStuckBalance?(state: ConnectionState, chainId: number): Promise<AgentWithdrawResult>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
 }
 /**
@@ -656,6 +671,14 @@ declare class OwneySDK {
      * @returns {AgentWithdrawResult} for a single agent, or {OwneyWithdrawResult} with per-agent results
      */
     withdraw(options: WithdrawOptions): Promise<OwneyWithdrawResult | AgentWithdrawResult>;
+    /**
+     * Funds a prior withdrawal left stranded in the agent's smart account (the
+     * payout leg never reached the owner's EOA). Read-only — check once after
+     * connect. Agents without a smart account model report "0".
+     */
+    getStuckBalance(agentId: AgentId): Promise<AgentStuckBalance>;
+    /** Sweep that stranded balance to the owner's EOA — one signature. No-op ("0") when nothing is stuck. */
+    recoverStuckBalance(agentId: AgentId): Promise<AgentWithdrawResult>;
     /**
      * Get the user's balances for a specific agent, or aggregated across all agents.
      * @param agentId - Optional. Agent to query. Omit for aggregated balances.
@@ -812,4 +835,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { type AccountAgentApy, type AccountApyOptions, 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 AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, 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 RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentStuckBalance, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, 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 RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };

package/dist/index.d.ts

@@ -195,6 +195,13 @@ interface AgentWithdrawResult {
     /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
 }
+/** Funds a prior withdrawal left in the agent's smart account, awaiting recovery to the owner's EOA. */
+interface AgentStuckBalance {
+    /** Smallest-unit amount stuck in the smart account; "0" when nothing is stuck. */
+    amount: string;
+    /** The smart account holding the funds (for display / on-chain verification). */
+    smartAccountAddress: string;
+}
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
     /**
@@ -446,6 +453,14 @@ interface IAgent {
      * a write occurred (`false` = already enabled / not supported).
      */
     ensureAutoSelectProtocols?(state: ConnectionState, chainId: number, asset: "USDC" | "WETH"): Promise<boolean>;
+    /**
+     * Read funds a prior withdrawal left stranded in the agent's smart account
+     * (the payout leg never reached the owner's EOA). Optional capability — only
+     * agents with a per-user smart account model this. Checked once after connect.
+     */
+    getStuckBalance?(state: ConnectionState, chainId: number): Promise<AgentStuckBalance>;
+    /** Sweep that stranded balance to the owner's EOA. No-op (amount "0") when nothing is stuck. */
+    recoverStuckBalance?(state: ConnectionState, chainId: number): Promise<AgentWithdrawResult>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
 }
 /**
@@ -656,6 +671,14 @@ declare class OwneySDK {
      * @returns {AgentWithdrawResult} for a single agent, or {OwneyWithdrawResult} with per-agent results
      */
     withdraw(options: WithdrawOptions): Promise<OwneyWithdrawResult | AgentWithdrawResult>;
+    /**
+     * Funds a prior withdrawal left stranded in the agent's smart account (the
+     * payout leg never reached the owner's EOA). Read-only — check once after
+     * connect. Agents without a smart account model report "0".
+     */
+    getStuckBalance(agentId: AgentId): Promise<AgentStuckBalance>;
+    /** Sweep that stranded balance to the owner's EOA — one signature. No-op ("0") when nothing is stuck. */
+    recoverStuckBalance(agentId: AgentId): Promise<AgentWithdrawResult>;
     /**
      * Get the user's balances for a specific agent, or aggregated across all agents.
      * @param agentId - Optional. Agent to query. Omit for aggregated balances.
@@ -812,4 +835,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { type AccountAgentApy, type AccountApyOptions, 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 AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, 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 RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentStuckBalance, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, 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 RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };

package/dist/index.js

@@ -3036,7 +3036,7 @@ var OwneySDK = class {
     }
     if (agentId === "surfliquid") {
       if (!key2) return null;
-      const { SurfLiquidAgent } = await import("./surfliquid.agent-AE7RZ66F.js");
+      const { SurfLiquidAgent } = await import("./surfliquid.agent-E54CPWXF.js");
       return new SurfLiquidAgent({
         apiKey: this.apiKey,
         routingApiBaseUrl: this.routingApiBaseUrl
@@ -3691,6 +3691,31 @@ var OwneySDK = class {
     }
     return { agentResult: results, totalWithdrawn: withdrawn.toString() };
   }
+  /**
+   * Funds a prior withdrawal left stranded in the agent's smart account (the
+   * payout leg never reached the owner's EOA). Read-only — check once after
+   * connect. Agents without a smart account model report "0".
+   */
+  async getStuckBalance(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const agent = this.getAgent(agentId);
+    if (!agent.getStuckBalance) return { amount: "0", smartAccountAddress: "" };
+    return agent.getStuckBalance(state, chainId);
+  }
+  /** Sweep that stranded balance to the owner's EOA — one signature. No-op ("0") when nothing is stuck. */
+  async recoverStuckBalance(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const agent = this.getAgent(agentId);
+    if (!agent.recoverStuckBalance) return { type: "full", amount: "0" };
+    return withFailureReporting(
+      this.apiKey,
+      agent.id,
+      () => agent.recoverStuckBalance(state, chainId),
+      this.routingApiBaseUrl
+    );
+  }
   // --- Portfolio reads ---
   /**
    * Get the user's balances for a specific agent, or aggregated across all agents.

package/dist/{surfliquid.agent-AE7RZ66F.js → surfliquid.agent-E54CPWXF.js}

@@ -10,8 +10,10 @@ import {
   SubmittedError,
   VaultNotSponsorableError,
   depositSponsored,
+  readStuckBalance,
+  sweepStuckBalance,
   withdrawSponsored
-} from "./chunk-3HL52KM7.js";
+} from "./chunk-5W56YOBO.js";
 import "./chunk-AURO3C3R.js";
 
 // src/agents/surfliquid/surfliquid.agent.ts
@@ -533,7 +535,7 @@ var SurfLiquidAgent = class {
     }
   }
   async sponsoredWallet(state) {
-    const { createSponsoredWallet } = await import("./surfliquid.smart-account-C535356J.js");
+    const { createSponsoredWallet } = await import("./surfliquid.smart-account-O6YPCQT3.js");
     return createSponsoredWallet({
       provider: state.provider,
       ownerAddress: state.walletAddress,
@@ -555,7 +557,7 @@ var SurfLiquidAgent = class {
   async deposit(state, _chainId, amount, _asset, _depositCallback) {
     const broker = await this.connect(state);
     const wallet = await this.sponsoredWallet(state);
-    const { createSponsoredChain } = await import("./surfliquid.smart-account-C535356J.js");
+    const { createSponsoredChain } = await import("./surfliquid.smart-account-O6YPCQT3.js");
     try {
       const { txHash, vault } = await this.withSession(
         state,
@@ -570,7 +572,7 @@ var SurfLiquidAgent = class {
   async withdraw(state, _chainId, _token, amount) {
     const broker = await this.connect(state);
     const wallet = await this.sponsoredWallet(state);
-    const { createSponsoredChain } = await import("./surfliquid.smart-account-C535356J.js");
+    const { createSponsoredChain } = await import("./surfliquid.smart-account-O6YPCQT3.js");
     try {
       const result = await this.withSession(
         state,
@@ -587,6 +589,24 @@ var SurfLiquidAgent = class {
       throw toOwneyError(error);
     }
   }
+  /** Funds a prior withdrawal's sweep left in the smart account (never reached the EOA). No session needed — pure read. */
+  async getStuckBalance(state) {
+    const wallet = await this.sponsoredWallet(state);
+    const { createSponsoredChain } = await import("./surfliquid.smart-account-O6YPCQT3.js");
+    const amount = await readStuckBalance({ chain: createSponsoredChain(this.config.rpcUrl), wallet });
+    return { amount: amount.toString(), smartAccountAddress: wallet.smartAccountAddress };
+  }
+  /** Sweep the stranded balance to the owner's EOA — one sponsored userOp, one signature. */
+  async recoverStuckBalance(state) {
+    const wallet = await this.sponsoredWallet(state);
+    const { createSponsoredChain } = await import("./surfliquid.smart-account-O6YPCQT3.js");
+    try {
+      const { txHash, amount } = await sweepStuckBalance({ chain: createSponsoredChain(this.config.rpcUrl), wallet });
+      return { txHash, type: "full", amount: amount.toString() };
+    } catch (error) {
+      throw toOwneyError(error);
+    }
+  }
   // --- IAgent: portfolio reads ---
   async vault(state) {
     const broker = await this.connect(state);

package/dist/{surfliquid.smart-account-C535356J.js → surfliquid.smart-account-O6YPCQT3.js}

@@ -6,7 +6,7 @@ import {
   SURFLIQUID_VAULT_ABI,
   SubmittedError,
   USDC_ABI
-} from "./chunk-3HL52KM7.js";
+} from "./chunk-5W56YOBO.js";
 import {
   readTokenMeta
 } from "./chunk-AURO3C3R.js";

package/package.json

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