agentwallet-sdk 3.3.0 → 3.4.0

package/dist/swap/router/rsi/types.d.ts

@@ -1,106 +0,0 @@
-/** Goals — what the agent is optimizing for */
-export interface WalletGoals {
-    /** Primary optimization target */
-    primary: 'maximize-net-output' | 'minimize-gas' | 'maximize-speed' | 'minimize-risk';
-    /** Hard constraints — never violated */
-    constraints: {
-        maxSlippageBps?: number;
-        maxGasUsd?: number;
-        mevProtectionRequired?: boolean;
-        maxSingleSwapUsd?: number;
-    };
-    /** Soft targets — tracked and optimized toward */
-    targets?: {
-        minSavingsVsBaselineBps?: number;
-    };
-}
-/** Directives — standing orders the agent follows */
-export interface WalletDirective {
-    rule: string;
-    enabled: boolean;
-    params: Record<string, number | string | boolean>;
-}
-/** Built-in directive rules */
-export type DirectiveRule = 'prefer-mev-protected' | 'avoid-high-gas' | 'time-based-routing' | 'pair-specific-routing' | 'alert-on-arb-opportunity';
-/** RSI Configuration */
-export interface RSIConfig {
-    enabled: boolean;
-    /** How many outcomes before running a mutation cycle */
-    learningWindow?: number;
-    /** Maximum parameter change per cycle (0-1) */
-    mutationRate?: number;
-    /** Metrics to track */
-    metrics?: RSIMetric[];
-    /** File path or key for persisting state */
-    storageKey?: string;
-}
-export type RSIMetric = 'provider-win-rate' | 'quote-accuracy' | 'latency' | 'failure-rate' | 'gas-accuracy' | 'fill-rate' | 'time-of-day-patterns';
-/** A single recorded swap outcome */
-export interface SwapOutcome {
-    timestamp: number;
-    chain: string;
-    fromToken: string;
-    toToken: string;
-    amount: string;
-    /** All quotes received (not just the winner) */
-    allQuotes: Array<{
-        provider: string;
-        toAmount: string;
-        gasEstimateUsd: number;
-        estimatedTimeMs: number;
-        mevProtected: boolean;
-    }>;
-    /** The provider that was selected */
-    selectedProvider: string;
-    /** Quoted output amount */
-    quotedOutput: string;
-    /** Actual output received (after execution) */
-    actualOutput?: string;
-    /** Actual gas paid in USD */
-    actualGasUsd?: number;
-    /** Whether the swap succeeded */
-    success: boolean;
-    /** Execution time in ms */
-    executionTimeMs?: number;
-}
-/** Learned provider weight adjustments */
-export interface ProviderWeights {
-    /** Global weights (across all pairs) */
-    global: Record<string, number>;
-    /** Per-chain weights */
-    byChain: Record<string, Record<string, number>>;
-    /** Per-pair weights (most specific) */
-    byPair: Record<string, Record<string, number>>;
-}
-/** Result of a mutation cycle */
-export interface MutationResult {
-    cycle: number;
-    timestamp: number;
-    outcomesAnalyzed: number;
-    mutations: Array<{
-        type: string;
-        provider: string;
-        field: string;
-        oldValue: number;
-        newValue: number;
-        reason: string;
-    }>;
-    metrics: {
-        avgSavingsVsBaselineBps: number;
-        providerWinRates: Record<string, number>;
-        avgQuoteAccuracy: number;
-        avgLatencyMs: Record<string, number>;
-    };
-}
-/** Full persisted RSI state */
-export interface RSIState {
-    version: number;
-    lastMutationCycle: number;
-    totalOutcomes: number;
-    providerWeights: ProviderWeights;
-    outcomes: SwapOutcome[];
-    mutationHistory: MutationResult[];
-    directives: WalletDirective[];
-    goals: WalletGoals;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/swap/router/rsi/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/rsi/types.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/rsi/types.js

@@ -1,3 +0,0 @@
-// [MAX-ADDED] SwapRSIEngine types — Recursively Self-Improving swap routing brain
-export {};
-//# sourceMappingURL=types.js.map

package/dist/swap/router/rsi/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/swap/router/rsi/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/swap/router/types.d.ts

@@ -1,120 +0,0 @@
-export type SwapStrategy = 'best-net-output' | 'fastest' | 'lowest-gas' | 'mev-protected';
-/** Unified quote format returned by every provider */
-export interface AggregatorQuote {
-    /** Provider name (e.g. '1inch', '0x', 'paraswap', 'cowswap', 'lifi', 'uniswap', 'jupiter') */
-    provider: string;
-    /** Input token symbol or address */
-    fromToken: string;
-    /** Output token symbol or address */
-    toToken: string;
-    /** Input amount in smallest unit (e.g. wei, lamports) */
-    fromAmount: bigint;
-    /** Expected output amount in smallest unit */
-    toAmount: bigint;
-    /** Gas estimate in wei (0 for Solana/gasless) */
-    gasEstimate: bigint;
-    /** Gas cost in USD */
-    gasEstimateUsd: number;
-    /** Provider platform fee in basis points */
-    platformFee: number;
-    /** toAmount adjusted for gas cost — used for ranking */
-    netOutput: bigint;
-    /** Price impact as percentage (e.g. 0.3 = 0.3%) */
-    priceImpact: number;
-    /** DEX route path (e.g. ['Uniswap V3', 'Curve']) */
-    route: string[];
-    /** Estimated execution time in milliseconds */
-    estimatedTimeMs: number;
-    /** Whether this quote is MEV-protected (CowSwap, 1inch Fusion) */
-    mevProtected: boolean;
-    /** Ready-to-submit transaction data (if provided by aggregator) */
-    txData?: {
-        to: string;
-        data: string;
-        value: bigint;
-        gasLimit: bigint;
-    };
-    /** Token decimals for the output token (needed for USD normalization) */
-    toTokenDecimals?: number;
-    /** USD price of one unit of the output token */
-    toTokenPriceUsd?: number;
-    /** Raw provider response for debugging */
-    metadata?: Record<string, unknown>;
-}
-/** Receipt from waitForTransaction */
-export interface TransactionReceipt {
-    status: 'success' | 'reverted';
-    blockNumber?: number;
-    gasUsed?: bigint;
-    [key: string]: unknown;
-}
-/** Result after executing a swap */
-export interface AggregatorSwapResult {
-    /** Transaction hash (EVM) or signature (Solana) */
-    txHash: string;
-    /** Quote that was executed */
-    quote: AggregatorQuote;
-    /** Chain the swap was executed on */
-    chain: string;
-    /** Receipt (populated when waitForReceipt: true) */
-    receipt?: TransactionReceipt;
-    /** Whether the transaction succeeded (populated when waitForReceipt: true) */
-    success?: boolean;
-}
-/** Parameters for requesting a quote */
-export interface QuoteParams {
-    /** Token symbol or address (e.g. 'USDC' or '0x833589...') */
-    fromToken: string;
-    /** Token symbol or address */
-    toToken: string;
-    /** Human-readable amount (e.g. '100' for 100 USDC) */
-    amount: string;
-    /** Chain name: 'ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'solana', etc. */
-    chain: string;
-    /** Sender address (required by some providers for accurate quotes) */
-    fromAddress?: string;
-    /** Slippage tolerance in bps (default: 50 = 0.5%) */
-    slippageBps?: number;
-}
-/** Provider interface — each aggregator implements this */
-export interface ISwapProvider {
-    /** Provider identifier */
-    readonly name: string;
-    /** Chains this provider supports (lowercase) */
-    readonly supportedChains: string[];
-    /** Fetch a quote; returns null if unsupported or on error */
-    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
-}
-/** SmartSwapRouter configuration */
-export interface SmartSwapConfig {
-    /** Providers to query (default: all available for chain) */
-    providers?: string[];
-    /** Ranking strategy (default: 'best-net-output') */
-    strategy?: SwapStrategy;
-    /** Per-provider timeout in ms (default: 5000) */
-    timeoutMs?: number;
-    /** Default slippage in bps (default: 50) */
-    slippageBps?: number;
-    /** Providers to exclude */
-    excludeProviders?: string[];
-    /** API keys for providers that require them */
-    apiKeys?: {
-        oneInch?: string;
-        zerox?: string;
-    };
-    /** Quote cache TTL in ms (default: 3000, set to 0 to disable) */
-    cacheTtlMs?: number;
-    /** Max consecutive failures before a provider is marked unhealthy (default: 3) */
-    healthMaxFailures?: number;
-    /** Cooldown in ms before retrying an unhealthy provider (default: 60000) */
-    healthCooldownMs?: number;
-    /** [MAX-ADDED] RSI engine config — opt-in self-improvement (default: disabled) */
-    rsi?: import('./rsi/types.js').RSIConfig;
-    /** [MAX-ADDED] Wallet goals for RSI optimization */
-    goals?: import('./rsi/types.js').WalletGoals;
-}
-/** Chain name → chain ID mapping for EVM chains */
-export declare const CHAIN_IDS: Record<string, number>;
-/** Reverse mapping: chain ID → name */
-export declare const CHAIN_NAMES: Record<number, string>;
-//# sourceMappingURL=types.d.ts.map

package/dist/swap/router/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/swap/router/types.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/types.js

@@ -1,16 +0,0 @@
-// [MAX-ADDED] SmartSwapRouter types — multi-DEX meta-aggregation for agentwallet-sdk
-// Separate from the existing Uniswap-specific SwapQuote in ../types.ts
-/** Chain name → chain ID mapping for EVM chains */
-export const CHAIN_IDS = {
-    ethereum: 1,
-    base: 8453,
-    arbitrum: 42161,
-    optimism: 10,
-    polygon: 137,
-    avalanche: 43114,
-    bnb: 56,
-    gnosis: 100,
-};
-/** Reverse mapping: chain ID → name */
-export const CHAIN_NAMES = Object.fromEntries(Object.entries(CHAIN_IDS).map(([k, v]) => [v, k]));
-//# sourceMappingURL=types.js.map

package/dist/swap/router/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/swap/router/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,uEAAuE;AA4HvE,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAA2B;IAC/C,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAA2B,MAAM,CAAC,WAAW,CACnE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAClD,CAAC"}

package/dist/tax/engine.d.ts

@@ -1,131 +0,0 @@
-/**
- * Tax / P&L Engine — Core Engine
- *
- * ⚠️ DISCLAIMER: This module is for informational purposes only.
- * Tax laws are complex, jurisdiction-specific, and change frequently.
- * Always consult a qualified tax professional before filing. This is NOT tax advice.
- *
- * Key rules modeled (US-centric):
- * - Every token swap = taxable disposal of fromToken + acquisition of toToken
- * - Short-term gain: held < 365 days → taxed as ordinary income
- * - Long-term gain: held ≥ 365 days → preferential capital gains rates
- * - Yield received = ordinary income (full rate)
- * - Gas fees = reduce net gain (treated as selling expense)
- * - Wash sale rule: NOT applicable to crypto as of 2024 (no legislation yet)
- * - Fiat on-ramp = establishes cost basis, NOT a taxable event
- * - Bridge (cross-chain move) = generally NOT taxable (same owner, same asset)
- */
-import type { TaxEngineConfig, TaxEvent, TaxLot, RealizedGain, TaxSummary } from './types.js';
-export declare class TaxEngine {
-    private config;
-    private lotManager;
-    private events;
-    private gains;
-    constructor(config?: TaxEngineConfig);
-    /**
-     * Record a swap — the most common taxable event in DeFi.
-     *
-     * A swap creates two sub-events:
-     * 1. Disposal of fromToken (taxable — creates realized gain/loss)
-     * 2. Acquisition of toToken (establishes new cost basis)
-     *
-     * Returns the RealizedGain record, or null if no lots were tracked
-     * (zero cost basis scenario — gain equals full proceeds).
-     */
-    recordSwap(params: {
-        txHash: string;
-        chain: string;
-        timestamp: number;
-        fromToken: string;
-        fromTokenAddress: string;
-        fromAmount: bigint;
-        fromValueUsd: number;
-        toToken: string;
-        toTokenAddress: string;
-        toAmount: bigint;
-        toValueUsd: number;
-        gasPaidUsd?: number;
-    }): RealizedGain | null;
-    /**
-     * Record yield received from a DeFi protocol (taxable as ordinary income).
-     *
-     * Yield is treated as income at the fair market value when received.
-     * The cost basis of the new lot = market value at receipt.
-     */
-    recordYieldReceived(params: {
-        txHash?: string;
-        chain: string;
-        timestamp: number;
-        token: string;
-        tokenAddress: string;
-        amount: bigint;
-        valueUsd: number;
-        protocol: string;
-    }): void;
-    /**
-     * Record a fiat on-ramp (buying crypto with fiat currency).
-     *
-     * This is NOT a taxable event — it establishes the cost basis for future disposals.
-     * The cost basis = amount paid in fiat (USD).
-     */
-    recordFiatOnRamp(params: {
-        txHash?: string;
-        chain: string;
-        timestamp: number;
-        token: string;
-        tokenAddress: string;
-        amount: bigint;
-        paidUsd: number;
-    }): void;
-    /**
-     * Generate an annual tax summary.
-     *
-     * ⚠️ For informational purposes only. Consult a tax professional.
-     */
-    getSummary(year?: number): TaxSummary;
-    /**
-     * Export to CSV format compatible with TurboTax, Koinly, CoinTracker, and similar tools.
-     *
-     * ⚠️ For informational purposes only. Consult a tax professional.
-     * All USD values are formatted to 2 decimal places to prevent CSV parsing issues.
-     */
-    exportCSV(year?: number): string;
-    /**
-     * Export to JSON (for programmatic use, custom reporting, CPA handoff).
-     *
-     * ⚠️ For informational purposes only. Consult a tax professional.
-     */
-    exportJSON(year?: number): {
-        summary: TaxSummary;
-        gains: RealizedGain[];
-        events: TaxEvent[];
-    };
-    /**
-     * Export full engine state for persistence across sessions.
-     */
-    exportState(): {
-        lots: Record<string, TaxLot[]>;
-        events: TaxEvent[];
-        gains: RealizedGain[];
-    };
-    /**
-     * Load state from a previous session (e.g., from database or JSON file).
-     * After loading, new swaps will correctly build on existing lot inventory.
-     */
-    loadState(state: {
-        lots: Record<string, TaxLot[]>;
-        events: TaxEvent[];
-        gains: RealizedGain[];
-    }): void;
-    /**
-     * Determine if a disposal is short-term or long-term.
-     *
-     * Uses the acquisition timestamp of the earliest lot consumed (conservative
-     * for FIFO; oldest lot determines the holding period of the bulk of the disposal).
-     *
-     * Rule: held ≥ 365 days = long-term; held < 365 days = short-term.
-     * If no lots were tracked, defaults to short-term (conservative).
-     */
-    private determineGainType;
-}
-//# sourceMappingURL=engine.d.ts.map

package/dist/tax/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/tax/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAU,EAEX,MAAM,YAAY,CAAC;AAMpB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAsB;gBAEvB,MAAM,GAAE,eAAoB;IAWxC;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,YAAY,GAAG,IAAI;IA4EvB;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IAiCR;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI;IAgCR;;;;OAIG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAwCrC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAoChC;;;;OAIG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;QACzB,OAAO,EAAE,UAAU,CAAC;QACpB,KAAK,EAAE,YAAY,EAAE,CAAC;QACtB,MAAM,EAAE,QAAQ,EAAE,CAAC;KACpB;IAiBD;;OAEG;IACH,WAAW,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,CAAC;QACnB,KAAK,EAAE,YAAY,EAAE,CAAC;KACvB;IAQD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,CAAC;QACnB,KAAK,EAAE,YAAY,EAAE,CAAC;KACvB,GAAG,IAAI;IAQR;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;CAiB1B"}