@owney/sdk 0.7.7-beta.5 → 0.7.7

package/dist/index.cjs

@@ -217,6 +217,32 @@ function resolveChainId(chain) {
   if (Number.isFinite(asNum) && asNum > 0) return asNum;
   return NAME_TO_CHAIN_ID[chain.trim().toLowerCase()] ?? NaN;
 }
+function mapPendingAllocations(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const pending = [];
+  for (const entry of raw) {
+    if (typeof entry !== "object" || entry === null) continue;
+    const e = entry;
+    if (typeof e.chainId !== "number" || !Number.isFinite(e.chainId)) continue;
+    if (typeof e.tokenSymbol !== "string" || e.tokenSymbol === "") continue;
+    if (typeof e.balance !== "string") continue;
+    let amount;
+    try {
+      amount = hexToDecimal(e.balance, tokenDecimals(e.tokenSymbol));
+    } catch {
+      continue;
+    }
+    if (!Number.isFinite(amount) || amount <= 0) continue;
+    pending.push({
+      chainId: e.chainId,
+      asset: e.tokenSymbol,
+      amount: String(amount),
+      isPending: e.isPending === true,
+      ...typeof e.updatedAt === "string" && e.updatedAt !== "" ? { since: e.updatedAt } : {}
+    });
+  }
+  return pending.length > 0 ? pending : void 0;
+}
 function mapBalances(raw, _chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const portfolioByChain = portfolio.portfolioByChain ?? {};
@@ -268,12 +294,16 @@ function mapBalances(raw, _chainId, smartWallet) {
     // structural read keeps it undefined today and auto-populates later.
     liquidity: p.liquidity
   }));
