@owney/sdk 0.6.9-beta.0 → 0.6.9-beta.2

package/dist/index.js

@@ -1,10 +1,3 @@
-import {
-  AgentChainIncompatibleError,
-  AgentNotFoundError,
-  NotConnectedError,
-  OwneyError
-} from "./chunk-GMNQBWUB.js";
-
 // src/agents/zyfai/zyfai.agent.ts
 import { ZyfaiSDK } from "@zyfai/sdk";
 import { createPublicClient, http } from "viem";
@@ -63,6 +56,55 @@ var SupportedAssets = [
   }
 ];
 
+// src/errors.ts
+var OwneyError = class extends Error {
+  code;
+  details;
+  agentId;
+  constructor(code, message, details, agentId) {
+    const prefix = agentId ? `[${code}][agent:${agentId}]` : `[${code}]`;
+    super(`${prefix} ${message}`);
+    this.name = "OwneyError";
+    this.code = code;
+    this.details = details;
+    this.agentId = agentId;
+  }
+};
+var AgentNotFoundError = class extends OwneyError {
+  constructor(agentId, available) {
+    super(
+      "AGENT_NOT_FOUND",
+      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
+      { agentId, available },
+      agentId
+    );
+    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)) {
@@ -137,46 +179,46 @@ function resolveChainId(chain) {
 function mapBalances(raw, _chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const portfolioByChain = portfolio.portfolioByChain ?? {};
-  const rawPositions = portfolio.positions ?? [];
-  const detailByKey = /* @__PURE__ */ new Map();
-  for (const p of rawPositions) {
-    const cid = resolveChainId(p.chain ?? "");
-    const symbol = (p.token_symbol ?? "").toUpperCase();
-    if (Number.isFinite(cid) && symbol) detailByKey.set(`${cid}:${symbol}`, p);
-  }
   let totalBalance = 0;
   const tokens = [];
-  const positions = [];
   for (const [chainIdKey, tokensBySymbol] of Object.entries(portfolioByChain)) {
     const positionChainId = Number(chainIdKey);
-    const chainName = CHAIN_ID_TO_NAME[positionChainId] ?? "BASE";
     for (const [symbol, { balance, decimals }] of Object.entries(
       tokensBySymbol ?? {}
     )) {
-      const amount = hexToDecimal(balance || "0", tokenDecimals(symbol, decimals));
+      const amount = hexToDecimal(balance || "0", decimals);
       totalBalance += amount;
       tokens.push({
-        chain: chainName,
+        chain: CHAIN_ID_TO_NAME[positionChainId] ?? "BASE",
         chainId: positionChainId,
         asset: symbol,
         amount: String(amount)
       });
-      const detail = detailByKey.get(`${positionChainId}:${symbol.toUpperCase()}`);
-      positions.push({
-        chain: chainName,
-        protocol: detail?.protocol_name ?? detail?.protocol_id ?? "",
-        protocolId: detail?.protocol_id,
-        pool: detail?.pool,
-        asset: symbol,
-        amount: String(amount),
-        apy: detail?.pool_apy,
-        tvl: detail?.pool_tvl,
-        // PositionSlot has no `liquidity` field yet; Zyfai will add it. Narrow
-        // structural read keeps it undefined today and auto-populates later.
-        liquidity: detail?.liquidity
-      });
     }
   }
+  const positions = (portfolio.positions ?? []).map((p) => ({
+    chain: p.chain ?? "",
+    protocol: p.protocol_name ?? p.protocol_id ?? "",
+    protocolId: p.protocol_id,
+    pool: p.pool,
+    asset: p.token_symbol ?? "",
+    // Position amount is hex-encoded base units (like the token balances
+    // above). `PositionSlot` doesn't type a `decimals` field, but runtime
+    // getBalances payloads often carry one (e.g. 18 for WETH) — prefer that
+    // when present, otherwise fall back to the per-symbol lookup so
+    // non-6-decimal assets like WETH don't render 1e12 too large.
+    amount: String(
+      hexToDecimal(
+        p.amount || "0",
+        tokenDecimals(p.token_symbol, p.decimals)
+      )
+    ),
+    apy: p.pool_apy,
+    tvl: p.pool_tvl,
+    // PositionSlot has no `liquidity` field yet; Zyfai will add it. Narrow
+    // structural read keeps it undefined today and auto-populates later.
+    liquidity: p.liquidity
+  }));
   return {
     smartWallet,
     totalBalance: String(totalBalance),
@@ -586,6 +628,56 @@ function buildProtocolMergeUpdate(available, current, asset) {
   };
 }
 
+// src/agents/zyfai/splitting.ts
+var MAX_MIN_SPLITS = 4;
+var MIN_FORCE_SPLITS = 2;
+var AUTOMATIC_MIN_SPLITS = 1;
+function toZyfaiSplitting(policy) {
+  switch (policy.splittingMode) {
+    case "none":
+      return { splitting: false };
+    case "automatic":
+      return { splitting: true, minSplits: AUTOMATIC_MIN_SPLITS };
+    case "force":
+      return {
+        splitting: true,
+        minSplits: clampForceSplits(policy.minSplits)
+      };
+  }
+}
+function clampForceSplits(minSplits) {
+  if (typeof minSplits !== "number" || !Number.isFinite(minSplits)) {
+    return MIN_FORCE_SPLITS;
+  }
+  const rounded = Math.round(minSplits);
+  if (rounded < MIN_FORCE_SPLITS) return MIN_FORCE_SPLITS;
+  if (rounded > MAX_MIN_SPLITS) return MAX_MIN_SPLITS;
+  return rounded;
+}
+function splittingNeedsUpdate(current, desired) {
+  if (!current) return true;
+  if (current.splitting !== desired.splitting) return true;
+  if (desired.minSplits === void 0) return false;
+  return current.minSplits !== desired.minSplits;
+}
+
+// src/lib/debug.ts
+var configuredDebug = false;
+function setOwneyDebug(enabled) {
+  configuredDebug = enabled;
+}
+function isOwneyDebug() {
+  return globalThis.__OWNEY_DEBUG__ === true || configuredDebug;
+}
+function debugLog(scope, message, data) {
+  if (!isOwneyDebug()) return;
+  if (data === void 0) {
+    console.log(`[${scope}] ${message}`);
+  } else {
+    console.log(`[${scope}] ${message}`, data);
+  }
+}
+
 // src/agents/zyfai/zyfai.agent.ts
 var DEFAULT_ZYFAI_RPC_URLS = {
   8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
@@ -598,6 +690,7 @@ var WETH_ADDRESS_BY_CHAIN = {
   1: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
 };
 var VIEM_CHAIN = { 8453: base, 42161: arbitrum, 1: mainnet };
+var SPLITTING_ASSETS = ["USDC", "WETH"];
 function isAlreadyActiveSessionKeyError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return /already has an active session key/i.test(message);
@@ -962,6 +1055,62 @@ var ZyfaiAgent = class {
       throw error;
     }
   }
+  /**
+   * Apply the org's capital splitting policy to this user's Zyfai profile.
+   *
+   * Per ASSET, not per chain: Zyfai stores splitting under
+   * `assetTypeSettings[asset]`, so one call would only configure USDC and leave a
+   * WETH holder's real setting untouched.
+   *
+   * Non-fatal throughout. This is a side effect of connecting, so a Zyfai hiccup
+   * must leave the user connected with their profile unchanged, never fail
+   * activation.
+   */
+  async applyOrgPolicy(_state, _chainId, policy) {
+    debugLog("zyfai:splitting", "applying org policy", {
+      policy,
+      // Per asset because Zyfai stores splitting under assetTypeSettings[asset].
+      assets: SPLITTING_ASSETS
+    });
+    await Promise.all(
+      SPLITTING_ASSETS.map((asset) => this.applySplitting(asset, policy))
+    );
+  }
+  async applySplitting(asset, policy) {
+    try {
+      const desired = toZyfaiSplitting(policy);
+      const current = await this.sdk.getUserDetails(asset);
+      const currentSplitting = {
+        splitting: current?.splitting,
+        minSplits: current?.minSplits
+      };
+      const needsUpdate = splittingNeedsUpdate(current, desired);
+      debugLog("zyfai:splitting", `${asset}: comparing`, {
+        mode: policy.splittingMode,
+        current: currentSplitting,
+        desired,
+        // Spelled out because the "why" is the non-obvious part: minSplits is
+        // what separates automatic (1) from force (2-4), not `splitting`.
+        decision: needsUpdate ? "will write \u2014 profile differs from the org policy" : "skipping \u2014 profile already matches"
+      });
+      if (!needsUpdate) return;
+      const result = await this.sdk.updateUserProfile({ asset, ...desired });
+      debugLog("zyfai:splitting", `${asset}: wrote updateUserProfile`, {
+        sent: { asset, ...desired },
+        // updateUserProfile re-reads the profile after PATCHing, so this is
+        // Zyfai's own view of the result rather than an echo of what we sent.
+        zyfaiNowReports: {
+          splitting: result?.splitting,
+          minSplits: result?.minSplits
+        }
+      });
+    } catch (error) {
+      console.warn(
+        `[zyfai] applyOrgPolicy(${asset}) failed (non-fatal):`,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
   async deposit(state, chainId, amount, asset, depositCallback) {
     try {
       await this.connectFull(state, chainId);
@@ -1115,6 +1264,40 @@ var ZyfaiAgent = class {
 
 // src/lib/routing-api.ts
 var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
+async function fetchOrgAgentConfig(apiKey) {
+  const url = `${ROUTING_API_BASE_URL}/api/v1/agent/org-config`;
+  try {
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "x-owney-api-key": `${apiKey}`
+      }
+    });
+    if (!res.ok) {
+      if (res.status !== 404) {
+        console.warn(
+          `[owney-sdk] Could not read org agent config (${res.status}); leaving user profiles unchanged.`
+        );
+      }
+      return null;
+    }
+    const json = await res.json();
+    const policy = json.success ? json.data ?? null : null;
+    debugLog(
+      "owney-sdk",
+      policy ? "org agent config: loaded" : "org agent config: none set by this partner \u2014 user profiles will be left as they are",
+      policy ?? void 0
+    );
+    return policy;
+  } catch (error) {
+    console.warn(
+      "[owney-sdk] Could not read org agent config (non-fatal):",
+      error instanceof Error ? error.message : String(error)
+    );
+    return null;
+  }
+}
 async function fetchAgentKeys(apiKey) {
   const url = `${ROUTING_API_BASE_URL}/api/v1/agent/keys`;
   const res = await fetch(url, {
@@ -1713,7 +1896,6 @@ var VIEM_CHAIN2 = {
   42161: arbitrum2,
   1: mainnet2
 };
-var AGENT_ELIGIBILITY_ORDER = ["surfliquid", "zyfai", "sail"];
 var SPONSORED_WETH_BY_CHAIN = {
   8453: "0x4200000000000000000000000000000000000006",
   42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
@@ -1733,6 +1915,12 @@ var OwneySDK = class {
   disabledAgents = /* @__PURE__ */ new Set();
   state = null;
   apiKey;
+  // The org's agent policy, fetched once per client. Applied to each agent on
+  // activation (ROUT-229). `undefined` means "not fetched yet", `null` means
+  // "fetched, and the partner has no policy" — which is a real answer meaning
+  // leave every user's agent profile alone.
+  orgAgentConfig;
+  orgAgentConfigPromise = null;
   zyfaiRpcUrls;
   routingApiBaseUrl;
   referralSource;
@@ -1741,6 +1929,7 @@ var OwneySDK = class {
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
+    if (config.debug) setOwneyDebug(true);
     this.zyfaiRpcUrls = config.zyfaiRpcUrls;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
     this.referralSource = config.referralSource;
@@ -1902,14 +2091,57 @@ var OwneySDK = class {
     }
     return active;
   }
+  /**
+   * Read the org's agent policy once and reuse it. fetchOrgAgentConfig never
+   * throws — it degrades to null — so this cannot break activation.
+   */
+  async getOrgAgentConfig() {
+    if (this.orgAgentConfig !== void 0) return this.orgAgentConfig;
+    if (!this.orgAgentConfigPromise) {
+      this.orgAgentConfigPromise = fetchOrgAgentConfig(this.apiKey).then(
+        (config) => {
+          this.orgAgentConfig = config;
+          return config;
+        }
+      );
+    }
+    return this.orgAgentConfigPromise;
+  }
+  /**
+   * Apply the org policy to one agent, after it has activated.
+   *
+   * Sequenced after activation rather than alongside it because applying the
+   * policy needs the authenticated session activation establishes. Every failure
+   * mode is swallowed: a partner's splitting preference is not worth failing a
+   * user's connect over.
+   */
+  async applyOrgPolicyTo(agent, state, chainId) {
+    if (!agent.applyOrgPolicy) {
+      debugLog(
+        "owney-sdk",
+        `${agent.id}: no applyOrgPolicy \u2014 agent has no org-level knobs, skipping`
+      );
+      return;
+    }
+    try {
+      const policy = await this.getOrgAgentConfig();
+      if (!policy) return;
+      await agent.applyOrgPolicy(state, chainId, policy);
+    } catch (error) {
+      console.warn(
+        `[owney-sdk] applyOrgPolicy(${agent.id}) failed (non-fatal):`,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
   async ensureAgentsInitialized() {
     if (this.agents.size > 0) return;
     if (!this.initializingAgentsPromise) {
       this.initializingAgentsPromise = (async () => {
         const agentKeys = await fetchAgentKeys(this.apiKey);
         this.disabledAgents.clear();
-        for (const { key, agent_type, project_name, is_enabled } of agentKeys) {
-          const agent = await this.createAgent(agent_type, key, project_name);
+        for (const { key, agent_type, is_enabled } of agentKeys) {
+          const agent = this.createAgent(agent_type, key);
           if (!agent) continue;
           this.agents.set(agent_type, agent);
           if (is_enabled === false) {
@@ -1930,15 +2162,10 @@ var OwneySDK = class {
       this.initializingAgentsPromise = null;
     }
   }
-  async createAgent(agentId, key, projectName) {
+  createAgent(agentId, key) {
     if (agentId === "zyfai") {
       return new ZyfaiAgent(key, this.zyfaiRpcUrls, this.referralSource);
     }
-    if (agentId === "surfliquid") {
-      if (!projectName) return null;
-      const { SurfLiquidAgent } = await import("./surfliquid.agent-OMOYXWLP.js");
-      return new SurfLiquidAgent({ projectName, appId: key });
-    }
     return null;
   }
   // --- Account lifecycle ---
@@ -1991,6 +2218,7 @@ var OwneySDK = class {
       Promise.all(
         agents.map(async (agent) => {
           await agent.activateAgent(state, chainId);
+          await this.applyOrgPolicyTo(agent, state, chainId);
         })
       ).catch((error) => {
         console.error("activateAgent background init failed:", error);
@@ -2018,6 +2246,7 @@ var OwneySDK = class {
     Promise.all(
       enabledCompatible.map(async (agent) => {
         await agent.activateAgent(state, chainId);
+        await this.applyOrgPolicyTo(agent, state, chainId);
       })
     ).catch((error) => {
       console.error("activateAgent background init failed:", error);
@@ -2091,30 +2320,18 @@ var OwneySDK = class {
       );
     }
     const agentResults = {};
-    const agentErrors = {};
     for (const { agent, amount: agentAmount } of agentAmounts) {
-      try {
-        agentResults[agent.id] = await this.depositWithFallback(
-          agent,
-          state,
-          chainId,
-          agentAmount,
-          asset,
-          effectiveCallback,
-          depositCallback
-        );
-      } catch (error) {
-        agentErrors[agent.id] = error instanceof Error ? error.message : String(error);
-      }
-    }
-    if (Object.keys(agentResults).length === 0) {
-      throw new OwneyError(
-        "DEPOSIT_ALL_FAILED",
-        `All ${agentAmounts.length} agent deposit(s) failed.`,
-        { agentErrors }
+      agentResults[agent.id] = await this.depositWithFallback(
+        agent,
+        state,
+        chainId,
+        agentAmount,
+        asset,
+        effectiveCallback,
+        depositCallback
       );
     }
-    return Object.keys(agentErrors).length > 0 ? { agentResults, agentErrors } : { agentResults };
+    return { agentResults };
   }
   /**
    * Invokes `agent.deposit` with the resolved sponsored callback, composing
@@ -2271,34 +2488,6 @@ var OwneySDK = class {
     }
     return eligible;
   }
-  /**
-   * Agent ids the routing API provisioned for this org that support the given
-   * chain + asset, ordered by preference ({@link AGENT_ELIGIBILITY_ORDER},
-   * surfliquid first). Returns `[]` when the org has no compatible agent — never
-   * throws on an empty org. Loads agent keys on first call (apiKey only, no
-   * wallet), so the UI can resolve which agent to use before the user connects.
-   *
-   * This is the source of truth for agent availability: an agent appears here
-   * iff the routing API returned its key. No per-app feature flags.
-   */
-  async getEligibleAgentIds(chainId, asset) {
-    try {
-      await this.ensureAgentsInitialized();
-    } catch (error) {
-      if (error instanceof OwneyError && error.code === "API_NO_AGENTS") {
-        return [];
-      }
-      throw error;
-    }
-    return [...this.agents.values()].filter((agent) => {
-      const chainAssets = agent.supportedAssets.find(
-        (sa) => sa.chainId === chainId
-      );
-      return chainAssets?.assets.some((a) => a.symbol === asset) ?? false;
-    }).map((agent) => agent.id).sort(
-      (a, b) => AGENT_ELIGIBILITY_ORDER.indexOf(a) - AGENT_ELIGIBILITY_ORDER.indexOf(b)
-    );
-  }
   // --- Fund operations ---
   /**
    * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
@@ -2334,17 +2523,9 @@ var OwneySDK = class {
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     if (!amount) {
-      const aggregated2 = await this.getBalances();
-      const funded = projectAgentBalancesForAsset(
-        eligibleAgents,
-        aggregated2.agentBalances,
-        chainId,
-        asset,
-        assetInfo.decimals
-      ).filter((b) => b.balance > 0n);
       const results2 = {};
       const agentErrors2 = {};
-      for (const { agent } of funded) {
+      for (const agent of eligibleAgents) {
         try {
           results2[agent.id] = await agent.withdraw(state, chainId, token);
         } catch (err) {
@@ -2361,10 +2542,9 @@ var OwneySDK = class {
           { asset, agentErrors: agentErrors2 }
         );
       }
-      const totalWithdrawn = funded.filter(({ agent }) => results2[agent.id] !== void 0).reduce((sum, { balance }) => sum + balance, 0n);
       return {
         agentResult: results2,
-        totalWithdrawn: totalWithdrawn.toString()
+        totalWithdrawn: sumWithdrawnAmount(results2).toString()
       };
     }
     const requested = BigInt(amount);
@@ -3075,5 +3255,6 @@ export {
   NotConnectedError,
   OwneyError,
   OwneySDK,
-  createOwneySIWX
+  createOwneySIWX,
+  setOwneyDebug
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.6.9-beta.0",
+  "version": "0.6.9-beta.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -23,9 +23,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@surf_liquid/core-sdk": "^0.4.0",
     "@zyfai/sdk": "^0.2.41",
-    "ethers": "^6.17.0",
     "siwe": "^3.0.0",
     "viem": "^2.48.1"
   },

package/dist/chunk-GMNQBWUB.js

@@ -1,55 +0,0 @@
-// src/errors.ts
-var OwneyError = class extends Error {
-  code;
-  details;
-  agentId;
-  constructor(code, message, details, agentId) {
-    const prefix = agentId ? `[${code}][agent:${agentId}]` : `[${code}]`;
-    super(`${prefix} ${message}`);
-    this.name = "OwneyError";
-    this.code = code;
-    this.details = details;
-    this.agentId = agentId;
-  }
-};
-var AgentNotFoundError = class extends OwneyError {
-  constructor(agentId, available) {
-    super(
-      "AGENT_NOT_FOUND",
-      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
-      { agentId, available },
-      agentId
-    );
-    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;
-  }
-};
-
-export {
-  OwneyError,
-  AgentNotFoundError,
-  NotConnectedError,
-  AgentChainIncompatibleError
-};