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

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

@@ -1,12 +1,13 @@
 import {
-  buildReceiveWithAuthorizationTypedData,
-  randomAuthNonce
-} from "./chunk-5LU2SHO7.js";
+  buildPermitTypedData
+} from "./chunk-AURO3C3R.js";
 
 // src/agents/surfliquid/surfliquid.constants.ts
 var SURFLIQUID_CHAIN_ID = 8453;
 var SURFLIQUID_CHAIN_NAME = "BASE";
 var SURFLIQUID_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var SURFLIQUID_PERMIT_CAP = 10000000000n;
+var SURFLIQUID_PERMIT_TTL_SECONDS = 3600n;
 var SURFLIQUID_MIN_DEPOSIT = "0";
 var SURFLIQUID_SUPPORTED_ASSETS = [
   {
@@ -49,10 +50,16 @@ var SURFLIQUID_VAULT_ABI = parseAbi([
 var USDC_ABI = parseAbi([
   "function approve(address spender, uint256 amount)",
   "function transfer(address to, uint256 amount)",
+  "function transferFrom(address from, address to, uint256 value)",
   "function balanceOf(address account) view returns (uint256)",
-  "function receiveWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce, bytes signature)"
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function nonces(address owner) view returns (uint256)",
+  "function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)"
 ]);
 
+// src/agents/surfliquid/surfliquid.sponsorship.ts
+import { parseSignature } from "viem";
+
 // src/agents/surfliquid/surfliquid.calls.ts
 import { encodeFunctionData } from "viem";
 var call = (to, abi, functionName, args) => ({
@@ -60,12 +67,12 @@ var call = (to, abi, functionName, args) => ({
   data: encodeFunctionData({ abi, functionName, args })
 });
 function buildDepositCalls(input) {
-  const { smartAccount, vault, amount, authorization, deploySalt } = input;
-  if (authorization.to.toLowerCase() !== smartAccount.toLowerCase()) {
-    throw new Error("Transfer authorization must pay the smart account");
+  const { smartAccount, owner, vault, amount, permit, deploySalt } = input;
+  if (permit && permit.owner.toLowerCase() !== owner.toLowerCase()) {
+    throw new Error("Permit must be signed by the smart account's owner");
   }
-  if (authorization.value < amount) {
-    throw new Error("Transfer authorization is worth less than the deposit");
+  if (permit && permit.value < amount) {
+    throw new Error("Permit allowance is worth less than the deposit");
   }
   if (!input.hasInitialDeposit && !input.morphoVault) {
     throw new Error("A first deposit needs a target morpho vault");
@@ -79,16 +86,21 @@ function buildDepositCalls(input) {
       ])
     );
   }
+  if (permit) {
+    calls.push(
+      call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "permit", [
+        permit.owner,
+        smartAccount,
+        permit.value,
+        permit.deadline,
+        permit.v,
+        permit.r,
+        permit.s
+      ])
+    );
+  }
   calls.push(
-    call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "receiveWithAuthorization", [
-      authorization.from,
-      authorization.to,
-      authorization.value,
-      authorization.validAfter,
-      authorization.validBefore,
-      authorization.nonce,
-      authorization.signature
-    ]),
+    call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "transferFrom", [owner, smartAccount, amount]),
     call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "approve", [vault, amount]),
     input.hasInitialDeposit ? call(vault, SURFLIQUID_VAULT_ABI, "userDeposit", [SURFLIQUID_USDC_ADDRESS, amount]) : call(vault, SURFLIQUID_VAULT_ABI, "initialDeposit", [
       SURFLIQUID_USDC_ADDRESS,
@@ -111,7 +123,6 @@ function buildSweepCalls(input) {
 }
 
 // src/agents/surfliquid/surfliquid.sponsorship.ts
-var AUTHORIZATION_TTL_SECONDS = 3600n;
 var SubmittedError = class extends Error {
   constructor(message, userOpHash) {
     super(message);
@@ -160,22 +171,23 @@ async function pickMorphoVault(api) {
   }
   return candidate.vaultAddress;
 }
-async function depositSponsored(input) {
-  const { api, chain, wallet, amount } = input;
-  const { vault, deploySalt, registerAfterDeposit } = await resolveVault(input);
-  const hasInitialDeposit = deploySalt ? false : await chain.hasInitialDeposit(vault, SURFLIQUID_USDC_ADDRESS);
-  const morphoVault = hasInitialDeposit ? void 0 : await pickMorphoVault(api);
-  const { tokenName, tokenVersion } = await chain.readTokenMeta();
+async function permitIfShort(input) {
+  const { chain, wallet, amount } = input;
+  const allowance = await chain.readAllowance(wallet.ownerAddress, wallet.smartAccountAddress);
+  if (allowance >= amount) return void 0;
+  const [{ tokenName, tokenVersion }, nonce] = await Promise.all([
+    chain.readTokenMeta(),
+    chain.readPermitNonce(wallet.ownerAddress)
+  ]);
   const message = {
-    from: wallet.ownerAddress,
-    to: wallet.smartAccountAddress,
-    value: amount,
-    validAfter: 0n,
-    validBefore: BigInt(Math.floor(Date.now() / 1e3)) + AUTHORIZATION_TTL_SECONDS,
-    nonce: randomAuthNonce()
+    owner: wallet.ownerAddress,
+    spender: wallet.smartAccountAddress,
+    value: amount > SURFLIQUID_PERMIT_CAP ? amount : SURFLIQUID_PERMIT_CAP,
+    nonce,
+    deadline: BigInt(Math.floor(Date.now() / 1e3)) + SURFLIQUID_PERMIT_TTL_SECONDS
   };
-  const signature = await wallet.signTransferAuthorization(
-    buildReceiveWithAuthorizationTypedData({
+  const signature = await wallet.signPermit(
+    buildPermitTypedData({
       token: SURFLIQUID_USDC_ADDRESS,
       chainId: SURFLIQUID_CHAIN_ID,
       tokenName,
@@ -183,12 +195,40 @@ async function depositSponsored(input) {
       message
     })
   );
+  const { r, s, v, yParity } = parseSignature(signature);
+  return {
+    owner: message.owner,
+    value: message.value,
+    deadline: message.deadline,
+    v: Number(v ?? BigInt(yParity + 27)),
+    r,
+    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);
+  const hasInitialDeposit = deploySalt ? false : await chain.hasInitialDeposit(vault, SURFLIQUID_USDC_ADDRESS);
+  const morphoVault = hasInitialDeposit ? void 0 : await pickMorphoVault(api);
+  const permit = await permitIfShort({ chain, wallet, amount });
   const txHash = await wallet.sendCalls(
     buildDepositCalls({
       smartAccount: wallet.smartAccountAddress,
+      owner: wallet.ownerAddress,
       vault,
       amount,
-      authorization: { ...message, signature },
+      permit,
       hasInitialDeposit,
       morphoVault,
       deploySalt
@@ -222,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" };
@@ -249,6 +297,8 @@ export {
   USDC_ABI,
   SubmittedError,
   VaultNotSponsorableError,
+  readStuckBalance,
+  sweepStuckBalance,
   depositSponsored,
   withdrawSponsored
 };

package/dist/{chunk-5LU2SHO7.js → chunk-AURO3C3R.js}

@@ -21,14 +21,6 @@ function buildTransferWithAuthorizationTypedData(input) {
     message: input.message
   };
 }
-function buildReceiveWithAuthorizationTypedData(input) {
-  const transfer = buildTransferWithAuthorizationTypedData(input);
-  return {
-    ...transfer,
-    types: { ReceiveWithAuthorization: transfer.types.TransferWithAuthorization },
-    primaryType: "ReceiveWithAuthorization"
-  };
-}
 async function readTokenMeta(publicClient, token) {
   const [tokenName, tokenVersion] = await Promise.all([
     publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "name" }),
@@ -41,10 +33,26 @@ function randomAuthNonce() {
   globalThis.crypto.getRandomValues(bytes);
   return bytesToHex(bytes);
 }
+function buildPermitTypedData(input) {
+  return {
+    domain: { name: input.tokenName, version: input.tokenVersion, chainId: input.chainId, verifyingContract: input.token },
+    types: {
+      Permit: [
+        { name: "owner", type: "address" },
+        { name: "spender", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" }
+      ]
+    },
+    primaryType: "Permit",
+    message: input.message
+  };
+}
 
 export {
   buildTransferWithAuthorizationTypedData,
-  buildReceiveWithAuthorizationTypedData,
   readTokenMeta,
-  randomAuthNonce
+  randomAuthNonce,
+  buildPermitTypedData
 };

package/dist/index.cjs

@@ -193,14 +193,6 @@ function buildTransferWithAuthorizationTypedData(input) {
     message: input.message
   };
 }
-function buildReceiveWithAuthorizationTypedData(input) {
-  const transfer = buildTransferWithAuthorizationTypedData(input);
-  return {
-    ...transfer,
-    types: { ReceiveWithAuthorization: transfer.types.TransferWithAuthorization },
-    primaryType: "ReceiveWithAuthorization"
-  };
-}
 async function readTokenMeta(publicClient, token) {
   const [tokenName, tokenVersion] = await Promise.all([
     publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "name" }),
@@ -213,6 +205,22 @@ function randomAuthNonce() {
   globalThis.crypto.getRandomValues(bytes);
   return (0, import_viem3.bytesToHex)(bytes);
 }
+function buildPermitTypedData(input) {
+  return {
+    domain: { name: input.tokenName, version: input.tokenVersion, chainId: input.chainId, verifyingContract: input.token },
+    types: {
+      Permit: [
+        { name: "owner", type: "address" },
+        { name: "spender", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" }
+      ]
+    },
+    primaryType: "Permit",
+    message: input.message
+  };
+}
 var import_viem3, ERC20_META_ABI;
 var init_transfer_auth = __esm({
   "src/lib/transfer-auth.ts"() {
@@ -226,13 +234,15 @@ var init_transfer_auth = __esm({
 });
 
 // src/agents/surfliquid/surfliquid.constants.ts
-var SURFLIQUID_CHAIN_ID, SURFLIQUID_CHAIN_NAME, SURFLIQUID_USDC_ADDRESS, SURFLIQUID_MIN_DEPOSIT, SURFLIQUID_SUPPORTED_ASSETS, SURFLIQUID_ACTION_MAP;
+var SURFLIQUID_CHAIN_ID, SURFLIQUID_CHAIN_NAME, SURFLIQUID_USDC_ADDRESS, SURFLIQUID_PERMIT_CAP, SURFLIQUID_PERMIT_TTL_SECONDS, SURFLIQUID_MIN_DEPOSIT, SURFLIQUID_SUPPORTED_ASSETS, SURFLIQUID_ACTION_MAP;
 var init_surfliquid_constants = __esm({
   "src/agents/surfliquid/surfliquid.constants.ts"() {
     "use strict";
     SURFLIQUID_CHAIN_ID = 8453;
     SURFLIQUID_CHAIN_NAME = "BASE";
     SURFLIQUID_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    SURFLIQUID_PERMIT_CAP = 10000000000n;
+    SURFLIQUID_PERMIT_TTL_SECONDS = 3600n;
     SURFLIQUID_MIN_DEPOSIT = "0";
     SURFLIQUID_SUPPORTED_ASSETS = [
       {
@@ -645,20 +655,23 @@ var init_surfliquid_contracts = __esm({
     USDC_ABI = (0, import_viem6.parseAbi)([
       "function approve(address spender, uint256 amount)",
       "function transfer(address to, uint256 amount)",
+      "function transferFrom(address from, address to, uint256 value)",
       "function balanceOf(address account) view returns (uint256)",
-      "function receiveWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce, bytes signature)"
+      "function allowance(address owner, address spender) view returns (uint256)",
+      "function nonces(address owner) view returns (uint256)",
+      "function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)"
     ]);
   }
 });
 
 // src/agents/surfliquid/surfliquid.calls.ts
 function buildDepositCalls(input) {
-  const { smartAccount, vault, amount, authorization, deploySalt } = input;
-  if (authorization.to.toLowerCase() !== smartAccount.toLowerCase()) {
-    throw new Error("Transfer authorization must pay the smart account");
+  const { smartAccount, owner, vault, amount, permit, deploySalt } = input;
+  if (permit && permit.owner.toLowerCase() !== owner.toLowerCase()) {
+    throw new Error("Permit must be signed by the smart account's owner");
   }
-  if (authorization.value < amount) {
-    throw new Error("Transfer authorization is worth less than the deposit");
+  if (permit && permit.value < amount) {
+    throw new Error("Permit allowance is worth less than the deposit");
   }
   if (!input.hasInitialDeposit && !input.morphoVault) {
     throw new Error("A first deposit needs a target morpho vault");
@@ -672,16 +685,21 @@ function buildDepositCalls(input) {
       ])
     );
   }
+  if (permit) {
+    calls.push(
+      call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "permit", [
+        permit.owner,
+        smartAccount,
+        permit.value,
+        permit.deadline,
+        permit.v,
+        permit.r,
+        permit.s
+      ])
+    );
+  }
   calls.push(
-    call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "receiveWithAuthorization", [
-      authorization.from,
-      authorization.to,
-      authorization.value,
-      authorization.validAfter,
-      authorization.validBefore,
-      authorization.nonce,
-      authorization.signature
-    ]),
+    call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "transferFrom", [owner, smartAccount, amount]),
     call(SURFLIQUID_USDC_ADDRESS, USDC_ABI, "approve", [vault, amount]),
     input.hasInitialDeposit ? call(vault, SURFLIQUID_VAULT_ABI, "userDeposit", [SURFLIQUID_USDC_ADDRESS, amount]) : call(vault, SURFLIQUID_VAULT_ABI, "initialDeposit", [
       SURFLIQUID_USDC_ADDRESS,
@@ -751,22 +769,23 @@ async function pickMorphoVault(api) {
   }
   return candidate.vaultAddress;
 }
-async function depositSponsored(input) {
-  const { api, chain, wallet, amount } = input;
-  const { vault, deploySalt, registerAfterDeposit } = await resolveVault(input);
-  const hasInitialDeposit = deploySalt ? false : await chain.hasInitialDeposit(vault, SURFLIQUID_USDC_ADDRESS);
-  const morphoVault = hasInitialDeposit ? void 0 : await pickMorphoVault(api);
-  const { tokenName, tokenVersion } = await chain.readTokenMeta();
+async function permitIfShort(input) {
+  const { chain, wallet, amount } = input;
+  const allowance = await chain.readAllowance(wallet.ownerAddress, wallet.smartAccountAddress);
+  if (allowance >= amount) return void 0;
+  const [{ tokenName, tokenVersion }, nonce] = await Promise.all([
+    chain.readTokenMeta(),
+    chain.readPermitNonce(wallet.ownerAddress)
+  ]);
   const message = {
-    from: wallet.ownerAddress,
-    to: wallet.smartAccountAddress,
-    value: amount,
-    validAfter: 0n,
-    validBefore: BigInt(Math.floor(Date.now() / 1e3)) + AUTHORIZATION_TTL_SECONDS,
-    nonce: randomAuthNonce()
+    owner: wallet.ownerAddress,
+    spender: wallet.smartAccountAddress,
+    value: amount > SURFLIQUID_PERMIT_CAP ? amount : SURFLIQUID_PERMIT_CAP,
+    nonce,
+    deadline: BigInt(Math.floor(Date.now() / 1e3)) + SURFLIQUID_PERMIT_TTL_SECONDS
   };
-  const signature = await wallet.signTransferAuthorization(
-    buildReceiveWithAuthorizationTypedData({
+  const signature = await wallet.signPermit(
+    buildPermitTypedData({
       token: SURFLIQUID_USDC_ADDRESS,
       chainId: SURFLIQUID_CHAIN_ID,
       tokenName,
@@ -774,12 +793,40 @@ async function depositSponsored(input) {
       message
     })
   );
+  const { r, s, v, yParity } = (0, import_viem8.parseSignature)(signature);
+  return {
+    owner: message.owner,
+    value: message.value,
+    deadline: message.deadline,
+    v: Number(v ?? BigInt(yParity + 27)),
+    r,
+    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);
+  const hasInitialDeposit = deploySalt ? false : await chain.hasInitialDeposit(vault, SURFLIQUID_USDC_ADDRESS);
+  const morphoVault = hasInitialDeposit ? void 0 : await pickMorphoVault(api);
+  const permit = await permitIfShort({ chain, wallet, amount });
   const txHash = await wallet.sendCalls(
     buildDepositCalls({
       smartAccount: wallet.smartAccountAddress,
+      owner: wallet.ownerAddress,
       vault,
       amount,
-      authorization: { ...message, signature },
+      permit,
       hasInitialDeposit,
       morphoVault,
       deploySalt
@@ -813,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" };
@@ -827,14 +882,14 @@ async function withdrawSponsored(input) {
     );
   }
 }
-var AUTHORIZATION_TTL_SECONDS, SubmittedError, VaultNotSponsorableError;
+var import_viem8, SubmittedError, VaultNotSponsorableError;
 var init_surfliquid_sponsorship = __esm({
   "src/agents/surfliquid/surfliquid.sponsorship.ts"() {
     "use strict";
+    import_viem8 = require("viem");
     init_transfer_auth();
     init_surfliquid_constants();
     init_surfliquid_calls();
-    AUTHORIZATION_TTL_SECONDS = 3600n;
     SubmittedError = class extends Error {
       constructor(message, userOpHash) {
         super(message);
@@ -946,7 +1001,7 @@ __export(surfliquid_smart_account_exports, {
   pinAccount: () => pinAccount
 });
 function publicClientFor(rpcUrl) {
-  return (0, import_viem8.createPublicClient)({ chain: import_chains2.base, transport: (0, import_viem8.http)(rpcUrl) });
+  return (0, import_viem9.createPublicClient)({ chain: import_chains2.base, transport: (0, import_viem9.http)(rpcUrl) });
 }
 function createSponsoredChain(rpcUrl) {
   const client = publicClientFor(rpcUrl);
@@ -976,7 +1031,19 @@ function createSponsoredChain(rpcUrl) {
     }),
     // Cast: viem's OP-stack tx union does not match the generic PublicClient
     // the helper is typed against, though every method it uses is present.
-    readTokenMeta: () => readTokenMeta(client, SURFLIQUID_USDC_ADDRESS)
+    readTokenMeta: () => readTokenMeta(client, SURFLIQUID_USDC_ADDRESS),
+    readAllowance: (owner, spender) => client.readContract({
+      address: SURFLIQUID_USDC_ADDRESS,
+      abi: USDC_ABI,
+      functionName: "allowance",
+      args: [owner, spender]
+    }),
+    readPermitNonce: (owner) => client.readContract({
+      address: SURFLIQUID_USDC_ADDRESS,
+      abi: USDC_ABI,
+      functionName: "nonces",
+      args: [owner]
+    })
   };
 }
 function pinAccount(provider, address) {
@@ -992,7 +1059,7 @@ async function createSponsoredWallet(input) {
     owner: pinAccount(input.provider, input.ownerAddress),
     entryPoint
   });
-  const bundlerTransport = (0, import_viem8.http)(sponsorProxyUrl(input.routingApiBaseUrl), {
+  const bundlerTransport = (0, import_viem9.http)(sponsorProxyUrl(input.routingApiBaseUrl), {
     fetchOptions: { headers: { "x-owney-api-key": input.apiKey } }
   });
   const pimlico = (0, import_pimlico.createPimlicoClient)({ transport: bundlerTransport, entryPoint });
@@ -1005,16 +1072,16 @@ async function createSponsoredWallet(input) {
       estimateFeesPerGas: async () => (await pimlico.getUserOperationGasPrice()).fast
     }
   });
-  const walletClient = (0, import_viem8.createWalletClient)({
+  const walletClient = (0, import_viem9.createWalletClient)({
     account: input.ownerAddress,
     chain: import_chains2.base,
-    transport: (0, import_viem8.custom)(input.provider)
+    transport: (0, import_viem9.custom)(input.provider)
   });
   return {
     smartAccountAddress: account.address,
     ownerAddress: input.ownerAddress,
     // The EOA signs, not the smart account: USDC verifies ECDSA from the token holder.
-    signTransferAuthorization: (typedData) => walletClient.signTypedData({
+    signPermit: (typedData) => walletClient.signTypedData({
       account: input.ownerAddress,
       domain: typedData.domain,
       types: typedData.types,
@@ -1037,14 +1104,14 @@ async function createSponsoredWallet(input) {
     }
   };
 }
-var import_permissionless, import_accounts, import_pimlico, import_viem8, import_account_abstraction, import_chains2, sponsorProxyUrl;
+var import_permissionless, import_accounts, import_pimlico, import_viem9, import_account_abstraction, import_chains2, sponsorProxyUrl;
 var init_surfliquid_smart_account = __esm({
   "src/agents/surfliquid/surfliquid.smart-account.ts"() {
     "use strict";
     import_permissionless = require("permissionless");
     import_accounts = require("permissionless/accounts");
     import_pimlico = require("permissionless/clients/pimlico");
-    import_viem8 = require("viem");
+    import_viem9 = require("viem");
     import_account_abstraction = require("viem/account-abstraction");
     import_chains2 = require("viem/chains");
     init_transfer_auth();
@@ -1075,11 +1142,11 @@ function toOwneyError(error) {
   }
   return new OwneyError("SPONSORSHIP_UNAVAILABLE", message, void 0, AGENT_ID2);
 }
-var import_viem9, import_chains3, AGENT_ID2, WALLET_REJECTED_CODE, DISCOVERY_WALLET2, HISTORY_DEFAULT_LIMIT, APY_WINDOW_KEY2, SurfLiquidAgent;
+var import_viem10, import_chains3, AGENT_ID2, WALLET_REJECTED_CODE, DISCOVERY_WALLET2, HISTORY_DEFAULT_LIMIT, APY_WINDOW_KEY2, SurfLiquidAgent;
 var init_surfliquid_agent = __esm({
   "src/agents/surfliquid/surfliquid.agent.ts"() {
     "use strict";
-    import_viem9 = require("viem");
+    import_viem10 = require("viem");
     import_chains3 = require("viem/chains");
     init_errors();
     init_surfliquid_constants();
@@ -1133,10 +1200,10 @@ var init_surfliquid_agent = __esm({
         if (this.connectPromise) return this.connectPromise;
         this.connectPromise = (async () => {
           const message = await broker.nonce();
-          const walletClient = (0, import_viem9.createWalletClient)({
+          const walletClient = (0, import_viem10.createWalletClient)({
             account: state.walletAddress,
             chain: import_chains3.base,
-            transport: (0, import_viem9.custom)(state.provider)
+            transport: (0, import_viem10.custom)(state.provider)
           });
           const signature = await walletClient.signMessage({ account: state.walletAddress, message });
           await broker.login(message, signature);
@@ -1218,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);
@@ -3481,7 +3566,7 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
 }
 
 // src/client.ts
-var import_viem10 = require("viem");
+var import_viem11 = require("viem");
 var import_chains4 = require("viem/chains");
 
 // src/lib/sponsored-deposit.ts
@@ -4160,14 +4245,14 @@ var OwneySDK = class {
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
       // runtime, but the two share a name TS treats as unrelated.
-      getPublicClient: (cid) => (0, import_viem10.createPublicClient)({
+      getPublicClient: (cid) => (0, import_viem11.createPublicClient)({
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem10.custom)(provider)
+        transport: (0, import_viem11.custom)(provider)
       }),
-      getWalletClient: (cid) => (0, import_viem10.createWalletClient)({
+      getWalletClient: (cid) => (0, import_viem11.createWalletClient)({
         account: owner,
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem10.custom)(provider)
+        transport: (0, import_viem11.custom)(provider)
       })
     });
     if (!onApproved) this.cachedSponsoredCallback = callback;
@@ -4213,14 +4298,14 @@ var OwneySDK = class {
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
       // runtime, but the two share a name TS treats as unrelated.
-      getPublicClient: (cid) => (0, import_viem10.createPublicClient)({
+      getPublicClient: (cid) => (0, import_viem11.createPublicClient)({
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem10.custom)(provider)
+        transport: (0, import_viem11.custom)(provider)
       }),
-      getWalletClient: (cid) => (0, import_viem10.createWalletClient)({
+      getWalletClient: (cid) => (0, import_viem11.createWalletClient)({
         account: owner,
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem10.custom)(provider)
+        transport: (0, import_viem11.custom)(provider)
       })
     });
     if (!onApproved) this.cachedWethSponsoredCallback = callback;
@@ -4979,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.
@@ -5314,10 +5424,10 @@ var OwneySDK = class {
       );
     }
     const provider = this.requireConnectedProvider();
-    const wallet = (0, import_viem10.createWalletClient)({
+    const wallet = (0, import_viem11.createWalletClient)({
       account: state.walletAddress,
       chain: VIEM_CHAIN2[chainId],
-      transport: (0, import_viem10.custom)(provider)
+      transport: (0, import_viem11.custom)(provider)
     });
     const hash = await wallet.writeContract({
       address: token,
@@ -5327,9 +5437,9 @@ var OwneySDK = class {
       account: state.walletAddress,
       chain: VIEM_CHAIN2[chainId]
     });
-    const publicClient = (0, import_viem10.createPublicClient)({
+    const publicClient = (0, import_viem11.createPublicClient)({
       chain: VIEM_CHAIN2[chainId],
-      transport: (0, import_viem10.custom)(provider)
+      transport: (0, import_viem11.custom)(provider)
     });
     const receipt = await publicClient.waitForTransactionReceipt({
       hash,
@@ -5445,7 +5555,7 @@ init_errors();
 init_debug();
 
 // src/agents/zyfai/zyfai.siwx.ts
-var import_viem11 = require("viem");
+var import_viem12 = require("viem");
 var import_siwe = require("siwe");
 var import_sdk2 = require("@zyfai/sdk");
 
@@ -5572,7 +5682,7 @@ function buildSIWXConfig(deps) {
       issuedAt,
       toString() {
         return new import_siwe.SiweMessage({
-          address: (0, import_viem11.getAddress)(accountAddress),
+          address: (0, import_viem12.getAddress)(accountAddress),
           chainId: numericChainId(chainId),
           domain,
           uri,

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

@@ -12,7 +12,7 @@ import {
   buildTransferWithAuthorizationTypedData,
   randomAuthNonce,
   readTokenMeta
-} from "./chunk-5LU2SHO7.js";
+} from "./chunk-AURO3C3R.js";
 
 // src/lib/rate-limit.ts
 function rateLimitDelay(error, now = Date.now()) {
@@ -3036,7 +3036,7 @@ var OwneySDK = class {
     }
     if (agentId === "surfliquid") {
       if (!key2) return null;
-      const { SurfLiquidAgent } = await import("./surfliquid.agent-XDJ672GM.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-XDJ672GM.js → surfliquid.agent-E54CPWXF.js}

@@ -10,9 +10,11 @@ import {
   SubmittedError,
   VaultNotSponsorableError,
   depositSponsored,
+  readStuckBalance,
+  sweepStuckBalance,
   withdrawSponsored
-} from "./chunk-W3FYRJLJ.js";
-import "./chunk-5LU2SHO7.js";
+} from "./chunk-5W56YOBO.js";
+import "./chunk-AURO3C3R.js";
 
 // src/agents/surfliquid/surfliquid.agent.ts
 import { createWalletClient, custom } from "viem";
@@ -533,7 +535,7 @@ var SurfLiquidAgent = class {
     }
   }
   async sponsoredWallet(state) {
-    const { createSponsoredWallet } = await import("./surfliquid.smart-account-DWV5B3D5.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-DWV5B3D5.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-DWV5B3D5.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-DWV5B3D5.js → surfliquid.smart-account-O6YPCQT3.js}

@@ -6,10 +6,10 @@ import {
   SURFLIQUID_VAULT_ABI,
   SubmittedError,
   USDC_ABI
-} from "./chunk-W3FYRJLJ.js";
+} from "./chunk-5W56YOBO.js";
 import {
   readTokenMeta
-} from "./chunk-5LU2SHO7.js";
+} from "./chunk-AURO3C3R.js";
 
 // src/agents/surfliquid/surfliquid.smart-account.ts
 import { createSmartAccountClient } from "permissionless";
@@ -55,7 +55,19 @@ function createSponsoredChain(rpcUrl) {
     }),
     // Cast: viem's OP-stack tx union does not match the generic PublicClient
     // the helper is typed against, though every method it uses is present.
-    readTokenMeta: () => readTokenMeta(client, SURFLIQUID_USDC_ADDRESS)
+    readTokenMeta: () => readTokenMeta(client, SURFLIQUID_USDC_ADDRESS),
+    readAllowance: (owner, spender) => client.readContract({
+      address: SURFLIQUID_USDC_ADDRESS,
+      abi: USDC_ABI,
+      functionName: "allowance",
+      args: [owner, spender]
+    }),
+    readPermitNonce: (owner) => client.readContract({
+      address: SURFLIQUID_USDC_ADDRESS,
+      abi: USDC_ABI,
+      functionName: "nonces",
+      args: [owner]
+    })
   };
 }
 function pinAccount(provider, address) {
@@ -93,7 +105,7 @@ async function createSponsoredWallet(input) {
     smartAccountAddress: account.address,
     ownerAddress: input.ownerAddress,
     // The EOA signs, not the smart account: USDC verifies ECDSA from the token holder.
-    signTransferAuthorization: (typedData) => walletClient.signTypedData({
+    signPermit: (typedData) => walletClient.signTypedData({
       account: input.ownerAddress,
       domain: typedData.domain,
       types: typedData.types,

package/package.json

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