@owney/sdk 0.5.1 → 0.5.3-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # @owney/sdk
 
-A TypeScript SDK for interacting with DeFi yield agents. Supports multiple agent backends (Zyfai, Sail) through a unified interface.
+A TypeScript SDK for interacting with DeFi yield agents. Supports multiple agents through a unified interface.
 
 ## Installation
 
@@ -117,7 +117,7 @@ Activate the user's smart wallet for the specified agents, or all chain-compatib
 
 ```typescript
 // Activate specific agents on Base
-await sdk.activateAgent(8453, ["zyfai", "sail"]);
+await sdk.activateAgent(8453, ["zyfai"]);
 
 // Activate all agents that support Arbitrum
 await sdk.activateAgent(42161);
@@ -159,8 +159,7 @@ const results = await sdk.deposit({
     return await transferTokens(smartWallet, amount);
   },
 });
-console.log(results.agentResults.zyfai.amount); // "50000000"
-console.log(results.agentResults.sail.amount); // "50000000"
+console.log(results.agentResults.zyfai.amount); // "100000000"
 ```
 
 ### `withdraw(options)`
@@ -199,15 +198,13 @@ console.log(result.type); // "partial"
 console.log(result.amount); // "50000000"
 
 // Partial withdrawal split proportionally across all agents
-// e.g. zyfai=$5, sail=$2, amount=$4 → zyfai withdraws $3, sail withdraws $1
+// e.g. zyfai=$5, amount=$4 -> zyfai withdraws $4
 const split = await sdk.withdraw({ asset: "USDC", amount: "4000000" });
-console.log(split.agentResult.zyfai.amount); // "3000000"
-console.log(split.agentResult.sail.amount); // "1000000"
+console.log(split.agentResult.zyfai.amount); // "4000000"
 
 // Full withdrawal from all agents
 const results = await sdk.withdraw({ asset: "USDC" });
 console.log(results.agentResult.zyfai.type); // "full"
-console.log(results.agentResult.sail.type); // "full"
 ```
 
 ### `getBalances(agentId?)`
@@ -216,7 +213,7 @@ Get the user's balances for a specific agent, or aggregated across all agents.
 
 | Param     | Type                           | Description                          |
 | --------- | ------------------------------ | ------------------------------------ |
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
+| `agentId` | `"zyfai"` (optional)          | Agent to query. Omit for all agents. |
 
 Returns: `AgentBalance` (single agent) or `OwneyBalances` (all agents)
 
@@ -229,9 +226,8 @@ console.log(balance.tokens); // [{ chain: "BASE", chainId: 8453, asset: "USDC",
 
 // All agents
 const allBalances = await sdk.getBalances();
-console.log(allBalances.totalBalance); // "300.50"
+console.log(allBalances.totalBalance); // "150.25"
 console.log(allBalances.agentBalances.zyfai.totalBalance); // "150.25"
-console.log(allBalances.agentBalances.sail.totalBalance); // "150.25"
 ```
 
 ### `getEarnings(agentId?)`
@@ -240,7 +236,7 @@ Get the user's on-chain earnings for a specific agent, or aggregated across all
 
 | Param     | Type                           | Description                          |
 | --------- | ------------------------------ | ------------------------------------ |
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
+| `agentId` | `"zyfai"` (optional)          | Agent to query. Omit for all agents. |
 
 Returns: `AgentEarnings` (single agent) or `OwneyEarnings` (all agents)
 
@@ -268,7 +264,7 @@ Get the weighted APY for the user's account. When querying all agents, the total
 
 | Param     | Type                           | Description                                      |
 | --------- | ------------------------------ | ------------------------------------------------ |
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for balance-weighted total. |
+| `agentId` | `"zyfai"` (optional)          | Agent to query. Omit for balance-weighted total. |
 | `days`    | `"7D" \| "14D" \| "30D"`       | Lookback period                                  |
 
 Returns: `AccountAgentApy` (single agent) or `OwneyAccountApy` (all agents)
@@ -287,7 +283,6 @@ console.log(apy.apyByChainAndAsset?.[8453]?.USDC); // 5.4
 const allApy = await sdk.getAccountApy({ days: "30D" });
 console.log(allApy.totalApy); // "5.6"
 console.log(allApy.agentApy.zyfai.weightedApyAfterFee); // 6.0
-console.log(allApy.agentApy.sail.weightedApyAfterFee); // 4.0
 // Per (chain, asset), balance-weighted across all agents.
 // Cells with 0/missing APY for a given agent are excluded from that cell.
 console.log(allApy.apyByChainAndAsset[8453]?.USDC); // 5.3
@@ -304,7 +299,7 @@ Results are **cursor-paginated**. The first call (no `cursor`) anchors a stable
 
 | Param              | Type                           | Description                                              |
 | ------------------ | ------------------------------ | -------------------------------------------------------- |
-| `agentId`          | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents.                     |
+| `agentId`          | `"zyfai"` (optional)          | Agent to query. Omit for all agents.                     |
 | `filters.fromDate` | `string` (optional)            | Start date (`YYYY-MM-DD`)                                |
 | `filters.toDate`   | `string` (optional)            | End date (`YYYY-MM-DD`)                                  |
 | `filters.limit`    | `number` (optional)            | Max entries returned per call. Defaults to `10`.         |
@@ -336,7 +331,7 @@ console.log(history.data[0].rebalanceLog[0].status); // "success"
 // All agents (merged and sorted by date)
 const allHistory = await sdk.getHistory();
 console.log(allHistory.hasMore); // true | false
