agentwallet-sdk 3.2.1 → 3.4.0

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

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

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

package/dist/tax/types.js

@@ -1,18 +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 {};
-//# sourceMappingURL=types.js.map

package/dist/tax/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tax/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/yield/index.d.ts

@@ -1,26 +0,0 @@
-/**
- * Yield Vault Module
- *
- * Puts idle agent capital to work across DeFi vaults and RWA tokens.
- *
- * Quick start:
- *   import { YieldVault, YieldRateFetcher } from './yield/index.js';
- *
- *   const vault = new YieldVault({ enabled: true });
- *   const opportunities = await vault.scan({ token: 'USDC', amountUsd: 10_000 });
- *   const best = opportunities.find(o => o.viable);
- *   if (best) {
- *     const tx = vault.buildDepositTx({
- *       protocol: best.best.protocol,
- *       token: 'USDC',
- *       amount: 10_000_000_000n, // 10k USDC (6 decimals)
- *       chain: best.best.chain,
- *       walletAddress: '0xYourAgentWallet',
- *     });
- *     // agent signs + sends tx
- *   }
- */
-export { YieldVault } from './vault.js';
-export { YieldRateFetcher, PROTOCOL_ADDRESSES } from './rates.js';
-export type { YieldProtocol, YieldCategory, YieldPosition, YieldRate, YieldOpportunity, YieldVaultConfig, DepositResult, WithdrawResult, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/yield/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/yield/index.js

@@ -1,25 +0,0 @@
-/**
- * Yield Vault Module
- *
- * Puts idle agent capital to work across DeFi vaults and RWA tokens.
- *
- * Quick start:
- *   import { YieldVault, YieldRateFetcher } from './yield/index.js';
- *
- *   const vault = new YieldVault({ enabled: true });
- *   const opportunities = await vault.scan({ token: 'USDC', amountUsd: 10_000 });
- *   const best = opportunities.find(o => o.viable);
- *   if (best) {
- *     const tx = vault.buildDepositTx({
- *       protocol: best.best.protocol,
- *       token: 'USDC',
- *       amount: 10_000_000_000n, // 10k USDC (6 decimals)
- *       chain: best.best.chain,
- *       walletAddress: '0xYourAgentWallet',
- *     });
- *     // agent signs + sends tx
- *   }
- */
-export { YieldVault } from './vault.js';
-export { YieldRateFetcher, PROTOCOL_ADDRESSES } from './rates.js';
-//# sourceMappingURL=index.js.map

package/dist/yield/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/yield/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/yield/rates.d.ts

@@ -1,114 +0,0 @@
-/**
- * Yield Rate Fetcher
- *
- * Fetches current APY rates from DeFi protocols and RWA token sources.
- * When a provider is not supplied (tests, offline, no RPC), returns accurate
- * mock rates based on current market conditions (~Q1 2026).
- *
- * DeFi risk scores (0-100, lower = safer):
- *   Aave V3:      15 — battle-tested, billions TVL, audited
- *   Compound V3:  20 — mature, lower TVL than Aave
- *   Morpho Blue:  25 — newer architecture, peer-to-peer matching
- *
- * RWA risk scores:
- *   USDC-collateralized RWA: 10–20 (T-bill backed, regulated issuers)
- */
-import { ethers } from 'ethers';
-import type { YieldRate, YieldVaultConfig } from './types.js';
-export declare const PROTOCOL_ADDRESSES: {
-    readonly 'aave-v3': {
-        readonly ethereum: {
-            readonly pool: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2";
-            readonly dataProvider: "0x7B4EB56E7CD4b454BA8ff71E4518426369a138a3";
-        };
-        readonly base: {
-            readonly pool: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5";
-            readonly dataProvider: "0x2d8A3C5677189723C4cB8873CfC9C8976ddf54D8";
-        };
-        readonly arbitrum: {
-            readonly pool: "0x794a61358D6845594F94dc1DB02A252b5b4814aD";
-            readonly dataProvider: "0x69FA688f1Dc47d4B5d8029D5a35FB7a548310654";
-        };
-    };
-    readonly 'compound-v3': {
-        readonly ethereum: {
-            readonly comet: "0xc3d688B66703497DAA19211EEdff47f25384cdc3";
-        };
-        readonly base: {
-            readonly comet: "0xb125E6687d4313864e53df431d5425969c15Eb2";
-        };
-        readonly arbitrum: {
-            readonly comet: "0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf";
-        };
-    };
-    readonly usdy: {
-        readonly ethereum: {
-            readonly token: "0x96F6eF951840721AdBF7B6A2Ce4A795F61F8f60a";
-        };
-        readonly arbitrum: {
-            readonly token: "0x7fAb54cb9d83BDAF0e94b1C2bA96F64Fb7D86b7A";
-        };
-    };
-};
-export declare class YieldRateFetcher {
-    /**
-     * Fetch current supply APY for Aave V3.
-     *
-     * On-chain: queries getReserveData() on the Aave Data Provider.
-     * currentLiquidityRate is in ray format (1e27 = 100% APY).
-     * APY = (1 + rate / 1e27 / SECONDS_PER_YEAR)^SECONDS_PER_YEAR - 1
-     *
-     * Falls back to accurate mock rates when provider is not available.
-     *
-     * Risk score: 15 (battle-tested, billions TVL, multiple audits)
-     */
-    fetchAaveRate(token: string, chain: string, provider?: ethers.JsonRpcProvider): Promise<YieldRate>;
-    /**
-     * Fetch current supply APY for Compound V3.
-     *
-     * On-chain: calls getSupplyRate(utilization) on the Comet contract.
-     * supplyRate is per-second (18 decimals).
-     * APY = (1 + supplyRate / 1e18)^SECONDS_PER_YEAR - 1
-     *
-     * Risk score: 20 (mature protocol, lower TVL than Aave)
-     */
-    fetchCompoundRate(token: string, chain: string, provider?: ethers.JsonRpcProvider): Promise<YieldRate>;
-    /**
-     * Fetch APY for Morpho Blue.
-     *
-     * Morpho Blue uses peer-to-peer rate matching — on-chain query is complex
-     * (varies per market). We use well-calibrated estimates based on current
-     * market conditions. Real implementation would query Morpho's API or
-     * aggregate across market IDs.
-     *
-     * Risk score: 25 (newer architecture, audited, growing TVL)
-     */
-    fetchMorphoRate(token: string, chain: string, _provider?: ethers.JsonRpcProvider): Promise<YieldRate>;
-    /**
-     * Get current RWA token rates.
-     *
-     * RWA tokens are backed by tokenized T-bills and short-duration government bonds.
-     * Rates (~4.8–5.2% APY as of Q1 2026) track the Fed Funds rate.
-     *
-     * Agent-friendliness matrix:
-     * ┌──────────┬──────────────┬───────────┬───────────────────────────────────┐
-     * │ Protocol │ KYC Required │ Min Dep.  │ Chains                            │
-     * ├──────────┼──────────────┼───────────┼───────────────────────────────────┤
-     * │ BUIDL    │ ✅ YES       │ $1,000,000│ Ethereum only                     │
-     * │ OUSG     │ ✅ YES       │ ~$5,000   │ Ethereum, Base                    │
-     * │ USDY     │ ❌ NO        │ ~$500     │ Ethereum, Arbitrum (best for bots)│
-     * │ USYC     │ ❌ NO        │ ~$1,000   │ Ethereum, Base                    │
-     * │ wUSTB    │ ❌ NO        │ ~$100     │ Ethereum                          │
-     * └──────────┴──────────────┴───────────┴───────────────────────────────────┘
-     *
-     * ⚠️ BUIDL: $1M minimum is a HARD requirement. Do not recommend to retail agents.
-     */
-    fetchRWARates(chains: string[]): Promise<YieldRate[]>;
-    /**
-     * Fetch all rates across DeFi protocols and RWA tokens.
-     * Applies config filters (KYC, chains, tokens).
-     * Returns sorted by APY descending.
-     */
-    fetchAllRates(config: YieldVaultConfig): Promise<YieldRate[]>;
-}
-//# sourceMappingURL=rates.d.ts.map

package/dist/yield/rates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../../src/yield/rates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBrB,CAAC;AAsDX,qBAAa,gBAAgB;IAC3B;;;;;;;;;;OAUG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,eAAe,GAChC,OAAO,CAAC,SAAS,CAAC;IAuCrB;;;;;;;;OAQG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,eAAe,GAChC,OAAO,CAAC,SAAS,CAAC;IAoCrB;;;;;;;;;OASG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,eAAe,GACjC,OAAO,CAAC,SAAS,CAAC;IAmBrB;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAgG3D;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAsCpE"}