agentwallet-sdk 3.3.0 → 3.4.0

package/dist/tax/engine.js

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

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

package/dist/tax/index.d.ts

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

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

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

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

package/dist/tax/lots.d.ts

@@ -1,60 +0,0 @@
-/**
- * Tax / P&L Engine — Cost Basis Lot Manager
- *
- * ⚠️ DISCLAIMER: For informational purposes only. Consult a tax professional.
- *
- * Manages tax lots (individual purchase/acquisition records) for each token.
- * Supports FIFO, LIFO, and Specific Identification disposal ordering.
- */
-import type { TaxLot, CostBasisMethod } from './types.js';
-export declare class LotManager {
-    private lots;
-    private getLotKey;
-    /**
-     * Add a new tax lot (e.g., after buying or receiving a token).
-     */
-    addLot(lot: TaxLot): void;
-    /**
-     * Get all lots for a token on a specific chain.
-     */
-    getLots(token: string, chain: string): TaxLot[];
-    /**
-     * Get a specific lot by ID (used by determineGainType for acquisition date lookup).
-     */
-    getLotById(lotId: string): TaxLot | undefined;
-    /**
-     * Dispose of lots using FIFO / LIFO / Specific Identification.
-     * Updates the lot inventory in place and returns an audit trail of disposals.
-     *
-     * If no lots are tracked (pre-existing wallet), returns [] with zero cost basis.
-     */
-    disposeLots(params: {
-        token: string;
-        chain: string;
-        amount: bigint;
-        method: CostBasisMethod;
-        specificLotIds?: string[];
-    }): Array<{
-        lotId: string;
-        amountUsed: bigint;
-        costBasisUsed: number;
-        acquiredAt: number;
-    }>;
-    /**
-     * Get total holdings across all lots for a token on a chain.
-     */
-    getTotalHolding(token: string, chain: string): {
-        amount: bigint;
-        costBasisUsd: number;
-    };
-    /**
-     * Export lot state for persistence (e.g., to database or JSON file).
-     * Note: bigint values will need special serialization if persisting to JSON.
-     */
-    exportState(): Record<string, TaxLot[]>;
-    /**
-     * Load lot state from a previous session.
-     */
-    loadState(state: Record<string, TaxLot[]>): void;
-}
-//# sourceMappingURL=lots.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"lots.d.ts","sourceRoot":"","sources":["../../src/tax/lots.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAoC;IAEhD,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ7C;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,eAAe,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA2D3F;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAQvF;;;OAGG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAQvC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;CAGjD"}

package/dist/tax/lots.js

@@ -1,129 +0,0 @@
-/**
- * Tax / P&L Engine — Cost Basis Lot Manager
- *
- * ⚠️ DISCLAIMER: For informational purposes only. Consult a tax professional.
- *
- * Manages tax lots (individual purchase/acquisition records) for each token.
- * Supports FIFO, LIFO, and Specific Identification disposal ordering.
- */
-export class LotManager {
-    constructor() {
-        this.lots = new Map(); // key: "chain:token"
-    }
-    getLotKey(token, chain) {
-        return `${chain}:${token}`;
-    }
-    /**
-     * Add a new tax lot (e.g., after buying or receiving a token).
-     */
-    addLot(lot) {
-        const key = this.getLotKey(lot.token, lot.chain);
-        const existing = this.lots.get(key) ?? [];
-        existing.push(lot);
-        this.lots.set(key, existing);
-    }
-    /**
-     * Get all lots for a token on a specific chain.
-     */
-    getLots(token, chain) {
-        return this.lots.get(this.getLotKey(token, chain)) ?? [];
-    }
-    /**
-     * Get a specific lot by ID (used by determineGainType for acquisition date lookup).
-     */
-    getLotById(lotId) {
-        for (const lots of this.lots.values()) {
-            const found = lots.find(l => l.id === lotId);
-            if (found)
-                return found;
-        }
-        return undefined;
-    }
-    /**
-     * Dispose of lots using FIFO / LIFO / Specific Identification.
-     * Updates the lot inventory in place and returns an audit trail of disposals.
-     *
-     * If no lots are tracked (pre-existing wallet), returns [] with zero cost basis.
-     */
-    disposeLots(params) {
-        const key = this.getLotKey(params.token, params.chain);
-        let lots = this.lots.get(key) ?? [];
-        if (lots.length === 0) {
-            // No lots tracked — zero cost basis (common for pre-existing wallets)
-            return [];
-        }
-        // Order lots by method
-        let sorted;
-        if (params.method === 'fifo') {
-            sorted = [...lots].sort((a, b) => a.acquiredAt - b.acquiredAt);
-        }
-        else if (params.method === 'lifo') {
-            sorted = [...lots].sort((a, b) => b.acquiredAt - a.acquiredAt);
-        }
-        else {
-            // specific-id: use only the explicitly requested lots
-            sorted = lots.filter(l => params.specificLotIds?.includes(l.id));
-        }
-        const disposals = [];
-        let remaining = params.amount;
-        for (const lot of sorted) {
-            if (remaining === 0n)
-                break;
-            const amountUsed = remaining > lot.amount ? lot.amount : remaining;
-            const fraction = Number(amountUsed) / Number(lot.amount);
-            const costBasisUsed = lot.costBasisUsd * fraction;
-            disposals.push({
-                lotId: lot.id,
-                amountUsed,
-                costBasisUsed,
-                acquiredAt: lot.acquiredAt,
-            });
-            remaining -= amountUsed;
-            // Update the lot inventory
-            if (amountUsed === lot.amount) {
-                // Lot fully consumed — remove it
-                lots = lots.filter(l => l.id !== lot.id);
-            }
-            else {
-                // Lot partially consumed — reduce amount and cost basis; perUnit stays unchanged
-                const idx = lots.findIndex(l => l.id === lot.id);
-                lots[idx] = {
-                    ...lot,
-                    amount: lot.amount - amountUsed,
-                    costBasisUsd: lot.costBasisUsd * (1 - fraction),
-                    costBasisPerUnit: lot.costBasisPerUnit, // unchanged — reflects original purchase price
-                };
-            }
-        }
-        this.lots.set(key, lots);
-        return disposals;
-    }
-    /**
-     * Get total holdings across all lots for a token on a chain.
-     */
-    getTotalHolding(token, chain) {
-        const lots = this.getLots(token, chain);
-        return {
-            amount: lots.reduce((sum, l) => sum + l.amount, 0n),
-            costBasisUsd: lots.reduce((sum, l) => sum + l.costBasisUsd, 0),
-        };
-    }
-    /**
-     * Export lot state for persistence (e.g., to database or JSON file).
-     * Note: bigint values will need special serialization if persisting to JSON.
-     */
-    exportState() {
-        const state = {};
-        for (const [key, lots] of this.lots) {
-            state[key] = lots;
-        }
-        return state;
-    }
-    /**
-     * Load lot state from a previous session.
-     */
-    loadState(state) {
-        this.lots = new Map(Object.entries(state));
-    }
-}
-//# sourceMappingURL=lots.js.map

