@owney/sdk 0.7.7-beta.6 → 0.7.8

package/README.md

@@ -263,6 +263,25 @@ console.log(allEarnings.agentEarnings.zyfai.lifetimeEarnings); // 42.5
 console.log(allEarnings.agentEarnings.zyfai.tokens); // per-chain, per-asset breakdown
 ```
 
+### `refreshEarnings(agentId?)`
+
+Refresh earnings for agents whose earnings data may be outdated. If the latest
+snapshot is less than one hour old, the SDK returns it without recalculating.
+
+| Param     | Type                 | Description                          |
+| --------- | -------------------- | ------------------------------------ |
+| `agentId` | `"zyfai"` (optional) | Agent to refresh. Omit for all agents. |
+
+Returns: `AgentEarnings` (single agent) or `OwneyEarnings` (all agents)
+
+```typescript
+// Single agent
+const refreshed = await sdk.refreshEarnings("zyfai");
+
+// All agents
+const allRefreshed = await sdk.refreshEarnings();
+```
+
 ### `getAccountApy({ agentId?, days })`
 
 Get the weighted APY for the user's account. When querying all agents, the total APY is a balance-weighted average.

package/dist/index.cjs

@@ -871,6 +871,7 @@ var WETH_ADDRESS_BY_CHAIN = {
 var VIEM_CHAIN = { 8453: import_chains.base, 42161: import_chains.arbitrum, 1: import_chains.mainnet };
 var SPLITTING_ASSETS = ["USDC", "WETH"];
 var POOL_POLICY_CHAIN_IDS = [8453, 42161, 1];
+var EARNINGS_REFRESH_COOLDOWN_MS = 60 * 60 * 1e3;
 var ZyfaiAgent = class {
   id = "zyfai";
   supportedChainIds = [8453, 42161, 1];
@@ -922,6 +923,7 @@ var ZyfaiAgent = class {
   // successful decode is cached forever; failures are NOT cached so a transient
   // RPC error retries on the next fetch.
   withdrawAmountCache = /* @__PURE__ */ new Map();
+  earningsRefreshInFlight = null;
   constructor(apiKey, rpcUrls, referralSource) {
     this.rpcUrls = rpcUrls ?? DEFAULT_ZYFAI_RPC_URLS;
     this.sdk = new import_sdk.ZyfaiSDK({
@@ -1719,6 +1721,22 @@ var ZyfaiAgent = class {
     const raw = await this.sdk.getOnchainEarnings(smartWallet);
     return mapEarnings(raw, smartWallet);
   }
+  async refreshEarnings(state, chainId) {
+    if (this.earningsRefreshInFlight) return this.earningsRefreshInFlight;
+    this.earningsRefreshInFlight = (async () => {
+      const { smartWallet } = await this.resolveSmartWallet(state, chainId);
+      const current = await this.sdk.getOnchainEarnings(smartWallet);
+      const lastCheck = current.data.lastCheckTimestamp ? Date.parse(current.data.lastCheckTimestamp) : Number.NaN;
+      const isFresh = Number.isFinite(lastCheck) && Date.now() - lastCheck < EARNINGS_REFRESH_COOLDOWN_MS;
+      const earnings = isFresh ? current : await this.sdk.calculateOnchainEarnings(smartWallet);
+      return mapEarnings(earnings, smartWallet);
+    })();
+    try {
+      return await this.earningsRefreshInFlight;
+    } finally {
+      this.earningsRefreshInFlight = null;
+    }
+  }
   async getAccountApy(state, chainId, days, tokenSymbol) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     const raw = await this.sdk.getDailyApyHistory(smartWallet, days);
@@ -2025,7 +2043,7 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
 }
 
 // src/client.ts
-var import_viem5 = require("viem");
+var import_viem6 = require("viem");
 var import_chains2 = require("viem/chains");
 
 // src/lib/transfer-auth.ts
@@ -2455,6 +2473,97 @@ function makeSponsoredWethCallback(deps) {
   };
 }
 
+// src/lib/sponsored-calls-deposit.ts
+var import_viem5 = require("viem");
+var DEFAULT_POLL_INTERVAL_MS = 1500;
+var DEFAULT_MAX_POLLS = 30;
+async function paymasterSupported(provider, owner, chainId) {
+  const caps = await provider.request({
+    method: "wallet_getCapabilities",
+    params: [owner]
+  });
+  const forChain = caps?.[(0, import_viem5.toHex)(chainId)] ?? caps?.[String(chainId)];
+  return Boolean(forChain?.paymasterService?.supported);
+}
+function makeSponsoredCallsCallback(deps) {
+  const pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const maxPolls = deps.maxPolls ?? DEFAULT_MAX_POLLS;
+  const absolutePaymasterUrl = () => {
+    const configured = deps.paymasterServiceUrl;
+    if (/^https?:\/\//i.test(configured)) return configured;
+    const origin = globalThis.location?.origin;
+    if (!origin) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_UNSUPPORTED",
+        `paymasterServiceUrl "${configured}" is relative and no page origin is available to resolve it.`
+      );
+    }
+    return new URL(configured, origin).toString();
+  };
+  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}`
+      );
+    }
+    if (!await paymasterSupported(deps.provider, deps.ownerAddress, chainId)) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_UNSUPPORTED",
+        `Wallet does not advertise paymasterService on chain ${chainId}.`,
+        { chainId }
+      );
+    }
+    const data = (0, import_viem5.encodeFunctionData)({
+      abi: import_viem5.erc20Abi,
+      functionName: "transfer",
+      args: [smartWallet, BigInt(amount)]
+    });
+    const sendResult = await deps.provider.request({
+      method: "wallet_sendCalls",
+      params: [
+        {
+          version: "2.0.0",
+          from: deps.ownerAddress,
+          chainId: (0, import_viem5.toHex)(chainId),
+          atomicRequired: false,
+          calls: [{ to: token, value: "0x0", data }],
+          capabilities: {
+            paymasterService: { url: absolutePaymasterUrl() }
+          }
+        }
+      ]
+    });
+    deps.onApproved?.();
+    const callsId = typeof sendResult === "string" ? sendResult : sendResult?.id;
+    if (!callsId) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_NO_ID",
+        "Wallet accepted wallet_sendCalls but returned no calls id.",
+        { chainId }
+      );
+    }
+    for (let attempt = 0; attempt < maxPolls; attempt += 1) {
+      const status = await deps.provider.request({
+        method: "wallet_getCallsStatus",
+        params: [callsId]
+      });
+      const txHash = status?.receipts?.[0]?.transactionHash;
+      if (txHash) return txHash;
+      if (pollIntervalMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+      }
+    }
+    throw new OwneyError(
+      "SPONSORED_CALLS_NO_RECEIPT",
+      `No receipt for calls ${callsId} after ${maxPolls} polls; the deposit may still settle.`,
+      { chainId, callsId }
+    );
+  };
+}
+
 // src/client.ts
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
@@ -2516,12 +2625,15 @@ var OwneySDK = class {
   referralSource;
   cachedSponsoredCallback = null;
   cachedWethSponsoredCallback = null;
+  paymasterServiceUrl;
+  cachedSponsoredCallsCallbacks = /* @__PURE__ */ new Map();
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
     if (config.debug) setOwneyDebug(true);
     this.zyfaiRpcUrls = config.zyfaiRpcUrls;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
+    this.paymasterServiceUrl = config.paymasterServiceUrl;
     this.referralSource = config.referralSource;
   }
   /**
@@ -2544,6 +2656,7 @@ var OwneySDK = class {
     this.state = { provider, walletAddress, chainId: null };
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
+    this.cachedSponsoredCallsCallbacks.clear();
   }
   /**
    * Disconnect from all agents and clear connection state.
@@ -2558,6 +2671,7 @@ var OwneySDK = class {
     this.state = null;
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
+    this.cachedSponsoredCallsCallbacks.clear();
   }
   isAgentDisabled(agentId) {
     return this.disabledAgents.has(agentId);
@@ -2620,14 +2734,14 @@ var OwneySDK = class {
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
       // runtime, but the two share a name TS treats as unrelated.
-      getPublicClient: (cid) => (0, import_viem5.createPublicClient)({
+      getPublicClient: (cid) => (0, import_viem6.createPublicClient)({
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem5.custom)(provider)
+        transport: (0, import_viem6.custom)(provider)
       }),
-      getWalletClient: (cid) => (0, import_viem5.createWalletClient)({
+      getWalletClient: (cid) => (0, import_viem6.createWalletClient)({
         account: owner,
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem5.custom)(provider)
+        transport: (0, import_viem6.custom)(provider)
       })
     });
     if (!onApproved) this.cachedSponsoredCallback = callback;
@@ -2639,6 +2753,26 @@ var OwneySDK = class {
    * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
    * `PermitTransferFrom` instead of an EIP-3009 authorization.
    */