-console.log(allHistory.data[0].agent); // "sail" (most recent entry)
+console.log(allHistory.data[0].agent); // "zyfai" (most recent entry)
 console.log(allHistory.data[0].action); // "Rebalance"
 
 // Paginate through all history (per-chain, anchored to a single snapshot)
@@ -351,44 +346,13 @@ do {
 } while (cursor);
 ```
 
-### `pauseAgent(agentId)`
-
-Pause an agent's automated operations. The agent will stop rebalancing until resumed.
-
-| Param     | Type                | Description    |
-| --------- | ------------------- | -------------- |
-| `agentId` | `"zyfai" \| "sail"` | Agent to pause |
-
-Returns: `OwneyAgentStatus`
-
-```typescript
-const status = await sdk.pauseAgent("zyfai");
-console.log(status.success); // true
-```
-
-### `resumeAgent(agentId)`
-
-Resume an agent's automated operations.
-
-| Param     | Type                | Description     |
-| --------- | ------------------- | --------------- |
-| `agentId` | `"zyfai" \| "sail"` | Agent to resume |
-
-Returns: `OwneyAgentStatus`
-
-```typescript
-const status = await sdk.resumeAgent("zyfai");
-console.log(status.success); // true
-console.log(status.protocols); // ["aave", "compound"]
-```
-
 ### `getUserProfile(agentId?)`
 
 Get the user's profile for a specific agent, or all agents.
 
 | Param     | Type                           | Description                          |
 | --------- | ------------------------------ | ------------------------------------ |
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
+| `agentId` | `"zyfai"` (optional)          | Agent to query. Omit for all agents. |
 
 Returns: `AgentUserProfile` (single agent) or `OwneyUserProfile` (all agents)
 
@@ -404,7 +368,6 @@ console.log(profile.protocols); // ["aave", "compound"]
 // All agents
 const allProfiles = await sdk.getUserProfile();
 console.log(allProfiles.agentUserProfile.zyfai.smartWallet); // "0x..."
-console.log(allProfiles.agentUserProfile.sail.smartWallet); // "0x..."
 ```
 
 ### `getAgentApy({ agentId?, days, tokenSymbol?, chainId? })`
@@ -413,14 +376,14 @@ Get the agent's average APY performance over a time period. Does not require a w
 
 | Param         | Type                           | Description                                                                                                                                                                                    |
 | ------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `agentId`     | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents.                                                                                                                                                           |
+| `agentId`     | `"zyfai"` (optional)          | Agent to query. Omit for all agents.                                                                                                                                                           |
 | `days`        | `"7D" \| "14D" \| "30D"`       | Lookback period                                                                                                                                                                                |
-| `tokenSymbol` | `string` (optional)            | Asset symbol (e.g. `"USDC"`, `"WETH"`). Scopes the upstream request to a specific asset when the agent's backend supports it. Zyfai forwards this; Sail currently ignores it at the API level. |
-| `chainId`     | `number` (optional)            | Chain id. Typically paired with `tokenSymbol` for per-asset+chain APY. Zyfai forwards this; Sail currently ignores it at the API level.                                                        |
+| `tokenSymbol` | `string` (optional)            | Asset symbol (e.g. `"USDC"`). Scopes the upstream request to a specific asset when the agent's backend supports it.                                                                      |
+| `chainId`     | `number` (optional)            | Chain id. Typically paired with `tokenSymbol` for per-asset+chain APY.                                                                       |
 
 Returns: `AgentApy` (single agent) or `OwneyAgentApy` (all agents)
 
-Both agents populate `detailedApys.apyPerAsset` with a per-chain, per-token
+ The agent populates `detailedApys.apyPerAsset` with a per-chain, per-token
 breakdown when available. `tokenSymbol` / `chainId` only affect whether the
 upstream query is scoped — the breakdown is built from whatever the agent
 returns.
@@ -434,10 +397,8 @@ console.log(apy.detailedApys?.apyPerAsset[8453]?.USDC); // 8.7
 // All agents
 const allApy = await sdk.getAgentApy({ days: "30D" });
 console.log(allApy.agentApy.zyfai.averageApy); // 8.5
-console.log(allApy.agentApy.sail.averageApy); // 6.2
-console.log(allApy.agentApy.sail.detailedApys?.apyPerAsset[42161]?.USDT); // 6.4
 
