@owney/sdk 0.2.7 → 0.2.8

package/README.md

@@ -603,13 +603,83 @@ type DepositCallback = (
 ) => Promise<`0x${string}`> | `0x${string}`;
 ```
 
-### Error Classes
+### Error Handling
 
-| Error | Thrown when |
-|-------|------------|
-| `NotConnectedError` | A wallet-dependent method is called before `connect()` |
-| `AgentNotFoundError` | An unknown agent ID is passed (e.g. a typo) |
-| `AgentChainIncompatibleError` | `activateAgent` is called with agents that don't support the given chain. Exposes `incompatibleAgents` and `connectedChainId` properties for programmatic handling. |
+All errors thrown by the SDK are instances of `OwneyError` (which extends `Error`), each carrying a stable `code` string and optional `details` object for programmatic handling.
+
+```typescript
+import { OwneyError } from "@owney/sdk";
+
+try {
+  await sdk.getBalances();
+} catch (error) {
+  if (error instanceof OwneyError) {
+    switch (error.code) {
+      case "NOT_CONNECTED":
+        // prompt user to connect wallet
+        break;
+      case "NO_ACTIVE_CHAIN":
+        // prompt user to activate an agent
+        break;
+      case "BALANCE_ALL_FAILED":
+        // all agents failed to return balances
+        break;
+      default:
+        console.error(`[${error.code}] ${error.message}`, error.details);
+    }
+  }
+}
+```
+
+```typescript
+type OwneyErrorCode =
+  // Connection & wallet
+  | "NOT_CONNECTED"           // Wallet-dependent method called before connect()
+  | "NO_ACTIVE_CHAIN"         // Method called before activateAgent()
+  | "WALLET_NO_ACCOUNTS"      // Provider returned no accounts during connect()
+  | "WALLET_ADDRESS_REQUIRED" // Wallet address missing during agent auth
+  // Agent resolution
+  | "AGENT_NOT_FOUND"          // Unknown agent ID passed
+  | "AGENT_CHAIN_INCOMPATIBLE" // Agent(s) don't support the given chain
+  | "AGENT_EMPTY_LIST"         // Empty agentId array passed to activateAgent()
+  // Chain
+  | "CHAIN_UNSUPPORTED"           // Chain ID not in supported list (8453, 42161)
+  | "CHAIN_NO_COMPATIBLE_AGENTS"  // No agents support the given chain
+  // Asset
+  | "ASSET_UNSUPPORTED"           // Agent doesn't support the asset on the active chain
+  | "ASSET_NO_COMPATIBLE_AGENTS"  // No agents support the asset on the active chain
+  // Deposit
+  | "DEPOSIT_AMOUNT_TOO_SMALL"    // Amount too small to split across agents
+  | "DEPOSIT_CALLBACK_REQUIRED"   // Sail agent requires a depositCallback
+  | "DEPOSIT_CALLBACK_INVALID"    // depositCallback didn't return a tx hash
+  | "DEPOSIT_NO_PERMITTED_TOKENS" // No permitted tokens available for deposit
+  // Withdraw
+  | "WITHDRAW_NO_PERMITTED_TOKENS" // No permitted tokens available for withdrawal
+  // API
+  | "API_ROUTING_ERROR"  // Routing API returned a non-OK HTTP status
+  | "API_ROUTING_FAILED" // Routing API returned { success: false }
+  | "API_SAIL_ERROR"     // Sail API returned a non-OK HTTP status
+  | "API_SAIL_TIMEOUT"   // Sail API request timed out
+  | "API_NO_AGENTS"      // No supported agents returned by routing API
+  // Aggregation
+  | "BALANCE_ALL_FAILED"     // All agents failed to return balances
+  | "ALLOCATION_ALL_FAILED"  // All agents failed to return allocation data
+  // Validation
+  | "VALIDATION_INVALID_DAYS"; // Invalid days value (expected "7D", "14D", or "30D")
+
+class OwneyError extends Error {
+  readonly code: OwneyErrorCode;
+  readonly details?: Record<string, unknown>;
+}
+```
+
+The three convenience subclasses extend `OwneyError` and remain backwards-compatible:
+
+| Class | Code | Extra properties |
+|-------|------|------------------|
+| `NotConnectedError` | `NOT_CONNECTED` | — |
+| `AgentNotFoundError` | `AGENT_NOT_FOUND` | — |
+| `AgentChainIncompatibleError` | `AGENT_CHAIN_INCOMPATIBLE` | `incompatibleAgents`, `connectedChainId` |
 
 ## License
 

package/dist/index.cjs

@@ -303,15 +303,6 @@ function mapApyByStrategy(raw) {
 }
 
 // src/agents/zyfai/zyfai.agent.ts
-var ZYFAI_TIMING_PREFIX = "[AgentTiming][zyfai]";
-function logTiming(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${ZYFAI_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${ZYFAI_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var ZyfaiAgent = class {
   id = "zyfai";
   supportedChainIds = [8453, 42161];
@@ -332,8 +323,8 @@ var ZyfaiAgent = class {
   connectedChainId = null;
   smartWalletCache = /* @__PURE__ */ new Map();
   connectAuthPromise = null;
-  constructor(apiKey) {
-    this.sdk = new import_sdk.ZyfaiSDK({ apiKey });
+  constructor(apiKey, rpcUrls) {
+    this.sdk = new import_sdk.ZyfaiSDK({ apiKey, rpcUrls });
   }
   // --- Private helpers ---
   getAddress() {
@@ -347,17 +338,12 @@ var ZyfaiAgent = class {
   }
   /** Light connect: SIWE auth only. Re-auths if chain changed. */
   async connectAuth(state, chainId) {
-    const startedAt = Date.now();
     const validChainId = isValidChainId(chainId);
     if (this.connectedAddress && this.connectedChainId === validChainId) {
-      logTiming("connectAuth cache-hit", startedAt, { chainId: validChainId });
       return;
     }
     if (this.connectAuthPromise) {
       await this.connectAuthPromise;
-      logTiming("connectAuth awaited-inflight", startedAt, {
-        chainId: validChainId
-      });
       return;
     }
     this.connectAuthPromise = (async () => {
@@ -370,69 +356,40 @@ var ZyfaiAgent = class {
     })();
     try {
       await this.connectAuthPromise;
-      logTiming("connectAuth success", startedAt, { chainId: validChainId });
     } finally {
       this.connectAuthPromise = null;
     }
   }
   /** Full connect: SIWE auth + Safe deploy check + session key. */
   async connectFull(state, chainId) {
-    const startedAt = Date.now();
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
     const address = this.getAddress();
-    const walletLookupStart = Date.now();
     const wallet = await this.sdk.getSmartWalletAddress(address, validChainId);
-    logTiming("connectFull getSmartWalletAddress", walletLookupStart, {
-      chainId: validChainId
-    });
     this.smartWalletCache.set(`${address}_${validChainId}`, wallet.address);
     if (!wallet.isDeployed) {
-      const deployStart = Date.now();
       await this.sdk.deploySafe(address, validChainId, "aggressive", true);
-      logTiming("connectFull deploySafe", deployStart, {
-        chainId: validChainId
-      });
     }
-    const userDetailsStart = Date.now();
     const user = await this.sdk.getUserDetails();
-    logTiming("connectFull getUserDetails", userDetailsStart, {
-      chainId: validChainId
-    });
     if (!user.hasActiveSessionKey) {
-      const sessionKeyStart = Date.now();
       await this.sdk.createSessionKey(address, validChainId);
-      logTiming("connectFull createSessionKey", sessionKeyStart, {
-        chainId: validChainId
-      });
     }
-    logTiming("connectFull success", startedAt, { chainId: validChainId });
   }
   /** Connect + resolve smart wallet address for read operations. */
   async resolveSmartWallet(state, chainId) {
-    const startedAt = Date.now();
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
     const ownerAddress = this.getAddress();
     const cacheKey = `${ownerAddress}_${validChainId}`;
     let smartWallet = this.smartWalletCache.get(cacheKey);
     if (!smartWallet) {
-      const lookupStart = Date.now();
       const { address } = await this.sdk.getSmartWalletAddress(
         ownerAddress,
         validChainId
       );
-      logTiming("resolveSmartWallet remote-lookup", lookupStart, {
-        chainId: validChainId
-      });
       smartWallet = address;
       this.smartWalletCache.set(cacheKey, smartWallet);
-    } else {
-      logTiming("resolveSmartWallet cache-hit", startedAt, {
-        chainId: validChainId
-      });
     }
-    logTiming("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return { smartWallet, chainId: validChainId };
   }
   // --- IAgent: Connection lifecycle ---
@@ -492,14 +449,8 @@ var ZyfaiAgent = class {
   }
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
-    const startedAt = Date.now();
     const { smartWallet, chainId: validChainId } = await this.resolveSmartWallet(state, chainId);
-    const portfolioStart = Date.now();
     const raw = await this.sdk.getPortfolio(this.getAddress());
-    logTiming("getBalances getPortfolio", portfolioStart, {
-      chainId: validChainId
-    });
-    logTiming("getBalances success", startedAt, { chainId: validChainId });
     return mapBalances(raw, validChainId, smartWallet);
   }
   async getEarnings(state, chainId) {
@@ -564,13 +515,13 @@ function mapWithdraw2(raw) {
 function mapPortfolioBalances(raw, smartWallet) {
   let total = 0;
   const tokens = [];
-  for (const item of raw.result) {
-    total += item.usd_value;
+  for (const item of raw.tokens) {
+    total += item.balanceFormatted;
     tokens.push({
-      chain: item.chain.toUpperCase(),
-      chainId: item.chain_id,
-      asset: item.token === "USD\u20AE0" ? "USDT" : item.token,
-      amount: String(item.usd_value)
+      chain: SUPPORTED_CHAINS[item.chain],
+      chainId: item.chain,
+      asset: item.symbol === "USD\u20AE0" ? "USDT" : item.symbol,
+      amount: item.balance
     });
   }
   return {
@@ -753,16 +704,7 @@ function remapApyPerAssetToSymbols(raw) {
 var SAIL_API_BASE = "https://app.sail.money";
 var PROJECT_ID = "sail";
 var PAGE_ID = "home";
-var SAIL_TIMING_PREFIX = "[AgentTiming][sail]";
 var SAIL_PORTFOLIO_TIMEOUT_MS = 8e3;
-function logTiming2(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${SAIL_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${SAIL_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var SailAgent = class {
   id = "sail";
   supportedChainIds = [8453, 42161];
@@ -835,7 +777,6 @@ var SailAgent = class {
   }
   /** Initiate SIWE and sign with the user's wallet. */
   async signSiwe(state, chainId) {
-    const startedAt = Date.now();
     const initiate = await this.request(
       "POST",
       `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/auth/initiate`,
@@ -850,7 +791,6 @@ var SailAgent = class {
       method: "personal_sign",
       params: [initiate.message, state.walletAddress]
     });
-    logTiming2("signSiwe success", startedAt, { chainId });
     return {
       sessionId: initiate.sessionId,
       message: initiate.message,
@@ -859,14 +799,11 @@ var SailAgent = class {
   }
   /** Full connect: auth handles smart account creation via SIWE flow. */
   async connectFull(state, chainId) {
-    const startedAt = Date.now();
     if (this.connectedAddress && this.connectedChainId === chainId) {
-      logTiming2("connectFull cache-hit", startedAt, { chainId });
       return;
     }
     if (this.connectPromise) {
       await this.connectPromise;
-      logTiming2("connectFull awaited-inflight", startedAt, { chainId });
       return;
     }
     if (!state.walletAddress) {
@@ -899,13 +836,11 @@ var SailAgent = class {
     })();
     try {
       await this.connectPromise;
-      logTiming2("connectFull success", startedAt, { chainId });
     } finally {
       this.connectPromise = null;
     }
   }
   async resolveSmartWallet(state, chainId) {
-    const startedAt = Date.now();
     await this.connectFull(state, chainId);
     const validChainId = isValidChainId(chainId);
     if (!this.smartWalletAddress) {
@@ -914,7 +849,6 @@ var SailAgent = class {
         "Wallet not connected. Call sdk.connect() first."
       );
     }
-    logTiming2("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return {
       smartWallet: this.smartWalletAddress,
       chainId: validChainId
@@ -1039,13 +973,9 @@ var SailAgent = class {
   }
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
-    const startedAt = Date.now();
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-    const portfolioStart = Date.now();
     try {
-      const raw = await this.getMetricsPortfolio(state, chainId);
-      logTiming2("getBalances getMetricsPortfolio", portfolioStart, { chainId });
-      logTiming2("getBalances success", startedAt, { chainId });
+      const raw = await this.getPortfolio();
       return mapPortfolioBalances(raw, smartWallet);
     } catch (error) {
       if (error instanceof OwneyError && error.code === "API_SAIL_TIMEOUT") {
@@ -1055,9 +985,8 @@ var SailAgent = class {
             chainId
           }
         );
-        logTiming2("getBalances timeout-fallback", startedAt, { chainId });
         return mapPortfolioBalances(
-          { message: "timeout", result: [] },
+          { message: "timeout", tokens: [] },
           smartWallet
         );
       }
@@ -1088,6 +1017,14 @@ var SailAgent = class {
       SAIL_PORTFOLIO_TIMEOUT_MS
     );
   }
+  async getPortfolio() {
+    return this.request(
+      "GET",
+      `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/portfolio/tokens`,
+      void 0,
+      SAIL_PORTFOLIO_TIMEOUT_MS
+    );
+  }
   async getMetricsEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     return this.request(
@@ -1095,7 +1032,7 @@ var SailAgent = class {
       `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/metrics/earnings?smart_account=${smartWallet}`
     );
   }
-  async getMetricsBalance(state, chainId, currency) {
+  async getMetricsBalance(state, chainId, currency = "usd") {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     return this.request(
       "GET",
@@ -1243,27 +1180,16 @@ async function fetchAgentKeys(apiKey) {
 }
 
 // src/client.ts
-var AGENT_CONSTRUCTORS = {
-  zyfai: ZyfaiAgent,
-  sail: SailAgent
-};
-var SDK_TIMING_PREFIX = "[OwneySDKTiming]";
-function logTiming3(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${SDK_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${SDK_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
   state = null;
   apiKey;
+  zyfaiRpcUrls;
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
+    this.zyfaiRpcUrls = config.zyfaiRpcUrls;
   }
   /**
    * Establish connection state for all subsequent SDK calls.
@@ -1347,10 +1273,9 @@ var OwneySDK = class {
       this.initializingAgentsPromise = (async () => {
         const agentKeys = await fetchAgentKeys(this.apiKey);
         for (const { key, agent_type } of agentKeys) {
-          const AgentClass = AGENT_CONSTRUCTORS[agent_type];
-          if (!AgentClass)
+          const agent = this.createAgent(agent_type, key);
+          if (!agent)
             continue;
-          const agent = new AgentClass(key);
           this.agents.set(agent_type, agent);
         }
         if (this.agents.size === 0) {
@@ -1367,6 +1292,15 @@ var OwneySDK = class {
       this.initializingAgentsPromise = null;
     }
   }
+  createAgent(agentId, key) {
+    if (agentId === "zyfai") {
+      return new ZyfaiAgent(key, this.zyfaiRpcUrls);
+    }
+    if (agentId === "sail") {
+      return new SailAgent(key);
+    }
+    return null;
+  }
   // --- Account lifecycle ---
   /**
    * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
@@ -1379,7 +1313,6 @@ var OwneySDK = class {
    *   throws before activating any agent.
    */
   async activateAgent(chainId, agentId) {
-    const startedAt = Date.now();
     const state = this.requireState();
     await this.ensureAgentsInitialized();
     if (agentId !== void 0) {
@@ -1407,20 +1340,11 @@ var OwneySDK = class {
       state.chainId = chainId;
       Promise.all(
         agents.map(async (agent) => {
-          const agentStart = Date.now();
           await agent.activateAgent(state, chainId);
-          logTiming3("activateAgent background-agent-ready", agentStart, {
-            chainId,
-            agentId: agent.id
-          });
         })
       ).catch((error) => {
         console.error("activateAgent background init failed:", error);
       });
-      logTiming3("activateAgent scheduled", startedAt, {
-        chainId,
-        agentIds: uniqueIds
-      });
       return;
     }
     const compatible = [...this.agents.values()].filter(
@@ -1440,20 +1364,11 @@ var OwneySDK = class {
     state.chainId = chainId;
     Promise.all(
       compatible.map(async (agent) => {
-        const agentStart = Date.now();
         await agent.activateAgent(state, chainId);
-        logTiming3("activateAgent background-agent-ready", agentStart, {
-          chainId,
-          agentId: agent.id
-        });
       })
     ).catch((error) => {
       console.error("activateAgent background init failed:", error);
     });
-    logTiming3("activateAgent scheduled", startedAt, {
-      chainId,
-      agentIds: compatible.map((agent) => agent.id)
-    });
   }
   /**
    * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
@@ -1578,12 +1493,10 @@ var OwneySDK = class {
    * @returns {AgentBalance} for a single agent, or {OwneyBalances} with totalBalance and per-agent breakdown
    */
   async getBalances(agentId) {
-    const startedAt = Date.now();
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
       const result = await this.getAgent(agentId).getBalances(state, chainId);
-      logTiming3("getBalances single-agent", startedAt, { chainId, agentId });
       return result;
     }
     let totalBalance = 0;
@@ -1591,12 +1504,7 @@ var OwneySDK = class {
     const entries = [...this.getActiveAgents().entries()];
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
-        const agentStartedAt = Date.now();
         const b = await agent.getBalances(state, chainId);
-        logTiming3("getBalances per-agent", agentStartedAt, {
-          chainId,
-          agentId: id
-        });
         return [id, b];
       })
     );
@@ -1617,11 +1525,6 @@ var OwneySDK = class {
         "Failed to fetch balances for all active agents."
       );
     }
-    logTiming3("getBalances aggregate", startedAt, {
-      chainId,
-      totalAgents: entries.length,
-      successCount
-    });
     return {
       totalBalance: String(totalBalance),
       agentBalances: results

package/dist/index.d.cts

@@ -1,5 +1,11 @@
+type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
 interface OwneySDKConfig {
     apiKey: string;
+    /**
+     * Optional per-chain RPC overrides for Zyfai SDK network calls.
+     * Example: { 8453: "https://...", 42161: "https://..." }
+     */
+    zyfaiRpcUrls?: ZyfaiRpcUrlsConfig;
 }
 interface ConnectionState {
     provider: any;
@@ -203,6 +209,7 @@ declare class OwneySDK {
     private activeAgents;
     private state;
     private apiKey;
+    private zyfaiRpcUrls?;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -231,6 +238,7 @@ declare class OwneySDK {
     private getAgent;
     private getActiveAgents;
     private ensureAgentsInitialized;
+    private createAgent;
     /**
      * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
      * Deploys the Safe contract and creates a session key if not already set up.

package/dist/index.d.ts

@@ -1,5 +1,11 @@
+type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
 interface OwneySDKConfig {
     apiKey: string;
+    /**
+     * Optional per-chain RPC overrides for Zyfai SDK network calls.
+     * Example: { 8453: "https://...", 42161: "https://..." }
+     */
+    zyfaiRpcUrls?: ZyfaiRpcUrlsConfig;
 }
 interface ConnectionState {
     provider: any;
@@ -203,6 +209,7 @@ declare class OwneySDK {
     private activeAgents;
     private state;
     private apiKey;
+    private zyfaiRpcUrls?;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
     /**
@@ -231,6 +238,7 @@ declare class OwneySDK {
     private getAgent;
     private getActiveAgents;
     private ensureAgentsInitialized;
+    private createAgent;
     /**
      * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
      * Deploys the Safe contract and creates a session key if not already set up.

package/dist/index.js

@@ -273,15 +273,6 @@ function mapApyByStrategy(raw) {
 }
 
 // src/agents/zyfai/zyfai.agent.ts
-var ZYFAI_TIMING_PREFIX = "[AgentTiming][zyfai]";
-function logTiming(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${ZYFAI_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${ZYFAI_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var ZyfaiAgent = class {
   id = "zyfai";
   supportedChainIds = [8453, 42161];
@@ -302,8 +293,8 @@ var ZyfaiAgent = class {
   connectedChainId = null;
   smartWalletCache = /* @__PURE__ */ new Map();
   connectAuthPromise = null;
-  constructor(apiKey) {
-    this.sdk = new ZyfaiSDK({ apiKey });
+  constructor(apiKey, rpcUrls) {
+    this.sdk = new ZyfaiSDK({ apiKey, rpcUrls });
   }
   // --- Private helpers ---
   getAddress() {
@@ -317,17 +308,12 @@ var ZyfaiAgent = class {
   }
   /** Light connect: SIWE auth only. Re-auths if chain changed. */
   async connectAuth(state, chainId) {
-    const startedAt = Date.now();
     const validChainId = isValidChainId(chainId);
     if (this.connectedAddress && this.connectedChainId === validChainId) {
-      logTiming("connectAuth cache-hit", startedAt, { chainId: validChainId });
       return;
     }
     if (this.connectAuthPromise) {
       await this.connectAuthPromise;
-      logTiming("connectAuth awaited-inflight", startedAt, {
-        chainId: validChainId
-      });
       return;
     }
     this.connectAuthPromise = (async () => {
@@ -340,69 +326,40 @@ var ZyfaiAgent = class {
     })();
     try {
       await this.connectAuthPromise;
-      logTiming("connectAuth success", startedAt, { chainId: validChainId });
     } finally {
       this.connectAuthPromise = null;
     }
   }
   /** Full connect: SIWE auth + Safe deploy check + session key. */
   async connectFull(state, chainId) {
-    const startedAt = Date.now();
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
     const address = this.getAddress();
-    const walletLookupStart = Date.now();
     const wallet = await this.sdk.getSmartWalletAddress(address, validChainId);
-    logTiming("connectFull getSmartWalletAddress", walletLookupStart, {
-      chainId: validChainId
-    });
     this.smartWalletCache.set(`${address}_${validChainId}`, wallet.address);
     if (!wallet.isDeployed) {
-      const deployStart = Date.now();
       await this.sdk.deploySafe(address, validChainId, "aggressive", true);
-      logTiming("connectFull deploySafe", deployStart, {
-        chainId: validChainId
-      });
     }
-    const userDetailsStart = Date.now();
     const user = await this.sdk.getUserDetails();
-    logTiming("connectFull getUserDetails", userDetailsStart, {
-      chainId: validChainId
-    });
     if (!user.hasActiveSessionKey) {
-      const sessionKeyStart = Date.now();
       await this.sdk.createSessionKey(address, validChainId);
-      logTiming("connectFull createSessionKey", sessionKeyStart, {
-        chainId: validChainId
-      });
     }
-    logTiming("connectFull success", startedAt, { chainId: validChainId });
   }
   /** Connect + resolve smart wallet address for read operations. */
   async resolveSmartWallet(state, chainId) {
-    const startedAt = Date.now();
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
     const ownerAddress = this.getAddress();
     const cacheKey = `${ownerAddress}_${validChainId}`;
     let smartWallet = this.smartWalletCache.get(cacheKey);
     if (!smartWallet) {
-      const lookupStart = Date.now();
       const { address } = await this.sdk.getSmartWalletAddress(
         ownerAddress,
         validChainId
       );
-      logTiming("resolveSmartWallet remote-lookup", lookupStart, {
-        chainId: validChainId
-      });
       smartWallet = address;
       this.smartWalletCache.set(cacheKey, smartWallet);
-    } else {
-      logTiming("resolveSmartWallet cache-hit", startedAt, {
-        chainId: validChainId
-      });
     }
-    logTiming("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return { smartWallet, chainId: validChainId };
   }
   // --- IAgent: Connection lifecycle ---
@@ -462,14 +419,8 @@ var ZyfaiAgent = class {
   }
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
-    const startedAt = Date.now();
     const { smartWallet, chainId: validChainId } = await this.resolveSmartWallet(state, chainId);
-    const portfolioStart = Date.now();
     const raw = await this.sdk.getPortfolio(this.getAddress());
-    logTiming("getBalances getPortfolio", portfolioStart, {
-      chainId: validChainId
-    });
-    logTiming("getBalances success", startedAt, { chainId: validChainId });
     return mapBalances(raw, validChainId, smartWallet);
   }
   async getEarnings(state, chainId) {
@@ -534,13 +485,13 @@ function mapWithdraw2(raw) {
 function mapPortfolioBalances(raw, smartWallet) {
   let total = 0;
   const tokens = [];
-  for (const item of raw.result) {
-    total += item.usd_value;
+  for (const item of raw.tokens) {
+    total += item.balanceFormatted;
     tokens.push({
-      chain: item.chain.toUpperCase(),
-      chainId: item.chain_id,
-      asset: item.token === "USD\u20AE0" ? "USDT" : item.token,
-      amount: String(item.usd_value)
+      chain: SUPPORTED_CHAINS[item.chain],
+      chainId: item.chain,
+      asset: item.symbol === "USD\u20AE0" ? "USDT" : item.symbol,
+      amount: item.balance
     });
   }
   return {
@@ -723,16 +674,7 @@ function remapApyPerAssetToSymbols(raw) {
 var SAIL_API_BASE = "https://app.sail.money";
 var PROJECT_ID = "sail";
 var PAGE_ID = "home";
-var SAIL_TIMING_PREFIX = "[AgentTiming][sail]";
 var SAIL_PORTFOLIO_TIMEOUT_MS = 8e3;
-function logTiming2(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${SAIL_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${SAIL_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var SailAgent = class {
   id = "sail";
   supportedChainIds = [8453, 42161];
@@ -805,7 +747,6 @@ var SailAgent = class {
   }
   /** Initiate SIWE and sign with the user's wallet. */
   async signSiwe(state, chainId) {
-    const startedAt = Date.now();
     const initiate = await this.request(
       "POST",
       `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/auth/initiate`,
@@ -820,7 +761,6 @@ var SailAgent = class {
       method: "personal_sign",
       params: [initiate.message, state.walletAddress]
     });
-    logTiming2("signSiwe success", startedAt, { chainId });
     return {
       sessionId: initiate.sessionId,
       message: initiate.message,
@@ -829,14 +769,11 @@ var SailAgent = class {
   }
   /** Full connect: auth handles smart account creation via SIWE flow. */
   async connectFull(state, chainId) {
-    const startedAt = Date.now();
     if (this.connectedAddress && this.connectedChainId === chainId) {
-      logTiming2("connectFull cache-hit", startedAt, { chainId });
       return;
     }
     if (this.connectPromise) {
       await this.connectPromise;
-      logTiming2("connectFull awaited-inflight", startedAt, { chainId });
       return;
     }
     if (!state.walletAddress) {
@@ -869,13 +806,11 @@ var SailAgent = class {
     })();
     try {
       await this.connectPromise;
-      logTiming2("connectFull success", startedAt, { chainId });
     } finally {
       this.connectPromise = null;
     }
   }
   async resolveSmartWallet(state, chainId) {
-    const startedAt = Date.now();
     await this.connectFull(state, chainId);
     const validChainId = isValidChainId(chainId);
     if (!this.smartWalletAddress) {
@@ -884,7 +819,6 @@ var SailAgent = class {
         "Wallet not connected. Call sdk.connect() first."
       );
     }
-    logTiming2("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return {
       smartWallet: this.smartWalletAddress,
       chainId: validChainId
@@ -1009,13 +943,9 @@ var SailAgent = class {
   }
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
-    const startedAt = Date.now();
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-    const portfolioStart = Date.now();
     try {
-      const raw = await this.getMetricsPortfolio(state, chainId);
-      logTiming2("getBalances getMetricsPortfolio", portfolioStart, { chainId });
-      logTiming2("getBalances success", startedAt, { chainId });
+      const raw = await this.getPortfolio();
       return mapPortfolioBalances(raw, smartWallet);
     } catch (error) {
       if (error instanceof OwneyError && error.code === "API_SAIL_TIMEOUT") {
@@ -1025,9 +955,8 @@ var SailAgent = class {
             chainId
           }
         );
-        logTiming2("getBalances timeout-fallback", startedAt, { chainId });
         return mapPortfolioBalances(
-          { message: "timeout", result: [] },
+          { message: "timeout", tokens: [] },
           smartWallet
         );
       }
@@ -1058,6 +987,14 @@ var SailAgent = class {
       SAIL_PORTFOLIO_TIMEOUT_MS
     );
   }
+  async getPortfolio() {
+    return this.request(
+      "GET",
+      `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/portfolio/tokens`,
+      void 0,
+      SAIL_PORTFOLIO_TIMEOUT_MS
+    );
+  }
   async getMetricsEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     return this.request(
@@ -1065,7 +1002,7 @@ var SailAgent = class {
       `/api/v1/projects/${PROJECT_ID}/pages/${PAGE_ID}/metrics/earnings?smart_account=${smartWallet}`
     );
   }
-  async getMetricsBalance(state, chainId, currency) {
+  async getMetricsBalance(state, chainId, currency = "usd") {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
     return this.request(
       "GET",
@@ -1213,27 +1150,16 @@ async function fetchAgentKeys(apiKey) {
 }
 
 // src/client.ts
-var AGENT_CONSTRUCTORS = {
-  zyfai: ZyfaiAgent,
-  sail: SailAgent
-};
-var SDK_TIMING_PREFIX = "[OwneySDKTiming]";
-function logTiming3(label, startedAt, meta) {
-  const elapsedMs = Date.now() - startedAt;
-  if (meta) {
-    console.log(`${SDK_TIMING_PREFIX} ${label} ${elapsedMs}ms`, meta);
-    return;
-  }
-  console.log(`${SDK_TIMING_PREFIX} ${label} ${elapsedMs}ms`);
-}
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
   state = null;
   apiKey;
+  zyfaiRpcUrls;
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
+    this.zyfaiRpcUrls = config.zyfaiRpcUrls;
   }
   /**
    * Establish connection state for all subsequent SDK calls.
@@ -1317,10 +1243,9 @@ var OwneySDK = class {
       this.initializingAgentsPromise = (async () => {
         const agentKeys = await fetchAgentKeys(this.apiKey);
         for (const { key, agent_type } of agentKeys) {
-          const AgentClass = AGENT_CONSTRUCTORS[agent_type];
-          if (!AgentClass)
+          const agent = this.createAgent(agent_type, key);
+          if (!agent)
             continue;
-          const agent = new AgentClass(key);
           this.agents.set(agent_type, agent);
         }
         if (this.agents.size === 0) {
@@ -1337,6 +1262,15 @@ var OwneySDK = class {
       this.initializingAgentsPromise = null;
     }
   }
+  createAgent(agentId, key) {
+    if (agentId === "zyfai") {
+      return new ZyfaiAgent(key, this.zyfaiRpcUrls);
+    }
+    if (agentId === "sail") {
+      return new SailAgent(key);
+    }
+    return null;
+  }
   // --- Account lifecycle ---
   /**
    * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
@@ -1349,7 +1283,6 @@ var OwneySDK = class {
    *   throws before activating any agent.
    */
   async activateAgent(chainId, agentId) {
-    const startedAt = Date.now();
     const state = this.requireState();
     await this.ensureAgentsInitialized();
     if (agentId !== void 0) {
@@ -1377,20 +1310,11 @@ var OwneySDK = class {
       state.chainId = chainId;
       Promise.all(
         agents.map(async (agent) => {
-          const agentStart = Date.now();
           await agent.activateAgent(state, chainId);
-          logTiming3("activateAgent background-agent-ready", agentStart, {
-            chainId,
-            agentId: agent.id
-          });
         })
       ).catch((error) => {
         console.error("activateAgent background init failed:", error);
       });
-      logTiming3("activateAgent scheduled", startedAt, {
-        chainId,
-        agentIds: uniqueIds
-      });
       return;
     }
     const compatible = [...this.agents.values()].filter(
@@ -1410,20 +1334,11 @@ var OwneySDK = class {
     state.chainId = chainId;
     Promise.all(
       compatible.map(async (agent) => {
-        const agentStart = Date.now();
         await agent.activateAgent(state, chainId);
-        logTiming3("activateAgent background-agent-ready", agentStart, {
-          chainId,
-          agentId: agent.id
-        });
       })
     ).catch((error) => {
       console.error("activateAgent background init failed:", error);
     });
-    logTiming3("activateAgent scheduled", startedAt, {
-      chainId,
-      agentIds: compatible.map((agent) => agent.id)
-    });
   }
   /**
    * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
@@ -1548,12 +1463,10 @@ var OwneySDK = class {
    * @returns {AgentBalance} for a single agent, or {OwneyBalances} with totalBalance and per-agent breakdown
    */
   async getBalances(agentId) {
-    const startedAt = Date.now();
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
       const result = await this.getAgent(agentId).getBalances(state, chainId);
-      logTiming3("getBalances single-agent", startedAt, { chainId, agentId });
       return result;
     }
     let totalBalance = 0;
@@ -1561,12 +1474,7 @@ var OwneySDK = class {
     const entries = [...this.getActiveAgents().entries()];
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
-        const agentStartedAt = Date.now();
         const b = await agent.getBalances(state, chainId);
-        logTiming3("getBalances per-agent", agentStartedAt, {
-          chainId,
-          agentId: id
-        });
         return [id, b];
       })
     );
@@ -1587,11 +1495,6 @@ var OwneySDK = class {
         "Failed to fetch balances for all active agents."
       );
     }
-    logTiming3("getBalances aggregate", startedAt, {
-      chainId,
-      totalAgents: entries.length,
-      successCount
-    });
     return {
       totalBalance: String(totalBalance),
       agentBalances: results

package/package.json

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