@owney/sdk 0.7.7-beta.2 → 0.7.7-beta.4

package/dist/index.d.cts

@@ -180,6 +180,21 @@ interface OwneyPosition {
      *  response later; undefined until then. */
     liquidity?: number;
 }
+/**
+ * Funds that have landed in the agent's wallet but are not yet deployed into a
+ * protocol. Sourced from Zyfai `staleBalances[].isPending`. Absent when nothing
+ * is pending, and for agents that do not report it (sail).
+ */
+interface OwneyPendingAllocation {
+    /** Deliberately loose (not OwneySupportedChainId) because Zyfai reports balances on unsupported chains. */
+    chainId: number;
+    /** Raw agent symbol, not normalized to OwneySupportedTokens; carries Zyfai's casing and "eth" alias for WETH. */
+    asset: string;
+    /** Decimal string, consistent with `OwneyToken.amount`. */
+    amount: string;
+    /** ISO timestamp from Zyfai's `updatedAt`, when the payload carries one. */
+    since?: string;
+}
 interface AgentBalance {
     smartWallet?: `0x${string}`;
     totalBalance: string;
@@ -191,6 +206,8 @@ interface AgentBalance {
      * them (zyfai). Omitted for agents that don't expose positions (sail).
      */
     positions?: OwneyPosition[];
+    /** Funds received but not yet deployed. Omitted when nothing is pending. */
+    pendingAllocations?: OwneyPendingAllocation[];
 }
 interface OwneyBalances {
     totalBalance: string;
@@ -392,7 +409,7 @@ declare class OwneySDK {
     private routingApiBaseUrl?;
     private referralSource?;
     private cachedSponsoredCallback;
-    private cachedPermit2Callbacks;
+    private cachedWethSponsoredCallback;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -428,21 +445,12 @@ declare class OwneySDK {
      */
     private getDefaultSponsoredCallback;
     /**
-     * Lazily builds (and caches) the Permit2 sponsored callback for one asset.
-     * Used for WETH always, and for USDC when the connected owner is a smart
-     * account — EIP-3009 verifies with ecrecover inside USDC and cannot accept a
-     * contract signature, while Permit2 supports ERC-1271.
+     * 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 getDefaultPermit2Callback;
-    /**
-     * True when the connected owner has bytecode — a deployed smart wallet, or an
-     * EOA carrying an EIP-7702 delegation (the Base app's "Upgrade your wallet").
-     * Such wallets sign via ERC-1271, which EIP-3009 cannot verify.
-     *
-     * Fails OPEN: an unreadable code check returns false so a working EOA deposit
-     * is never blocked by a flaky provider.
-     */
-    private ownerHasCode;
+    private getDefaultWethSponsoredCallback;
     private getAgent;
     private getActiveAgents;
     /**
@@ -492,16 +500,13 @@ declare class OwneySDK {
      * 1. Missing Permit2 allowance: when the app did not supply its own
      *    callback and the attempt fails with `PERMIT2_APPROVAL_REQUIRED` on a
      *    WETH deposit, this is the wallet's first gasless WETH deposit. We send
-     *    the one-time (user-paid) Permit2 approval via `approvePermit2()`, wait
-     *    for the new allowance to actually be readable via
-     *    `waitForPermit2Allowance()` (the wallet's own RPC can lag a freshly
-     *    mined tx), then retry the SAME sponsored attempt once. Bounded to one
-     *    approval attempt per call so a wallet/agent that keeps reporting the
-     *    allowance as missing can't loop forever. If `approvePermit2()` itself
-     *    throws (e.g. the user rejects the wallet prompt), that error
-     *    propagates as-is — the user said no to a transaction, so we must not
-     *    turn around and ask them to pay for a different one via the fallback
-     *    below.
+     *    the one-time (user-paid) Permit2 approval via `approvePermit2()` and
+     *    retry the SAME sponsored attempt once. Bounded to one approval attempt
+     *    per call so a wallet/agent that keeps reporting the allowance as
+     *    missing can't loop forever. If `approvePermit2()` itself throws (e.g.
+     *    the user rejects the wallet prompt), that error propagates as-is —
+     *    the user said no to a transaction, so we must not turn around and ask
+     *    them to pay for a different one via the fallback below.
      * 2. `shouldFallbackToUserPaid`: the SDK's own WETH sponsor path failed at
      *    the infrastructure layer in a provably safe-to-retry way, so we warn
      *    and retry once with `undefined`, falling through to a user-paid
@@ -513,18 +518,6 @@ declare class OwneySDK {
      * propagates unchanged. Scoped per agent invocation so one agent's failure
      * doesn't force a retry of sibling agents in a multi-agent split.
      */
-    /**
-     * Polls the owner's Permit2 allowance for `asset` until it covers `amount`
-     * or the attempt budget runs out. Called right after `approvePermit2()`
-     * resolves: the approval tx is mined, but the wallet's own RPC can still
-     * serve a stale (zero) allowance on the very next read (replica lag), which
-     * would otherwise make the immediate retry fail with the same
-     * PERMIT2_APPROVAL_REQUIRED error the user just approved past. Never
-     * throws — if the allowance still hasn't caught up after the budget, the
-     * caller's retry will surface the honest PERMIT2_APPROVAL_REQUIRED error
-     * rather than this helper inventing a different one.
-     */
-    private waitForPermit2Allowance;
     private depositWithFallback;
     private getMinDepositAmount;
     private splitDepositAmount;
@@ -602,16 +595,14 @@ declare class OwneySDK {
      */
     ensureAutoSelectProtocols(asset: "USDC" | "WETH", agentId?: AgentId): Promise<boolean>;
     /**
-     * One-time, user-paid approval of Permit2 on the given sponsored token for
-     * the active chain. Required once per wallet per chain per token before a
-     * gasless deposit of that asset over Permit2; afterwards deposit() is
-     * signature-only for it. This call itself is a real transaction the user
-     * pays gas for. Resolves only after the approval transaction is mined (1
-     * confirmation), so a subsequent deposit() will see the new allowance;
-     * throws if the transaction reverted.
+     * One-time, user-paid approval of Permit2 on the sponsored WETH token for
+     * the active chain. Required once per wallet per chain before gasless WETH
+     * deposits; afterwards deposit() is signature-only. Resolves only after the
+     * approval transaction is mined (1 confirmation), so a subsequent deposit()
+     * will see the new allowance; throws if the transaction reverted.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: "WETH" | "USDC"): Promise<`0x${string}`>;
+    approvePermit2(asset?: "WETH"): Promise<`0x${string}`>;
     /**
      * Get the agent's average APY performance over a time period. Does not require a wallet connection.
      * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")

package/dist/index.d.ts

@@ -180,6 +180,21 @@ interface OwneyPosition {
      *  response later; undefined until then. */
     liquidity?: number;
 }
+/**
+ * Funds that have landed in the agent's wallet but are not yet deployed into a
+ * protocol. Sourced from Zyfai `staleBalances[].isPending`. Absent when nothing
+ * is pending, and for agents that do not report it (sail).
+ */
+interface OwneyPendingAllocation {
+    /** Deliberately loose (not OwneySupportedChainId) because Zyfai reports balances on unsupported chains. */
+    chainId: number;
+    /** Raw agent symbol, not normalized to OwneySupportedTokens; carries Zyfai's casing and "eth" alias for WETH. */
+    asset: string;
+    /** Decimal string, consistent with `OwneyToken.amount`. */
+    amount: string;
+    /** ISO timestamp from Zyfai's `updatedAt`, when the payload carries one. */
+    since?: string;
+}
 interface AgentBalance {
     smartWallet?: `0x${string}`;
     totalBalance: string;
@@ -191,6 +206,8 @@ interface AgentBalance {
      * them (zyfai). Omitted for agents that don't expose positions (sail).
      */
     positions?: OwneyPosition[];
+    /** Funds received but not yet deployed. Omitted when nothing is pending. */
+    pendingAllocations?: OwneyPendingAllocation[];
 }
 interface OwneyBalances {
     totalBalance: string;
@@ -392,7 +409,7 @@ declare class OwneySDK {
     private routingApiBaseUrl?;
     private referralSource?;
     private cachedSponsoredCallback;
-    private cachedPermit2Callbacks;
+    private cachedWethSponsoredCallback;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -428,21 +445,12 @@ declare class OwneySDK {
      */
     private getDefaultSponsoredCallback;
     /**
-     * Lazily builds (and caches) the Permit2 sponsored callback for one asset.
-     * Used for WETH always, and for USDC when the connected owner is a smart
-     * account — EIP-3009 verifies with ecrecover inside USDC and cannot accept a
-     * contract signature, while Permit2 supports ERC-1271.
+     * 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 getDefaultPermit2Callback;
-    /**
-     * True when the connected owner has bytecode — a deployed smart wallet, or an
-     * EOA carrying an EIP-7702 delegation (the Base app's "Upgrade your wallet").
-     * Such wallets sign via ERC-1271, which EIP-3009 cannot verify.
-     *
-     * Fails OPEN: an unreadable code check returns false so a working EOA deposit
-     * is never blocked by a flaky provider.
-     */
-    private ownerHasCode;
+    private getDefaultWethSponsoredCallback;
     private getAgent;
     private getActiveAgents;
     /**
@@ -492,16 +500,13 @@ declare class OwneySDK {
      * 1. Missing Permit2 allowance: when the app did not supply its own
      *    callback and the attempt fails with `PERMIT2_APPROVAL_REQUIRED` on a
      *    WETH deposit, this is the wallet's first gasless WETH deposit. We send
-     *    the one-time (user-paid) Permit2 approval via `approvePermit2()`, wait
-     *    for the new allowance to actually be readable via
-     *    `waitForPermit2Allowance()` (the wallet's own RPC can lag a freshly
-     *    mined tx), then retry the SAME sponsored attempt once. Bounded to one
-     *    approval attempt per call so a wallet/agent that keeps reporting the
-     *    allowance as missing can't loop forever. If `approvePermit2()` itself
-     *    throws (e.g. the user rejects the wallet prompt), that error
-     *    propagates as-is — the user said no to a transaction, so we must not
-     *    turn around and ask them to pay for a different one via the fallback
-     *    below.
+     *    the one-time (user-paid) Permit2 approval via `approvePermit2()` and
+     *    retry the SAME sponsored attempt once. Bounded to one approval attempt
+     *    per call so a wallet/agent that keeps reporting the allowance as
+     *    missing can't loop forever. If `approvePermit2()` itself throws (e.g.
+     *    the user rejects the wallet prompt), that error propagates as-is —
+     *    the user said no to a transaction, so we must not turn around and ask
+     *    them to pay for a different one via the fallback below.
      * 2. `shouldFallbackToUserPaid`: the SDK's own WETH sponsor path failed at
      *    the infrastructure layer in a provably safe-to-retry way, so we warn
      *    and retry once with `undefined`, falling through to a user-paid
@@ -513,18 +518,6 @@ declare class OwneySDK {
      * propagates unchanged. Scoped per agent invocation so one agent's failure
      * doesn't force a retry of sibling agents in a multi-agent split.
      */
-    /**
-     * Polls the owner's Permit2 allowance for `asset` until it covers `amount`
-     * or the attempt budget runs out. Called right after `approvePermit2()`
-     * resolves: the approval tx is mined, but the wallet's own RPC can still
-     * serve a stale (zero) allowance on the very next read (replica lag), which
-     * would otherwise make the immediate retry fail with the same
-     * PERMIT2_APPROVAL_REQUIRED error the user just approved past. Never
-     * throws — if the allowance still hasn't caught up after the budget, the
-     * caller's retry will surface the honest PERMIT2_APPROVAL_REQUIRED error
-     * rather than this helper inventing a different one.
-     */
-    private waitForPermit2Allowance;
     private depositWithFallback;
     private getMinDepositAmount;
     private splitDepositAmount;
@@ -602,16 +595,14 @@ declare class OwneySDK {
      */
     ensureAutoSelectProtocols(asset: "USDC" | "WETH", agentId?: AgentId): Promise<boolean>;
     /**
-     * One-time, user-paid approval of Permit2 on the given sponsored token for
-     * the active chain. Required once per wallet per chain per token before a
-     * gasless deposit of that asset over Permit2; afterwards deposit() is
-     * signature-only for it. This call itself is a real transaction the user
-     * pays gas for. Resolves only after the approval transaction is mined (1
-     * confirmation), so a subsequent deposit() will see the new allowance;
-     * throws if the transaction reverted.
+     * One-time, user-paid approval of Permit2 on the sponsored WETH token for
+     * the active chain. Required once per wallet per chain before gasless WETH
+     * deposits; afterwards deposit() is signature-only. Resolves only after the
+     * approval transaction is mined (1 confirmation), so a subsequent deposit()
+     * will see the new allowance; throws if the transaction reverted.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: "WETH" | "USDC"): Promise<`0x${string}`>;
+    approvePermit2(asset?: "WETH"): Promise<`0x${string}`>;
     /**
      * Get the agent's average APY performance over a time period. Does not require a wallet connection.
      * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")