-// Scope the upstream query to USDC on Base (Zyfai-aware; Sail ignores the filter)
+// Scope the upstream query to USDC on Base
 const usdcBaseApy = await sdk.getAgentApy({
   days: "30D",
   tokenSymbol: "USDC",
@@ -454,7 +415,7 @@ Returns: `OwneyAgentAllocation`
 
 ```typescript
 const allocation = await sdk.getAgentAllocation();
-console.log(allocation.agentAllocation); // { zyfai: 75, sail: 25 }
+console.log(allocation.agentAllocation); // { zyfai: 100 }
 ```
 
 ## Types
@@ -462,7 +423,7 @@ console.log(allocation.agentAllocation); // { zyfai: 75, sail: 25 }
 ### Configuration
 
 ```typescript
-type AgentId = "zyfai" | "sail";
+type AgentId = "zyfai";
 type Asset = string;
 type DailyApyDays = "7D" | "14D" | "30D";
 type OwneySupportedChainId = 8453 | 42161;
@@ -639,12 +600,6 @@ interface OwneyAgentHistory {
   nextCursor?: string;
 }
 
-interface OwneyAgentStatus {
-  success: boolean;
-  strategy?: string;
-  protocols?: string[];
-}
-
 interface AgentUserProfile {
   address: string;
   smartWallet: string;
@@ -738,7 +693,7 @@ type OwneyErrorCode =
   | "ASSET_NO_COMPATIBLE_AGENTS" // No agents support the asset on the active chain
   // Deposit
   | "DEPOSIT_AMOUNT_BELOW_MINIMUM" // Amount below an agent's required minimum deposit for the chain+asset
-  | "DEPOSIT_CALLBACK_REQUIRED" // Sail agent requires a depositCallback
+  | "DEPOSIT_CALLBACK_REQUIRED" // 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
@@ -750,8 +705,6 @@ type OwneyErrorCode =
   // 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

package/dist/index.cjs

@@ -157,6 +157,18 @@ var CHAIN_ID_TO_NAME = {
   8453: "BASE",
   42161: "ARBITRUM"
 };
+var NAME_TO_CHAIN_ID = Object.entries(
+  CHAIN_ID_TO_NAME
+).reduce((acc, [id, name]) => {
+  acc[name.toLowerCase()] = Number(id);
+  return acc;
+}, {});
+function resolveChainId(chain) {
+  const asNum = Number(chain);
+  if (Number.isFinite(asNum) && asNum > 0)
+    return asNum;
+  return NAME_TO_CHAIN_ID[chain.trim().toLowerCase()] ?? NaN;
+}
 function mapBalances(raw, _chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const portfolioByChain = portfolio.portfolioByChain ?? {};
@@ -305,13 +317,6 @@ function mapEntries(rawEntries, chainId) {
     };
   });
 }
-function mapAgentStatus(raw) {
-  return {
-    success: raw.success,
-    strategy: raw.strategy,
-    protocols: raw.protocols
-  };
-}
 function mapUserProfile(raw, userAddress) {
   return {
     address: userAddress,
@@ -347,6 +352,46 @@ function mapApyByStrategy(raw) {
     detailedApys: hasDetails ? { apyPerAsset } : void 0
   };
 }
+function computeAllocationApy(positions) {
+  let weightedSum = 0;
+  let totalValue = 0;
+  const buckets = {};
+  for (const p of positions) {
+    const apy = p.apy;
+    const value = Number(p.amount);
+    if (typeof apy !== "number" || !Number.isFinite(value) || value <= 0) {
+      continue;
+    }
+    weightedSum += apy * value;
+    totalValue += value;
+    const chainId = resolveChainId(p.chain);
+    const token = p.asset;
+    if (!SUPPORTED_CHAIN_IDS.includes(chainId))
+      continue;
+    if (!SUPPORTED_TOKENS.includes(token))
+      continue;
+    const perAsset = buckets[chainId] ?? {};
+    const cell = perAsset[token] ?? { weightedSum: 0, value: 0 };
+    cell.weightedSum += apy * value;
+    cell.value += value;
+    perAsset[token] = cell;
+    buckets[chainId] = perAsset;
+  }
+  const apyByChainAndAsset = {};
+  for (const [chainKey, perAsset] of Object.entries(buckets)) {
+    const chainId = Number(chainKey);
+    const out = {};
+    for (const [token, cell] of Object.entries(perAsset ?? {})) {
+      if (cell && cell.value > 0) {
+        out[token] = cell.weightedSum / cell.value;
+      }
+    }
+    if (Object.keys(out).length > 0)
+      apyByChainAndAsset[chainId] = out;
+  }
+  const totalApy = totalValue > 0 ? String(weightedSum / totalValue) : "0";
+  return { totalApy, apyByChainAndAsset };
+}
 
 // src/agents/zyfai/zyfai.history-cursor.ts
 var InvalidHistoryCursorError = class extends Error {
@@ -729,17 +774,6 @@ var ZyfaiAgent = class {
       nextCursor
     };
   }
-  // --- IAgent: Agent control ---
-  async pause(state, chainId) {
-    await this.connectAuth(state, chainId);
-    const raw = await this.sdk.pauseAgent();
-    return mapAgentStatus(raw);
-  }
-  async resume(state, chainId) {
-    await this.connectAuth(state, chainId);
-    const raw = await this.sdk.resumeAgent();
-    return mapAgentStatus(raw);
-  }
   async getUserProfile(state, chainId) {
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
@@ -1100,7 +1134,10 @@ var SPONSORED_USDC_BY_CHAIN = {
   8453: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
   42161: "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
 };
-var VIEM_CHAIN = { 8453: import_chains.base, 42161: import_chains.arbitrum };
+var VIEM_CHAIN = {
+  8453: import_chains.base,
+  42161: import_chains.arbitrum
+};
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
@@ -1620,10 +1657,7 @@ var OwneySDK = class {
       disabledBalances,
       requested
     );
-    const enabledTotal = enabledBalances.reduce(
-      (s, b) => s + b.balance,
-      0n
-    );
+    const enabledTotal = enabledBalances.reduce((s, b) => s + b.balance, 0n);
     const enabledPlans = afterDrain > 0n ? planProportionalShares(enabledBalances, afterDrain, enabledTotal) : enabledBalances.map(({ agent, balance }) => ({
       agent,
       balance,
@@ -1894,27 +1928,6 @@ var OwneySDK = class {
       nextCursor: hasMore ? encodeMultiAgentCursor(nextCursorMap) : void 0
     };
   }
-  // --- Agent control ---
-  /**
-   * Pause an agent's automated operations. The agent will stop rebalancing until resumed.
-   * @param agentId - The agent to pause (e.g. "zyfai")
-   * @returns OwneyAgentStatus with success flag
-   */
-  async pauseAgent(agentId) {
-    const state = this.requireState();
-    const chainId = this.requireChainId();
-    return this.getAgent(agentId).pause(state, chainId);
-  }
-  /**
-   * Resume an agent's automated operations.
-   * @param agentId - The agent to resume (e.g. "zyfai")
-   * @returns OwneyAgentStatus with success flag
-   */
-  async resumeAgent(agentId) {
-    const state = this.requireState();
-    const chainId = this.requireChainId();
-    return this.getAgent(agentId).resume(state, chainId);
-  }
   /**
    * Get the user's profile for a specific agent, or all agents.
    * @param agentId - Optional. Agent to query. Omit for all agents.
@@ -2044,6 +2057,62 @@ var OwneySDK = class {
       agentPositions: positionsByAgent
     };
   }
+  /**
+   * Allocation-weighted APY from the current portfolio: each pool's APY
+   * weighted by the user's position value in it. More accurate per-user than
+   * the historical 30D APY. (ROUT-228)
+   * @param options.agentId - Optional. Scope to one agent. Omit to aggregate
+   *   positions across all active agents.
+   */
+  async getAllocationApy({
+    agentId
+  } = {}) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const activeAgents = agentId ? /* @__PURE__ */ new Map([[agentId, this.getAgent(agentId)]]) : this.getActiveAgents();
+    const entries = [...activeAgents.entries()];
+    const balanceResults = await Promise.allSettled(
+      entries.map(async ([id, agent]) => {
+        const b = await agent.getBalances(state, chainId);
+        return [id, b.positions ?? []];
+      })
+    );
+    const agentApy = {};
+    const allPositions = [];
+    let successCount = 0;
+    const agentErrors = {};
+    for (let i = 0; i < balanceResults.length; i++) {
+      const settled = balanceResults[i];
+      const [aid] = entries[i];
+      if (settled.status === "fulfilled") {
+        const [id, positions] = settled.value;
+        const per = computeAllocationApy(positions);
+        agentApy[id] = {
+          totalApy: per.totalApy,
+          apyByChainAndAsset: per.apyByChainAndAsset
+        };
+        allPositions.push(...positions);
+        successCount += 1;
+      } else {
+        const reason = settled.reason;
+        agentErrors[aid] = reason instanceof Error ? reason.message : String(reason);
+        console.error(`getAllocationApy agent "${aid}" failed:`, reason);
+      }
+    }
+    if (successCount === 0) {
+      throw new OwneyError(
+        "ALLOCATION_ALL_FAILED",
+        "Failed to fetch allocation APY: all agents failed.",
+        { agentErrors }
+      );
+    }
+    const overall = computeAllocationApy(allPositions);
+    return {
+      totalApy: overall.totalApy,
+      apyByChainAndAsset: overall.apyByChainAndAsset,
+      agentApy
+    };
+  }
 };
 
 // src/agents/zyfai/zyfai.siwx.ts

package/dist/index.d.cts

@@ -21,90 +21,6 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
-type DepositCallback = (smartWalletAddress: string, chainId: number, amount: string) => Promise<`0x${string}`> | `0x${string}`;
-interface IAgent {
-    readonly id: string;
-    readonly supportedChainIds: readonly OwneySupportedChainId[];
-    readonly supportedAssets: readonly AgentSupportedAssets[];
-    disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
-    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
-    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
-    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays): Promise<AccountAgentApy>;
-    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
-    pause(state: ConnectionState, chainId: number): Promise<OwneyAgentStatus>;
-    resume(state: ConnectionState, chainId: number): Promise<OwneyAgentStatus>;
-    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
-    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
-}
-/**
- * Optional filters for per-agent APY lookups.
- * - `tokenSymbol` / `chainId` scope the APY to a specific asset+chain when
- *   the underlying provider supports it (Zyfai). Agents whose backends do
- *   not yet support per-asset APY will ignore these options.
- */
-type AgentApyOptions = {
-    tokenSymbol?: string;
-    chainId?: number;
-};
-
-type AgentId = "zyfai" | "sail";
-type Asset = string;
-type AgentSupportedAsset = {
-    readonly symbol: string;
-    readonly minDepositAmount: string;
-};
-type AgentSupportedAssets = {
-    readonly chainId: number;
-    readonly chain?: string;
-    readonly assets: readonly AgentSupportedAsset[];
-};
-type DailyApyDays = "7D" | "14D" | "30D";
-type HistoryFilters = {
-    fromDate?: string;
-    toDate?: string;
-    /** Max entries returned per call. Defaults to 10. */
-    limit?: number;
-    /** Opaque cursor returned by a previous getHistory call. */
-    cursor?: string;
-};
-type HistoryOptions = {
-    agentId?: AgentId;
-    filters?: HistoryFilters;
-};
-type WithdrawOptions = {
-    asset: Asset;
-    amount?: string;
-    agentId?: AgentId;
-};
-type AccountApyOptions = {
-    agentId?: AgentId;
-    days: DailyApyDays;
-};
-type AgentsApyOptions = {
-    agentId?: AgentId;
-    days: DailyApyDays;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
-     * specific asset+chain. Ignored by agents whose backends do not yet
-     * support per-asset APY.
-     */
-    tokenSymbol?: string;
-    /**
-     * Optional chain id for per-asset APY lookups. Typically paired with
-     * `tokenSymbol`.
-     */
-    chainId?: number;
-};
-type DepositOptions = {
-    amount: string;
-    asset: Asset;
-    depositCallback?: DepositCallback;
-    agentId?: AgentId;
-};
-
 interface OwneyDepositResult {
     txHash: string;
     smartWallet: string;
@@ -177,6 +93,17 @@ interface OwneyAccountApy {
     agentApy: Record<AgentId, AccountAgentApy>;
     apyByChainAndAsset: ApyByChainAndAsset;
 }
+interface AllocationAgentApy {
+    /** Account-wide weighted APY for this agent, as a decimal string. */
+    totalApy: string;
+    apyByChainAndAsset: ApyByChainAndAsset;
+}
+interface OwneyAllocationApy {
+    /** Account-wide weighted APY across all active agents, as a decimal string. */
+    totalApy: string;
+    apyByChainAndAsset: ApyByChainAndAsset;
+    agentApy: Record<AgentId, AllocationAgentApy>;
+}
 type HistoryAction = "Rebalance" | "Deposit" | "Top up" | "Withdraw" | "Earned";
 interface HistoryTransaction {
     txHashes: string[];
@@ -214,11 +141,6 @@ interface OwneyAgentHistory {
     /** Opaque cursor for the next page. Present iff `hasMore === true`. */
     nextCursor?: string;
 }
-interface OwneyAgentStatus {
-    success: boolean;
-    strategy?: string;
-    protocols?: string[];
-}
 interface AgentUserProfile {
     address: string;
     smartWallet: string;
@@ -246,6 +168,88 @@ interface OwneyAgentAllocation {
     agentPositions: Record<AgentId, OwneyPosition[]>;
 }
 
+type DepositCallback = (smartWalletAddress: string, chainId: number, amount: string) => Promise<`0x${string}`> | `0x${string}`;
+interface IAgent {
+    readonly id: string;
+    readonly supportedChainIds: readonly OwneySupportedChainId[];
+    readonly supportedAssets: readonly AgentSupportedAssets[];
+    disconnect(): Promise<void>;
+    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
+    deposit(state: ConnectionState, chainId: number, amount: string, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
+    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
+    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
+    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
+    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays): Promise<AccountAgentApy>;
+    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
+    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
+    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
+}
+/**
+ * Optional filters for per-agent APY lookups.
+ * - `tokenSymbol` / `chainId` scope the APY to a specific asset+chain when
+ *   the underlying provider supports it (Zyfai). Agents whose backends do
+ *   not yet support per-asset APY will ignore these options.
+ */
+type AgentApyOptions = {
+    tokenSymbol?: string;
+    chainId?: number;
+};
+
+type AgentId = "zyfai" | "sail";
+type Asset = string;
+type AgentSupportedAsset = {
+    readonly symbol: string;
+    readonly minDepositAmount: string;
+};
+type AgentSupportedAssets = {
+    readonly chainId: number;
+    readonly chain?: string;
+    readonly assets: readonly AgentSupportedAsset[];
+};
+type DailyApyDays = "7D" | "14D" | "30D";
+type HistoryFilters = {
+    fromDate?: string;
+    toDate?: string;
+    /** Max entries returned per call. Defaults to 10. */
+    limit?: number;
+    /** Opaque cursor returned by a previous getHistory call. */
+    cursor?: string;
+};
+type HistoryOptions = {
+    agentId?: AgentId;
+    filters?: HistoryFilters;
+};
+type WithdrawOptions = {
+    asset: Asset;
+    amount?: string;
+    agentId?: AgentId;
+};
+type AccountApyOptions = {
+    agentId?: AgentId;
+    days: DailyApyDays;
+};
+type AgentsApyOptions = {
+    agentId?: AgentId;
+    days: DailyApyDays;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
+     * specific asset+chain. Ignored by agents whose backends do not yet
+     * support per-asset APY.
+     */
+    tokenSymbol?: string;
+    /**
+     * Optional chain id for per-asset APY lookups. Typically paired with
+     * `tokenSymbol`.
+     */
+    chainId?: number;
+};
+type DepositOptions = {
+    amount: string;
+    asset: Asset;
+    depositCallback?: DepositCallback;
+    agentId?: AgentId;
+};
+
 declare class OwneySDK {
     private agents;
     private activeAgents;
@@ -382,18 +386,6 @@ declare class OwneySDK {
      * @returns {OwneyAgentHistory} `data` (up to `limit` entries), `hasMore`, `nextCursor`.
      */
     getHistory(params?: HistoryOptions): Promise<OwneyAgentHistory>;
-    /**
-     * Pause an agent's automated operations. The agent will stop rebalancing until resumed.
-     * @param agentId - The agent to pause (e.g. "zyfai")
-     * @returns OwneyAgentStatus with success flag
-     */
-    pauseAgent(agentId: AgentId): Promise<OwneyAgentStatus>;
-    /**
-     * Resume an agent's automated operations.
-     * @param agentId - The agent to resume (e.g. "zyfai")
-     * @returns OwneyAgentStatus with success flag
-     */
-    resumeAgent(agentId: AgentId): Promise<OwneyAgentStatus>;
     /**
      * Get the user's profile for a specific agent, or all agents.
      * @param agentId - Optional. Agent to query. Omit for all agents.
@@ -418,6 +410,16 @@ declare class OwneySDK {
      * @returns Object with agent names as keys and allocation percentages as values
      */
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
+    /**
+     * Allocation-weighted APY from the current portfolio: each pool's APY
+     * weighted by the user's position value in it. More accurate per-user than
+     * the historical 30D APY. (ROUT-228)
+     * @param options.agentId - Optional. Scope to one agent. Omit to aggregate
+     *   positions across all active agents.
+     */
+    getAllocationApy({ agentId, }?: {
+        agentId?: AgentId;
+    }): Promise<OwneyAllocationApy>;
 }
 
 type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
@@ -463,4 +465,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };

package/dist/index.d.ts

@@ -21,90 +21,6 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
-type DepositCallback = (smartWalletAddress: string, chainId: number, amount: string) => Promise<`0x${string}`> | `0x${string}`;
-interface IAgent {
-    readonly id: string;
-    readonly supportedChainIds: readonly OwneySupportedChainId[];
-    readonly supportedAssets: readonly AgentSupportedAssets[];
-    disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
-    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
-    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
-    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays): Promise<AccountAgentApy>;
-    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
-    pause(state: ConnectionState, chainId: number): Promise<OwneyAgentStatus>;
-    resume(state: ConnectionState, chainId: number): Promise<OwneyAgentStatus>;
-    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
-    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
-}
-/**
- * Optional filters for per-agent APY lookups.
- * - `tokenSymbol` / `chainId` scope the APY to a specific asset+chain when
- *   the underlying provider supports it (Zyfai). Agents whose backends do
- *   not yet support per-asset APY will ignore these options.
- */
-type AgentApyOptions = {
-    tokenSymbol?: string;
-    chainId?: number;
-};
-
-type AgentId = "zyfai" | "sail";
-type Asset = string;
-type AgentSupportedAsset = {
-    readonly symbol: string;
-    readonly minDepositAmount: string;
-};
-type AgentSupportedAssets = {
-    readonly chainId: number;
-    readonly chain?: string;
-    readonly assets: readonly AgentSupportedAsset[];
-};
-type DailyApyDays = "7D" | "14D" | "30D";
-type HistoryFilters = {
-    fromDate?: string;
-    toDate?: string;
-    /** Max entries returned per call. Defaults to 10. */
-    limit?: number;
-    /** Opaque cursor returned by a previous getHistory call. */
-    cursor?: string;
-};
-type HistoryOptions = {
-    agentId?: AgentId;
-    filters?: HistoryFilters;
-};
-type WithdrawOptions = {
-    asset: Asset;
-    amount?: string;
-    agentId?: AgentId;
-};
-type AccountApyOptions = {
-    agentId?: AgentId;
-    days: DailyApyDays;
-};
-type AgentsApyOptions = {
-    agentId?: AgentId;
-    days: DailyApyDays;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
-     * specific asset+chain. Ignored by agents whose backends do not yet
-     * support per-asset APY.
-     */
-    tokenSymbol?: string;
-    /**
-     * Optional chain id for per-asset APY lookups. Typically paired with
-     * `tokenSymbol`.
-     */
-    chainId?: number;
-};
-type DepositOptions = {
-    amount: string;
-    asset: Asset;
-    depositCallback?: DepositCallback;
-    agentId?: AgentId;
-};
-
 interface OwneyDepositResult {
     txHash: string;
     smartWallet: string;
@@ -177,6 +93,17 @@ interface OwneyAccountApy {
     agentApy: Record<AgentId, AccountAgentApy>;
     apyByChainAndAsset: ApyByChainAndAsset;
 }
+interface AllocationAgentApy {
+    /** Account-wide weighted APY for this agent, as a decimal string. */
+    totalApy: string;
+    apyByChainAndAsset: ApyByChainAndAsset;
+}
+interface OwneyAllocationApy {
+    /** Account-wide weighted APY across all active agents, as a decimal string. */
+    totalApy: string;
+    apyByChainAndAsset: ApyByChainAndAsset;
+    agentApy: Record<AgentId, AllocationAgentApy>;
+}
 type HistoryAction = "Rebalance" | "Deposit" | "Top up" | "Withdraw" | "Earned";
 interface HistoryTransaction {
     txHashes: string[];
@@ -214,11 +141,6 @@ interface OwneyAgentHistory {
     /** Opaque cursor for the next page. Present iff `hasMore === true`. */
     nextCursor?: string;
 }
-interface OwneyAgentStatus {
-    success: boolean;
-    strategy?: string;
-    protocols?: string[];
-}
 interface AgentUserProfile {
     address: string;
     smartWallet: string;
@@ -246,6 +168,88 @@ interface OwneyAgentAllocation {
     agentPositions: Record<AgentId, OwneyPosition[]>;
 }
 
+type DepositCallback = (smartWalletAddress: string, chainId: number, amount: string) => Promise<`0x${string}`> | `0x${string}`;
+interface IAgent {
+    readonly id: string;
+    readonly supportedChainIds: readonly OwneySupportedChainId[];
+    readonly supportedAssets: readonly AgentSupportedAssets[];
+    disconnect(): Promise<void>;
+    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
+    deposit(state: ConnectionState, chainId: number, amount: string, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
+    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
+    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
+    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
+    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays): Promise<AccountAgentApy>;
+    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
+    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
+    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
+}
+/**
+ * Optional filters for per-agent APY lookups.
+ * - `tokenSymbol` / `chainId` scope the APY to a specific asset+chain when
+ *   the underlying provider supports it (Zyfai). Agents whose backends do
+ *   not yet support per-asset APY will ignore these options.
+ */
+type AgentApyOptions = {
+    tokenSymbol?: string;
+    chainId?: number;
+};
+
+type AgentId = "zyfai" | "sail";
+type Asset = string;
+type AgentSupportedAsset = {
+    readonly symbol: string;
+    readonly minDepositAmount: string;
+};
+type AgentSupportedAssets = {
+    readonly chainId: number;
+    readonly chain?: string;
+    readonly assets: readonly AgentSupportedAsset[];
+};
+type DailyApyDays = "7D" | "14D" | "30D";
+type HistoryFilters = {
+    fromDate?: string;
+    toDate?: string;
+    /** Max entries returned per call. Defaults to 10. */
+    limit?: number;
+    /** Opaque cursor returned by a previous getHistory call. */
+    cursor?: string;
+};
+type HistoryOptions = {
+    agentId?: AgentId;
+    filters?: HistoryFilters;
+};
+type WithdrawOptions = {
+    asset: Asset;
+    amount?: string;
+    agentId?: AgentId;
+};
+type AccountApyOptions = {
+    agentId?: AgentId;
+    days: DailyApyDays;
+};
+type AgentsApyOptions = {
+    agentId?: AgentId;
+    days: DailyApyDays;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
+     * specific asset+chain. Ignored by agents whose backends do not yet
+     * support per-asset APY.
+     */
+    tokenSymbol?: string;
+    /**
+     * Optional chain id for per-asset APY lookups. Typically paired with
+     * `tokenSymbol`.
+     */
+    chainId?: number;
+};
+type DepositOptions = {
+    amount: string;
+    asset: Asset;
+    depositCallback?: DepositCallback;
+    agentId?: AgentId;
+};
+
 declare class OwneySDK {
     private agents;
     private activeAgents;
@@ -382,18 +386,6 @@ declare class OwneySDK {
      * @returns {OwneyAgentHistory} `data` (up to `limit` entries), `hasMore`, `nextCursor`.
      */
     getHistory(params?: HistoryOptions): Promise<OwneyAgentHistory>;
-    /**
-     * Pause an agent's automated operations. The agent will stop rebalancing until resumed.
-     * @param agentId - The agent to pause (e.g. "zyfai")
-     * @returns OwneyAgentStatus with success flag
-     */
-    pauseAgent(agentId: AgentId): Promise<OwneyAgentStatus>;
-    /**
-     * Resume an agent's automated operations.
-     * @param agentId - The agent to resume (e.g. "zyfai")
-     * @returns OwneyAgentStatus with success flag
-     */
-    resumeAgent(agentId: AgentId): Promise<OwneyAgentStatus>;
     /**
      * Get the user's profile for a specific agent, or all agents.
      * @param agentId - Optional. Agent to query. Omit for all agents.
@@ -418,6 +410,16 @@ declare class OwneySDK {
      * @returns Object with agent names as keys and allocation percentages as values
      */
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
+    /**
+     * Allocation-weighted APY from the current portfolio: each pool's APY
+     * weighted by the user's position value in it. More accurate per-user than
+     * the historical 30D APY. (ROUT-228)
+     * @param options.agentId - Optional. Scope to one agent. Omit to aggregate
+     *   positions across all active agents.
+     */
+    getAllocationApy({ agentId, }?: {
+        agentId?: AgentId;
+    }): Promise<OwneyAllocationApy>;
 }
 
 type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
@@ -463,4 +465,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, ApyByChainAndAsset, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };

package/dist/index.js

@@ -125,6 +125,18 @@ var CHAIN_ID_TO_NAME = {
   8453: "BASE",
   42161: "ARBITRUM"
 };
+var NAME_TO_CHAIN_ID = Object.entries(
+  CHAIN_ID_TO_NAME
+).reduce((acc, [id, name]) => {
+  acc[name.toLowerCase()] = Number(id);
+  return acc;
+}, {});
+function resolveChainId(chain) {
+  const asNum = Number(chain);
+  if (Number.isFinite(asNum) && asNum > 0)
+    return asNum;
+  return NAME_TO_CHAIN_ID[chain.trim().toLowerCase()] ?? NaN;
+}
 function mapBalances(raw, _chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const portfolioByChain = portfolio.portfolioByChain ?? {};
@@ -273,13 +285,6 @@ function mapEntries(rawEntries, chainId) {
     };
   });
 }
-function mapAgentStatus(raw) {
-  return {
-    success: raw.success,
-    strategy: raw.strategy,
-    protocols: raw.protocols
-  };
-}
 function mapUserProfile(raw, userAddress) {
   return {
     address: userAddress,
@@ -315,6 +320,46 @@ function mapApyByStrategy(raw) {
     detailedApys: hasDetails ? { apyPerAsset } : void 0
   };
 }
+function computeAllocationApy(positions) {
+  let weightedSum = 0;
+  let totalValue = 0;
+  const buckets = {};
+  for (const p of positions) {
+    const apy = p.apy;
+    const value = Number(p.amount);
+    if (typeof apy !== "number" || !Number.isFinite(value) || value <= 0) {
+      continue;
+    }
+    weightedSum += apy * value;
+    totalValue += value;
+    const chainId = resolveChainId(p.chain);
+    const token = p.asset;
+    if (!SUPPORTED_CHAIN_IDS.includes(chainId))
+      continue;
+    if (!SUPPORTED_TOKENS.includes(token))
+      continue;
+    const perAsset = buckets[chainId] ?? {};
+    const cell = perAsset[token] ?? { weightedSum: 0, value: 0 };
+    cell.weightedSum += apy * value;
+    cell.value += value;
+    perAsset[token] = cell;
+    buckets[chainId] = perAsset;
+  }
+  const apyByChainAndAsset = {};
+  for (const [chainKey, perAsset] of Object.entries(buckets)) {
+    const chainId = Number(chainKey);
+    const out = {};
+    for (const [token, cell] of Object.entries(perAsset ?? {})) {
+      if (cell && cell.value > 0) {
+        out[token] = cell.weightedSum / cell.value;
+      }
+    }
+    if (Object.keys(out).length > 0)
+      apyByChainAndAsset[chainId] = out;
+  }
+  const totalApy = totalValue > 0 ? String(weightedSum / totalValue) : "0";
+  return { totalApy, apyByChainAndAsset };
+}
 
 // src/agents/zyfai/zyfai.history-cursor.ts
 var InvalidHistoryCursorError = class extends Error {
@@ -697,17 +742,6 @@ var ZyfaiAgent = class {
       nextCursor
     };
   }
-  // --- IAgent: Agent control ---
-  async pause(state, chainId) {
-    await this.connectAuth(state, chainId);
-    const raw = await this.sdk.pauseAgent();
-    return mapAgentStatus(raw);
-  }
-  async resume(state, chainId) {
-    await this.connectAuth(state, chainId);
-    const raw = await this.sdk.resumeAgent();
-    return mapAgentStatus(raw);
-  }
   async getUserProfile(state, chainId) {
     await this.connectAuth(state, chainId);
     const validChainId = isValidChainId(chainId);
@@ -1072,7 +1106,10 @@ var SPONSORED_USDC_BY_CHAIN = {
   8453: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
   42161: "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
 };
-var VIEM_CHAIN = { 8453: base, 42161: arbitrum };
+var VIEM_CHAIN = {
+  8453: base,
+  42161: arbitrum
+};
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
@@ -1592,10 +1629,7 @@ var OwneySDK = class {
       disabledBalances,
       requested
     );
-    const enabledTotal = enabledBalances.reduce(
-      (s, b) => s + b.balance,
-      0n
-    );
+    const enabledTotal = enabledBalances.reduce((s, b) => s + b.balance, 0n);
     const enabledPlans = afterDrain > 0n ? planProportionalShares(enabledBalances, afterDrain, enabledTotal) : enabledBalances.map(({ agent, balance }) => ({
       agent,
       balance,
@@ -1866,27 +1900,6 @@ var OwneySDK = class {
       nextCursor: hasMore ? encodeMultiAgentCursor(nextCursorMap) : void 0
     };
   }
-  // --- Agent control ---
-  /**
-   * Pause an agent's automated operations. The agent will stop rebalancing until resumed.
-   * @param agentId - The agent to pause (e.g. "zyfai")
-   * @returns OwneyAgentStatus with success flag
-   */
-  async pauseAgent(agentId) {
-    const state = this.requireState();
-    const chainId = this.requireChainId();
-    return this.getAgent(agentId).pause(state, chainId);
-  }
-  /**
-   * Resume an agent's automated operations.
-   * @param agentId - The agent to resume (e.g. "zyfai")
-   * @returns OwneyAgentStatus with success flag
-   */
-  async resumeAgent(agentId) {
-    const state = this.requireState();
-    const chainId = this.requireChainId();
-    return this.getAgent(agentId).resume(state, chainId);
-  }
   /**
    * Get the user's profile for a specific agent, or all agents.
    * @param agentId - Optional. Agent to query. Omit for all agents.
@@ -2016,6 +2029,62 @@ var OwneySDK = class {
       agentPositions: positionsByAgent
     };
   }
+  /**
+   * Allocation-weighted APY from the current portfolio: each pool's APY
+   * weighted by the user's position value in it. More accurate per-user than
+   * the historical 30D APY. (ROUT-228)
+   * @param options.agentId - Optional. Scope to one agent. Omit to aggregate
+   *   positions across all active agents.
+   */
+  async getAllocationApy({
+    agentId
+  } = {}) {
+    const state = this.requireState();
+    const chainId = this.requireChainId();
+    const activeAgents = agentId ? /* @__PURE__ */ new Map([[agentId, this.getAgent(agentId)]]) : this.getActiveAgents();
+    const entries = [...activeAgents.entries()];
+    const balanceResults = await Promise.allSettled(
+      entries.map(async ([id, agent]) => {
+        const b = await agent.getBalances(state, chainId);
+        return [id, b.positions ?? []];
+      })
+    );
+    const agentApy = {};
+    const allPositions = [];
+    let successCount = 0;
+    const agentErrors = {};
+    for (let i = 0; i < balanceResults.length; i++) {
+      const settled = balanceResults[i];
+      const [aid] = entries[i];
+      if (settled.status === "fulfilled") {
+        const [id, positions] = settled.value;
+        const per = computeAllocationApy(positions);
+        agentApy[id] = {
+          totalApy: per.totalApy,
+          apyByChainAndAsset: per.apyByChainAndAsset
+        };
+        allPositions.push(...positions);
+        successCount += 1;
+      } else {
+        const reason = settled.reason;
+        agentErrors[aid] = reason instanceof Error ? reason.message : String(reason);
+        console.error(`getAllocationApy agent "${aid}" failed:`, reason);
+      }
+    }
+    if (successCount === 0) {
+      throw new OwneyError(
+        "ALLOCATION_ALL_FAILED",
+        "Failed to fetch allocation APY: all agents failed.",
+        { agentErrors }
+      );
+    }
+    const overall = computeAllocationApy(allPositions);
+    return {
+      totalApy: overall.totalApy,
+      apyByChainAndAsset: overall.apyByChainAndAsset,
+      agentApy
+    };
+  }
 };
 
 // src/agents/zyfai/zyfai.siwx.ts

package/package.json

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