@owney/sdk 0.2.6 → 0.2.8

package/dist/index.js

@@ -26,11 +26,58 @@ var SupportedAssets = [
   }
 ];
 
+// src/errors.ts
+var OwneyError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "OwneyError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var AgentNotFoundError = class extends OwneyError {
+  constructor(agentId, available) {
+    super(
+      "AGENT_NOT_FOUND",
+      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
+      { agentId, available }
+    );
+    this.name = "AgentNotFoundError";
+  }
+};
+var NotConnectedError = class extends OwneyError {
+  constructor() {
+    super("NOT_CONNECTED", "Not connected. Call sdk.connect(provider) first.");
+    this.name = "NotConnectedError";
+  }
+};
+var AgentChainIncompatibleError = class extends OwneyError {
+  incompatibleAgents;
+  connectedChainId;
+  constructor(incompatibleAgents, connectedChainId) {
+    const details = incompatibleAgents.map(
+      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
+    ).join("; ");
+    super(
+      "AGENT_CHAIN_INCOMPATIBLE",
+      `Chain ${connectedChainId} is not supported by the following agents: ${details}`,
+      { incompatibleAgents, connectedChainId }
+    );
+    this.name = "AgentChainIncompatibleError";
+    this.incompatibleAgents = incompatibleAgents;
+    this.connectedChainId = connectedChainId;
+  }
+};
+
 // src/lib/utils.ts
 var isValidChainId = (chainId) => {
   if (!SUPPORTED_CHAIN_IDS.includes(chainId)) {
-    throw new Error(
-      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`
+    throw new OwneyError(
+      "CHAIN_UNSUPPORTED",
+      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`,
+      { chainId, supportedChainIds: [...SUPPORTED_CHAIN_IDS] }
     );
   }
   return chainId;
@@ -45,6 +92,15 @@ function hexToDecimal(hex, decimals = 6) {
   const remainder = parsed % divisor;
   return Number(whole) + Number(remainder) / Number(divisor);
 }
+function normalizeDecimalPlace(value, decimals = 6) {
+  const parsed = BigInt(value);
+  if (decimals <= 0)
+    return Number(parsed);
+  const divisor = BigInt(10 ** decimals);
+  const whole = parsed / divisor;
+  const remainder = parsed % divisor;
+  return Number(whole) + Number(remainder) / Number(divisor);
+}
 var DayFilterMapping = {
   "30D": 30,
   "14D": 14,
@@ -74,7 +130,7 @@ var CHAIN_NAME_TO_ID = {
   BASE: 8453,
   ARBITRUM: 42161
 };
-function mapBalances(raw, chainId) {
+function mapBalances(raw, chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const tokenMap = /* @__PURE__ */ new Map();
   for (const p of portfolio.positions || []) {
@@ -85,18 +141,7 @@ function mapBalances(raw, chainId) {
     tokenMap.set(key, {
       symbol,
       chainId: positionChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(p.amount || "0")
-    });
-  }
-  for (const s of portfolio.staleBalances || []) {
-    const symbol = s.tokenSymbol || "USDC";
-    const staleChainId = s.chainId ?? chainId;
-    const key = `${symbol}:${staleChainId}`;
-    const current = tokenMap.get(key);
-    tokenMap.set(key, {
-      symbol,
-      chainId: staleChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(s.balance || "0")
+      amount: (current?.amount ?? 0) + normalizeDecimalPlace(p.underlyingAmount || "0")
     });
   }
   let totalBalance = 0;
@@ -111,7 +156,7 @@ function mapBalances(raw, chainId) {
     });
   }
   return {
-    smartWallet: portfolio.smartWallet,
+    smartWallet,
     totalBalance: String(totalBalance),
     tokens
   };
@@ -228,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];
@@ -257,29 +293,27 @@ 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() {
     if (!this.connectedAddress) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
     return this.connectedAddress;
   }
   /** 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 () => {
@@ -292,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 ---
@@ -414,16 +419,9 @@ var ZyfaiAgent = class {
   }
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
-    const startedAt = Date.now();
-    await this.connectAuth(state, chainId);
-    const validChainId = isValidChainId(chainId);
-    const positionsStart = Date.now();
-    const raw = await this.sdk.getPositions(this.getAddress(), validChainId);
-    logTiming("getBalances getPositions", positionsStart, {
-      chainId: validChainId
-    });
-    logTiming("getBalances success", startedAt, { chainId: validChainId });
-    return mapBalances(raw, validChainId);
+    const { smartWallet, chainId: validChainId } = await this.resolveSmartWallet(state, chainId);
+    const raw = await this.sdk.getPortfolio(this.getAddress());
+    return mapBalances(raw, validChainId, smartWallet);
   }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
@@ -487,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 {
@@ -676,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];
@@ -735,7 +724,11 @@ var SailAgent = class {
       });
     } catch (error) {
       if (error instanceof Error && error.name === "AbortError" && timeoutMs) {
-        throw new Error(`Sail API timeout ${timeoutMs}ms: ${method} ${path}`);
+        throw new OwneyError(
+          "API_SAIL_TIMEOUT",
+          `Sail API timeout ${timeoutMs}ms: ${method} ${path}`,
+          { timeoutMs, method, path }
+        );
       }
       throw error;
     } finally {
@@ -744,13 +737,16 @@ var SailAgent = class {
     }
     if (!res.ok) {
       const text = await res.text().catch(() => "");
-      throw new Error(`Sail API error ${res.status}: ${text}`);
+      throw new OwneyError(
+        "API_SAIL_ERROR",
+        `Sail API error ${res.status}: ${text}`,
+        { statusCode: res.status, method, path, responseBody: text }
+      );
     }
     return res.json();
   }
   /** 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`,
@@ -765,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,
@@ -774,18 +769,18 @@ 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) {
-      throw new Error("Wallet address is required");
+      throw new OwneyError(
+        "WALLET_ADDRESS_REQUIRED",
+        "Wallet address is required. Call sdk.connect(provider) first."
+      );
     }
     this.connectPromise = (async () => {
       const { sessionId, signature, message } = await this.signSiwe(
@@ -811,19 +806,19 @@ 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) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
-    logTiming2("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return {
       smartWallet: this.smartWalletAddress,
       chainId: validChainId
@@ -848,7 +843,8 @@ var SailAgent = class {
   }
   async deposit(state, chainId, amount, depositCallback) {
     if (!depositCallback) {
-      throw new Error(
+      throw new OwneyError(
+        "DEPOSIT_CALLBACK_REQUIRED",
         "depositCallback is required for Sail. Provide a callback that transfers tokens and returns the transaction hash."
       );
     }
@@ -857,12 +853,16 @@ var SailAgent = class {
       const depositInfo = await this.getDepositInfo();
       const resolvedTokenAddress = depositInfo.permittedTokens[0]?.address;
       if (!resolvedTokenAddress) {
-        throw new Error("No permitted tokens available for deposit.");
+        throw new OwneyError(
+          "DEPOSIT_NO_PERMITTED_TOKENS",
+          "No permitted tokens available for deposit."
+        );
       }
       await this.executePreHooks(resolvedTokenAddress, amount, chainId);
       const txHash = await depositCallback(smartWallet, chainId, amount);
       if (!txHash) {
-        throw new Error(
+        throw new OwneyError(
+          "DEPOSIT_CALLBACK_INVALID",
           "depositCallback must return a transaction hash (txHash) for Sail deposits."
         );
       }
@@ -916,7 +916,10 @@ var SailAgent = class {
     const withdrawInfo = await this.getWithdrawInfo();
     const tokenAddress = withdrawInfo.permittedTokens[0]?.address;
     if (!tokenAddress) {
-      throw new Error("No permitted tokens available for withdrawal.");
+      throw new OwneyError(
+        "WITHDRAW_NO_PERMITTED_TOKENS",
+        "No permitted tokens available for withdrawal."
+      );
     }
     const resolvedAmount = amount ?? withdrawInfo.currentBalance;
     const { signature: adminWalletSignature, message: adminWalletPayload } = await this.signSiwe(state, chainId);
@@ -940,25 +943,20 @@ 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 Error && error.message.startsWith("Sail API timeout")) {
+      if (error instanceof OwneyError && error.code === "API_SAIL_TIMEOUT") {
         console.warn(
           "Sail portfolio request timed out; using empty snapshot.",
           {
             chainId
           }
         );
-        logTiming2("getBalances timeout-fallback", startedAt, { chainId });
         return mapPortfolioBalances(
-          { message: "timeout", result: [] },
+          { message: "timeout", tokens: [] },
           smartWallet
         );
       }
@@ -989,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(
@@ -996,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",
@@ -1033,8 +1039,10 @@ var SailAgent = class {
     }
     const dayCount = DayFilterMapping[days];
     if (dayCount === void 0) {
-      throw new Error(
-        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`
+      throw new OwneyError(
+        "VALIDATION_INVALID_DAYS",
+        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`,
+        { days }
       );
     }
     const now = /* @__PURE__ */ new Date();
@@ -1111,37 +1119,6 @@ var SailAgent = class {
   }
 };
 
-// src/errors.ts
-var AgentNotFoundError = class extends Error {
-  constructor(agentId, available) {
-    super(
-      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`
-    );
-    this.name = "AgentNotFoundError";
-  }
-};
-var NotConnectedError = class extends Error {
-  constructor() {
-    super("Not connected. Call sdk.connect(provider) first.");
-    this.name = "NotConnectedError";
-  }
-};
-var AgentChainIncompatibleError = class extends Error {
-  incompatibleAgents;
-  connectedChainId;
-  constructor(incompatibleAgents, connectedChainId) {
-    const details = incompatibleAgents.map(
-      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
-    ).join("; ");
-    super(
-      `Chain ${connectedChainId} is not supported by the following agents: ${details}`
-    );
-    this.name = "AgentChainIncompatibleError";
-    this.incompatibleAgents = incompatibleAgents;
-    this.connectedChainId = connectedChainId;
-  }
-};
-
 // src/lib/routing-api.ts
 var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function fetchAgentKeys(apiKey) {
@@ -1155,37 +1132,34 @@ async function fetchAgentKeys(apiKey) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => "");
-    throw new Error(`Routing API error ${res.status}: ${text}`);
+    throw new OwneyError(
+      "API_ROUTING_ERROR",
+      `Routing API error ${res.status}: ${text}`,
+      { statusCode: res.status, responseBody: text }
+    );
   }
   const json = await res.json();
   if (!json.success) {
-    throw new Error(`Routing API request failed: ${json.message}`);
+    throw new OwneyError(
+      "API_ROUTING_FAILED",
+      `Routing API request failed: ${json.message}`,
+      { message: json.message }
+    );
   }
   return json.data;
 }
 
 // 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.
@@ -1199,7 +1173,8 @@ var OwneySDK = class {
     });
     const walletAddress = accounts[0];
     if (!walletAddress) {
-      throw new Error(
+      throw new OwneyError(
+        "WALLET_NO_ACCOUNTS",
         "No accounts found. Ensure the wallet is unlocked and connected."
       );
     }
@@ -1238,7 +1213,8 @@ var OwneySDK = class {
   requireChainId() {
     const chainId = this.state?.chainId ?? null;
     if (chainId === null) {
-      throw new Error(
+      throw new OwneyError(
+        "NO_ACTIVE_CHAIN",
         "No active chain. Call sdk.activateAgent(chainId) first."
       );
     }
@@ -1267,14 +1243,14 @@ 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) {
-          throw new Error(
+          throw new OwneyError(
+            "API_NO_AGENTS",
             "No supported agents returned by the routing API. Check your API key and routing configuration."
           );
         }
@@ -1286,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.
@@ -1298,12 +1283,12 @@ 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) {
       if (agentId.length === 0) {
-        throw new Error(
+        throw new OwneyError(
+          "AGENT_EMPTY_LIST",
           "agentId array must not be empty. Omit the argument to activate all compatible agents."
         );
       }
@@ -1325,27 +1310,22 @@ 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(
       (agent) => agent.supportedChainIds.includes(chainId)
     );
     if (compatible.length === 0) {
-      throw new Error(`No agents support chain ${chainId}.`);
+      throw new OwneyError(
+        "CHAIN_NO_COMPATIBLE_AGENTS",
+        `No agents support chain ${chainId}.`,
+        { chainId }
+      );
     }
     this.activeAgents.clear();
     for (const agent of compatible) {
@@ -1354,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.
@@ -1393,8 +1364,10 @@ var OwneySDK = class {
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     const totalAmount = BigInt(amount);
     if (totalAmount < BigInt(eligibleAgents.length)) {
-      throw new Error(
-        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`
+      throw new OwneyError(
+        "DEPOSIT_AMOUNT_TOO_SMALL",
+        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`,
+        { amount, agentCount: eligibleAgents.length }
       );
     }
     const perAgent = totalAmount / BigInt(eligibleAgents.length);
@@ -1417,8 +1390,10 @@ var OwneySDK = class {
       (sa) => sa.chainId === chainId
     );
     if (!chainAssets || !chainAssets.assets.includes(asset)) {
-      throw new Error(
-        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_UNSUPPORTED",
+        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`,
+        { agentId: agent.id, asset, chainId }
       );
     }
   }
@@ -1430,8 +1405,10 @@ var OwneySDK = class {
       return chainAssets && chainAssets.assets.includes(asset);
     });
     if (eligible.length === 0) {
-      throw new Error(
-        `No agents support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_NO_COMPATIBLE_AGENTS",
+        `No agents support asset "${asset}" on chain ${chainId}.`,
+        { asset, chainId }
       );
     }
     return eligible;
@@ -1456,10 +1433,25 @@ var OwneySDK = class {
       return agent.withdraw(state, chainId, amount);
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
+    if (!amount) {
+      const results2 = {};
+      for (const agent of eligibleAgents) {
+        results2[agent.id] = await agent.withdraw(state, chainId);
+      }
+      return { agentResult: results2 };
+    }
     const results = {};
+    let lastError;
     for (const agent of eligibleAgents) {
-      results[agent.id] = await agent.withdraw(state, chainId, amount);
+      try {
+        results[agent.id] = await agent.withdraw(state, chainId, amount);
+        return { agentResult: results };
+      } catch (err) {
+        lastError = err;
+      }
     }
+    if (lastError)
+      throw lastError;
     return {
       agentResult: results
     };
@@ -1471,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;
@@ -1484,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];
       })
     );
@@ -1505,13 +1490,11 @@ var OwneySDK = class {
       console.error("getBalances agent failed:", settledResult.reason);
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch balances for all active agents.");
+      throw new OwneyError(
+        "BALANCE_ALL_FAILED",
+        "Failed to fetch balances for all active agents."
+      );
     }
-    logTiming3("getBalances aggregate", startedAt, {
-      chainId,
-      totalAgents: entries.length,
-      successCount
-    });
     return {
       totalBalance: String(totalBalance),
       agentBalances: results
@@ -1747,7 +1730,10 @@ var OwneySDK = class {
       }
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch allocation: all agents failed.");
+      throw new OwneyError(
+        "ALLOCATION_ALL_FAILED",
+        "Failed to fetch allocation: all agents failed."
+      );
     }
     const allocation = {};
     if (totalBalance === 0) {
@@ -1775,5 +1761,6 @@ export {
   AgentChainIncompatibleError,
   AgentNotFoundError,
   NotConnectedError,
+  OwneyError,
   OwneySDK
 };