+  const pendingAllocations = mapPendingAllocations(
+    portfolio.staleBalances
+  );
   return {
     smartWallet,
     totalBalance: String(totalBalance),
     totalBalanceAsset: "usdc",
     tokens,
-    positions
+    positions,
+    ...pendingAllocations ? { pendingAllocations } : {}
   };
 }
 function sumTokenValues(tokens) {
@@ -879,6 +909,12 @@ var ZyfaiAgent = class {
   connectedAddress = null;
   connectedChainId = null;
   smartWalletCache = /* @__PURE__ */ new Map();
+  /**
+   * `${eoa}:${chainId}` keys we have already tried createSessionKey for. Guards
+   * against re-running it on every activation/deposit when Zyfai's
+   * `hasActiveSessionKey` does not flip to true — see ensureSessionKey.
+   */
+  sessionKeyAttempts = /* @__PURE__ */ new Set();
   connectAuthPromise = null;
   rpcUrls;
   publicClients = /* @__PURE__ */ new Map();
@@ -1336,10 +1372,74 @@ var ZyfaiAgent = class {
    * recoverable (ensureWalletDeployed tries the other deploy call), but
    * failing the deposit outright is not.
    */
+  /**
+   * Zyfai's own answer to "what kind of wallet is this, and can the agent act on
+   * it", read from the positions payload (`GET /data/position`, which
+   * `getPositions` wraps).
+   *
+   * `predeployed` and `hasActiveSessionKey` are both returned at runtime but
+   * declared on neither `Portfolio` nor their docs, hence the cast. Verified
+   * live: an old wallet reports `{predeployed: false, hasActiveSessionKey:
+   * false}` while a pool wallet reports `{true, true}`.
+   *
+   * Preferred over the SDK's private `isPredeployed`, which is cached from the
+   * login response and can go stale mid-session. Returns an empty object on any
+   * failure so every caller degrades to its own fallback.
+   */
+  async readWalletState(ownerAddress) {
+    try {
+      const { portfolio } = await this.sdk.getPositions(ownerAddress);
+      const raw = portfolio;
+      debugLog("zyfai:onboard", "wallet state from getPositions", {
+        predeployed: raw?.predeployed,
+        hasActiveSessionKey: raw?.hasActiveSessionKey
+      });
+      return {
+        predeployed: raw?.predeployed,
+        hasActiveSessionKey: raw?.hasActiveSessionKey
+      };
+    } catch (error) {
+      console.warn(
+        "[zyfai] getPositions wallet-state read failed (non-fatal):",
+        error instanceof Error ? error.message : String(error)
+      );
+      return {};
+    }
+  }
   async isPredeployedPoolWallet(ownerAddress, smartWallet) {
+    const { predeployed } = await this.readWalletState(ownerAddress);
+    if (typeof predeployed === "boolean") {
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${predeployed ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        { source: "getPositions.predeployed", predeployed }
+      );
+      return predeployed;
+    }
+    const internals = this.sdk;
+    if (typeof internals.isPredeployed === "boolean") {
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${internals.isPredeployed ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        {
+          source: "login response (cached)",
+          predeployed: internals.isPredeployed
+        }
+      );
+      return internals.isPredeployed;
+    }
     try {
       const byEoa = await this.sdk.getSmartWalletByEOA(ownerAddress);
-      return typeof byEoa?.smartWallet === "string" && byEoa.smartWallet.toLowerCase() === smartWallet.toLowerCase();
+      const isPool = typeof byEoa?.smartWallet === "string" && byEoa.smartWallet.toLowerCase() === smartWallet.toLowerCase();
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${isPool ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        {
+          source: "getSmartWalletByEOA fallback",
+          poolRecord: byEoa?.smartWallet
+        }
+      );
+      return isPool;
     } catch (error) {
       console.warn(
         "[zyfai] getSmartWalletByEOA failed; assuming a legacy wallet:",
@@ -1377,8 +1477,24 @@ var ZyfaiAgent = class {
         ownerAddress,
         chainId
       );
-      if (!wallet.isDeployed) return;
-      await this.ensureSessionKey(ownerAddress, chainId, wallet.address);
+      debugLog("zyfai:onboard", `activation check on chain ${chainId}`, {
+        smartWallet: wallet.address,
+        isDeployed: wallet.isDeployed
+      });
+      if (!wallet.isDeployed) {
+        debugLog(
+          "zyfai:onboard",
+          "Safe not deployed on this chain; activation does nothing (deposit owns deploys)"
+        );
+        return;
+      }
+      const { hasActiveSessionKey } = await this.readWalletState(ownerAddress);
+      await this.ensureSessionKey(
+        ownerAddress,
+        chainId,
+        wallet.address,
+        hasActiveSessionKey
+      );
     } catch (error) {
       console.warn(
         "[zyfai] session-key check at activation failed (non-fatal):",
@@ -1386,20 +1502,51 @@ var ZyfaiAgent = class {
       );
     }
   }
-  async ensureSessionKey(ownerAddress, chainId, smartWallet) {
+  async ensureSessionKey(ownerAddress, chainId, smartWallet, hasActiveSessionKey) {
+    const attemptKey = `${ownerAddress.toLowerCase()}:${chainId}`;
+    if (this.sessionKeyAttempts.has(attemptKey)) {
+      debugLog(
+        "zyfai:onboard",
+        "session key: already attempted this session, skipping",
+        { chainId }
+      );
+      return;
+    }
     try {
-      const installed = await this.getPublicClient(chainId).readContract({
-        address: smartWallet,
-        abi: ERC7579_IS_MODULE_INSTALLED_ABI,
-        functionName: "isModuleInstalled",
-        // moduleTypeId 1 = validator (ERC-7579)
-        args: [1n, import_sdk.SMART_SESSIONS_VALIDATOR, "0x"]
-      });
-      if (installed) return;
+      if (hasActiveSessionKey === true) {
+        debugLog(
+          "zyfai:onboard",
+          "session key: already on record -> nothing to do",
+          { chainId }
+        );
+        return;
+      }
+      if (hasActiveSessionKey === void 0) {
+        const installed = await this.readSmartSessionsInstalled(
+          chainId,
+          smartWallet
+        );
+        debugLog(
+          "zyfai:onboard",
+          `session key: Zyfai state unavailable; on-chain validator ${installed ? "INSTALLED" : "MISSING"}`,
+          { smartWallet, chainId }
+        );
+        if (installed) return;
+      }
+      this.sessionKeyAttempts.add(attemptKey);
       console.warn(
-        `[zyfai] Safe ${smartWallet} has no smart-sessions validator on chain ${chainId}; creating a session key so the agent can allocate.`
+        `[zyfai] no session key for ${smartWallet} on chain ${chainId}; creating one so the agent can allocate.`
       );
+      debugLog("zyfai:onboard", "session key: calling createSessionKey", {
+        chainId,
+        smartWallet,
+        hasActiveSessionKey
+      });
       await this.sdk.createSessionKey(ownerAddress, chainId);
+      debugLog("zyfai:onboard", "session key: createSessionKey succeeded", {
+        chainId,
+        smartWallet
+      });
     } catch (error) {
       console.warn(
         "[zyfai] createSessionKey skipped (non-fatal):",
@@ -1407,6 +1554,16 @@ var ZyfaiAgent = class {
       );
     }
   }
+  /** Ground truth for "can Zyfai's automation act on this Safe, on this chain". */
+  async readSmartSessionsInstalled(chainId, smartWallet) {
+    return this.getPublicClient(chainId).readContract({
+      address: smartWallet,
+      abi: ERC7579_IS_MODULE_INSTALLED_ABI,
+      functionName: "isModuleInstalled",
+      // moduleTypeId 1 = validator (ERC-7579)
+      args: [1n, import_sdk.SMART_SESSIONS_VALIDATOR, "0x"]
+    });
+  }
   /**
    * Guarantee the user's Safe has code on `chainId` before anything transfers
    * funds into it, and return its address.
@@ -1427,8 +1584,24 @@ var ZyfaiAgent = class {
    */
   async ensureWalletDeployed(ownerAddress, chainId) {
     const wallet = await this.sdk.getSmartWalletAddress(ownerAddress, chainId);
+    debugLog("zyfai:onboard", `--- deposit onboarding, chain ${chainId} ---`, {
+      eoa: ownerAddress,
+      smartWallet: wallet.address,
+      isDeployed: wallet.isDeployed,
+      isOwner: wallet.isOwner
+    });
     if (wallet.isDeployed) {
-      await this.ensureSessionKey(ownerAddress, chainId, wallet.address);
+      debugLog(
+        "zyfai:onboard",
+        "Safe already has code -> no deploy needed, checking the session key"
+      );
+      const { hasActiveSessionKey } = await this.readWalletState(ownerAddress);
+      await this.ensureSessionKey(
+        ownerAddress,
+        chainId,
+        wallet.address,
+        hasActiveSessionKey
+      );
       return wallet.address;
     }
     const poolFirst = await this.isPredeployedPoolWallet(
@@ -1444,14 +1617,27 @@ var ZyfaiAgent = class {
       this.sdk.deploySafe(ownerAddress, chainId, "aggressive", true)
     );
     const [first, second] = poolFirst ? [deployAsPool, deployAsLegacy] : [deployAsLegacy, deployAsPool];
+    debugLog(
+      "zyfai:onboard",
+      `Safe has no code on chain ${chainId} -> deploying via ${poolFirst ? "deployOnChains (pool path)" : "deploySafe(createSessionKey=true) (legacy path)"}`
+    );
     try {
       await first();
+      debugLog(
+        "zyfai:onboard",
+        `${poolFirst ? "deployOnChains" : "deploySafe"} succeeded`
+      );
     } catch (error) {
       console.warn(
         `[zyfai] ${poolFirst ? "deployOnChains" : "deploySafe"} failed on chain ${chainId}; trying the other deploy path:`,
         error instanceof Error ? error.message : String(error)
       );
+      debugLog(
+        "zyfai:onboard",
+        `falling back to ${poolFirst ? "deploySafe (legacy path)" : "deployOnChains (pool path)"}`
+      );
       await second();
+      debugLog("zyfai:onboard", "fallback deploy path succeeded");
     }
     const redeployed = await this.sdk.getSmartWalletAddress(
       ownerAddress,

package/dist/index.d.cts

@@ -191,6 +191,29 @@ 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;
+    /**
+     * Zyfai's own `isPending` flag. TRUE means it is actively allocating. FALSE
+     * does NOT mean the entry is stale or safe to ignore: Zyfai flips it within
+     * minutes but leaves funds listed here indefinitely when it has not indexed
+     * the pool they landed in. Entries are surfaced regardless of this flag; use
+     * it only to decide wording, never to decide whether the money counts.
+     */
+    isPending: boolean;
+    /** ISO timestamp from Zyfai's `updatedAt`, when the payload carries one. */
+    since?: string;
+}
 interface AgentBalance {
     smartWallet?: `0x${string}`;
     totalBalance: string;
@@ -202,6 +225,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;

package/dist/index.d.ts

@@ -191,6 +191,29 @@ 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;
+    /**
+     * Zyfai's own `isPending` flag. TRUE means it is actively allocating. FALSE
+     * does NOT mean the entry is stale or safe to ignore: Zyfai flips it within
+     * minutes but leaves funds listed here indefinitely when it has not indexed
+     * the pool they landed in. Entries are surfaced regardless of this flag; use
+     * it only to decide wording, never to decide whether the money counts.
+     */
+    isPending: boolean;
+    /** ISO timestamp from Zyfai's `updatedAt`, when the payload carries one. */
+    since?: string;
+}
 interface AgentBalance {
     smartWallet?: `0x${string}`;
     totalBalance: string;
@@ -202,6 +225,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;

package/dist/index.js

@@ -184,6 +184,32 @@ function resolveChainId(chain) {
   if (Number.isFinite(asNum) && asNum > 0) return asNum;
   return NAME_TO_CHAIN_ID[chain.trim().toLowerCase()] ?? NaN;
 }
+function mapPendingAllocations(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const pending = [];
+  for (const entry of raw) {
+    if (typeof entry !== "object" || entry === null) continue;
+    const e = entry;
+    if (typeof e.chainId !== "number" || !Number.isFinite(e.chainId)) continue;
+    if (typeof e.tokenSymbol !== "string" || e.tokenSymbol === "") continue;
+    if (typeof e.balance !== "string") continue;
+    let amount;
+    try {
+      amount = hexToDecimal(e.balance, tokenDecimals(e.tokenSymbol));
+    } catch {
+      continue;
+    }
+    if (!Number.isFinite(amount) || amount <= 0) continue;
+    pending.push({
+      chainId: e.chainId,
+      asset: e.tokenSymbol,
+      amount: String(amount),
+      isPending: e.isPending === true,
+      ...typeof e.updatedAt === "string" && e.updatedAt !== "" ? { since: e.updatedAt } : {}
+    });
+  }
+  return pending.length > 0 ? pending : void 0;
+}
 function mapBalances(raw, _chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const portfolioByChain = portfolio.portfolioByChain ?? {};
@@ -235,12 +261,16 @@ function mapBalances(raw, _chainId, smartWallet) {
     // structural read keeps it undefined today and auto-populates later.
     liquidity: p.liquidity
   }));
+  const pendingAllocations = mapPendingAllocations(
+    portfolio.staleBalances
+  );
   return {
     smartWallet,
     totalBalance: String(totalBalance),
     totalBalanceAsset: "usdc",
     tokens,
-    positions
+    positions,
+    ...pendingAllocations ? { pendingAllocations } : {}
   };
 }
 function sumTokenValues(tokens) {
@@ -846,6 +876,12 @@ var ZyfaiAgent = class {
   connectedAddress = null;
   connectedChainId = null;
   smartWalletCache = /* @__PURE__ */ new Map();
+  /**
+   * `${eoa}:${chainId}` keys we have already tried createSessionKey for. Guards
+   * against re-running it on every activation/deposit when Zyfai's
+   * `hasActiveSessionKey` does not flip to true — see ensureSessionKey.
+   */
+  sessionKeyAttempts = /* @__PURE__ */ new Set();
   connectAuthPromise = null;
   rpcUrls;
   publicClients = /* @__PURE__ */ new Map();
@@ -1303,10 +1339,74 @@ var ZyfaiAgent = class {
    * recoverable (ensureWalletDeployed tries the other deploy call), but
    * failing the deposit outright is not.
    */
+  /**
+   * Zyfai's own answer to "what kind of wallet is this, and can the agent act on
+   * it", read from the positions payload (`GET /data/position`, which
+   * `getPositions` wraps).
+   *
+   * `predeployed` and `hasActiveSessionKey` are both returned at runtime but
+   * declared on neither `Portfolio` nor their docs, hence the cast. Verified
+   * live: an old wallet reports `{predeployed: false, hasActiveSessionKey:
+   * false}` while a pool wallet reports `{true, true}`.
+   *
+   * Preferred over the SDK's private `isPredeployed`, which is cached from the
+   * login response and can go stale mid-session. Returns an empty object on any
+   * failure so every caller degrades to its own fallback.
+   */
+  async readWalletState(ownerAddress) {
+    try {
+      const { portfolio } = await this.sdk.getPositions(ownerAddress);
+      const raw = portfolio;
+      debugLog("zyfai:onboard", "wallet state from getPositions", {
+        predeployed: raw?.predeployed,
+        hasActiveSessionKey: raw?.hasActiveSessionKey
+      });
+      return {
+        predeployed: raw?.predeployed,
+        hasActiveSessionKey: raw?.hasActiveSessionKey
+      };
+    } catch (error) {
+      console.warn(
+        "[zyfai] getPositions wallet-state read failed (non-fatal):",
+        error instanceof Error ? error.message : String(error)
+      );
+      return {};
+    }
+  }
   async isPredeployedPoolWallet(ownerAddress, smartWallet) {
+    const { predeployed } = await this.readWalletState(ownerAddress);
+    if (typeof predeployed === "boolean") {
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${predeployed ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        { source: "getPositions.predeployed", predeployed }
+      );
+      return predeployed;
+    }
+    const internals = this.sdk;
+    if (typeof internals.isPredeployed === "boolean") {
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${internals.isPredeployed ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        {
+          source: "login response (cached)",
+          predeployed: internals.isPredeployed
+        }
+      );
+      return internals.isPredeployed;
+    }
     try {
       const byEoa = await this.sdk.getSmartWalletByEOA(ownerAddress);
-      return typeof byEoa?.smartWallet === "string" && byEoa.smartWallet.toLowerCase() === smartWallet.toLowerCase();
+      const isPool = typeof byEoa?.smartWallet === "string" && byEoa.smartWallet.toLowerCase() === smartWallet.toLowerCase();
+      debugLog(
+        "zyfai:onboard",
+        `wallet class: ${isPool ? "PREDEPLOYED (new flow)" : "OLD (legacy flow)"}`,
+        {
+          source: "getSmartWalletByEOA fallback",
+          poolRecord: byEoa?.smartWallet
+        }
+      );
+      return isPool;
     } catch (error) {
       console.warn(
         "[zyfai] getSmartWalletByEOA failed; assuming a legacy wallet:",
@@ -1344,8 +1444,24 @@ var ZyfaiAgent = class {
         ownerAddress,
         chainId
       );
-      if (!wallet.isDeployed) return;
-      await this.ensureSessionKey(ownerAddress, chainId, wallet.address);
+      debugLog("zyfai:onboard", `activation check on chain ${chainId}`, {
+        smartWallet: wallet.address,
+        isDeployed: wallet.isDeployed
+      });
+      if (!wallet.isDeployed) {
+        debugLog(
+          "zyfai:onboard",
+          "Safe not deployed on this chain; activation does nothing (deposit owns deploys)"
+        );
+        return;
+      }
+      const { hasActiveSessionKey } = await this.readWalletState(ownerAddress);
+      await this.ensureSessionKey(
+        ownerAddress,
+        chainId,
+        wallet.address,
+        hasActiveSessionKey
+      );
     } catch (error) {
       console.warn(
         "[zyfai] session-key check at activation failed (non-fatal):",
@@ -1353,20 +1469,51 @@ var ZyfaiAgent = class {
       );
     }
   }
-  async ensureSessionKey(ownerAddress, chainId, smartWallet) {
+  async ensureSessionKey(ownerAddress, chainId, smartWallet, hasActiveSessionKey) {
+    const attemptKey = `${ownerAddress.toLowerCase()}:${chainId}`;
+    if (this.sessionKeyAttempts.has(attemptKey)) {
+      debugLog(
+        "zyfai:onboard",
+        "session key: already attempted this session, skipping",
+        { chainId }
+      );
+      return;
+    }
     try {
-      const installed = await this.getPublicClient(chainId).readContract({
-        address: smartWallet,
-        abi: ERC7579_IS_MODULE_INSTALLED_ABI,
-        functionName: "isModuleInstalled",
-        // moduleTypeId 1 = validator (ERC-7579)
-        args: [1n, SMART_SESSIONS_VALIDATOR, "0x"]
-      });
-      if (installed) return;
+      if (hasActiveSessionKey === true) {
+        debugLog(
+          "zyfai:onboard",
+          "session key: already on record -> nothing to do",
+          { chainId }
+        );
+        return;
+      }
+      if (hasActiveSessionKey === void 0) {
+        const installed = await this.readSmartSessionsInstalled(
+          chainId,
+          smartWallet
+        );
+        debugLog(
+          "zyfai:onboard",
+          `session key: Zyfai state unavailable; on-chain validator ${installed ? "INSTALLED" : "MISSING"}`,
+          { smartWallet, chainId }
+        );
+        if (installed) return;
+      }
+      this.sessionKeyAttempts.add(attemptKey);
       console.warn(
-        `[zyfai] Safe ${smartWallet} has no smart-sessions validator on chain ${chainId}; creating a session key so the agent can allocate.`
+        `[zyfai] no session key for ${smartWallet} on chain ${chainId}; creating one so the agent can allocate.`
       );
+      debugLog("zyfai:onboard", "session key: calling createSessionKey", {
+        chainId,
+        smartWallet,
+        hasActiveSessionKey
+      });
       await this.sdk.createSessionKey(ownerAddress, chainId);
+      debugLog("zyfai:onboard", "session key: createSessionKey succeeded", {
+        chainId,
+        smartWallet
+      });
     } catch (error) {
       console.warn(
         "[zyfai] createSessionKey skipped (non-fatal):",
@@ -1374,6 +1521,16 @@ var ZyfaiAgent = class {
       );
     }
   }
+  /** Ground truth for "can Zyfai's automation act on this Safe, on this chain". */
+  async readSmartSessionsInstalled(chainId, smartWallet) {
+    return this.getPublicClient(chainId).readContract({
+      address: smartWallet,
+      abi: ERC7579_IS_MODULE_INSTALLED_ABI,
+      functionName: "isModuleInstalled",
+      // moduleTypeId 1 = validator (ERC-7579)
+      args: [1n, SMART_SESSIONS_VALIDATOR, "0x"]
+    });
+  }
   /**
    * Guarantee the user's Safe has code on `chainId` before anything transfers
    * funds into it, and return its address.
@@ -1394,8 +1551,24 @@ var ZyfaiAgent = class {
    */
   async ensureWalletDeployed(ownerAddress, chainId) {
     const wallet = await this.sdk.getSmartWalletAddress(ownerAddress, chainId);
+    debugLog("zyfai:onboard", `--- deposit onboarding, chain ${chainId} ---`, {
+      eoa: ownerAddress,
+      smartWallet: wallet.address,
+      isDeployed: wallet.isDeployed,
+      isOwner: wallet.isOwner
+    });
     if (wallet.isDeployed) {
-      await this.ensureSessionKey(ownerAddress, chainId, wallet.address);
+      debugLog(
+        "zyfai:onboard",
+        "Safe already has code -> no deploy needed, checking the session key"
+      );
+      const { hasActiveSessionKey } = await this.readWalletState(ownerAddress);
+      await this.ensureSessionKey(
+        ownerAddress,
+        chainId,
+        wallet.address,
+        hasActiveSessionKey
+      );
       return wallet.address;
     }
     const poolFirst = await this.isPredeployedPoolWallet(
@@ -1411,14 +1584,27 @@ var ZyfaiAgent = class {
       this.sdk.deploySafe(ownerAddress, chainId, "aggressive", true)
     );
     const [first, second] = poolFirst ? [deployAsPool, deployAsLegacy] : [deployAsLegacy, deployAsPool];
+    debugLog(
+      "zyfai:onboard",
+      `Safe has no code on chain ${chainId} -> deploying via ${poolFirst ? "deployOnChains (pool path)" : "deploySafe(createSessionKey=true) (legacy path)"}`
+    );
     try {
       await first();
+      debugLog(
+        "zyfai:onboard",
+        `${poolFirst ? "deployOnChains" : "deploySafe"} succeeded`
+      );
     } catch (error) {
       console.warn(
         `[zyfai] ${poolFirst ? "deployOnChains" : "deploySafe"} failed on chain ${chainId}; trying the other deploy path:`,
         error instanceof Error ? error.message : String(error)
       );
+      debugLog(
+        "zyfai:onboard",
+        `falling back to ${poolFirst ? "deploySafe (legacy path)" : "deployOnChains (pool path)"}`
+      );
       await second();
+      debugLog("zyfai:onboard", "fallback deploy path succeeded");
     }
     const redeployed = await this.sdk.getSmartWalletAddress(
       ownerAddress,

package/package.json

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