@owney/sdk 0.2.5

package/dist/index.d.cts

@@ -0,0 +1,322 @@
+interface OwneySDKConfig {
+    apiKey: string;
+}
+interface ConnectionState {
+    provider: any;
+    walletAddress: `0x${string}`;
+    chainId: number | null;
+}
+declare const SUPPORTED_TOKENS: readonly ["USDC", "USDT"];
+declare const SUPPORTED_CHAIN_IDS: readonly [8453, 42161];
+declare const SUPPORTED_CHAINS: readonly ["BASE", "ARBITRUM"];
+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, 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): Promise<AgentApy>;
+}
+
+type AgentId = "zyfai" | "sail";
+type Asset = string;
+type AgentSupportedAssets = {
+    readonly chainId: number;
+    readonly chain?: string;
+    readonly assets: readonly string[];
+};
+type DailyApyDays = "7D" | "14D" | "30D";
+type HistoryFilters = {
+    fromDate?: string;
+    toDate?: 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;
+};
+type DepositOptions = {
+    amount: string;
+    asset: Asset;
+    depositCallback: DepositCallback;
+    agentId?: AgentId;
+};
+
+interface OwneyDepositResult {
+    txHash: string;
+    smartWallet: string;
+    amount: string;
+}
+interface OwneyMultiDepositResult {
+    agentResults: Record<string, OwneyDepositResult>;
+}
+interface AgentWithdrawResult {
+    txHash?: string;
+    type: "full" | "partial";
+    amount: string;
+}
+interface OwneyWithdrawResult {
+    agentResult: Record<AgentId, AgentWithdrawResult>;
+}
+interface OwneyToken {
+    chain: OwneySupportedChains;
+    chainId: OwneySupportedChainId;
+    asset: OwneySupportedTokens;
+    amount: string;
+}
+interface AgentBalance {
+    smartWallet?: `0x${string}`;
+    totalBalance: string;
+    tokens: OwneyToken[];
+}
+interface OwneyBalances {
+    totalBalance: string;
+    agentBalances: Record<AgentId, AgentBalance>;
+}
+interface AgentEarnings {
+    smartWallet: `0x${string}`;
+    lifetimeEarnings: number;
+}
+interface OwneyEarnings {
+    totalEarnings: string;
+    agentEarnings: Record<AgentId, AgentEarnings>;
+}
+interface AccountAgentApy {
+    walletAddress: string;
+    weightedApyAfterFee?: number;
+}
+interface OwneyAccountApy {
+    totalApy: string;
+    agentApy: Record<AgentId, AccountAgentApy>;
+}
+type HistoryAction = "Rebalance" | "Deposit" | "Top up" | "Withdraw" | "Earned";
+interface HistoryTransaction {
+    txHashes: string[];
+    chainId?: number;
+    tokenSymbol?: string;
+    amount?: string;
+}
+interface RebalanceLog {
+    fromProtocol: string;
+    toProtocol: string;
+    tokenSymbol: string;
+    amount: string;
+    status: "success" | "failed";
+}
+interface AgentHistoryEntry {
+    agent: AgentId;
+    action: HistoryAction;
+    date: string;
+    oldApy: string | null;
+    newApy: string | null;
+    transactions: HistoryTransaction[];
+    rebalanceLog: RebalanceLog[];
+}
+interface OwneyAgentHistory {
+    data: AgentHistoryEntry[];
+    total: number;
+}
+interface OwneyAgentStatus {
+    success: boolean;
+    strategy?: string;
+    protocols?: string[];
+}
+interface AgentUserProfile {
+    address: string;
+    smartWallet: string;
+    chains: number[];
+    strategy?: string;
+    hasActiveSessionKey: boolean;
+    protocols: string[];
+}
+interface OwneyUserProfile {
+    agentUserProfile: Record<AgentId, AgentUserProfile>;
+}
+interface AgentApy {
+    averageApy: number;
+}
+interface OwneyAgentApy {
+    agentApy: Record<AgentId, AgentApy>;
+}
+interface OwneyRouteResponse {
+    agent: AgentId;
+    chainId: number;
+}
+interface OwneyAgentAllocation {
+    agentAllocation: Record<AgentId, number>;
+}
+
+declare class OwneySDK {
+    private agents;
+    private activeAgents;
+    private state;
+    private apiKey;
+    constructor(config: OwneySDKConfig);
+    /**
+     * Establish connection state for all subsequent SDK calls.
+     * Must be called once before any agent operation that requires a wallet.
+     * @param provider - EIP-1193 wallet provider
+     */
+    connect(provider: any): Promise<void>;
+    /**
+     * Disconnect from all agents and clear connection state.
+     * After calling this, `connect()` must be called again before using agent methods.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if the SDK has an active connection state.
+     * @returns `true` if `connect()` has been called and `disconnect()` has not
+     */
+    isConnected(): boolean;
+    /**
+     * Get the currently active chain ID, set by `activateAgent`.
+     * @returns The active chain ID, or `null` if `activateAgent` has not been called
+     */
+    getActiveChainId(): number | null;
+    private requireState;
+    private requireChainId;
+    private getAgent;
+    private getActiveAgents;
+    /**
+     * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
+     * Deploys the Safe contract and creates a session key if not already set up.
+     * Saves the chainId for use by all subsequent SDK calls.
+     * @param chainId - Target chain ID (e.g. 8453 for Base, 42161 for Arbitrum)
+     * @param agentId - Optional. One or more agent IDs to activate. Omit to activate all agents
+     *   that support the given chainId (incompatible agents are silently skipped).
+     *   If provided, ALL specified agents must support the chainId or the call
+     *   throws before activating any agent.
+     */
+    activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
+    /**
+     * 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.
+     * @param options - Deposit parameters
+     * @param options.amount - Amount to deposit in smallest unit (e.g. "100000000" for 100 USDC)
+     * @param options.asset - Asset symbol to deposit (e.g. "USDC")
+     * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
+     *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
+     *   split amount and smart wallet address — expect multiple wallet prompts.
+     * @param options.agentId - Optional. Target agent. Omit to split equally across all agents.
+     * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
+     */
+    deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
+    private validateAssetSupport;
+    private getEligibleAgents;
+    /**
+     * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
+     * Validates that the asset is supported by the target agent(s) on the active chain.
+     * @param options - Withdraw parameters
+     * @param options.asset - Asset symbol (e.g. "USDC")
+     * @param options.amount - Optional. Amount to withdraw. Omit for full withdrawal.
+     * @param options.agentId - Optional. Target agent. Omit to withdraw from all agents.
+     * @returns {AgentWithdrawResult} for a single agent, or {OwneyWithdrawResult} with per-agent results
+     */
+    withdraw(options: WithdrawOptions): Promise<OwneyWithdrawResult | AgentWithdrawResult>;
+    /**
+     * Get the user's balances for a specific agent, or aggregated across all agents.
+     * @param agentId - Optional. Agent to query. Omit for aggregated balances.
+     * @returns {AgentBalance} for a single agent, or {OwneyBalances} with totalBalance and per-agent breakdown
+     */
+    getBalances(agentId?: AgentId): Promise<OwneyBalances | AgentBalance>;
+    /**
+     * Get the user's on-chain earnings for a specific agent, or aggregated across all agents.
+     * @param agentId - Optional. Agent to query. Omit for aggregated earnings.
+     * @returns {AgentEarnings} for a single agent, or {OwneyEarnings} with totalEarnings and per-agent breakdown
+     */
+    getEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
+    /**
+     * Get the weighted APY for the user's account over a time period.
+     * When querying all agents, the total APY is a balance-weighted average.
+     * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")
+     * @param options.agentId - Optional. Agent to query. Omit for balance-weighted total APY.
+     * @param options.days - Lookback period: "7D", "14D", or "30D"
+     * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
+     */
+    getAccountApy({ agentId, days, }: AccountApyOptions): Promise<OwneyAccountApy | AccountAgentApy>;
+    /**
+     * Get transaction history for a specific agent, or all agents.
+     * @param params - Optional. Contains agentId and filters.
+     * @param params.agentId - Optional. Agent to query. Omit for all agents.
+     * @param params.filters - Optional. Pagination and date filters (fromDate, toDate)
+     * @returns {OwneyAgentHistory} with per-agent history
+     */
+    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.
+     * @returns {AgentUserProfile} for a single agent, or {OwneyUserProfile} with per-agent profiles
+     */
+    getUserProfile(agentId?: AgentId): Promise<OwneyUserProfile | AgentUserProfile>;
+    /**
+     * Get the agent's average APY performance over a time period. Does not require a wallet connection.
+     * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")
+     * @param options.agentId - Optional. Agent to query. Omit for all agents.
+     * @param options.days - Lookback period: "7D", "14D", or "30D"
+     * @returns {AgentApy} for a single agent, or {OwneyAgentApy} with per-agent APY
+     */
+    getAgentApy({ agentId, days, }: AgentsApyOptions): Promise<OwneyAgentApy | AgentApy>;
+    /**
+     * Get the current fund allocation percentages across agents.
+     * @returns Object with agent names as keys and allocation percentages as values
+     */
+    getAgentAllocation(): Promise<OwneyAgentAllocation>;
+}
+
+declare class AgentNotFoundError extends Error {
+    constructor(agentId: string, available: string[]);
+}
+declare class NotConnectedError extends Error {
+    constructor();
+}
+declare class AgentChainIncompatibleError extends Error {
+    readonly incompatibleAgents: Array<{
+        agentId: string;
+        supportedChainIds: readonly number[];
+    }>;
+    readonly connectedChainId: number;
+    constructor(incompatibleAgents: Array<{
+        agentId: string;
+        supportedChainIds: readonly number[];
+    }>, connectedChainId: number);
+}
+
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.d.ts

