@owney/sdk 0.7.21-beta.3 → 0.7.21-beta.5

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;
@@ -601,10 +591,9 @@ declare class OwneySDK {
      * Serializing costs no real wall-clock: the user can only approve one prompt
      * at a time anyway.
      *
-     * Every agent is attempted even if an earlier one fails, so one declined
-     * signature can't deny the remaining agents their turn. Once all agents have
-     * had a chance, a partial failure identifies the agents that still need a
-     * retry; if none activated, the original provider error is preserved.
+     * Stop at the first failure so a canceled sign-in does not open another
+     * agent's wallet prompt. Report any earlier successes for diagnostics; the
+     * app discards the session when the complete sign-in does not succeed.
      */
     private activateAgentsInTurn;
     /**
@@ -615,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
@@ -627,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
@@ -729,14 +719,14 @@ 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
+     * One-time, user-paid approval of Permit2 on the selected token for
+     * the active chain. Required once per wallet, token and chain before sponsored
      * 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"): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens): 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

@@ -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;
@@ -601,10 +591,9 @@ declare class OwneySDK {
      * Serializing costs no real wall-clock: the user can only approve one prompt
      * at a time anyway.
      *
-     * Every agent is attempted even if an earlier one fails, so one declined
-     * signature can't deny the remaining agents their turn. Once all agents have
-     * had a chance, a partial failure identifies the agents that still need a
-     * retry; if none activated, the original provider error is preserved.
+     * Stop at the first failure so a canceled sign-in does not open another
+     * agent's wallet prompt. Report any earlier successes for diagnostics; the
+     * app discards the session when the complete sign-in does not succeed.
      */
     private activateAgentsInTurn;
     /**
@@ -615,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
@@ -627,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
@@ -729,14 +719,14 @@ 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
+     * One-time, user-paid approval of Permit2 on the selected token for
+     * the active chain. Required once per wallet, token and chain before sponsored
      * 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"): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens): 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")