@owney/sdk 0.7.25-beta.0 → 0.7.25-beta.1

package/README.md

@@ -19,7 +19,7 @@ const sdk = new OwneySDK({ apiKey: "your-owney-api-key" });
 // Connect with an EIP-1193 wallet provider
 await sdk.connect(provider);
 
-// Activate agents on Base (fetches agent keys on first call)
+// Activate agents on Base (creates and initializes provider wallets as needed)
 await sdk.activateAgent(8453);
 
 // Get balances across all agents
@@ -32,10 +32,10 @@ const balances = await sdk.getBalances();
 
 Create a new SDK instance.
 
-| Param                 | Type                                           | Description                                                                                 |
-| --------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| `config.apiKey`       | `string`                                       | Your Owney API key, used to authenticate with the routing API and fetch agent-specific keys |
-| `config.zyfaiRpcUrls` | `{ 8453?: string; 42161?: string }` (optional) | Per-chain RPC URL overrides used by Zyfai SDK network calls                                 |
+| Param                                   | Type                                                        | Description                                                                                       |
+| --------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `config.apiKey`                         | `string`                                                    | Your Owney API key, used to authenticate with the routing API and fetch agent-specific keys       |
+| `config.zyfaiRpcUrls`                   | `{ 8453?: string; 42161?: string }` (optional)              | Per-chain RPC URL overrides used by Zyfai SDK network calls                                       |
 
 ```typescript
 import { OwneySDK } from "@owney/sdk";
@@ -108,7 +108,7 @@ if (chainId) {
 
 ### `activateAgent(chainId, agentId?)`
 
-Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted. Smart wallets are pre-deployed by the underlying providers, so activation only performs authentication and profile syncing — no deploy or session-key signatures. Saves the chainId for use by all subsequent SDK calls.
+Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted. Activation performs each provider's required setup before deposits are allowed. For Yieldseeker, this creates the user and agent when needed and calls the agent `/deploy` endpoint before any funding transfer. Saves the chainId for use by all subsequent SDK calls.
 
 | Param     | Type                   | Description                                                                   |
 | --------- | ---------------------- | ----------------------------------------------------------------------------- |
@@ -125,7 +125,7 @@ await sdk.activateAgent(42161);
 
 ### `deposit(options)`
 
-Deposit funds into a specific agent, or split equally across all agents if `agentId` is omitted. Validates that the asset is supported by the target agent(s) on the active chain, and per-agent minimum deposit amounts (defined per chain+asset on `agent.supportedAssets[].assets[].minDepositAmount`) are taken into account. When splitting across agents, `depositCallback` is invoked once per final valid agent with that agent's split amount and smart wallet address — expect multiple wallet prompts.
+Deposit funds into a specific agent, or split equally across all agents if `agentId` is omitted. Validates that the asset is supported by the target agent(s) on the active chain, and per-agent minimum deposit amounts (defined per chain+asset on `agent.supportedAssets[].assets[].minDepositAmount`) are taken into account. Custom `depositCallback` implementations run once per final valid agent. The default Permit2 flow signs one recipient-bound batch authorization for every agent share.
 
 | Param                     | Type                 | Description                                                     |
 | ------------------------- | -------------------- | --------------------------------------------------------------- |
@@ -572,12 +572,14 @@ interface AccountAgentApy {
   weightedApyAfterFee?: number;
   weightedApyAfterFeeDetails?: AgentApyDetails;
   apyByChainAndAsset?: ApyByChainAndAsset;
+  history?: ApyHistoryPoint[];
 }
 
 interface OwneyAccountApy {
   totalApy: string;
   agentApy: Record<AgentId, AccountAgentApy>;
   apyByChainAndAsset: ApyByChainAndAsset;
+  history?: ApyHistoryPoint[]; // balance-weighted aggregate daily series
 }
 
 type HistoryAction = "Rebalance" | "Deposit" | "Top up" | "Withdraw" | "Earned";