+  getDefaultSponsoredCallsCallback(asset, onApproved) {
+    const cached = this.cachedSponsoredCallsCallbacks.get(asset);
+    if (!onApproved && cached) return cached;
+    const provider = this.requireConnectedProvider();
+    const callback = makeSponsoredCallsCallback({
+      provider,
+      ownerAddress: this.state.walletAddress,
+      paymasterServiceUrl: this.paymasterServiceUrl,
+      onApproved,
+      tokenAddressByChain: asset === "WETH" ? SPONSORED_WETH_BY_CHAIN : SPONSORED_USDC_BY_CHAIN
+    });
+    if (!onApproved) this.cachedSponsoredCallsCallbacks.set(asset, callback);
+    return callback;
+  }
+  /**
+   * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
+   * callback used when the caller omits `depositCallback` for a WETH deposit.
+   * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
+   * `PermitTransferFrom` instead of an EIP-3009 authorization.
+   */
   getDefaultWethSponsoredCallback(onApproved) {
     if (!onApproved && this.cachedWethSponsoredCallback)
       return this.cachedWethSponsoredCallback;
@@ -2653,14 +2787,14 @@ var OwneySDK = class {
       // Casts work around viem's chain-narrowed Client vs the generic
       // PublicClient/WalletClient param types — structurally identical at
       // runtime, but the two share a name TS treats as unrelated.
-      getPublicClient: (cid) => (0, import_viem5.createPublicClient)({
+      getPublicClient: (cid) => (0, import_viem6.createPublicClient)({
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem5.custom)(provider)
+        transport: (0, import_viem6.custom)(provider)
       }),
-      getWalletClient: (cid) => (0, import_viem5.createWalletClient)({
+      getWalletClient: (cid) => (0, import_viem6.createWalletClient)({
         account: owner,
         chain: VIEM_CHAIN2[cid],
-        transport: (0, import_viem5.custom)(provider)
+        transport: (0, import_viem6.custom)(provider)
       })
     });
     if (!onApproved) this.cachedWethSponsoredCallback = callback;
@@ -2861,7 +2995,7 @@ var OwneySDK = class {
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
-    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
+    const effectiveCallback = depositCallback ?? (this.paymasterServiceUrl ? this.getDefaultSponsoredCallsCallback(asset, onApproved) : asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(
@@ -3303,6 +3437,28 @@ var OwneySDK = class {
       agentEarnings: results
     };
   }
+  /**
+   * Return refreshed earnings while letting each agent own its refresh policy.
+   * Agents without a refresh capability fall back to their current snapshot.
+   */
+  async refreshEarnings(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const refreshAgent = (agent) => agent.refreshEarnings?.(state, chainId) ?? agent.getEarnings(state, chainId);
+    if (agentId) return refreshAgent(this.getAgent(agentId));
+    let totalEarnings = 0;
+    const agentEarnings = {};
+    const refreshed = await Promise.all(
+      [...this.getActiveAgents().entries()].map(
+        async ([id, agent]) => [id, await refreshAgent(agent)]
+      )
+    );
+    for (const [id, earnings] of refreshed) {
+      agentEarnings[id] = earnings;
+      totalEarnings += Number(earnings.lifetimeEarnings);
+    }
+    return { totalEarnings: String(totalEarnings), agentEarnings };
+  }
   /**
    * Get the weighted APY for the user's account over a time period.
    * When querying all agents, the total APY is a balance-weighted average.
@@ -3504,10 +3660,10 @@ var OwneySDK = class {
       );
     }
     const provider = this.requireConnectedProvider();
-    const wallet = (0, import_viem5.createWalletClient)({
+    const wallet = (0, import_viem6.createWalletClient)({
       account: state.walletAddress,
       chain: VIEM_CHAIN2[chainId],
-      transport: (0, import_viem5.custom)(provider)
+      transport: (0, import_viem6.custom)(provider)
     });
     const hash = await wallet.writeContract({
       address: token,
@@ -3517,9 +3673,9 @@ var OwneySDK = class {
       account: state.walletAddress,
       chain: VIEM_CHAIN2[chainId]
     });
-    const publicClient = (0, import_viem5.createPublicClient)({
+    const publicClient = (0, import_viem6.createPublicClient)({
       chain: VIEM_CHAIN2[chainId],
-      transport: (0, import_viem5.custom)(provider)
+      transport: (0, import_viem6.custom)(provider)
     });
     const receipt = await publicClient.waitForTransactionReceipt({
       hash,
@@ -3628,7 +3784,7 @@ var OwneySDK = class {
 };
 
 // src/agents/zyfai/zyfai.siwx.ts
-var import_viem6 = require("viem");
+var import_viem7 = require("viem");
 var import_siwe = require("siwe");
 var import_sdk2 = require("@zyfai/sdk");
 
@@ -3755,7 +3911,7 @@ function buildSIWXConfig(deps) {
       issuedAt,
       toString() {
         return new import_siwe.SiweMessage({
-          address: (0, import_viem6.getAddress)(accountAddress),
+          address: (0, import_viem7.getAddress)(accountAddress),
           chainId: numericChainId(chainId),
           domain,
           uri,

package/dist/index.d.cts

@@ -30,6 +30,17 @@ interface OwneySDKConfig {
      * already-deployed app: set `globalThis.__OWNEY_DEBUG__ = true` in devtools.
      */
     debug?: boolean;
+    /**
+     * Absolute URL of an ERC-7677 paymaster service. When set, deposits go out as
+     * an EIP-5792 `wallet_sendCalls` with `capabilities.paymasterService`, so a
+     * wallet that advertises sponsorship pays no native gas — the case EIP-3009
+     * cannot serve, because USDC verifies it with `ecrecover` and a smart account
+     * signs via ERC-1271.
+     *
+     * MUST be absolute: the wallet fetches this URL itself, so a relative path is
+     * unresolvable. Omit it and every rail behaves exactly as before.
+     */
+    paymasterServiceUrl?: string;
 }
 interface ConnectionState {
     provider: any;
@@ -372,6 +383,11 @@ interface IAgent {
     withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
     getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
+    /**
+     * Refresh the agent's earnings snapshot when its backend supports doing so.
+     * Implementations own freshness and request-deduplication policy.
+     */
+    refreshEarnings?(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, 
     /**
      * Optional asset symbol ("USDC" / "WETH") scoping the daily series to a
@@ -418,6 +434,8 @@ declare class OwneySDK {
     private referralSource?;
     private cachedSponsoredCallback;
     private cachedWethSponsoredCallback;
+    private paymasterServiceUrl?;
+    private cachedSponsoredCallsCallbacks;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -458,6 +476,13 @@ declare class OwneySDK {
      * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
      * `PermitTransferFrom` instead of an EIP-3009 authorization.
      */
+    private getDefaultSponsoredCallsCallback;
+    /**
+     * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
+     * callback used when the caller omits `depositCallback` for a WETH deposit.
+     * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
+     * `PermitTransferFrom` instead of an EIP-3009 authorization.
+     */
     private getDefaultWethSponsoredCallback;
     private getAgent;
     private getActiveAgents;
@@ -561,6 +586,11 @@ declare class OwneySDK {
      * @returns {AgentEarnings} for a single agent, or {OwneyEarnings} with totalEarnings and per-agent breakdown
      */
     getEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
+    /**
+     * Return refreshed earnings while letting each agent own its refresh policy.
+     * Agents without a refresh capability fall back to their current snapshot.
+     */
+    refreshEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
     /**
      * Get the weighted APY for the user's account over a time period.
      * When querying all agents, the total APY is a balance-weighted average.
@@ -634,7 +664,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "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";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "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" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "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

@@ -30,6 +30,17 @@ interface OwneySDKConfig {
      * already-deployed app: set `globalThis.__OWNEY_DEBUG__ = true` in devtools.
      */
     debug?: boolean;
+    /**
+     * Absolute URL of an ERC-7677 paymaster service. When set, deposits go out as
+     * an EIP-5792 `wallet_sendCalls` with `capabilities.paymasterService`, so a
+     * wallet that advertises sponsorship pays no native gas — the case EIP-3009
+     * cannot serve, because USDC verifies it with `ecrecover` and a smart account
+     * signs via ERC-1271.
+     *
+     * MUST be absolute: the wallet fetches this URL itself, so a relative path is
+     * unresolvable. Omit it and every rail behaves exactly as before.
+     */
+    paymasterServiceUrl?: string;
 }
 interface ConnectionState {
     provider: any;
@@ -372,6 +383,11 @@ interface IAgent {
     withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
     getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
+    /**
+     * Refresh the agent's earnings snapshot when its backend supports doing so.
+     * Implementations own freshness and request-deduplication policy.
+     */
+    refreshEarnings?(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, 
     /**
      * Optional asset symbol ("USDC" / "WETH") scoping the daily series to a
@@ -418,6 +434,8 @@ declare class OwneySDK {
     private referralSource?;
     private cachedSponsoredCallback;
     private cachedWethSponsoredCallback;
+    private paymasterServiceUrl?;
+    private cachedSponsoredCallsCallbacks;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -458,6 +476,13 @@ declare class OwneySDK {
      * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
      * `PermitTransferFrom` instead of an EIP-3009 authorization.
      */
+    private getDefaultSponsoredCallsCallback;
+    /**
+     * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
+     * callback used when the caller omits `depositCallback` for a WETH deposit.
+     * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
+     * `PermitTransferFrom` instead of an EIP-3009 authorization.
+     */
     private getDefaultWethSponsoredCallback;
     private getAgent;
     private getActiveAgents;
@@ -561,6 +586,11 @@ declare class OwneySDK {
      * @returns {AgentEarnings} for a single agent, or {OwneyEarnings} with totalEarnings and per-agent breakdown
      */
     getEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
+    /**
+     * Return refreshed earnings while letting each agent own its refresh policy.
+     * Agents without a refresh capability fall back to their current snapshot.
+     */
+    refreshEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
     /**
      * Get the weighted APY for the user's account over a time period.
      * When querying all agents, the total APY is a balance-weighted average.
@@ -634,7 +664,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "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";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "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" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "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

@@ -838,6 +838,7 @@ var WETH_ADDRESS_BY_CHAIN = {
 var VIEM_CHAIN = { 8453: base, 42161: arbitrum, 1: mainnet };
 var SPLITTING_ASSETS = ["USDC", "WETH"];
 var POOL_POLICY_CHAIN_IDS = [8453, 42161, 1];
+var EARNINGS_REFRESH_COOLDOWN_MS = 60 * 60 * 1e3;
 var ZyfaiAgent = class {
   id = "zyfai";
   supportedChainIds = [8453, 42161, 1];
@@ -889,6 +890,7 @@ var ZyfaiAgent = class {
   // successful decode is cached forever; failures are NOT cached so a transient
   // RPC error retries on the next fetch.
   withdrawAmountCache = /* @__PURE__ */ new Map();
+  earningsRefreshInFlight = null;
   constructor(apiKey, rpcUrls, referralSource) {
     this.rpcUrls = rpcUrls ?? DEFAULT_ZYFAI_RPC_URLS;
     this.sdk = new ZyfaiSDK({
@@ -1686,6 +1688,22 @@ var ZyfaiAgent = class {
     const raw = await this.sdk.getOnchainEarnings(smartWallet);
     return mapEarnings(raw, smartWallet);
   }
+  async refreshEarnings(state, chainId) {
+    if (this.earningsRefreshInFlight) return this.earningsRefreshInFlight;
+    this.earningsRefreshInFlight = (async () => {
+      const { smartWallet } = await this.resolveSmartWallet(state, chainId);
+      const current = await this.sdk.getOnchainEarnings(smartWallet);
+      const lastCheck = current.data.lastCheckTimestamp ? Date.parse(current.data.lastCheckTimestamp) : Number.NaN;
+      const isFresh = Number.isFinite(lastCheck) && Date.now() - lastCheck < EARNINGS_REFRESH_COOLDOWN_MS;
+      const earnings = isFresh ? current : await this.sdk.calculateOnchainEarnings(smartWallet);
+      return mapEarnings(earnings, smartWallet);
+    })();
+    try {
+      return await this.earningsRefreshInFlight;
+    } finally {
+      this.earningsRefreshInFlight = null;
+    }
+  }
   async getAccountApy(state, chainId, days, tokenSymbol) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     const raw = await this.sdk.getDailyApyHistory(smartWallet, days);
@@ -2426,6 +2444,97 @@ function makeSponsoredWethCallback(deps) {
   };
 }
 
+// src/lib/sponsored-calls-deposit.ts
+import { encodeFunctionData, erc20Abi, toHex } from "viem";
+var DEFAULT_POLL_INTERVAL_MS = 1500;
+var DEFAULT_MAX_POLLS = 30;
+async function paymasterSupported(provider, owner, chainId) {
+  const caps = await provider.request({
+    method: "wallet_getCapabilities",
+    params: [owner]
+  });
+  const forChain = caps?.[toHex(chainId)] ?? caps?.[String(chainId)];
+  return Boolean(forChain?.paymasterService?.supported);
+}
+function makeSponsoredCallsCallback(deps) {
+  const pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const maxPolls = deps.maxPolls ?? DEFAULT_MAX_POLLS;
+  const absolutePaymasterUrl = () => {
+    const configured = deps.paymasterServiceUrl;
+    if (/^https?:\/\//i.test(configured)) return configured;
+    const origin = globalThis.location?.origin;
+    if (!origin) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_UNSUPPORTED",
+        `paymasterServiceUrl "${configured}" is relative and no page origin is available to resolve it.`
+      );
+    }
+    return new URL(configured, origin).toString();
+  };
+  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}`
+      );
+    }
+    if (!await paymasterSupported(deps.provider, deps.ownerAddress, chainId)) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_UNSUPPORTED",
+        `Wallet does not advertise paymasterService on chain ${chainId}.`,
+        { chainId }
+      );
+    }
+    const data = encodeFunctionData({
+      abi: erc20Abi,
+      functionName: "transfer",
+      args: [smartWallet, BigInt(amount)]
+    });
+    const sendResult = await deps.provider.request({
+      method: "wallet_sendCalls",
+      params: [
+        {
+          version: "2.0.0",
+          from: deps.ownerAddress,
+          chainId: toHex(chainId),
+          atomicRequired: false,
+          calls: [{ to: token, value: "0x0", data }],
+          capabilities: {
+            paymasterService: { url: absolutePaymasterUrl() }
+          }
+        }
+      ]
+    });
+    deps.onApproved?.();
+    const callsId = typeof sendResult === "string" ? sendResult : sendResult?.id;
+    if (!callsId) {
+      throw new OwneyError(
+        "SPONSORED_CALLS_NO_ID",
+        "Wallet accepted wallet_sendCalls but returned no calls id.",
+        { chainId }
+      );
+    }
+    for (let attempt = 0; attempt < maxPolls; attempt += 1) {
+      const status = await deps.provider.request({
+        method: "wallet_getCallsStatus",
+        params: [callsId]
+      });
+      const txHash = status?.receipts?.[0]?.transactionHash;
+      if (txHash) return txHash;
+      if (pollIntervalMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+      }
+    }
+    throw new OwneyError(
+      "SPONSORED_CALLS_NO_RECEIPT",
+      `No receipt for calls ${callsId} after ${maxPolls} polls; the deposit may still settle.`,
+      { chainId, callsId }
+    );
+  };
+}
+
 // src/client.ts
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
@@ -2487,12 +2596,15 @@ var OwneySDK = class {
   referralSource;
   cachedSponsoredCallback = null;
   cachedWethSponsoredCallback = null;
+  paymasterServiceUrl;
+  cachedSponsoredCallsCallbacks = /* @__PURE__ */ new Map();
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
     if (config.debug) setOwneyDebug(true);
     this.zyfaiRpcUrls = config.zyfaiRpcUrls;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
+    this.paymasterServiceUrl = config.paymasterServiceUrl;
     this.referralSource = config.referralSource;
   }
   /**
@@ -2515,6 +2627,7 @@ var OwneySDK = class {
     this.state = { provider, walletAddress, chainId: null };
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
+    this.cachedSponsoredCallsCallbacks.clear();
   }
   /**
    * Disconnect from all agents and clear connection state.
@@ -2529,6 +2642,7 @@ var OwneySDK = class {
     this.state = null;
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
+    this.cachedSponsoredCallsCallbacks.clear();
   }
   isAgentDisabled(agentId) {
     return this.disabledAgents.has(agentId);
@@ -2610,6 +2724,26 @@ var OwneySDK = class {
    * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
    * `PermitTransferFrom` instead of an EIP-3009 authorization.
    */
+  getDefaultSponsoredCallsCallback(asset, onApproved) {
+    const cached = this.cachedSponsoredCallsCallbacks.get(asset);
+    if (!onApproved && cached) return cached;
+    const provider = this.requireConnectedProvider();
+    const callback = makeSponsoredCallsCallback({
+      provider,
+      ownerAddress: this.state.walletAddress,
+      paymasterServiceUrl: this.paymasterServiceUrl,
+      onApproved,
+      tokenAddressByChain: asset === "WETH" ? SPONSORED_WETH_BY_CHAIN : SPONSORED_USDC_BY_CHAIN
+    });
+    if (!onApproved) this.cachedSponsoredCallsCallbacks.set(asset, callback);
+    return callback;
+  }
+  /**
+   * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
+   * callback used when the caller omits `depositCallback` for a WETH deposit.
+   * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
+   * `PermitTransferFrom` instead of an EIP-3009 authorization.
+   */
   getDefaultWethSponsoredCallback(onApproved) {
     if (!onApproved && this.cachedWethSponsoredCallback)
       return this.cachedWethSponsoredCallback;
@@ -2832,7 +2966,7 @@ var OwneySDK = class {
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
-    const effectiveCallback = depositCallback ?? (asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
+    const effectiveCallback = depositCallback ?? (this.paymasterServiceUrl ? this.getDefaultSponsoredCallsCallback(asset, onApproved) : asset === "WETH" ? this.getDefaultWethSponsoredCallback(onApproved) : this.getDefaultSponsoredCallback(onApproved));
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(
@@ -3274,6 +3408,28 @@ var OwneySDK = class {
       agentEarnings: results
     };
   }
+  /**
+   * Return refreshed earnings while letting each agent own its refresh policy.
+   * Agents without a refresh capability fall back to their current snapshot.
+   */
+  async refreshEarnings(agentId) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const refreshAgent = (agent) => agent.refreshEarnings?.(state, chainId) ?? agent.getEarnings(state, chainId);
+    if (agentId) return refreshAgent(this.getAgent(agentId));
+    let totalEarnings = 0;
+    const agentEarnings = {};
+    const refreshed = await Promise.all(
+      [...this.getActiveAgents().entries()].map(
+        async ([id, agent]) => [id, await refreshAgent(agent)]
+      )
+    );
+    for (const [id, earnings] of refreshed) {
+      agentEarnings[id] = earnings;
+      totalEarnings += Number(earnings.lifetimeEarnings);
+    }
+    return { totalEarnings: String(totalEarnings), agentEarnings };
+  }
   /**
    * Get the weighted APY for the user's account over a time period.
    * When querying all agents, the total APY is a balance-weighted average.

package/package.json

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