agentwallet-sdk 5.0.4 → 5.1.0

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

@@ -0,0 +1,120 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,16 @@
+// [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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,131 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/tax/engine.js

@@ -0,0 +1,307 @@
+/**
+ * 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 { LotManager } from './lots.js';
+/** One year in milliseconds */
+const ONE_YEAR_MS = 365 * 24 * 60 * 60 * 1000;
+export class TaxEngine {
+    constructor(config = {}) {
+        this.events = [];
+        this.gains = [];
+        this.config = {
+            method: 'fifo',
+            taxYear: new Date().getFullYear(),
+            jurisdiction: 'US',
+            trackGasFees: true,
+            ...config,
+        };
+        this.lotManager = new LotManager();
+    }
+    /**
+     * 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) {
+        // 1. Dispose of fromToken lots using the configured cost basis method
+        const disposals = this.lotManager.disposeLots({
+            token: params.fromToken,
+            chain: params.chain,
+            amount: params.fromAmount,
+            method: this.config.method,
+        });
+        const totalCostBasis = disposals.reduce((sum, d) => sum + d.costBasisUsed, 0);
+        // 2. Calculate realized gain/loss
+        //    gain = proceeds − cost basis − gas fees paid
+        const gasPaidUsd = this.config.trackGasFees ? (params.gasPaidUsd ?? 0) : 0;
+        const realizedGainUsd = params.fromValueUsd - totalCostBasis - gasPaidUsd;
+        // 3. Determine hold duration → short-term vs long-term
+        const gainType = this.determineGainType(disposals, params.timestamp);
+        // 4. Build the RealizedGain record
+        const gain = {
+            eventId: `swap-${params.txHash}`,
+            txHash: params.txHash,
+            timestamp: params.timestamp,
+            chain: params.chain,
+            token: params.fromToken,
+            amountDisposed: params.fromAmount,
+            proceedsUsd: params.fromValueUsd,
+            costBasisUsd: totalCostBasis,
+            realizedGainUsd,
+            gainType,
+            lotsUsed: disposals.map(d => ({
+                lotId: d.lotId,
+                amountUsed: d.amountUsed,
+                costBasisUsed: d.costBasisUsed,
+            })),
+        };
+        this.gains.push(gain);
+        // 5. Add new lot for toToken — cost basis = fair market value at acquisition
+        this.lotManager.addLot({
+            id: `lot-${params.txHash}-${params.toToken}`,
+            token: params.toToken,
+            tokenAddress: params.toTokenAddress,
+            chain: params.chain,
+            amount: params.toAmount,
+            costBasisUsd: params.toValueUsd,
+            costBasisPerUnit: Number(params.toAmount) > 0
+                ? params.toValueUsd / Number(params.toAmount)
+                : 0,
+            acquiredAt: params.timestamp,
+            acquiredTxHash: params.txHash,
+            acquiredFrom: 'swap',
+        });
+        // 6. Record the TaxEvent
+        this.events.push({
+            id: `event-${params.txHash}`,
+            type: 'swap',
+            timestamp: params.timestamp,
+            txHash: params.txHash,
+            chain: params.chain,
+            disposedToken: params.fromToken,
+            disposedAmount: params.fromAmount,
+            disposedValueUsd: params.fromValueUsd,
+            acquiredToken: params.toToken,
+            acquiredAmount: params.toAmount,
+            acquiredValueUsd: params.toValueUsd,
+            gasPaidUsd,
+        });
+        // Return null if no lots were tracked (pre-existing wallet, zero cost basis)
+        return disposals.length > 0 ? gain : 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) {
+        const lotId = `lot-yield-${params.txHash ?? params.timestamp}-${params.token}`;
+        // Add a lot — cost basis = FMV at receipt (income already recognized)
+        this.lotManager.addLot({
+            id: lotId,
+            token: params.token,
+            tokenAddress: params.tokenAddress,
+            chain: params.chain,
+            amount: params.amount,
+            costBasisUsd: params.valueUsd,
+            costBasisPerUnit: Number(params.amount) > 0
+                ? params.valueUsd / Number(params.amount)
+                : 0,
+            acquiredAt: params.timestamp,
+            acquiredTxHash: params.txHash,
+            acquiredFrom: 'yield-received',
+        });
+        // Record the event (acquiredValueUsd = income amount for getSummary)
+        this.events.push({
+            id: `event-yield-${params.txHash ?? params.timestamp}`,
+            type: 'yield-received',
+            timestamp: params.timestamp,
+            txHash: params.txHash,
+            chain: params.chain,
+            acquiredToken: params.token,
+            acquiredAmount: params.amount,
+            acquiredValueUsd: params.valueUsd,
+            notes: `Yield from ${params.protocol}`,
+        });
+    }
+    /**
+     * 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) {
+        const lotId = `lot-fiat-${params.txHash ?? params.timestamp}-${params.token}`;
+        this.lotManager.addLot({
+            id: lotId,
+            token: params.token,
+            tokenAddress: params.tokenAddress,
+            chain: params.chain,
+            amount: params.amount,
+            costBasisUsd: params.paidUsd,
+            costBasisPerUnit: Number(params.amount) > 0
+                ? params.paidUsd / Number(params.amount)
+                : 0,
+            acquiredAt: params.timestamp,
+            acquiredTxHash: params.txHash,
+            acquiredFrom: 'fiat-on-ramp',
+        });
+        // Record event — not taxable, no gain created
+        this.events.push({
+            id: `event-fiat-${params.txHash ?? params.timestamp}`,
+            type: 'fiat-on-ramp',
+            timestamp: params.timestamp,
+            txHash: params.txHash,
+            chain: params.chain,
+            acquiredToken: params.token,
+            acquiredAmount: params.amount,
+            acquiredValueUsd: params.paidUsd,
+            notes: 'Fiat on-ramp — establishes cost basis, not taxable',
+        });
+    }
+    /**
+     * Generate an annual tax summary.
+     *
+     * ⚠️ For informational purposes only. Consult a tax professional.
+     */
+    getSummary(year) {
+        const targetYear = year ?? this.config.taxYear;
+        const yearStart = new Date(targetYear, 0, 1).getTime();
+        const yearEnd = new Date(targetYear + 1, 0, 1).getTime();
+        const yearGains = this.gains.filter(g => g.timestamp >= yearStart && g.timestamp < yearEnd);
+        const yearEvents = this.events.filter(e => e.timestamp >= yearStart && e.timestamp < yearEnd);
+        const shortTermGain = yearGains
+            .filter(g => g.gainType === 'short-term')
+            .reduce((sum, g) => sum + g.realizedGainUsd, 0);
+        const longTermGain = yearGains
+            .filter(g => g.gainType === 'long-term')
+            .reduce((sum, g) => sum + g.realizedGainUsd, 0);
+        const ordinaryIncome = yearEvents
+            .filter(e => e.type === 'yield-received')
+            .reduce((sum, e) => sum + (e.acquiredValueUsd ?? 0), 0);
+        const totalGasPaid = yearEvents
+            .reduce((sum, e) => sum + (e.gasPaidUsd ?? 0), 0);
+        return {
+            year: targetYear,
+            totalProceeds: yearGains.reduce((sum, g) => sum + g.proceedsUsd, 0),
+            totalCostBasis: yearGains.reduce((sum, g) => sum + g.costBasisUsd, 0),
+            shortTermGain,
+            longTermGain,
+            totalNetGain: shortTermGain + longTermGain,
+            ordinaryIncome,
+            totalGasPaid,
+            taxableEventCount: yearGains.length,
+        };
+    }
+    /**
+     * 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) {
+        const targetYear = year ?? this.config.taxYear;
+        const yearStart = new Date(targetYear, 0, 1).getTime();
+        const yearEnd = new Date(targetYear + 1, 0, 1).getTime();
+        const yearGains = this.gains.filter(g => g.timestamp >= yearStart && g.timestamp < yearEnd);
+        const headers = [
+            'Date',
+            'Type',
+            'Asset',
+            'Proceeds (USD)',
+            'Cost Basis (USD)',
+            'Gain/Loss (USD)',
+            'Gain Type',
+            'Tx Hash',
+            'Chain',
+        ];
+        const rows = yearGains.map(g => [
+            new Date(g.timestamp).toISOString().split('T')[0],
+            'Sale/Swap',
+            g.token,
+            g.proceedsUsd.toFixed(2),
+            g.costBasisUsd.toFixed(2),
+            g.realizedGainUsd.toFixed(2),
+            g.gainType === 'long-term' ? 'Long-term' : 'Short-term',
+            g.txHash ?? '',
+            g.chain,
+        ]);
+        return [headers, ...rows].map(row => row.join(',')).join('\n');
+    }
+    /**
+     * Export to JSON (for programmatic use, custom reporting, CPA handoff).
+     *
+     * ⚠️ For informational purposes only. Consult a tax professional.
+     */
+    exportJSON(year) {
+        const summary = this.getSummary(year);
+        const targetYear = year ?? this.config.taxYear;
+        const yearStart = new Date(targetYear, 0, 1).getTime();
+        const yearEnd = new Date(targetYear + 1, 0, 1).getTime();
+        return {
+            summary,
+            gains: this.gains.filter(g => g.timestamp >= yearStart && g.timestamp < yearEnd),
+            events: this.events.filter(e => e.timestamp >= yearStart && e.timestamp < yearEnd),
+        };
+    }
+    /**
+     * Export full engine state for persistence across sessions.
+     */
+    exportState() {
+        return {
+            lots: this.lotManager.exportState(),
+            events: this.events,
+            gains: this.gains,
+        };
+    }
+    /**
+     * 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) {
+        this.lotManager.loadState(state.lots);
+        this.events = state.events;
+        this.gains = state.gains;
+    }
+    // ─── Private Helpers ───
+    /**
+     * 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).
+     */
+    determineGainType(disposals, disposalTimestamp) {
+        if (disposals.length === 0)
+            return 'short-term';
+        // Find the earliest acquisition date among all lots used in this disposal
+        const earliestAcquiredAt = disposals.reduce((earliest, d) => Math.min(earliest, d.acquiredAt), Infinity);
+        if (earliestAcquiredAt === Infinity)
+            return 'short-term';
+        const holdDurationMs = disposalTimestamp - earliestAcquiredAt;
+        return holdDurationMs >= ONE_YEAR_MS ? 'long-term' : 'short-term';
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/tax/engine.js.map

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

package/dist/tax/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tax / P&L Engine — Barrel Export
+ *
+ * ⚠️ DISCLAIMER: For informational purposes only. Consult a tax professional.
+ */
+export type { TaxEventType, CostBasisMethod, GainType, TaxLot, TaxEvent, RealizedGain, TaxSummary, TaxExportRow, TaxEngineConfig, } from './types.js';
+export { LotManager } from './lots.js';
+export { TaxEngine } from './engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tax/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/tax/index.js

@@ -0,0 +1,12 @@
+/**
+ * @premium This module is part of AgentWallet Premium.
+ * Contact: https://github.com/up2itnow/AgentNexus2 for access.
+ */
+/**
+ * Tax / P&L Engine — Barrel Export
+ *
+ * ⚠️ DISCLAIMER: For informational purposes only. Consult a tax professional.
+ */
+export { LotManager } from './lots.js';
+export { TaxEngine } from './engine.js';
+//# sourceMappingURL=index.js.map

package/dist/tax/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tax/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}