@owney/sdk 0.7.25-beta.20 → 0.7.25-beta.21

package/dist/index.cjs

@@ -286,6 +286,240 @@ var AgentChainIncompatibleError = class extends OwneyError {
   }
 };
 
+// src/lib/transfer-auth.ts
+var import_viem2 = require("viem");
+
+// src/lib/sponsor-client.ts
+var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
+async function postPaymasterIntent(input) {
+  const base6 = input.baseUrl ?? ROUTING_API_BASE_URL;
+  let res;
+  try {
+    res = await fetch(`${base6}/api/v1/sponsor/paymaster-intent`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-owney-api-key": input.apiKey,
+        Authorization: `Signature ${input.yieldseekerSignature}`
+      },
+      body: JSON.stringify(input.body)
+    });
+  } catch (networkError) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Paymaster intent network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
+      { cause: String(networkError), safeToFallback: true }
+    );
+  }
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+  }
+  if (!res.ok || !parsed?.success || typeof parsed.data?.intent !== "string" || typeof parsed.data.expiresAt !== "number") {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Paymaster intent API error ${res.status}: ${parsed?.message ?? text.slice(0, 500)}`,
+      {
+        statusCode: res.status,
+        responseBody: text.slice(0, 500),
+        safeToFallback: true
+      }
+    );
+  }
+  return parsed.data;
+}
+async function getSponsorRelayerAddress(input) {
+  const base6 = input.baseUrl ?? ROUTING_API_BASE_URL;
+  let res;
+  try {
+    res = await fetch(
+      `${base6}/api/v1/sponsor/relayer-address?chainId=${input.chainId}`,
+      {
+        headers: { "x-owney-api-key": input.apiKey }
+      }
+    );
+  } catch (networkError) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Sponsor API network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
+      { cause: String(networkError), safeToFallback: true }
+    );
+  }
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+  }
+  if (!res.ok || !parsed?.success || !parsed.data?.relayer) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Sponsor API error ${res.status}: ${parsed?.message ?? text.slice(0, 500)}`,
+      {
+        statusCode: res.status,
+        responseBody: text.slice(0, 500),
+        safeToFallback: true
+      }
+    );
+  }
+  return parsed.data.relayer;
+}
+async function postSponsorBatchTransfer(input) {
+  let res;
+  try {
+    res = await fetch(
+      `${input.baseUrl ?? ROUTING_API_BASE_URL}/api/v1/sponsor/permit2-batch`,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          "x-owney-api-key": input.apiKey
+        },
+        body: JSON.stringify(input.body)
+      }
+    );
+  } catch {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      "Deposit status is unknown. Retry the same amount to check it.",
+      { safeToFallback: false }
+    );
+  }
+  const parsed = await res.json().catch(() => null);
+  if (!res.ok || !parsed?.success || !/^0x[0-9a-fA-F]{64}$/.test(parsed.data?.txHash ?? "")) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      "Deposit could not be confirmed. Retry the same amount to check its status.",
+      {
+        statusCode: res.status,
+        safeToFallback: false,
+        notSubmitted: parsed?.notSubmitted === true || parsed?.error?.notSubmitted === true || parsed?.error?.details?.notSubmitted === true
+      }
+    );
+  }
+  return parsed.data;
+}
+
+// src/lib/permit2.ts
+var import_viem3 = require("viem");
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+var MAX_UINT256 = 2n ** 256n - 1n;
+function permit2ApprovalAmount(requiredAmount) {
+  if (requiredAmount <= 0n) {
+    throw new Error("Permit2 approval requires a positive deposit amount");
+  }
+  return MAX_UINT256;
+}
+var ERC20_ALLOWANCE_ABI = [
+  {
+    type: "function",
+    name: "allowance",
+    stateMutability: "view",
+    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" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  }
+];
+function randomPermit2Nonce() {
+  const bytes = new Uint8Array(32);
+  globalThis.crypto.getRandomValues(bytes);
+  return BigInt((0, import_viem3.bytesToHex)(bytes));
+}
+async function readPermit2Allowance(publicClient, token, owner, blockNumber) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "allowance",
+    args: [owner, PERMIT2_ADDRESS],
+    ...blockNumber === void 0 ? {} : { blockNumber }
+  });
+}
+async function readErc20Balance(publicClient, token, owner) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "balanceOf",
+    args: [owner]
+  });
+}
+
+// src/lib/chain-guard.ts
+var CHAIN_NAMES = {
+  1: "Ethereum",
+  8453: "Base",
+  42161: "Arbitrum"
+};
+function chainName(chainId) {
+  return CHAIN_NAMES[chainId] ?? `chain ${chainId}`;
+}
+async function ensureWalletOnChain(pub, wallet, expected) {
+  const actual = await pub.getChainId();
+  if (actual === expected) return;
+  try {
+    await wallet.switchChain({ id: expected });
+  } catch (error) {
+    throw new OwneyError(
+      "CHAIN_MISMATCH",
+      `Your wallet is on ${chainName(actual)}. Switch it to ${chainName(expected)} and try again.`,
+      {
+        expectedChainId: expected,
+        actualChainId: actual,
+        cause: error instanceof Error ? error.message : String(error)
+      }
+    );
+  }
+  const after = await pub.getChainId();
+  if (after !== expected) {
+    throw new OwneyError(
+      "CHAIN_MISMATCH",
+      `Your wallet is still on ${chainName(after)}. Switch it to ${chainName(expected)} and try again.`,
+      { expectedChainId: expected, actualChainId: after }
+    );
+  }
+}
+
+// src/lib/sponsored-deposit.ts
+var AUTH_WINDOW_SECONDS = 15 * 60;
+var verificationSetter = /* @__PURE__ */ Symbol("owney.depositVerificationSetter");
+function provideDepositVerificationContext(callback, context) {
+  callback[verificationSetter]?.(context);
+}
+function makeVerificationAwareDepositCallback(implementation) {
+  let nextVerification;
+  const callback = async (smartWallet, chainId, amount) => {
+    const verification = nextVerification;
+    nextVerification = void 0;
+    return implementation(smartWallet, chainId, amount, verification);
+  };
+  Object.defineProperty(callback, verificationSetter, {
+    value: (context) => {
+      nextVerification = context;
+    }
+  });
+  return callback;
+}
+
 // src/lib/rate-limit.ts
 function rateLimitDelay(error, now = Date.now()) {
   const seen = /* @__PURE__ */ new Set();
@@ -560,7 +794,7 @@ function hasEmptyWithdrawalSnapshot(raw2, chainId, token) {
 }
 
 // src/agents/zyfai/zyfai.deposit.ts
-var import_viem2 = require("viem");
+var import_viem4 = require("viem");
 
 // src/types/config.ts
 var P_SUPPORTED_CHAINS = {
@@ -610,20 +844,20 @@ var SupportedAssets = [
 ];
 
 // src/agents/zyfai/zyfai.deposit.ts
-async function submitZyfaiDeposit({ sdk, state, chain, amount, asset, smartWallet, assertCurrent }) {
+async function submitZyfaiDeposit({ sdk, state, chain, amount, asset, smartWallet, assertCurrent, onBeforeSubmission }) {
   const owner = state.walletAddress;
   const provider = state.provider;
   const token = SupportedAssets.find((value) => value.chainId === chain.id && value.symbol === asset);
-  if (!token || !(0, import_viem2.isAddress)(owner) || !(0, import_viem2.isAddress)(smartWallet) || !/^\d+$/.test(amount) || BigInt(amount) <= 0n)
+  if (!token || !(0, import_viem4.isAddress)(owner) || !(0, import_viem4.isAddress)(smartWallet) || !/^\d+$/.test(amount) || BigInt(amount) <= 0n)
     throw new OwneyError("AGENT_INVALID_RESPONSE", "Invalid Zyfai deposit transfer.", { chainId: chain.id, asset }, "zyfai");
   assertCurrent();
   const prepared = await sdk.prepareEnterPosition({ userAddress: owner, chainId: chain.id, amount, asset, strategy: "aggressive" });
   assertCurrent();
-  const expectedData = (0, import_viem2.encodeFunctionData)({ abi: import_viem2.erc20Abi, functionName: "transfer", args: [smartWallet, BigInt(amount)] });
+  const expectedData = (0, import_viem4.encodeFunctionData)({ abi: import_viem4.erc20Abi, functionName: "transfer", args: [smartWallet, BigInt(amount)] });
   const transfer = prepared?.transfer;
   if (!transfer || transfer.safeAddress?.toLowerCase() !== smartWallet.toLowerCase() || transfer.tokenAddress?.toLowerCase() !== token.address.toLowerCase() || transfer.to?.toLowerCase() !== token.address.toLowerCase() || transfer.data?.toLowerCase() !== expectedData.toLowerCase() || transfer.value !== "0")
     throw new OwneyError("AGENT_INVALID_RESPONSE", "Zyfai prepared a different deposit transfer.", { chainId: chain.id, asset }, "zyfai");
-  const wallet = (0, import_viem2.createWalletClient)({ account: owner, chain, transport: (0, import_viem2.custom)({
+  const wallet = (0, import_viem4.createWalletClient)({ account: owner, chain, transport: (0, import_viem4.custom)({
     request: async (args) => {
       assertCurrent();
       if (args.method === "eth_sendTransaction") {
@@ -634,6 +868,8 @@ async function submitZyfaiDeposit({ sdk, state, chain, amount, asset, smartWalle
         assertCurrent();
         if (!Array.isArray(accounts) || typeof accounts[0] !== "string" || accounts[0].toLowerCase() !== owner.toLowerCase() || Number(chainId) !== chain.id)
           throw new OwneyError("NOT_CONNECTED", "Wallet changed while preparing Zyfai deposit.", void 0, "zyfai");
+        await onBeforeSubmission?.();
+        assertCurrent();
       }
       return provider.request(args);
     }
@@ -643,7 +879,7 @@ async function submitZyfaiDeposit({ sdk, state, chain, amount, asset, smartWalle
 
 // src/agents/zyfai/zyfai.agent.ts
 var import_sdk = require("@zyfai/sdk");
-var import_viem5 = require("viem");
+var import_viem7 = require("viem");
 var import_chains = require("viem/chains");
 
 // src/lib/debug.ts
@@ -690,8 +926,8 @@ var DayFilterMapping = {
 };
 
 // src/agents/zyfai/zyfai.mapper.ts
-var import_viem3 = require("viem");
-var exactHexAmount = (raw2, decimals) => (0, import_viem3.formatUnits)(BigInt(/^0x/i.test(raw2) ? raw2 : `0x${raw2}`), decimals);
+var import_viem5 = require("viem");
+var exactHexAmount = (raw2, decimals) => (0, import_viem5.formatUnits)(BigInt(/^0x/i.test(raw2) ? raw2 : `0x${raw2}`), decimals);
 var DECIMALS_BY_SYMBOL = {
   usdc: 6,
   weth: 18,
@@ -790,7 +1026,7 @@ function mapBalances(raw2, _chainId, smartWallet) {
     // legacy `amount` fallback is hex. Runtime
     // getBalances payloads often carry one (e.g. 18 for WETH) — prefer that
     // when present, otherwise fall back to the per-symbol lookup.
-    amount: p.underlyingAmountWithFee ?? p.underlyingAmount ? (0, import_viem3.formatUnits)(
+    amount: p.underlyingAmountWithFee ?? p.underlyingAmount ? (0, import_viem5.formatUnits)(
       BigInt(p.underlyingAmountWithFee ?? p.underlyingAmount ?? "0"),
       tokenDecimals(
         p.token_symbol,
@@ -1455,7 +1691,7 @@ function protocolsPolicyNeedsUpdate(current, desiredProtocols, desiredAutoSelect
 }
 
 // src/lib/paid-rpc.ts
-var import_viem4 = require("viem");
+var import_viem6 = require("viem");
 var PAID_RPC_RETRY_COUNT = 3;
 var PAID_RPC_RETRY_DELAY_MS = 1e3;
 function configuredRpcProxyBaseUrl(baseUrl) {
@@ -1491,9 +1727,9 @@ function createPaidRpcClient(chain, rpcUrls) {
     rpcUrls,
     chain.id
   );
-  return (0, import_viem4.createPublicClient)({
+  return (0, import_viem6.createPublicClient)({
     chain,
-    transport: (0, import_viem4.http)(url, {
+    transport: (0, import_viem6.http)(url, {
       retryCount: PAID_RPC_RETRY_COUNT,
       retryDelay: PAID_RPC_RETRY_DELAY_MS
     })
@@ -1590,7 +1826,7 @@ async function withPaidRpcDiagnostics(operation, chainId, rpcMethod, agentId) {
 }
 
 // src/agents/zyfai/zyfai.agent.ts
-var ERC7579_IS_MODULE_INSTALLED_ABI = (0, import_viem5.parseAbi)([
+var ERC7579_IS_MODULE_INSTALLED_ABI = (0, import_viem7.parseAbi)([
   "function isModuleInstalled(uint256 moduleTypeId, address module, bytes additionalContext) view returns (bool)"
 ]);
 var WETH_ADDRESS_BY_CHAIN = {
@@ -1757,7 +1993,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
           }, asset.address, entry.action === "Withdraw" ? "withdraw" : "deposit");
           if (evidence.transfer === "confirmed" && evidence.confirmedAmount) {
             Object.assign(tx, {
-              amount: (0, import_viem5.formatUnits)(BigInt(evidence.confirmedAmount), asset.decimals),
+              amount: (0, import_viem7.formatUnits)(BigInt(evidence.confirmedAmount), asset.decimals),
               amountRaw: evidence.confirmedAmount,
               blockNumber: evidence.blockNumber,
               logIndexes: evidence.logIndexes,
@@ -2470,7 +2706,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
     await this.ensureSessionKey(ownerAddress, chainId, redeployed.address);
     return redeployed.address;
   }
-  async deposit(state, chainId, amount, asset, depositCallback, onProgress) {
+  async deposit(state, chainId, amount, asset, depositCallback, onProgress, onBeforeSubmission) {
     const validChainId = isValidChainId(chainId);
     const owner = state.walletAddress;
     const provider = state.provider;
@@ -2503,7 +2739,18 @@ var ZyfaiAgent = class _ZyfaiAgent {
       amount,
       asset,
       smartWallet,
-      assertCurrent
+      assertCurrent,
+      onBeforeSubmission: onBeforeSubmission ? () => onBeforeSubmission({
+        agentId: this.id,
+        chainId,
+        token: asset,
+        walletAddress: owner,
+        agentWallet: smartWallet,
+        intendedAmount: amount,
+        transfer: "pending",
+        registration: "pending",
+        delivery: "not-applicable"
+      }) : void 0
     });
     let evidence = {
       agentId: this.id,
@@ -2573,7 +2820,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
         this.sdk.getPortfolio(owner).catch(() => void 0)
       ]);
       assertScope();
-      if (!(0, import_viem5.isAddress)(wallet.address) || !registered.smartWallet || registered.smartWallet.toLowerCase() !== wallet.address.toLowerCase())
+      if (!(0, import_viem7.isAddress)(wallet.address) || !registered.smartWallet || registered.smartWallet.toLowerCase() !== wallet.address.toLowerCase())
         throw new OwneyError(
           "AGENT_AUTH_FAILED",
           "Could not verify Zyfai's withdrawal wallet.",
@@ -2584,7 +2831,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
         const asset = SupportedAssets.find((value) => value.chainId === chainId && value.symbol === token);
         const idle = asset ? await this.getPublicClient(chainId).readContract({
           address: asset.address,
-          abi: import_viem5.erc20Abi,
+          abi: import_viem7.erc20Abi,
           functionName: "balanceOf",
           args: [wallet.address]
         }).catch(() => void 0) : void 0;
@@ -2831,13 +3078,13 @@ var ZyfaiAgent = class _ZyfaiAgent {
         this.sdk.getSmartWalletByEOA(owner)
       ]);
       assertScope();
-      if (!(0, import_viem5.isAddress)(wallet.address) || wallet.isDeployed !== false && (wallet.isDeployed !== true || wallet.isOwner !== true) || !registered.smartWallet || registered.smartWallet.toLowerCase() !== wallet.address.toLowerCase()) throw unavailable();
+      if (!(0, import_viem7.isAddress)(wallet.address) || wallet.isDeployed !== false && (wallet.isDeployed !== true || wallet.isOwner !== true) || !registered.smartWallet || registered.smartWallet.toLowerCase() !== wallet.address.toLowerCase()) throw unavailable();
       const client = this.getPublicClient(validChainId);
       const blockNumber = await client.getBlockNumber({ cacheTime: 0 });
       assertScope();
       const idle = await client.readContract({
         address: asset.address,
-        abi: import_viem5.erc20Abi,
+        abi: import_viem7.erc20Abi,
         functionName: "balanceOf",
         args: [wallet.address],
         blockNumber
@@ -2894,7 +3141,7 @@ var ZyfaiAgent = class _ZyfaiAgent {
     if (blockNumber < BigInt(evidence.blockNumber)) return void 0;
     const idle = await client.readContract({
       address: asset.address,
-      abi: import_viem5.erc20Abi,
+      abi: import_viem7.erc20Abi,
       functionName: "balanceOf",
       args: [balance.smartWallet],
       blockNumber
@@ -3102,240 +3349,6 @@ var ZyfaiAgent = class _ZyfaiAgent {
 var import_viem13 = require("viem");
 var import_chains4 = require("viem/chains");
 
-// src/lib/chain-guard.ts
-var CHAIN_NAMES = {
-  1: "Ethereum",
-  8453: "Base",
-  42161: "Arbitrum"
-};
-function chainName(chainId) {
-  return CHAIN_NAMES[chainId] ?? `chain ${chainId}`;
-}
-async function ensureWalletOnChain(pub, wallet, expected) {
-  const actual = await pub.getChainId();
-  if (actual === expected) return;
-  try {
-    await wallet.switchChain({ id: expected });
-  } catch (error) {
-    throw new OwneyError(
-      "CHAIN_MISMATCH",
-      `Your wallet is on ${chainName(actual)}. Switch it to ${chainName(expected)} and try again.`,
-      {
-        expectedChainId: expected,
-        actualChainId: actual,
-        cause: error instanceof Error ? error.message : String(error)
-      }
-    );
-  }
-  const after = await pub.getChainId();
-  if (after !== expected) {
-    throw new OwneyError(
-      "CHAIN_MISMATCH",
-      `Your wallet is still on ${chainName(after)}. Switch it to ${chainName(expected)} and try again.`,
-      { expectedChainId: expected, actualChainId: after }
-    );
-  }
-}
-
-// src/lib/transfer-auth.ts
-var import_viem6 = require("viem");
-
-// src/lib/sponsor-client.ts
-var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
-async function postPaymasterIntent(input) {
-  const base6 = input.baseUrl ?? ROUTING_API_BASE_URL;
-  let res;
-  try {
-    res = await fetch(`${base6}/api/v1/sponsor/paymaster-intent`, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        "x-owney-api-key": input.apiKey,
-        Authorization: `Signature ${input.yieldseekerSignature}`
-      },
-      body: JSON.stringify(input.body)
-    });
-  } catch (networkError) {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      `Paymaster intent network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
-      { cause: String(networkError), safeToFallback: true }
-    );
-  }
-  const text = await res.text();
-  let parsed = null;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-  }
-  if (!res.ok || !parsed?.success || typeof parsed.data?.intent !== "string" || typeof parsed.data.expiresAt !== "number") {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      `Paymaster intent API error ${res.status}: ${parsed?.message ?? text.slice(0, 500)}`,
-      {
-        statusCode: res.status,
-        responseBody: text.slice(0, 500),
-        safeToFallback: true
-      }
-    );
-  }
-  return parsed.data;
-}
-async function getSponsorRelayerAddress(input) {
-  const base6 = input.baseUrl ?? ROUTING_API_BASE_URL;
-  let res;
-  try {
-    res = await fetch(
-      `${base6}/api/v1/sponsor/relayer-address?chainId=${input.chainId}`,
-      {
-        headers: { "x-owney-api-key": input.apiKey }
-      }
-    );
-  } catch (networkError) {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      `Sponsor API network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
-      { cause: String(networkError), safeToFallback: true }
-    );
-  }
-  const text = await res.text();
-  let parsed = null;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-  }
-  if (!res.ok || !parsed?.success || !parsed.data?.relayer) {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      `Sponsor API error ${res.status}: ${parsed?.message ?? text.slice(0, 500)}`,
-      {
-        statusCode: res.status,
-        responseBody: text.slice(0, 500),
-        safeToFallback: true
-      }
-    );
-  }
-  return parsed.data.relayer;
-}
-async function postSponsorBatchTransfer(input) {
-  let res;
-  try {
-    res = await fetch(
-      `${input.baseUrl ?? ROUTING_API_BASE_URL}/api/v1/sponsor/permit2-batch`,
-      {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-          "x-owney-api-key": input.apiKey
-        },
-        body: JSON.stringify(input.body)
-      }
-    );
-  } catch {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      "Deposit status is unknown. Retry the same amount to check it.",
-      { safeToFallback: false }
-    );
-  }
-  const parsed = await res.json().catch(() => null);
-  if (!res.ok || !parsed?.success || !/^0x[0-9a-fA-F]{64}$/.test(parsed.data?.txHash ?? "")) {
-    throw new OwneyError(
-      "SPONSOR_REQUEST_FAILED",
-      "Deposit could not be confirmed. Retry the same amount to check its status.",
-      {
-        statusCode: res.status,
-        safeToFallback: false,
-        notSubmitted: parsed?.notSubmitted === true || parsed?.error?.notSubmitted === true || parsed?.error?.details?.notSubmitted === true
-      }
-    );
-  }
-  return parsed.data;
-}
-
-// src/lib/permit2.ts
-var import_viem7 = require("viem");
-var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
-var MAX_UINT256 = 2n ** 256n - 1n;
-function permit2ApprovalAmount(requiredAmount) {
-  if (requiredAmount <= 0n) {
-    throw new Error("Permit2 approval requires a positive deposit amount");
-  }
-  return MAX_UINT256;
-}
-var ERC20_ALLOWANCE_ABI = [
-  {
-    type: "function",
-    name: "allowance",
-    stateMutability: "view",
-    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" }
-    ],
-    outputs: [{ name: "", type: "bool" }]
-  },
-  {
-    type: "function",
-    name: "balanceOf",
-    stateMutability: "view",
-    inputs: [{ name: "account", type: "address" }],
-    outputs: [{ name: "", type: "uint256" }]
-  }
-];
-function randomPermit2Nonce() {
-  const bytes = new Uint8Array(32);
-  globalThis.crypto.getRandomValues(bytes);
-  return BigInt((0, import_viem7.bytesToHex)(bytes));
-}
-async function readPermit2Allowance(publicClient, token, owner, blockNumber) {
-  return publicClient.readContract({
-    address: token,
-    abi: ERC20_ALLOWANCE_ABI,
-    functionName: "allowance",
-    args: [owner, PERMIT2_ADDRESS],
-    ...blockNumber === void 0 ? {} : { blockNumber }
-  });
-}
-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;
-var verificationSetter = /* @__PURE__ */ Symbol("owney.depositVerificationSetter");
-function provideDepositVerificationContext(callback, context) {
-  callback[verificationSetter]?.(context);
-}
-function makeVerificationAwareDepositCallback(implementation) {
-  let nextVerification;
-  const callback = async (smartWallet, chainId, amount) => {
-    const verification = nextVerification;
-    nextVerification = void 0;
-    return implementation(smartWallet, chainId, amount, verification);
-  };
-  Object.defineProperty(callback, verificationSetter, {
-    value: (context) => {
-      nextVerification = context;
-    }
-  });
-  return callback;
-}
-
 // src/agents/yieldseeker/yieldseeker.auth.ts
 var import_siwe = require("siwe");
 var import_viem8 = require("viem");
@@ -5387,7 +5400,7 @@ var YieldseekerAgent = class {
     this.assertAsset(targetAsset);
     await this.ensureAgent(state, chainId, targetAsset);
   }
-  async deposit(state, chainId, amount, asset, depositCallback, onProgress) {
+  async deposit(state, chainId, amount, asset, depositCallback, onProgress, onBeforeSubmission) {
     this.assertChain(chainId);
     this.assertAsset(asset);
     if (BigInt(amount) <= 0n) {
@@ -5443,7 +5456,17 @@ var YieldseekerAgent = class {
           chainId
         }, submitted, (value) => {
           receipt = value;
-        });
+        }, onBeforeSubmission ? () => onBeforeSubmission({
+          agentId: this.id,
+          chainId,
+          token: asset,
+          walletAddress: state.walletAddress,
+          agentWallet: context.wallet.walletAddress,
+          intendedAmount: amount,
+          transfer: "pending",
+          registration: "not-applicable",
+          delivery: "not-applicable"
+        }) : void 0);
       } catch (error) {
         if (error instanceof OwneyError && error.details?.ownerTransferNotExecuted === true && error.details.reason === "TRANSACTION_REPLACED_WITH_DIFFERENT_CALL") {
           notifyFunding(onProgress, {
@@ -7039,8 +7062,9 @@ var YieldseekerAgent = class {
       this.id
     );
   }
-  async submitTransaction(state, chainId, transaction, onSubmitted, onReceipt) {
+  async submitTransaction(state, chainId, transaction, onSubmitted, onReceipt, onBeforeSubmission) {
     if (this.transactionExecutor) {
+      await onBeforeSubmission?.();
       const hash2 = await this.transactionExecutor(state, chainId, transaction, onReceipt);
       onSubmitted?.(hash2);
       return hash2;
@@ -7050,7 +7074,10 @@ var YieldseekerAgent = class {
     const walletClient = (0, import_viem13.createWalletClient)({
       account,
       chain: import_chains4.base,
-      transport: (0, import_viem13.custom)(state.provider)
+      transport: onBeforeSubmission ? (0, import_viem13.custom)({ request: async (args) => {
+        if (args.method === "eth_sendTransaction") await onBeforeSubmission();
+        return state.provider.request(args);
+      } }, { retryCount: 0 }) : (0, import_viem13.custom)(state.provider)
     });
     const walletChainClient = (0, import_viem13.createPublicClient)({
       chain: import_chains4.base,
@@ -7891,6 +7918,7 @@ async function execute(i, key2, plan) {
         };
         save(key2, body);
       }
+      await i.onBeforeSubmission?.((0, import_viem16.keccak256)(body.serializedTransaction));
       try {
         i.onSubmitted?.((0, import_viem16.keccak256)(body.serializedTransaction));
       } catch {
@@ -7918,6 +7946,13 @@ async function execute(i, key2, plan) {
       clear(key2, body);
       return hash;
     } catch (error) {
+      if (initial.serializedTransaction && error instanceof OwneyError && error.code === "DEPOSIT_CHECKPOINT_FAILED") {
+        throw new OwneyError(
+          error.code,
+          "Could not save recovery of the existing deposit.",
+          { ...error.details, notSubmitted: false, safeToFallback: false }
+        );
+      }
       if (!body.serializedTransaction && !body.serializedPermitTransaction || rejectedPreparation(error) || error instanceof OwneyError && error.details?.notSubmitted === true)
         clear(key2, body);
       throw error;
@@ -8044,6 +8079,7 @@ function makeSponsoredTokenCallback(deps) {
       wallet,
       onApproved: deps.onApproved,
       onSubmitted: (hash) => deps.onSubmitted?.(hash, transfers),
+      onBeforeSubmission: (hash) => deps.onBeforeSubmission?.(hash, transfers),
       resumeTxHash: deps.resumeTxHash
     });
   };
@@ -8215,6 +8251,7 @@ function makeSponsoredCallsCallback(deps) {
       } catch {
       }
     };
+    await deps.onBeforeSubmission?.(requestedId, transfers);
     progress(requestedId, "pending");
     let sendResult;
     try {
@@ -8512,8 +8549,8 @@ var OwneySDK = class {
     return createPaidRpcClient(VIEM_CHAIN2[chainId], this.rpcUrls);
   }
   /** Builds the default USDC batch callback for the connected wallet. */
-  getDefaultSponsoredCallback(onApproved, onSubmitted, resumeTxHash) {
-    if (!onApproved && !onSubmitted && !resumeTxHash && this.cachedSponsoredCallback)
+  getDefaultSponsoredCallback(onApproved, onSubmitted, resumeTxHash, onBeforeSubmission) {
+    if (!onApproved && !onSubmitted && !resumeTxHash && !onBeforeSubmission && this.cachedSponsoredCallback)
       return this.cachedSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
@@ -8523,6 +8560,7 @@ var OwneySDK = class {
       ownerAddress: owner,
       onApproved,
       onSubmitted,
+      onBeforeSubmission,
       resumeTxHash,
       tokenAddressByChain: SPONSORED_USDC_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
@@ -8539,13 +8577,13 @@ var OwneySDK = class {
         transport: (0, import_viem18.custom)(provider)
       })
     });
-    if (!onApproved && !onSubmitted && !resumeTxHash) this.cachedSponsoredCallback = callback;
+    if (!onApproved && !onSubmitted && !resumeTxHash && !onBeforeSubmission) this.cachedSponsoredCallback = callback;
     return callback;
   }
   /** Builds the wallet-native sponsored calls callback for compatible paymasters. */
-  getDefaultSponsoredCallsCallback(asset, onApproved, onSubmitted, onCallsProgress) {
+  getDefaultSponsoredCallsCallback(asset, onApproved, onSubmitted, onCallsProgress, onBeforeSubmission) {
     const cached = this.cachedSponsoredCallsCallbacks.get(asset);
-    if (!onApproved && !onSubmitted && !onCallsProgress && cached) return cached;
+    if (!onApproved && !onSubmitted && !onCallsProgress && !onBeforeSubmission && cached) return cached;
     const provider = this.requireConnectedProvider();
     const callback = makeSponsoredCallsCallback({
       apiKey: this.apiKey,
@@ -8556,9 +8594,10 @@ var OwneySDK = class {
       onApproved,
       onSubmitted,
       onCallsProgress,
+      onBeforeSubmission,
       tokenAddressByChain: sponsoredTokensFor(asset)
     });
-    if (!onApproved && !onSubmitted && !onCallsProgress) this.cachedSponsoredCallsCallbacks.set(asset, callback);
+    if (!onApproved && !onSubmitted && !onCallsProgress && !onBeforeSubmission) this.cachedSponsoredCallsCallbacks.set(asset, callback);
     return callback;
   }
   /**
@@ -8567,8 +8606,8 @@ var OwneySDK = class {
    * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
    * single-use batch authorization instead of an EIP-3009 authorization.
    */
-  getDefaultWethSponsoredCallback(onApproved, onSubmitted, resumeTxHash) {
-    if (!onApproved && !onSubmitted && !resumeTxHash && this.cachedWethSponsoredCallback)
+  getDefaultWethSponsoredCallback(onApproved, onSubmitted, resumeTxHash, onBeforeSubmission) {
+    if (!onApproved && !onSubmitted && !resumeTxHash && !onBeforeSubmission && this.cachedWethSponsoredCallback)
       return this.cachedWethSponsoredCallback;
     const provider = this.requireConnectedProvider();
     const owner = this.state.walletAddress;
@@ -8578,6 +8617,7 @@ var OwneySDK = class {
       ownerAddress: owner,
       onApproved,
       onSubmitted,
+      onBeforeSubmission,
       resumeTxHash,
       tokenAddressByChain: SPONSORED_WETH_BY_CHAIN,
       // Casts work around viem's chain-narrowed Client vs the generic
@@ -8594,7 +8634,7 @@ var OwneySDK = class {
         transport: (0, import_viem18.custom)(provider)
       })
     });
-    if (!onApproved && !onSubmitted && !resumeTxHash) this.cachedWethSponsoredCallback = callback;
+    if (!onApproved && !onSubmitted && !resumeTxHash && !onBeforeSubmission) this.cachedWethSponsoredCallback = callback;
     return callback;
   }
   getAgent(agentId) {
@@ -8910,8 +8950,12 @@ var OwneySDK = class {
       );
     const prepared = /* @__PURE__ */ new Map();
     const paidFallbackAgents = /* @__PURE__ */ new Set();
-    const onProgress = options.onProgress ? (evidence) => {
-      if (evidence.agentWallet) prepared.set(evidence.agentWallet.toLowerCase(), evidence);
+    const onProgress = options.onProgress || options.onBeforeSubmission ? (evidence) => {
+      if (evidence.agentWallet) {
+        const wallet = evidence.agentWallet.toLowerCase();
+        evidence = { ...prepared.get(wallet), ...evidence };
+        prepared.set(wallet, evidence);
+      }
       notifyFunding(options.onProgress, evidence);
     } : void 0;
     const onSubmitted = onProgress ? (hash, destinations) => {
@@ -8931,9 +8975,45 @@ var OwneySDK = class {
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
+    let checkpointFailure;
+    let checkpointFailedEvidence = [];
+    const checkpoint2 = options.onBeforeSubmission ? async (evidence) => {
+      try {
+        if (this.state !== state || state.chainId !== chainId) throw new Error("Wallet changed before deposit submission.");
+        const submitting = evidence.map((leg) => ({ ...leg, depositSubmission: "started" }));
+        await options.onBeforeSubmission(submitting);
+        if (this.state !== state || state.chainId !== chainId) throw new Error("Wallet changed before deposit submission.");
+        submitting.forEach((leg) => notifyFunding(onProgress, leg));
+      } catch (cause) {
+        checkpointFailedEvidence = evidence;
+        checkpointFailure = new OwneyError(
+          "DEPOSIT_CHECKPOINT_FAILED",
+          "Could not safely save this deposit before submission.",
+          { notSubmitted: !options.resumeTxHash, safeToFallback: false, cause }
+        );
+        throw checkpointFailure;
+      }
+    } : void 0;
+    const checkpointDestinations = checkpoint2 ? async (destinations, identifier) => {
+      const evidence = destinations.map((destination) => {
+        const leg = prepared.get(destination.to.toLowerCase());
+        if (!leg || leg.intendedAmount !== destination.amount)
+          throw new OwneyError("DEPOSIT_CHECKPOINT_FAILED", "Missing prepared deposit destination.", { notSubmitted: true, safeToFallback: false });
+        return { ...leg, ...identifier, transfer: "pending" };
+      });
+      await checkpoint2(evidence);
+    } : void 0;
+    const checkpointHash = checkpointDestinations ? (hash, destinations) => checkpointDestinations(destinations, { txHash: hash }) : void 0;
+    const checkpointCalls = checkpointDestinations ? (id, destinations) => checkpointDestinations(destinations, { callsId: id }) : void 0;
+    const checkpointPaid = checkpoint2 ? (evidence) => checkpoint2([evidence]) : void 0;
+    const customCallback = depositCallback && checkpointDestinations ? makeVerificationAwareDepositCallback(async (to, cid, value, verification) => {
+      if (verification) provideDepositVerificationContext(depositCallback, verification);
+      await checkpointDestinations([{ to, amount: value }], {});
+      return depositCallback(to, cid, value);
+    }) : depositCallback;
     if (options.resumeTxHash && (depositCallback || this.paymasterServiceUrl || !/^0x[\da-f]{64}$/i.test(options.resumeTxHash)))
       throw new OwneyError("DEPOSIT_IN_PROGRESS", "This deposit cannot resume the saved relayer transaction.");
-    const effectiveCallback = depositCallback ?? (this.paymasterServiceUrl ? this.getDefaultSponsoredCallsCallback(asset, onApproved, onSubmitted, onCallsProgress) : asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved, onSubmitted, options.resumeTxHash) : this.getDefaultSponsoredCallback(onApproved, onSubmitted, options.resumeTxHash));
+    const effectiveCallback = customCallback ?? (this.paymasterServiceUrl ? this.getDefaultSponsoredCallsCallback(asset, onApproved, onSubmitted, onCallsProgress, checkpointCalls) : asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved, onSubmitted, options.resumeTxHash, checkpointHash) : this.getDefaultSponsoredCallback(onApproved, onSubmitted, options.resumeTxHash, checkpointHash));
     try {
       if (options.resumeTxHash) {
         const token = SupportedAssets.find((value) => value.chainId === chainId && value.symbol === asset);
@@ -8997,7 +9077,8 @@ var OwneySDK = class {
           depositCallback,
           onProgress,
           () => paidFallbackAgents.add(agent.id),
-          !!options.resumeTxHash
+          !!options.resumeTxHash,
+          checkpointPaid
         );
       }
       const totalAmount = BigInt(amount);
@@ -9099,7 +9180,8 @@ var OwneySDK = class {
             depositCallback,
             onProgress,
             () => paidFallbackAgents.add(agent.id),
-            !!options.resumeTxHash
+            !!options.resumeTxHash,
+            checkpointPaid
           );
         } catch (error) {
           if (Object.keys(agentResults).length === 0) throw error;
@@ -9119,12 +9201,22 @@ var OwneySDK = class {
       }
       return { agentResults };
     } catch (error) {
+      if (checkpointFailure && !(error instanceof OwneyError && error.details?.notSubmitted === false)) {
+        error = error instanceof OwneyError && error.code === "DEPOSIT_PARTIAL_FAILURE" ? new OwneyError(
+          error.code,
+          "Some deposits completed before another agent could be submitted.",
+          { ...error.details, cause: checkpointFailure },
+          error.agentId
+        ) : checkpointFailure;
+        if (!options.resumeTxHash) for (const evidence of checkpointFailedEvidence)
+          notifyFunding(onProgress, { ...evidence, transfer: "failed" });
+      }
       if (!depositCallback && onProgress && !options.resumeTxHash) {
         const ids = agentId ? [agentId] : this.getEligibleAgents(chainId, asset).map((agent) => agent.id);
         for (const id of ids) {
           const evidence = [...prepared.values()].find((value) => value.agentId === id);
-          if (paidFallbackAgents.has(id) || evidence?.transfer === "confirmed" || evidence?.transfer === "failed") continue;
           const rejected = error instanceof OwneyError && error.details?.notSubmitted === true;
+          if (!rejected && paidFallbackAgents.has(id) || evidence?.transfer === "confirmed" || evidence?.transfer === "failed") continue;
           if (!rejected && (evidence?.txHash || evidence?.userOpHash || evidence?.callsId)) continue;
           notifyFunding(onProgress, { ...evidence ?? {
             agentId: id,
@@ -9167,11 +9259,11 @@ var OwneySDK = class {
    * propagates unchanged. Scoped per agent invocation so one agent's failure
    * doesn't force a retry of sibling agents in a multi-agent split.
    */
-  async depositWithFallback(agent, state, chainId, amount, asset, effectiveCallback, appCallback, onProgress, onPaidFallback, resumeOnly = false) {
+  async depositWithFallback(agent, state, chainId, amount, asset, effectiveCallback, appCallback, onProgress, onPaidFallback, resumeOnly = false, onBeforeSubmission) {
     const attempt = (callback) => withFailureReporting(
       this.apiKey,
       agent.id,
-      () => onProgress ? agent.deposit(state, chainId, amount, asset, callback, onProgress) : agent.deposit(state, chainId, amount, asset, callback),
+      () => onBeforeSubmission ? agent.deposit(state, chainId, amount, asset, callback, onProgress, onBeforeSubmission) : onProgress ? agent.deposit(state, chainId, amount, asset, callback, onProgress) : agent.deposit(state, chainId, amount, asset, callback),
       this.routingApiBaseUrl
     );
     let approvalAttempted = false;