@owney/sdk 0.7.21-beta.4 → 0.7.21-beta.6

package/dist/index.d.cts

@@ -532,25 +532,15 @@ declare class OwneySDK {
     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.
-     */
+    /** Builds the default USDC batch callback for the connected wallet. */
     private getDefaultSponsoredCallback;
-    /**
-     * 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.
-     */
+    /** Builds the wallet-native sponsored calls callback for compatible paymasters. */
     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.
+     * single-use batch authorization instead of an EIP-3009 authorization.
      */
     private getDefaultWethSponsoredCallback;
     private getAgent;
@@ -614,7 +604,8 @@ declare class OwneySDK {
      * @param options.asset - Asset symbol to deposit (e.g. "USDC")
      * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
      *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
-     *   split amount and smart wallet address — expect multiple wallet prompts.
+     *   split amount and smart wallet address. Default sponsored deposits batch
+     *   all shares into one signature; custom callbacks still run once per agent.
      * @param options.agentId - Optional explicit target. Otherwise split equally,
      *   or fund remaining agents when a recovery deposit cannot meet every minimum.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
@@ -626,7 +617,7 @@ 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
+     *    token deposit, this is the wallet's first Permit2 deposit for that token. We send
      *    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
@@ -728,14 +719,15 @@ declare class OwneySDK {
      */
     ensureAutoSelectProtocols(asset: "USDC" | "WETH", agentId?: AgentId): Promise<boolean>;
     /**
-     * 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.
+     * User-paid approval of Permit2 on the selected token for the active chain.
+     * Approves exactly the pending deposit amount. Another approval is required
+     * for a later deposit once this allowance has been consumed. Resolves after
+     * one confirmation so the subsequent deposit attempt sees the new allowance.
+     *
+     * @param requiredAmount Raw base-unit amount the pending deposit must cover.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: "WETH"): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint): 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")
@@ -806,6 +798,8 @@ declare class YieldseekerAgent implements IAgent {
     private readonly agentContexts;
     private readonly users;
     private readonly pendingAgents;
+    private readonly yieldOptions;
+    private readonly pendingYieldOptions;
     constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
     disconnect(): Promise<void>;
     activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
@@ -817,6 +811,7 @@ declare class YieldseekerAgent implements IAgent {
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
+    private loadYieldOptions;
     private userKey;
     private contextKey;
     private resolveUser;
@@ -826,7 +821,7 @@ declare class YieldseekerAgent implements IAgent {
     private resolveAgent;
     private loadPortfolio;
     private loadPortfolioContext;
-    private deployAfterFunding;
+    private deployAgent;
     private refreshSnapshotAfterMovement;
     private agentPath;
     private walletRequest;

package/dist/index.d.ts

@@ -532,25 +532,15 @@ declare class OwneySDK {
     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.
-     */
+    /** Builds the default USDC batch callback for the connected wallet. */
     private getDefaultSponsoredCallback;
-    /**
-     * 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.
-     */
+    /** Builds the wallet-native sponsored calls callback for compatible paymasters. */
     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.
+     * single-use batch authorization instead of an EIP-3009 authorization.
      */
     private getDefaultWethSponsoredCallback;
     private getAgent;
@@ -614,7 +604,8 @@ declare class OwneySDK {
      * @param options.asset - Asset symbol to deposit (e.g. "USDC")
      * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
      *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
-     *   split amount and smart wallet address — expect multiple wallet prompts.
+     *   split amount and smart wallet address. Default sponsored deposits batch
+     *   all shares into one signature; custom callbacks still run once per agent.
      * @param options.agentId - Optional explicit target. Otherwise split equally,
      *   or fund remaining agents when a recovery deposit cannot meet every minimum.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
@@ -626,7 +617,7 @@ 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
+     *    token deposit, this is the wallet's first Permit2 deposit for that token. We send
      *    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
@@ -728,14 +719,15 @@ declare class OwneySDK {
      */
     ensureAutoSelectProtocols(asset: "USDC" | "WETH", agentId?: AgentId): Promise<boolean>;
     /**
-     * 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.
+     * User-paid approval of Permit2 on the selected token for the active chain.
+     * Approves exactly the pending deposit amount. Another approval is required
+     * for a later deposit once this allowance has been consumed. Resolves after
+     * one confirmation so the subsequent deposit attempt sees the new allowance.
+     *
+     * @param requiredAmount Raw base-unit amount the pending deposit must cover.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: "WETH"): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint): 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")
@@ -806,6 +798,8 @@ declare class YieldseekerAgent implements IAgent {
     private readonly agentContexts;
     private readonly users;
     private readonly pendingAgents;
+    private readonly yieldOptions;
+    private readonly pendingYieldOptions;
     constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
     disconnect(): Promise<void>;
     activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
@@ -817,6 +811,7 @@ declare class YieldseekerAgent implements IAgent {
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
+    private loadYieldOptions;
     private userKey;
     private contextKey;
     private resolveUser;
@@ -826,7 +821,7 @@ declare class YieldseekerAgent implements IAgent {
     private resolveAgent;
     private loadPortfolio;
     private loadPortfolioContext;
-    private deployAfterFunding;
+    private deployAgent;
     private refreshSnapshotAfterMovement;
     private agentPath;
     private walletRequest;