@@ -0,0 +1,322 @@
+interface OwneySDKConfig {
+    apiKey: string;
+}
+interface ConnectionState {
+    provider: any;
+    walletAddress: `0x${string}`;
+    chainId: number | null;
+}
+declare const SUPPORTED_TOKENS: readonly ["USDC", "USDT"];
+declare const SUPPORTED_CHAIN_IDS: readonly [8453, 42161];
+declare const SUPPORTED_CHAINS: readonly ["BASE", "ARBITRUM"];
+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, 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): Promise<AgentApy>;
+}
+
+type AgentId = "zyfai" | "sail";
+type Asset = string;
+type AgentSupportedAssets = {
+    readonly chainId: number;
+    readonly chain?: string;
+    readonly assets: readonly string[];
+};
+type DailyApyDays = "7D" | "14D" | "30D";
+type HistoryFilters = {
+    fromDate?: string;
+    toDate?: 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;
+};
+type DepositOptions = {
+    amount: string;
+    asset: Asset;
+    depositCallback: DepositCallback;
+    agentId?: AgentId;
+};
+
+interface OwneyDepositResult {
+    txHash: string;
+    smartWallet: string;
+    amount: string;
+}
+interface OwneyMultiDepositResult {
+    agentResults: Record<string, OwneyDepositResult>;
+}
+interface AgentWithdrawResult {
+    txHash?: string;
+    type: "full" | "partial";
+    amount: string;
+}
+interface OwneyWithdrawResult {
+    agentResult: Record<AgentId, AgentWithdrawResult>;
+}
+interface OwneyToken {
+    chain: OwneySupportedChains;
+    chainId: OwneySupportedChainId;
+    asset: OwneySupportedTokens;
+    amount: string;
+}
+interface AgentBalance {
+    smartWallet?: `0x${string}`;
+    totalBalance: string;
+    tokens: OwneyToken[];
+}
+interface OwneyBalances {
+    totalBalance: string;
+    agentBalances: Record<AgentId, AgentBalance>;
+}
+interface AgentEarnings {
+    smartWallet: `0x${string}`;
+    lifetimeEarnings: number;
+}
+interface OwneyEarnings {
+    totalEarnings: string;
+    agentEarnings: Record<AgentId, AgentEarnings>;
+}
+interface AccountAgentApy {
+    walletAddress: string;
+    weightedApyAfterFee?: number;
+}
+interface OwneyAccountApy {
+    totalApy: string;
+    agentApy: Record<AgentId, AccountAgentApy>;
+}
+type HistoryAction = "Rebalance" | "Deposit" | "Top up" | "Withdraw" | "Earned";
+interface HistoryTransaction {
+    txHashes: string[];
+    chainId?: number;
+    tokenSymbol?: string;
+    amount?: string;
+}
+interface RebalanceLog {
+    fromProtocol: string;
+    toProtocol: string;
+    tokenSymbol: string;
+    amount: string;
+    status: "success" | "failed";
+}
+interface AgentHistoryEntry {
+    agent: AgentId;
+    action: HistoryAction;
+    date: string;
+    oldApy: string | null;
+    newApy: string | null;
+    transactions: HistoryTransaction[];
+    rebalanceLog: RebalanceLog[];
+}
+interface OwneyAgentHistory {
+    data: AgentHistoryEntry[];
+    total: number;
+}
+interface OwneyAgentStatus {
+    success: boolean;
+    strategy?: string;
+    protocols?: string[];
+}
+interface AgentUserProfile {
+    address: string;
+    smartWallet: string;
+    chains: number[];
+    strategy?: string;
+    hasActiveSessionKey: boolean;
+    protocols: string[];
+}
+interface OwneyUserProfile {
+    agentUserProfile: Record<AgentId, AgentUserProfile>;
+}
+interface AgentApy {
+    averageApy: number;
+}
+interface OwneyAgentApy {
+    agentApy: Record<AgentId, AgentApy>;
+}
+interface OwneyRouteResponse {
+    agent: AgentId;
+    chainId: number;
+}
+interface OwneyAgentAllocation {
+    agentAllocation: Record<AgentId, number>;
+}
+
+declare class OwneySDK {
+    private agents;
+    private activeAgents;
+    private state;
+    private apiKey;
+    constructor(config: OwneySDKConfig);
+    /**
+     * Establish connection state for all subsequent SDK calls.
+     * Must be called once before any agent operation that requires a wallet.
+     * @param provider - EIP-1193 wallet provider
+     */
+    connect(provider: any): Promise<void>;
+    /**
+     * Disconnect from all agents and clear connection state.
+     * After calling this, `connect()` must be called again before using agent methods.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if the SDK has an active connection state.
+     * @returns `true` if `connect()` has been called and `disconnect()` has not
+     */
+    isConnected(): boolean;
+    /**
+     * Get the currently active chain ID, set by `activateAgent`.
+     * @returns The active chain ID, or `null` if `activateAgent` has not been called
+     */
+    getActiveChainId(): number | null;
+    private requireState;
+    private requireChainId;
+    private getAgent;
+    private getActiveAgents;
+    /**
+     * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
+     * Deploys the Safe contract and creates a session key if not already set up.
+     * Saves the chainId for use by all subsequent SDK calls.
+     * @param chainId - Target chain ID (e.g. 8453 for Base, 42161 for Arbitrum)
+     * @param agentId - Optional. One or more agent IDs to activate. Omit to activate all agents
+     *   that support the given chainId (incompatible agents are silently skipped).
+     *   If provided, ALL specified agents must support the chainId or the call
+     *   throws before activating any agent.
+     */
+    activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
+    /**
+     * 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.
+     * @param options - Deposit parameters
+     * @param options.amount - Amount to deposit in smallest unit (e.g. "100000000" for 100 USDC)
+     * @param options.asset - Asset symbol to deposit (e.g. "USDC")
+     * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
+     *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
+     *   split amount and smart wallet address — expect multiple wallet prompts.
+     * @param options.agentId - Optional. Target agent. Omit to split equally across all agents.
+     * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
+     */
+    deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
+    private validateAssetSupport;
+    private getEligibleAgents;
+    /**
+     * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
+     * Validates that the asset is supported by the target agent(s) on the active chain.
+     * @param options - Withdraw parameters
+     * @param options.asset - Asset symbol (e.g. "USDC")
+     * @param options.amount - Optional. Amount to withdraw. Omit for full withdrawal.
+     * @param options.agentId - Optional. Target agent. Omit to withdraw from all agents.
+     * @returns {AgentWithdrawResult} for a single agent, or {OwneyWithdrawResult} with per-agent results
+     */
+    withdraw(options: WithdrawOptions): Promise<OwneyWithdrawResult | AgentWithdrawResult>;
+    /**
+     * Get the user's balances for a specific agent, or aggregated across all agents.
+     * @param agentId - Optional. Agent to query. Omit for aggregated balances.
+     * @returns {AgentBalance} for a single agent, or {OwneyBalances} with totalBalance and per-agent breakdown
+     */
+    getBalances(agentId?: AgentId): Promise<OwneyBalances | AgentBalance>;
+    /**
+     * Get the user's on-chain earnings for a specific agent, or aggregated across all agents.
+     * @param agentId - Optional. Agent to query. Omit for aggregated earnings.
+     * @returns {AgentEarnings} for a single agent, or {OwneyEarnings} with totalEarnings and per-agent breakdown
+     */
+    getEarnings(agentId?: AgentId): Promise<OwneyEarnings | AgentEarnings>;
+    /**
+     * Get the weighted APY for the user's account over a time period.
+     * When querying all agents, the total APY is a balance-weighted average.
+     * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")
+     * @param options.agentId - Optional. Agent to query. Omit for balance-weighted total APY.
+     * @param options.days - Lookback period: "7D", "14D", or "30D"
+     * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
+     */
+    getAccountApy({ agentId, days, }: AccountApyOptions): Promise<OwneyAccountApy | AccountAgentApy>;
+    /**
+     * Get transaction history for a specific agent, or all agents.
+     * @param params - Optional. Contains agentId and filters.
+     * @param params.agentId - Optional. Agent to query. Omit for all agents.
+     * @param params.filters - Optional. Pagination and date filters (fromDate, toDate)
+     * @returns {OwneyAgentHistory} with per-agent history
+     */
+    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.
+     * @returns {AgentUserProfile} for a single agent, or {OwneyUserProfile} with per-agent profiles
+     */
+    getUserProfile(agentId?: AgentId): Promise<OwneyUserProfile | AgentUserProfile>;
+    /**
+     * Get the agent's average APY performance over a time period. Does not require a wallet connection.
+     * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")
+     * @param options.agentId - Optional. Agent to query. Omit for all agents.
+     * @param options.days - Lookback period: "7D", "14D", or "30D"
+     * @returns {AgentApy} for a single agent, or {OwneyAgentApy} with per-agent APY
+     */
+    getAgentApy({ agentId, days, }: AgentsApyOptions): Promise<OwneyAgentApy | AgentApy>;
+    /**
+     * Get the current fund allocation percentages across agents.
+     * @returns Object with agent names as keys and allocation percentages as values
+     */
+    getAgentAllocation(): Promise<OwneyAgentAllocation>;
+}
+
+declare class AgentNotFoundError extends Error {
+    constructor(agentId: string, available: string[]);
+}
+declare class NotConnectedError extends Error {
+    constructor();
+}
+declare class AgentChainIncompatibleError extends Error {
+    readonly incompatibleAgents: Array<{
+        agentId: string;
+        supportedChainIds: readonly number[];
+    }>;
+    readonly connectedChainId: number;
+    constructor(incompatibleAgents: Array<{
+        agentId: string;
+        supportedChainIds: readonly number[];
+    }>, connectedChainId: number);
+}
+
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };