@owney/sdk 0.4.4 → 0.5.0-beta.0

package/dist/index.cjs

@@ -240,7 +240,6 @@ function mapApyHistory(raw) {
 }
 function mapEntries(rawEntries, chainId) {
   const actionMap = {
-    "Deposit to protocol": "Deposit",
     "Top up wallet": "Top up",
     "Partial withdraw from protocol": "Withdraw",
     "Withdraw from protocol": "Withdraw",
@@ -662,7 +661,7 @@ var ZyfaiAgent = class {
   }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-    const raw = await this.sdk.calculateOnchainEarnings(smartWallet);
+    const raw = await this.sdk.getOnchainEarnings(smartWallet);
     return mapEarnings(raw, smartWallet);
   }
   async getAccountApy(state, chainId, days) {
@@ -688,17 +687,24 @@ var ZyfaiAgent = class {
         fromDate: options?.fromDate,
         toDate
       });
-      matched.push(...raw.data.filter((e) => e.chainId === validChainId));
+      raw.data.forEach((entry, idx) => {
+        if (entry.chainId === validChainId && entry.action !== "Deposit to protocol") {
+          matched.push({ entry, rawIdx: offset + idx });
+        }
+      });
       offset += raw.data.length;
       if (raw.data.length < backendPageSize) {
         backendExhausted = true;
         break;
       }
     }
-    const overshoot = Math.max(0, matched.length - limit);
-    const pageData = matched.slice(0, limit);
-    const hasMore = !backendExhausted || overshoot > 0;
-    const nextCursor = hasMore ? encodeHistoryCursor({ toDate, rawOffset: offset - overshoot }) : void 0;
+    const pageData = matched.slice(0, limit).map((m) => m.entry);
+    const firstOvershoot = matched[limit];
+    const hasMore = !backendExhausted || firstOvershoot !== void 0;
+    const nextCursor = hasMore ? encodeHistoryCursor({
+      toDate,
+      rawOffset: firstOvershoot ? firstOvershoot.rawIdx : offset
+    }) : void 0;
     return {
       data: mapEntries(pageData, validChainId),
       hasMore,
@@ -927,6 +933,130 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
   return out;
 }
 