package/dist/tax/lots.js.map

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

package/dist/tax/types.d.ts

@@ -1,113 +0,0 @@
-/**
- * Tax / P&L Engine — Types
- *
- * ⚠️ DISCLAIMER: This module is for informational purposes only.
- * Tax laws vary by jurisdiction and change frequently. Always consult
- * a qualified tax professional before filing. This is NOT tax advice.
- *
- * Models IRS rules for crypto (US-centric, adaptable):
- * - FIFO / LIFO / Specific Identification cost basis methods
- * - Short-term capital gains: held < 365 days (taxed as ordinary income)
- * - Long-term capital gains: held ≥ 365 days (preferential rates)
- * - Wash sale rule: NOT currently applicable to crypto (as of 2024) — noted here
- *   for awareness. If legislation changes, this engine will need updating.
- * - Yield / interest received = ordinary income (taxed at full rate)
- * - Gas fees = deductible as part of cost basis / selling expenses
- */
-export type TaxEventType = 'swap' | 'deposit' | 'withdrawal' | 'yield-received' | 'bridge' | 'gas-paid' | 'fiat-on-ramp';
-export type CostBasisMethod = 'fifo' | 'lifo' | 'specific-id';
-export type GainType = 'short-term' | 'long-term';
-export interface TaxLot {
-    id: string;
-    token: string;
-    tokenAddress: string;
-    chain: string;
-    amount: bigint;
-    costBasisUsd: number;
-    costBasisPerUnit: number;
-    acquiredAt: number;
-    acquiredTxHash?: string;
-    acquiredFrom: TaxEventType;
-}
-export interface TaxEvent {
-    id: string;
-    type: TaxEventType;
-    timestamp: number;
-    txHash?: string;
-    chain: string;
-    /** For swaps: token disposed of */
-    disposedToken?: string;
-    disposedAmount?: bigint;
-    disposedValueUsd?: number;
-    /** For swaps: token acquired */
-    acquiredToken?: string;
-    acquiredAmount?: bigint;
-    acquiredValueUsd?: number;
-    /** Gas paid in USD */
-    gasPaidUsd?: number;
-    /** Notes */
-    notes?: string;
-}
-export interface RealizedGain {
-    eventId: string;
-    txHash?: string;
-    timestamp: number;
-    chain: string;
-    token: string;
-    /** Amount disposed */
-    amountDisposed: bigint;
-    /** Sale proceeds (market value at disposal) */
-    proceedsUsd: number;
-    /** Cost basis of lots disposed */
-    costBasisUsd: number;
-    /** Realized gain (proceeds - costBasis - fees) */
-    realizedGainUsd: number;
-    /** Short or long term */
-    gainType: GainType;
-    /** Lots used (for audit trail) */
-    lotsUsed: Array<{
-        lotId: string;
-        amountUsed: bigint;
-        costBasisUsed: number;
-    }>;
-}
-export interface TaxSummary {
-    year: number;
-    totalProceeds: number;
-    totalCostBasis: number;
-    /** Short-term gains (< 1 year hold) */
-    shortTermGain: number;
-    /** Long-term gains (≥ 1 year hold) */
-    longTermGain: number;
-    /** Total net gain */
-    totalNetGain: number;
-    /** Total yield/interest received (ordinary income) */
-    ordinaryIncome: number;
-    /** Total gas fees paid (cost basis adjustments) */
-    totalGasPaid: number;
-    /** Number of taxable events */
-    taxableEventCount: number;
-}
-export interface TaxExportRow {
-    date: string;
-    type: string;
-    asset: string;
-    amount: string;
-    proceeds: string;
-    costBasis: string;
-    gain: string;
-    gainType: string;
-    txHash: string;
-    chain: string;
-}
-export interface TaxEngineConfig {
-    /** Cost basis method (default: 'fifo') */
-    method?: CostBasisMethod;
-    /** Tax year for summary (default: current year) */
-    taxYear?: number;
-    /** Your jurisdiction (default: 'US') */
-    jurisdiction?: 'US' | 'EU' | 'UK' | 'OTHER';
-    /** Track gas fees as deductible expenses (default: true) */
-    trackGasFees?: boolean;
-}
-//# sourceMappingURL=types.d.ts.map