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

package/dist/index.js

@@ -252,6 +252,240 @@ var AgentChainIncompatibleError = class extends OwneyError {
   }
 };
 
+// src/lib/transfer-auth.ts
+import { bytesToHex } from "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
+import { bytesToHex as bytesToHex2 } from "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(bytesToHex2(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();
@@ -576,7 +810,7 @@ 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);
@@ -600,6 +834,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);
     }
@@ -2439,7 +2675,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;
@@ -2472,7 +2708,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,
@@ -3083,240 +3330,6 @@ import {
 } from "viem";
 import { base as base4 } from "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
-import { bytesToHex } from "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
-import { bytesToHex as bytesToHex2 } from "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(bytesToHex2(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
 import { SiweMessage, generateNonce } from "siwe";
 import {
@@ -5382,7 +5395,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) {
@@ -5438,7 +5451,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, {
@@ -7034,8 +7057,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;
@@ -7045,7 +7069,10 @@ var YieldseekerAgent = class {
     const walletClient = createWalletClient4({
       account,
       chain: base4,
-      transport: custom4(state.provider)
+      transport: onBeforeSubmission ? custom4({ request: async (args) => {
+        if (args.method === "eth_sendTransaction") await onBeforeSubmission();
+        return state.provider.request(args);
+      } }, { retryCount: 0 }) : custom4(state.provider)
     });
     const walletChainClient = createPublicClient3({
       chain: base4,
@@ -7897,6 +7924,7 @@ async function execute(i, key2, plan) {
         };
         save(key2, body);
       }
+      await i.onBeforeSubmission?.(keccak256(body.serializedTransaction));
       try {
         i.onSubmitted?.(keccak256(body.serializedTransaction));
       } catch {
@@ -7924,6 +7952,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;
@@ -8050,6 +8085,7 @@ function makeSponsoredTokenCallback(deps) {
       wallet,
       onApproved: deps.onApproved,
       onSubmitted: (hash) => deps.onSubmitted?.(hash, transfers),
+      onBeforeSubmission: (hash) => deps.onBeforeSubmission?.(hash, transfers),
       resumeTxHash: deps.resumeTxHash
     });
   };
@@ -8221,6 +8257,7 @@ function makeSponsoredCallsCallback(deps) {
       } catch {
       }
     };
+    await deps.onBeforeSubmission?.(requestedId, transfers);
     progress(requestedId, "pending");
     let sendResult;
     try {
@@ -8518,8 +8555,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;
@@ -8529,6 +8566,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
@@ -8545,13 +8583,13 @@ var OwneySDK = class {
         transport: custom5(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,
@@ -8562,9 +8600,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;
   }
   /**
@@ -8573,8 +8612,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;
@@ -8584,6 +8623,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
@@ -8600,7 +8640,7 @@ var OwneySDK = class {
         transport: custom5(provider)
       })
     });
-    if (!onApproved && !onSubmitted && !resumeTxHash) this.cachedWethSponsoredCallback = callback;
+    if (!onApproved && !onSubmitted && !resumeTxHash && !onBeforeSubmission) this.cachedWethSponsoredCallback = callback;
     return callback;
   }
   getAgent(agentId) {
@@ -8916,8 +8956,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) => {
@@ -8937,9 +8981,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);
@@ -9003,7 +9083,8 @@ var OwneySDK = class {
           depositCallback,
           onProgress,
           () => paidFallbackAgents.add(agent.id),
-          !!options.resumeTxHash
+          !!options.resumeTxHash,
+          checkpointPaid
         );
       }
       const totalAmount = BigInt(amount);
@@ -9105,7 +9186,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;
@@ -9125,12 +9207,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,
@@ -9173,11 +9265,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;