+// src/client.ts
+var import_viem3 = require("viem");
+var import_chains = require("viem/chains");
+
+// src/lib/transfer-auth.ts
+var import_viem2 = require("viem");
+var ERC20_META_ABI = [
+  { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] },
+  { type: "function", name: "version", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] }
+];
+function buildTransferWithAuthorizationTypedData(input) {
+  return {
+    domain: { name: input.tokenName, version: input.tokenVersion, chainId: input.chainId, verifyingContract: input.token },
+    types: {
+      TransferWithAuthorization: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "validAfter", type: "uint256" },
+        { name: "validBefore", type: "uint256" },
+        { name: "nonce", type: "bytes32" }
+      ]
+    },
+    primaryType: "TransferWithAuthorization",
+    message: input.message
+  };
+}
+async function readTokenMeta(publicClient, token) {
+  const [tokenName, tokenVersion] = await Promise.all([
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "name" }),
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "version" }).catch(() => "2")
+  ]);
+  return { tokenName, tokenVersion };
+}
+function randomAuthNonce() {
+  const bytes = new Uint8Array(32);
+  globalThis.crypto.getRandomValues(bytes);
+  return (0, import_viem2.bytesToHex)(bytes);
+}
+
+// src/lib/sponsor-client.ts
+var ROUTING_API_BASE_URL3 = "https://owney-routing-api-243946518160.europe-west4.run.app";
+async function postSponsorTransferAuth(input) {
+  const base2 = input.baseUrl ?? ROUTING_API_BASE_URL3;
+  let res;
+  try {
+    res = await fetch(`${base2}/api/v1/sponsor/erc20-transfer-auth`, {
+      method: "POST",
+      headers: { "content-type": "application/json", "x-owney-api-key": input.apiKey },
+      body: JSON.stringify(input.body)
+    });
+  } catch (networkError) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Sponsor API network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
+      { cause: String(networkError) }
+    );
+  }
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+  }
+  if (!res.ok || !parsed?.success || !parsed.data) {
+    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) }
+    );
+  }
+  return parsed.data;
+}
+
+// src/lib/sponsored-deposit.ts
+var AUTH_WINDOW_SECONDS = 15 * 60;
+function makeSponsoredDepositCallback(deps) {
+  const post = deps.httpPost ?? postSponsorTransferAuth;
+  return async (smartWallet, chainId, amount) => {
+    const cid = chainId;
+    const token = deps.tokenAddressByChain[cid];
+    if (!token) {
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored token configured for chain ${chainId}`
+      );
+    }
+    const pub = deps.getPublicClient(cid);
+    const wallet = deps.getWalletClient(cid);
+    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
+    const validAfter = 0n;
+    const validBefore = BigInt(Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS);
+    const nonce = randomAuthNonce();
+    const typedData = buildTransferWithAuthorizationTypedData({
+      token,
+      chainId: cid,
+      tokenName,
+      tokenVersion,
+      message: { from: deps.ownerAddress, to: smartWallet, value: BigInt(amount), validAfter, validBefore, nonce }
+    });
+    const authSignature = await wallet.signTypedData(
+      { account: deps.ownerAddress, ...typedData }
+    );
+    const result = await post({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      body: {
+        chainId: cid,
+        token,
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: amount,
+        validAfter: validAfter.toString(),
+        validBefore: validBefore.toString(),
+        nonce,
+        authSignature,
+        tokenName,
+        tokenVersion
+      }
+    });
+    return result.txHash;
+  };
+}
+
 // src/client.ts
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
@@ -948,6 +1078,11 @@ function decodeMultiAgentCursor(token) {
   }
   return parsed;
 }
+var SPONSORED_USDC_BY_CHAIN = {
+  8453: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+  42161: "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
+};
+var VIEM_CHAIN = { 8453: import_chains.base, 42161: import_chains.arbitrum };
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
@@ -960,6 +1095,7 @@ var OwneySDK = class {
   state = null;
   apiKey;
   zyfaiRpcUrls;
+  cachedSponsoredCallback = null;
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
@@ -983,6 +1119,7 @@ var OwneySDK = class {
       );
     }
     this.state = { provider, walletAddress, chainId: null };
+    this.cachedSponsoredCallback = null;
   }
   /**
    * Disconnect from all agents and clear connection state.
@@ -995,6 +1132,7 @@ var OwneySDK = class {
     this.activeAgents.clear();
     this.disabledAgents.clear();
     this.state = null;
+    this.cachedSponsoredCallback = null;
   }
   isAgentDisabled(agentId) {
     return this.disabledAgents.has(agentId);
@@ -1028,6 +1166,46 @@ var OwneySDK = class {
     }
     return chainId;
   }
+  requireConnectedProvider() {
+    if (!this.state?.provider) {
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "connect(provider) must be called before deposit",
+        {}
+      );
+    }
+    return this.state.provider;
+  }
+  /**
+   * Lazily builds (and caches) the default EIP-3009 sponsored deposit callback
+   * used when the caller omits `depositCallback`. Wraps the connected EIP-1193
+   * provider with viem `custom(provider)` to read token meta and sign the
+   * `TransferWithAuthorization`, then POSTs to the sponsor API.
+   */
+  getDefaultSponsoredCallback() {
+    if (this.cachedSponsoredCallback)
+      return this.cachedSponsoredCallback;
+    const provider = this.requireConnectedProvider();
+    const owner = this.state.walletAddress;
+    this.cachedSponsoredCallback = makeSponsoredDepositCallback({
+      apiKey: this.apiKey,
+      ownerAddress: owner,
+      tokenAddressByChain: SPONSORED_USDC_BY_CHAIN,
+      // 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_viem3.createPublicClient)({
+        chain: VIEM_CHAIN[cid],
+        transport: (0, import_viem3.custom)(provider)
+      }),
+      getWalletClient: (cid) => (0, import_viem3.createWalletClient)({
+        account: owner,
+        chain: VIEM_CHAIN[cid],
+        transport: (0, import_viem3.custom)(provider)
+      })
+    });
+    return this.cachedSponsoredCallback;
+  }
   getAgent(agentId) {
     const agent = this.agents.get(agentId);
     if (!agent) {
@@ -1181,6 +1359,7 @@ var OwneySDK = class {
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
+    const effectiveCallback = depositCallback ?? this.getDefaultSponsoredCallback();
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(
@@ -1195,7 +1374,7 @@ var OwneySDK = class {
       return withFailureReporting(
         this.apiKey,
         agent.id,
-        () => agent.deposit(state, chainId, amount, depositCallback)
+        () => agent.deposit(state, chainId, amount, effectiveCallback)
       );
     }
     const totalAmount = BigInt(amount);
@@ -1229,7 +1408,7 @@ var OwneySDK = class {
       agentResults[agent.id] = await withFailureReporting(
         this.apiKey,
         agent.id,
-        () => agent.deposit(state, chainId, agentAmount, depositCallback)
+        () => agent.deposit(state, chainId, agentAmount, effectiveCallback)
       );
     }
     return { agentResults };
@@ -1677,9 +1856,20 @@ var OwneySDK = class {
         hasMore = true;
       }
     }
-    merged.sort(
-      (a, b) => new Date(b.date).getTime() - new Date(a.date).getTime()
-    );
+    merged.sort((a, b) => {
+      const dateDiff = new Date(b.date).getTime() - new Date(a.date).getTime();
+      if (dateDiff !== 0)
+        return dateDiff;
+      if (a.agent !== b.agent)
+        return a.agent < b.agent ? -1 : 1;
+      const aTx = a.transactions?.[0]?.txHashes?.[0] ?? "";
+      const bTx = b.transactions?.[0]?.txHashes?.[0] ?? "";
+      if (aTx !== bTx)
+        return aTx < bTx ? -1 : 1;
+      if (a.action !== b.action)
+        return a.action < b.action ? -1 : 1;
+      return 0;
+    });
     return {
       data: merged,
       hasMore,

package/dist/index.d.cts

@@ -99,7 +99,7 @@ type AgentsApyOptions = {
 type DepositOptions = {
     amount: string;
     asset: Asset;
-    depositCallback: DepositCallback;
+    depositCallback?: DepositCallback;
     agentId?: AgentId;
 };
 
@@ -170,6 +170,12 @@ interface RebalanceLog {
     amount: string;
     status: "success" | "failed";
 }
+interface AgentHistoryPosition {
+    protocol: string;
+    pool?: string;
+    tokenSymbol?: string;
+    amount?: string;
+}
 interface AgentHistoryEntry {
     agent: AgentId;
     action: HistoryAction;
@@ -178,6 +184,7 @@ interface AgentHistoryEntry {
     newApy: string | null;
     transactions: HistoryTransaction[];
     rebalanceLog: RebalanceLog[];
+    positions?: AgentHistoryPosition[];
 }
 interface OwneyAgentHistory {
     data: AgentHistoryEntry[];
@@ -228,6 +235,7 @@ declare class OwneySDK {
     private state;
     private apiKey;
     private zyfaiRpcUrls?;
+    private cachedSponsoredCallback;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -254,6 +262,14 @@ declare class OwneySDK {
     getActiveChainId(): number | null;
     private requireState;
     private requireChainId;
+    private requireConnectedProvider;
+    /**
+     * Lazily builds (and caches) the default EIP-3009 sponsored deposit callback
+     * used when the caller omits `depositCallback`. Wraps the connected EIP-1193
+     * provider with viem `custom(provider)` to read token meta and sign the
+     * `TransferWithAuthorization`, then POSTs to the sponsor API.
+     */
+    private getDefaultSponsoredCallback;
     private getAgent;
     private getActiveAgents;
     private ensureAgentsInitialized;
@@ -381,7 +397,7 @@ declare class OwneySDK {
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "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" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -411,4 +427,4 @@ declare class InvalidHistoryCursorError extends Error {
     constructor(message: string);
 }
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneySDK, OwneySDKConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneySDK, OwneySDKConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.d.ts

@@ -99,7 +99,7 @@ type AgentsApyOptions = {
 type DepositOptions = {
     amount: string;
     asset: Asset;
-    depositCallback: DepositCallback;
+    depositCallback?: DepositCallback;
     agentId?: AgentId;
 };
 
@@ -170,6 +170,12 @@ interface RebalanceLog {
     amount: string;
     status: "success" | "failed";
 }
+interface AgentHistoryPosition {
+    protocol: string;
+    pool?: string;
+    tokenSymbol?: string;
+    amount?: string;
+}
 interface AgentHistoryEntry {
     agent: AgentId;
     action: HistoryAction;
@@ -178,6 +184,7 @@ interface AgentHistoryEntry {
     newApy: string | null;
     transactions: HistoryTransaction[];
     rebalanceLog: RebalanceLog[];
+    positions?: AgentHistoryPosition[];
 }
 interface OwneyAgentHistory {
     data: AgentHistoryEntry[];
@@ -228,6 +235,7 @@ declare class OwneySDK {
     private state;
     private apiKey;
     private zyfaiRpcUrls?;
+    private cachedSponsoredCallback;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -254,6 +262,14 @@ declare class OwneySDK {
     getActiveChainId(): number | null;
     private requireState;
     private requireChainId;
+    private requireConnectedProvider;
+    /**
+     * Lazily builds (and caches) the default EIP-3009 sponsored deposit callback
+     * used when the caller omits `depositCallback`. Wraps the connected EIP-1193
+     * provider with viem `custom(provider)` to read token meta and sign the
+     * `TransferWithAuthorization`, then POSTs to the sponsor API.
+     */
+    private getDefaultSponsoredCallback;
     private getAgent;
     private getActiveAgents;
     private ensureAgentsInitialized;
@@ -381,7 +397,7 @@ declare class OwneySDK {
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
 }
 
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "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" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -411,4 +427,4 @@ declare class InvalidHistoryCursorError extends Error {
     constructor(message: string);
 }
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneySDK, OwneySDKConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneySDK, OwneySDKConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.js

@@ -209,7 +209,6 @@ function mapApyHistory(raw) {
 }
 function mapEntries(rawEntries, chainId) {
   const actionMap = {
-    "Deposit to protocol": "Deposit",
     "Top up wallet": "Top up",
     "Partial withdraw from protocol": "Withdraw",
     "Withdraw from protocol": "Withdraw",
@@ -631,7 +630,7 @@ var ZyfaiAgent = class {
   }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-    const raw = await this.sdk.calculateOnchainEarnings(smartWallet);
+    const raw = await this.sdk.getOnchainEarnings(smartWallet);
     return mapEarnings(raw, smartWallet);
   }
   async getAccountApy(state, chainId, days) {
@@ -657,17 +656,24 @@ var ZyfaiAgent = class {
         fromDate: options?.fromDate,
         toDate
       });
-      matched.push(...raw.data.filter((e) => e.chainId === validChainId));
+      raw.data.forEach((entry, idx) => {
+        if (entry.chainId === validChainId && entry.action !== "Deposit to protocol") {
+          matched.push({ entry, rawIdx: offset + idx });
+        }
+      });
       offset += raw.data.length;
       if (raw.data.length < backendPageSize) {
         backendExhausted = true;
         break;
       }
     }
-    const overshoot = Math.max(0, matched.length - limit);
-    const pageData = matched.slice(0, limit);
-    const hasMore = !backendExhausted || overshoot > 0;
-    const nextCursor = hasMore ? encodeHistoryCursor({ toDate, rawOffset: offset - overshoot }) : void 0;
+    const pageData = matched.slice(0, limit).map((m) => m.entry);
+    const firstOvershoot = matched[limit];
+    const hasMore = !backendExhausted || firstOvershoot !== void 0;
+    const nextCursor = hasMore ? encodeHistoryCursor({
+      toDate,
+      rawOffset: firstOvershoot ? firstOvershoot.rawIdx : offset
+    }) : void 0;
     return {
       data: mapEntries(pageData, validChainId),
       hasMore,
@@ -896,6 +902,134 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
   return out;
 }
 
+// src/client.ts
+import {
+  createPublicClient,
+  createWalletClient,
+  custom
+} from "viem";
+import { base, arbitrum } from "viem/chains";
+
+// src/lib/transfer-auth.ts
+import { bytesToHex } from "viem";
+var ERC20_META_ABI = [
+  { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] },
+  { type: "function", name: "version", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] }
+];
+function buildTransferWithAuthorizationTypedData(input) {
+  return {
+    domain: { name: input.tokenName, version: input.tokenVersion, chainId: input.chainId, verifyingContract: input.token },
+    types: {
+      TransferWithAuthorization: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "validAfter", type: "uint256" },
+        { name: "validBefore", type: "uint256" },
+        { name: "nonce", type: "bytes32" }
+      ]
+    },
+    primaryType: "TransferWithAuthorization",
+    message: input.message
+  };
+}
+async function readTokenMeta(publicClient, token) {
+  const [tokenName, tokenVersion] = await Promise.all([
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "name" }),
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "version" }).catch(() => "2")
+  ]);
+  return { tokenName, tokenVersion };
+}
+function randomAuthNonce() {
+  const bytes = new Uint8Array(32);
+  globalThis.crypto.getRandomValues(bytes);
+  return bytesToHex(bytes);
+}
+
+// src/lib/sponsor-client.ts
+var ROUTING_API_BASE_URL3 = "https://owney-routing-api-243946518160.europe-west4.run.app";
+async function postSponsorTransferAuth(input) {
+  const base2 = input.baseUrl ?? ROUTING_API_BASE_URL3;
+  let res;
+  try {
+    res = await fetch(`${base2}/api/v1/sponsor/erc20-transfer-auth`, {
+      method: "POST",
+      headers: { "content-type": "application/json", "x-owney-api-key": input.apiKey },
+      body: JSON.stringify(input.body)
+    });
+  } catch (networkError) {
+    throw new OwneyError(
+      "SPONSOR_REQUEST_FAILED",
+      `Sponsor API network error: ${networkError instanceof Error ? networkError.message : String(networkError)}`,
+      { cause: String(networkError) }
+    );
+  }
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+  }
+  if (!res.ok || !parsed?.success || !parsed.data) {
+    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) }
+    );
+  }
+  return parsed.data;
+}
+
+// src/lib/sponsored-deposit.ts
+var AUTH_WINDOW_SECONDS = 15 * 60;
+function makeSponsoredDepositCallback(deps) {
+  const post = deps.httpPost ?? postSponsorTransferAuth;
+  return async (smartWallet, chainId, amount) => {
+    const cid = chainId;
+    const token = deps.tokenAddressByChain[cid];
+    if (!token) {
+      throw new OwneyError(
+        "CHAIN_UNSUPPORTED",
+        `No sponsored token configured for chain ${chainId}`
+      );
+    }
+    const pub = deps.getPublicClient(cid);
+    const wallet = deps.getWalletClient(cid);
+    const { tokenName, tokenVersion } = await readTokenMeta(pub, token);
+    const validAfter = 0n;
+    const validBefore = BigInt(Math.floor(Date.now() / 1e3) + AUTH_WINDOW_SECONDS);
+    const nonce = randomAuthNonce();
+    const typedData = buildTransferWithAuthorizationTypedData({
+      token,
+      chainId: cid,
+      tokenName,
+      tokenVersion,
+      message: { from: deps.ownerAddress, to: smartWallet, value: BigInt(amount), validAfter, validBefore, nonce }
+    });
+    const authSignature = await wallet.signTypedData(
+      { account: deps.ownerAddress, ...typedData }
+    );
+    const result = await post({
+      baseUrl: deps.baseUrl,
+      apiKey: deps.apiKey,
+      body: {
+        chainId: cid,
+        token,
+        from: deps.ownerAddress,
+        to: smartWallet,
+        value: amount,
+        validAfter: validAfter.toString(),
+        validBefore: validBefore.toString(),
+        nonce,
+        authSignature,
+        tokenName,
+        tokenVersion
+      }
+    });
+    return result.txHash;
+  };
+}
+
 // src/client.ts
 function encodeMultiAgentCursor(map) {
   return Buffer.from(JSON.stringify(map), "utf8").toString("base64");
@@ -917,6 +1051,11 @@ function decodeMultiAgentCursor(token) {
   }
   return parsed;
 }
+var SPONSORED_USDC_BY_CHAIN = {
+  8453: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+  42161: "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
+};
+var VIEM_CHAIN = { 8453: base, 42161: arbitrum };
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
@@ -929,6 +1068,7 @@ var OwneySDK = class {
   state = null;
   apiKey;
   zyfaiRpcUrls;
+  cachedSponsoredCallback = null;
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
@@ -952,6 +1092,7 @@ var OwneySDK = class {
       );
     }
     this.state = { provider, walletAddress, chainId: null };
+    this.cachedSponsoredCallback = null;
   }
   /**
    * Disconnect from all agents and clear connection state.
@@ -964,6 +1105,7 @@ var OwneySDK = class {
     this.activeAgents.clear();
     this.disabledAgents.clear();
     this.state = null;
+    this.cachedSponsoredCallback = null;
   }
   isAgentDisabled(agentId) {
     return this.disabledAgents.has(agentId);
@@ -997,6 +1139,46 @@ var OwneySDK = class {
     }
     return chainId;
   }
+  requireConnectedProvider() {
+    if (!this.state?.provider) {
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "connect(provider) must be called before deposit",
+        {}
+      );
+    }
+    return this.state.provider;
+  }
+  /**
+   * Lazily builds (and caches) the default EIP-3009 sponsored deposit callback
+   * used when the caller omits `depositCallback`. Wraps the connected EIP-1193
+   * provider with viem `custom(provider)` to read token meta and sign the
+   * `TransferWithAuthorization`, then POSTs to the sponsor API.
+   */
+  getDefaultSponsoredCallback() {
+    if (this.cachedSponsoredCallback)
+      return this.cachedSponsoredCallback;
+    const provider = this.requireConnectedProvider();
+    const owner = this.state.walletAddress;
+    this.cachedSponsoredCallback = makeSponsoredDepositCallback({
+      apiKey: this.apiKey,
+      ownerAddress: owner,
+      tokenAddressByChain: SPONSORED_USDC_BY_CHAIN,
+      // 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) => createPublicClient({
+        chain: VIEM_CHAIN[cid],
+        transport: custom(provider)
+      }),
+      getWalletClient: (cid) => createWalletClient({
+        account: owner,
+        chain: VIEM_CHAIN[cid],
+        transport: custom(provider)
+      })
+    });
+    return this.cachedSponsoredCallback;
+  }
   getAgent(agentId) {
     const agent = this.agents.get(agentId);
     if (!agent) {
@@ -1150,6 +1332,7 @@ var OwneySDK = class {
     }
     const state = this.requireState();
     const chainId = this.requireChainId();
+    const effectiveCallback = depositCallback ?? this.getDefaultSponsoredCallback();
     if (agentId) {
       if (this.isAgentDisabled(agentId)) {
         throw new OwneyError(
@@ -1164,7 +1347,7 @@ var OwneySDK = class {
       return withFailureReporting(
         this.apiKey,
         agent.id,
-        () => agent.deposit(state, chainId, amount, depositCallback)
+        () => agent.deposit(state, chainId, amount, effectiveCallback)
       );
     }
     const totalAmount = BigInt(amount);
@@ -1198,7 +1381,7 @@ var OwneySDK = class {
       agentResults[agent.id] = await withFailureReporting(
         this.apiKey,
         agent.id,
-        () => agent.deposit(state, chainId, agentAmount, depositCallback)
+        () => agent.deposit(state, chainId, agentAmount, effectiveCallback)
       );
     }
     return { agentResults };
@@ -1646,9 +1829,20 @@ var OwneySDK = class {
         hasMore = true;
       }
     }
-    merged.sort(
-      (a, b) => new Date(b.date).getTime() - new Date(a.date).getTime()
-    );
+    merged.sort((a, b) => {
+      const dateDiff = new Date(b.date).getTime() - new Date(a.date).getTime();
+      if (dateDiff !== 0)
+        return dateDiff;
+      if (a.agent !== b.agent)
+        return a.agent < b.agent ? -1 : 1;
+      const aTx = a.transactions?.[0]?.txHashes?.[0] ?? "";
+      const bTx = b.transactions?.[0]?.txHashes?.[0] ?? "";
+      if (aTx !== bTx)
+        return aTx < bTx ? -1 : 1;
+      if (a.action !== b.action)
+        return a.action < b.action ? -1 : 1;
+      return 0;
+    });
     return {
       data: merged,
       hasMore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.4.4",
+  "version": "0.5.0-beta.0",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -35,4 +35,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}