@owney/sdk 0.6.8-beta.1 → 0.6.8-beta.3

package/dist/index.cjs

@@ -1051,7 +1051,14 @@ var ZyfaiAgent = class {
           amount
         );
         const tokenAddress = asset === "WETH" ? WETH_ADDRESS_BY_CHAIN[validChainId] : void 0;
-        await (tokenAddress ? this.sdk.logDeposit(validChainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(validChainId, txHash, amount));
+        try {
+          await (tokenAddress ? this.sdk.logDeposit(validChainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(validChainId, txHash, amount));
+        } catch (logError) {
+          console.warn(
+            "[owney-sdk] Deposit landed on-chain but logDeposit failed (non-fatal):",
+            logError
+          );
+        }
         return { txHash, smartWallet: wallet.address, amount };
       }
       const raw = await this.sdk.depositFunds(
@@ -1516,56 +1523,6 @@ async function getSponsorRelayerAddress(input) {
   return parsed.data.relayer;
 }
 
-// src/lib/sponsored-deposit.ts
-var AUTH_WINDOW_SECONDS = 15 * 60;
-function makeSponsoredDepositCallback(deps) {
-  const post = deps.httpPost ?? postSponsorTransferAuth;
-  return async (smartWallet, chainId, amount) => {
-    const cid = chainId;
-    const token = deps.tokenAddressByChain[cid];
-    if (!token) {
-      throw new OwneyError(
-        "CHAIN_UNSUPPORTED",
-        `No sponsored token configured for chain ${chainId}`
-      );
-    }
-    const pub = deps.getPublicClient(cid);
-    const wallet = deps.getWalletClient(cid);
-    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
-    const validAfter = 0n;
-    const validBefore = BigInt(Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS);
-    const nonce = randomAuthNonce();
-    const typedData = buildTransferWithAuthorizationTypedData({
-      token,
-      chainId: cid,
-      tokenName,
-      tokenVersion,
-      message: { from: deps.ownerAddress, to: smartWallet, value: BigInt(amount), validAfter, validBefore, nonce }
-    });
-    const authSignature = await wallet.signTypedData(
-      { account: deps.ownerAddress, ...typedData }
-    );
-    const result = await post({
-      baseUrl: deps.baseUrl,
-      apiKey: deps.apiKey,
-      body: {
-        chainId: cid,
-        token,
-        from: deps.ownerAddress,
-        to: smartWallet,
-        value: amount,
-        validAfter: validAfter.toString(),
-        validBefore: validBefore.toString(),
-        nonce,
-        authSignature,
-        tokenName,
-        tokenVersion
-      }
-    });
-    return result.txHash;
-  };
-}
-
 // src/lib/permit2.ts
 var import_viem4 = require("viem");
 var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
@@ -1575,20 +1532,37 @@ var ERC20_ALLOWANCE_ABI = [
     type: "function",
     name: "allowance",
     stateMutability: "view",
-    inputs: [{ name: "owner", type: "address" }, { name: "spender", type: "address" }],
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
     outputs: [{ name: "", type: "uint256" }]
   },
   {
     type: "function",
     name: "approve",
     stateMutability: "nonpayable",
-    inputs: [{ name: "spender", type: "address" }, { name: "amount", type: "uint256" }],
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
     outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
   }
 ];
 function buildPermitTransferFromTypedData(input) {
   return {
-    domain: { name: "Permit2", chainId: input.chainId, verifyingContract: PERMIT2_ADDRESS },
+    domain: {
+      name: "Permit2",
+      chainId: input.chainId,
+      verifyingContract: PERMIT2_ADDRESS
+    },
     types: {
       PermitTransferFrom: [
         { name: "permitted", type: "TokenPermissions" },
@@ -1618,6 +1592,87 @@ async function readPermit2Allowance(publicClient, token, owner) {
     args: [owner, PERMIT2_ADDRESS]
   });
 }
+async function readErc20Balance(publicClient, token, owner) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "balanceOf",
+    args: [owner]
+  });
+}
+
+// src/lib/sponsored-deposit.ts
+var AUTH_WINDOW_SECONDS = 15 * 60;
+function makeSponsoredDepositCallback(deps) {
+  const post = deps.httpPost ?? postSponsorTransferAuth;
+  return async (smartWallet, chainId, amount) => {
+    const cid = chainId;
+    const token = deps.tokenAddressByChain[cid];
+    if (!token) {
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored token configured for chain ${chainId}`
+      );
+    }
+    const pub = deps.getPublicClient(cid);
+    const wallet = deps.getWalletClient(cid);
+    try {
+      const balance = await readErc20Balance(pub, token, deps.ownerAddress);
+      if (balance < BigInt(amount)) {
+        throw new OwneyError(
+          "DEPOSIT_INSUFFICIENT_BALANCE",
+          "Insufficient balance for this deposit.",
+          { token, chainId: cid, balance: balance.toString(), amount }
+        );
+      }
+    } catch (err) {
+      if (err instanceof OwneyError) throw err;
+    }
+    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
+    const validAfter = 0n;
+    const validBefore = BigInt(
+      Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS
+    );
+    const nonce = randomAuthNonce();
+    const typedData = buildTransferWithAuthorizationTypedData({
+      token,
+      chainId: cid,
+      tokenName,
+      tokenVersion,
+      message: {
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: BigInt(amount),
+        validAfter,
+        validBefore,
+        nonce
+      }
+    });
+    const authSignature = await wallet.signTypedData({
+      account: deps.ownerAddress,
+      ...typedData
+    });
+    deps.onApproved?.();
+    const result = await post({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      body: {
+        chainId: cid,
+        token,
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: amount,
+        validAfter: validAfter.toString(),
+        validBefore: validBefore.toString(),
+        nonce,
+        authSignature,
+        tokenName,
+        tokenVersion
+      }
+    });
+    return result.txHash;
+  };
+}
 
 // src/lib/sponsored-weth-deposit.ts
 var PERMIT_WINDOW_SECONDS = 15 * 60;
@@ -1628,10 +1683,25 @@ function makeSponsoredWethCallback(deps) {
     const cid = chainId;
     const token = deps.tokenAddressByChain[cid];
     if (!token) {
-      throw new OwneyError("CHAIN_UNSUPPORTED", `No sponsored WETH configured for chain ${chainId}`);
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored WETH configured for chain ${chainId}`
+      );
     }
     const amountWei = BigInt(amount);
     const pub = deps.getPublicClient(cid);
+    try {
+      const balance = await readErc20Balance(pub, token, deps.ownerAddress);
+      if (balance < amountWei) {
+        throw new OwneyError(
+          "DEPOSIT_INSUFFICIENT_BALANCE",
+          "Insufficient WETH balance for this deposit.",
+          { token, chainId: cid, balance: balance.toString(), amount }
+        );
+      }
+    } catch (err) {
+      if (err instanceof OwneyError) throw err;
+    }
     const allowance = await readPermit2Allowance(pub, token, deps.ownerAddress);
     if (allowance < amountWei) {
       throw new OwneyError(
@@ -1640,9 +1710,15 @@ function makeSponsoredWethCallback(deps) {
         { token, chainId: cid, allowance: allowance.toString(), amount }
       );
     }
-    const relayer = await get({ baseUrl: deps.baseUrl, apiKey: deps.apiKey, chainId: cid });
+    const relayer = await get({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      chainId: cid
+    });
     const nonce = randomPermit2Nonce();
-    const deadline = BigInt(Math.floor(Date.now() / 1e3) + PERMIT_WINDOW_SECONDS);
+    const deadline = BigInt(
+      Math.floor(Date.now() / 1e3) + PERMIT_WINDOW_SECONDS
+    );
     const typedData = buildPermitTransferFromTypedData({
       chainId: cid,
       message: {
@@ -1653,9 +1729,11 @@ function makeSponsoredWethCallback(deps) {
       }
     });
     const wallet = deps.getWalletClient(cid);
-    const signature = await wallet.signTypedData(
-      { account: deps.ownerAddress, ...typedData }
-    );
+    const signature = await wallet.signTypedData({
+      account: deps.ownerAddress,
+      ...typedData
+    });
+    deps.onApproved?.();
     const result = await post({
       baseUrl: deps.baseUrl,
       apiKey: deps.apiKey,
@@ -1818,14 +1896,16 @@ var OwneySDK = class {
    * provider with viem `custom(provider)` to read token meta and sign the
    * `TransferWithAuthorization`, then POSTs to the sponsor API.
    */
-  getDefaultSponsoredCallback() {
-    if (this.cachedSponsoredCallback) return this.cachedSponsoredCallback;
+  getDefaultSponsoredCallback(onApproved) {
+    if (!onApproved && this.cachedSponsoredCallback)
+      return this.cachedSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
-    this.cachedSponsoredCallback = makeSponsoredDepositCallback({
+    const callback = makeSponsoredDepositCallback({
       apiKey: this.apiKey,
       baseUrl: this.routingApiBaseUrl,
       ownerAddress: owner,
+      onApproved,
       tokenAddressByChain: SPONSORED_USDC_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
@@ -1840,7 +1920,8 @@ var OwneySDK = class {
         transport: (0, import_viem5.custom)(provider)
       })
     });
-    return this.cachedSponsoredCallback;
+    if (!onApproved) this.cachedSponsoredCallback = callback;
+    return callback;
   }
   /**
    * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
@@ -1848,15 +1929,16 @@ var OwneySDK = class {
    * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
    * `PermitTransferFrom` instead of an EIP-3009 authorization.
    */
-  getDefaultWethSponsoredCallback() {
-    if (this.cachedWethSponsoredCallback)
+  getDefaultWethSponsoredCallback(onApproved) {
+    if (!onApproved && this.cachedWethSponsoredCallback)
       return this.cachedWethSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
-    this.cachedWethSponsoredCallback = makeSponsoredWethCallback({
+    const callback = makeSponsoredWethCallback({
       apiKey: this.apiKey,
       baseUrl: this.routingApiBaseUrl,
       ownerAddress: owner,
+      onApproved,
       tokenAddressByChain: SPONSORED_WETH_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
@@ -1871,7 +1953,8 @@ var OwneySDK = class {
         transport: (0, import_viem5.custom)(provider)
       })
     });
-    return this.cachedWethSponsoredCallback;
+    if (!onApproved) this.cachedWethSponsoredCallback = callback;
+    return callback;
   }
   getAgent(agentId) {
     const agent = this.agents.get(agentId);
@@ -2017,13 +2100,13 @@ var OwneySDK = class {
    * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
    */
   async deposit(options) {
-    const { amount, asset, depositCallback, agentId } = options;
+    const { amount, asset, depositCallback, agentId, onApproved } = options;
     if (BigInt(amount) === 0n) {
       return { agentResults: {} };
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
-    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback() : this.getDefaultSponsoredCallback());
+    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(

package/dist/index.d.cts

@@ -98,6 +98,7 @@ type DepositOptions = {
     asset: Asset;
     depositCallback?: DepositCallback;
     agentId?: AgentId;
+    onApproved?: () => void;
 };
 
 interface OwneyDepositResult {
@@ -524,7 +525,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.d.ts

@@ -98,6 +98,7 @@ type DepositOptions = {
     asset: Asset;
     depositCallback?: DepositCallback;
     agentId?: AgentId;
+    onApproved?: () => void;
 };
 
 interface OwneyDepositResult {
@@ -524,7 +525,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.js

@@ -1019,7 +1019,14 @@ var ZyfaiAgent = class {
           amount
         );
         const tokenAddress = asset === "WETH" ? WETH_ADDRESS_BY_CHAIN[validChainId] : void 0;
-        await (tokenAddress ? this.sdk.logDeposit(validChainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(validChainId, txHash, amount));
+        try {
+          await (tokenAddress ? this.sdk.logDeposit(validChainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(validChainId, txHash, amount));
+        } catch (logError) {
+          console.warn(
+            "[owney-sdk] Deposit landed on-chain but logDeposit failed (non-fatal):",
+            logError
+          );
+        }
         return { txHash, smartWallet: wallet.address, amount };
       }
       const raw = await this.sdk.depositFunds(
@@ -1488,56 +1495,6 @@ async function getSponsorRelayerAddress(input) {
   return parsed.data.relayer;
 }
 
-// src/lib/sponsored-deposit.ts
-var AUTH_WINDOW_SECONDS = 15 * 60;
-function makeSponsoredDepositCallback(deps) {
-  const post = deps.httpPost ?? postSponsorTransferAuth;
-  return async (smartWallet, chainId, amount) => {
-    const cid = chainId;
-    const token = deps.tokenAddressByChain[cid];
-    if (!token) {
-      throw new OwneyError(
-        "CHAIN_UNSUPPORTED",
-        `No sponsored token configured for chain ${chainId}`
-      );
-    }
-    const pub = deps.getPublicClient(cid);
-    const wallet = deps.getWalletClient(cid);
-    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
-    const validAfter = 0n;
-    const validBefore = BigInt(Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS);
-    const nonce = randomAuthNonce();
-    const typedData = buildTransferWithAuthorizationTypedData({
-      token,
-      chainId: cid,
-      tokenName,
-      tokenVersion,
-      message: { from: deps.ownerAddress, to: smartWallet, value: BigInt(amount), validAfter, validBefore, nonce }
-    });
-    const authSignature = await wallet.signTypedData(
-      { account: deps.ownerAddress, ...typedData }
-    );
-    const result = await post({
-      baseUrl: deps.baseUrl,
-      apiKey: deps.apiKey,
-      body: {
-        chainId: cid,
-        token,
-        from: deps.ownerAddress,
-        to: smartWallet,
-        value: amount,
-        validAfter: validAfter.toString(),
-        validBefore: validBefore.toString(),
-        nonce,
-        authSignature,
-        tokenName,
-        tokenVersion
-      }
-    });
-    return result.txHash;
-  };
-}
-
 // src/lib/permit2.ts
 import { bytesToHex as bytesToHex2 } from "viem";
 var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
@@ -1547,20 +1504,37 @@ var ERC20_ALLOWANCE_ABI = [
     type: "function",
     name: "allowance",
     stateMutability: "view",
-    inputs: [{ name: "owner", type: "address" }, { name: "spender", type: "address" }],
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
     outputs: [{ name: "", type: "uint256" }]
   },
   {
     type: "function",
     name: "approve",
     stateMutability: "nonpayable",
-    inputs: [{ name: "spender", type: "address" }, { name: "amount", type: "uint256" }],
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
     outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
   }
 ];
 function buildPermitTransferFromTypedData(input) {
   return {
-    domain: { name: "Permit2", chainId: input.chainId, verifyingContract: PERMIT2_ADDRESS },
+    domain: {
+      name: "Permit2",
+      chainId: input.chainId,
+      verifyingContract: PERMIT2_ADDRESS
+    },
     types: {
       PermitTransferFrom: [
         { name: "permitted", type: "TokenPermissions" },
@@ -1590,6 +1564,87 @@ async function readPermit2Allowance(publicClient, token, owner) {
     args: [owner, PERMIT2_ADDRESS]
   });
 }
+async function readErc20Balance(publicClient, token, owner) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "balanceOf",
+    args: [owner]
+  });
+}
+
+// src/lib/sponsored-deposit.ts
+var AUTH_WINDOW_SECONDS = 15 * 60;
+function makeSponsoredDepositCallback(deps) {
+  const post = deps.httpPost ?? postSponsorTransferAuth;
+  return async (smartWallet, chainId, amount) => {
+    const cid = chainId;
+    const token = deps.tokenAddressByChain[cid];
+    if (!token) {
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored token configured for chain ${chainId}`
+      );
+    }
+    const pub = deps.getPublicClient(cid);
+    const wallet = deps.getWalletClient(cid);
+    try {
+      const balance = await readErc20Balance(pub, token, deps.ownerAddress);
+      if (balance < BigInt(amount)) {
+        throw new OwneyError(
+          "DEPOSIT_INSUFFICIENT_BALANCE",
+          "Insufficient balance for this deposit.",
+          { token, chainId: cid, balance: balance.toString(), amount }
+        );
+      }
+    } catch (err) {
+      if (err instanceof OwneyError) throw err;
+    }
+    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
+    const validAfter = 0n;
+    const validBefore = BigInt(
+      Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS
+    );
+    const nonce = randomAuthNonce();
+    const typedData = buildTransferWithAuthorizationTypedData({
+      token,
+      chainId: cid,
+      tokenName,
+      tokenVersion,
+      message: {
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: BigInt(amount),
+        validAfter,
+        validBefore,
+        nonce
+      }
+    });
+    const authSignature = await wallet.signTypedData({
+      account: deps.ownerAddress,
+      ...typedData
+    });
+    deps.onApproved?.();
+    const result = await post({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      body: {
+        chainId: cid,
+        token,
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: amount,
+        validAfter: validAfter.toString(),
+        validBefore: validBefore.toString(),
+        nonce,
+        authSignature,
+        tokenName,
+        tokenVersion
+      }
+    });
+    return result.txHash;
+  };
+}
 
 // src/lib/sponsored-weth-deposit.ts
 var PERMIT_WINDOW_SECONDS = 15 * 60;
@@ -1600,10 +1655,25 @@ function makeSponsoredWethCallback(deps) {
     const cid = chainId;
     const token = deps.tokenAddressByChain[cid];
     if (!token) {
-      throw new OwneyError("CHAIN_UNSUPPORTED", `No sponsored WETH configured for chain ${chainId}`);
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored WETH configured for chain ${chainId}`
+      );
     }
     const amountWei = BigInt(amount);
     const pub = deps.getPublicClient(cid);
+    try {
+      const balance = await readErc20Balance(pub, token, deps.ownerAddress);
+      if (balance < amountWei) {
+        throw new OwneyError(
+          "DEPOSIT_INSUFFICIENT_BALANCE",
+          "Insufficient WETH balance for this deposit.",
+          { token, chainId: cid, balance: balance.toString(), amount }
+        );
+      }
+    } catch (err) {
+      if (err instanceof OwneyError) throw err;
+    }
     const allowance = await readPermit2Allowance(pub, token, deps.ownerAddress);
     if (allowance < amountWei) {
       throw new OwneyError(
@@ -1612,9 +1682,15 @@ function makeSponsoredWethCallback(deps) {
         { token, chainId: cid, allowance: allowance.toString(), amount }
       );
     }
-    const relayer = await get({ baseUrl: deps.baseUrl, apiKey: deps.apiKey, chainId: cid });
+    const relayer = await get({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      chainId: cid
+    });
     const nonce = randomPermit2Nonce();
-    const deadline = BigInt(Math.floor(Date.now() / 1e3) + PERMIT_WINDOW_SECONDS);
+    const deadline = BigInt(
+      Math.floor(Date.now() / 1e3) + PERMIT_WINDOW_SECONDS
+    );
     const typedData = buildPermitTransferFromTypedData({
       chainId: cid,
       message: {
@@ -1625,9 +1701,11 @@ function makeSponsoredWethCallback(deps) {
       }
     });
     const wallet = deps.getWalletClient(cid);
-    const signature = await wallet.signTypedData(
-      { account: deps.ownerAddress, ...typedData }
-    );
+    const signature = await wallet.signTypedData({
+      account: deps.ownerAddress,
+      ...typedData
+    });
+    deps.onApproved?.();
     const result = await post({
       baseUrl: deps.baseUrl,
       apiKey: deps.apiKey,
@@ -1790,14 +1868,16 @@ var OwneySDK = class {
    * provider with viem `custom(provider)` to read token meta and sign the
    * `TransferWithAuthorization`, then POSTs to the sponsor API.
    */
-  getDefaultSponsoredCallback() {
-    if (this.cachedSponsoredCallback) return this.cachedSponsoredCallback;
+  getDefaultSponsoredCallback(onApproved) {
+    if (!onApproved && this.cachedSponsoredCallback)
+      return this.cachedSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
-    this.cachedSponsoredCallback = makeSponsoredDepositCallback({
+    const callback = makeSponsoredDepositCallback({
       apiKey: this.apiKey,
       baseUrl: this.routingApiBaseUrl,
       ownerAddress: owner,
+      onApproved,
       tokenAddressByChain: SPONSORED_USDC_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
@@ -1812,7 +1892,8 @@ var OwneySDK = class {
         transport: custom(provider)
       })
     });
-    return this.cachedSponsoredCallback;
+    if (!onApproved) this.cachedSponsoredCallback = callback;
+    return callback;
   }
   /**
    * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
@@ -1820,15 +1901,16 @@ var OwneySDK = class {
    * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
    * `PermitTransferFrom` instead of an EIP-3009 authorization.
    */
-  getDefaultWethSponsoredCallback() {
-    if (this.cachedWethSponsoredCallback)
+  getDefaultWethSponsoredCallback(onApproved) {
+    if (!onApproved && this.cachedWethSponsoredCallback)
       return this.cachedWethSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
-    this.cachedWethSponsoredCallback = makeSponsoredWethCallback({
+    const callback = makeSponsoredWethCallback({
       apiKey: this.apiKey,
       baseUrl: this.routingApiBaseUrl,
       ownerAddress: owner,
+      onApproved,
       tokenAddressByChain: SPONSORED_WETH_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
@@ -1843,7 +1925,8 @@ var OwneySDK = class {
         transport: custom(provider)
       })
     });
-    return this.cachedWethSponsoredCallback;
+    if (!onApproved) this.cachedWethSponsoredCallback = callback;
+    return callback;
   }
   getAgent(agentId) {
     const agent = this.agents.get(agentId);
@@ -1989,13 +2072,13 @@ var OwneySDK = class {
    * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
    */
   async deposit(options) {
-    const { amount, asset, depositCallback, agentId } = options;
+    const { amount, asset, depositCallback, agentId, onApproved } = options;
     if (BigInt(amount) === 0n) {
       return { agentResults: {} };
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
-    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback() : this.getDefaultSponsoredCallback());
+    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(

package/package.json

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