amped-defi 1.0.0

package/dist/policy/policyEngine.js

@@ -0,0 +1,322 @@
+/**
+ * Policy Engine
+ *
+ * Enforces security policies for DeFi operations including:
+ * - Spend limits per transaction and daily
+ * - Allowed chain and token allowlists
+ * - Blocked recipient addresses
+ * - Maximum slippage tolerance
+ * - Simulation requirements
+ */
+import { normalizeChainId } from '../wallet/types';
+/**
+ * Policy Engine class for enforcing security constraints
+ */
+export class PolicyEngine {
+    config;
+    constructor(policyId) {
+        this.config = this.loadPolicyConfig(policyId);
+    }
+    /**
+     * Load policy configuration from environment
+     *
+     * @param policyId - Optional policy profile ID for custom limits
+     * @returns The policy configuration
+     */
+    loadPolicyConfig(policyId) {
+        const limitsJson = process.env.AMPED_OC_LIMITS_JSON;
+        if (!limitsJson) {
+            return {};
+        }
+        try {
+            const allConfigs = JSON.parse(limitsJson);
+            // If policyId is specified, use that config; otherwise use 'default' or empty
+            const config = policyId
+                ? allConfigs[policyId]
+                : allConfigs['default'] || allConfigs;
+            if (policyId && !config) {
+                return allConfigs['default'] || {};
+            }
+            return config || {};
+        }
+        catch (_error) {
+            return {};
+        }
+    }
+    /**
+     * Check if a chain is allowed
+     *
+     * @param chainId - The chain ID to check
+     * @returns Policy check result
+     */
+    checkChainAllowed(chainId) {
+        const { allowedChains } = this.config;
+        if (allowedChains && allowedChains.length > 0) {
+            const normalizedChain = normalizeChainId(chainId);
+            if (!allowedChains.includes(normalizedChain)) {
+                return {
+                    allowed: false,
+                    reason: `Chain not allowed: ${chainId}. Allowed chains: ${allowedChains.join(', ')}`,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check if a token is allowed on a specific chain
+     *
+     * @param chainId - The chain ID
+     * @param token - The token address or symbol
+     * @returns Policy check result
+     */
+    checkTokenAllowed(chainId, token) {
+        const { allowedTokensByChain } = this.config;
+        if (allowedTokensByChain) {
+            const normalizedChainForTokens = normalizeChainId(chainId);
+            const allowedTokens = allowedTokensByChain[normalizedChainForTokens];
+            if (allowedTokens && allowedTokens.length > 0) {
+                if (!allowedTokens.includes(token)) {
+                    return {
+                        allowed: false,
+                        reason: `Token not allowed on ${chainId}: ${token}. Allowed tokens: ${allowedTokens.join(', ')}`,
+                    };
+                }
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check if a recipient is blocked
+     *
+     * @param recipient - The recipient address
+     * @returns Policy check result
+     */
+    checkRecipientNotBlocked(recipient) {
+        const { blockedRecipients } = this.config;
+        if (blockedRecipients && blockedRecipients.length > 0) {
+            if (blockedRecipients.includes(recipient.toLowerCase())) {
+                return {
+                    allowed: false,
+                    reason: `Recipient is blocked: ${recipient}`,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check bridge amount against limits
+     *
+     * @param token - The token address or symbol
+     * @param amount - The amount in human-readable units
+     * @returns Policy check result
+     */
+    checkBridgeAmount(token, amount) {
+        const { maxBridgeAmountToken } = this.config;
+        if (maxBridgeAmountToken) {
+            const maxAmount = maxBridgeAmountToken[token];
+            if (maxAmount !== undefined) {
+                const amountNum = parseFloat(amount);
+                if (amountNum > maxAmount) {
+                    return {
+                        allowed: false,
+                        reason: `Bridge amount ${amount} exceeds maximum ${maxAmount} for token ${token}`,
+                        details: { maxAllowed: maxAmount, requested: amountNum },
+                    };
+                }
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check a bridge operation against all policies
+     *
+     * @param operation - The bridge operation to validate
+     * @returns Policy check result
+     */
+    async checkBridge(operation) {
+        const { srcChainId, dstChainId, srcToken, dstToken, amount, recipient } = operation;
+        // Check source chain
+        const srcChainCheck = this.checkChainAllowed(srcChainId);
+        if (!srcChainCheck.allowed)
+            return srcChainCheck;
+        // Check destination chain
+        const dstChainCheck = this.checkChainAllowed(dstChainId);
+        if (!dstChainCheck.allowed)
+            return dstChainCheck;
+        // Check source token
+        const srcTokenCheck = this.checkTokenAllowed(srcChainId, srcToken);
+        if (!srcTokenCheck.allowed)
+            return srcTokenCheck;
+        // Check destination token
+        const dstTokenCheck = this.checkTokenAllowed(dstChainId, dstToken);
+        if (!dstTokenCheck.allowed)
+            return dstTokenCheck;
+        // Check amount limits
+        const amountCheck = this.checkBridgeAmount(srcToken, amount);
+        if (!amountCheck.allowed)
+            return amountCheck;
+        // Check recipient if specified
+        if (recipient) {
+            const recipientCheck = this.checkRecipientNotBlocked(recipient);
+            if (!recipientCheck.allowed)
+                return recipientCheck;
+        }
+        return { allowed: true };
+    }
+    /**
+     * Get the current policy configuration
+     * @returns The policy configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get available policy IDs from the configuration
+     * @returns Array of available policy IDs
+     */
+    getAvailablePolicies() {
+        const limitsJson = process.env.AMPED_OC_LIMITS_JSON;
+        if (!limitsJson)
+            return [];
+        try {
+            const allConfigs = JSON.parse(limitsJson);
+            return Object.keys(allConfigs);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================================================
+    // Swap Policy Checks
+    // ============================================================================
+    /**
+     * Check swap input amount against USD limits
+     */
+    checkSwapAmount(inputAmount, srcToken) {
+        const { maxSwapInputUsd, maxSwapInputToken } = this.config;
+        // Check per-token limit if configured
+        if (maxSwapInputToken) {
+            const maxTokenAmount = maxSwapInputToken[srcToken];
+            if (maxTokenAmount !== undefined) {
+                const amountNum = parseFloat(inputAmount);
+                if (amountNum > maxTokenAmount) {
+                    return {
+                        allowed: false,
+                        reason: `Swap input amount ${inputAmount} exceeds maximum ${maxTokenAmount} for token ${srcToken}`,
+                        details: { maxAllowed: maxTokenAmount, requested: amountNum },
+                    };
+                }
+            }
+        }
+        // Note: USD limit check would require price oracle integration
+        // For now, we skip enforcement without prices
+        return { allowed: true };
+    }
+    /**
+     * Check slippage against maximum allowed
+     */
+    checkSlippage(slippageBps) {
+        const { maxSlippageBps } = this.config;
+        if (maxSlippageBps !== undefined && slippageBps > maxSlippageBps) {
+            return {
+                allowed: false,
+                reason: `Slippage ${slippageBps} bps exceeds maximum allowed ${maxSlippageBps} bps`,
+                details: { maxAllowed: maxSlippageBps, requested: slippageBps },
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check a swap operation against all policies
+     */
+    async checkSwap(params) {
+        const { srcChainId, dstChainId, srcToken, dstToken, inputAmount, slippageBps } = params;
+        // Check source chain
+        const srcChainCheck = this.checkChainAllowed(srcChainId);
+        if (!srcChainCheck.allowed)
+            return srcChainCheck;
+        // Check destination chain
+        const dstChainCheck = this.checkChainAllowed(dstChainId);
+        if (!dstChainCheck.allowed)
+            return dstChainCheck;
+        // Check source token
+        const srcTokenCheck = this.checkTokenAllowed(srcChainId, srcToken);
+        if (!srcTokenCheck.allowed)
+            return srcTokenCheck;
+        // Check destination token
+        const dstTokenCheck = this.checkTokenAllowed(dstChainId, dstToken);
+        if (!dstTokenCheck.allowed)
+            return dstTokenCheck;
+        // Check swap amount limits
+        const amountCheck = this.checkSwapAmount(inputAmount, srcToken);
+        if (!amountCheck.allowed)
+            return amountCheck;
+        // Check slippage
+        const slippageCheck = this.checkSlippage(slippageBps);
+        if (!slippageCheck.allowed)
+            return slippageCheck;
+        return { allowed: true };
+    }
+    // ============================================================================
+    // Money Market Policy Checks
+    // ============================================================================
+    /**
+     * Check borrow amount against limits
+     */
+    checkBorrowAmount(token, amount, amountUsd) {
+        const { maxBorrowUsd, maxBorrowToken } = this.config;
+        // Check per-token limit if configured
+        if (maxBorrowToken) {
+            const maxTokenAmount = maxBorrowToken[token];
+            if (maxTokenAmount !== undefined) {
+                const amountNum = parseFloat(amount);
+                if (amountNum > maxTokenAmount) {
+                    return {
+                        allowed: false,
+                        reason: `Borrow amount ${amount} exceeds maximum ${maxTokenAmount} for token ${token}`,
+                        details: { maxAllowed: maxTokenAmount, requested: amountNum },
+                    };
+                }
+            }
+        }
+        // Check USD limit if amountUsd is provided
+        if (maxBorrowUsd !== undefined && amountUsd !== undefined) {
+            if (amountUsd > maxBorrowUsd) {
+                return {
+                    allowed: false,
+                    reason: `Borrow amount $${amountUsd} exceeds maximum $${maxBorrowUsd}`,
+                    details: { maxAllowed: maxBorrowUsd, requested: amountUsd },
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check a money market operation against all policies
+     */
+    async checkMoneyMarket(params) {
+        const { chainId, dstChainId, token, amount, amountUsd, operation } = params;
+        // Check source chain
+        const chainCheck = this.checkChainAllowed(chainId);
+        if (!chainCheck.allowed)
+            return chainCheck;
+        // Check destination chain if cross-chain operation
+        if (dstChainId) {
+            const dstChainCheck = this.checkChainAllowed(dstChainId);
+            if (!dstChainCheck.allowed)
+                return dstChainCheck;
+        }
+        // Check token
+        const tokenCheck = this.checkTokenAllowed(chainId, token);
+        if (!tokenCheck.allowed)
+            return tokenCheck;
+        // Operation-specific checks
+        if (operation === 'borrow') {
+            const borrowCheck = this.checkBorrowAmount(token, amount, amountUsd);
+            if (!borrowCheck.allowed)
+                return borrowCheck;
+        }
+        return { allowed: true };
+    }
+}
+//# sourceMappingURL=policyEngine.js.map

package/dist/policy/policyEngine.js.map

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

package/dist/providers/spokeProviderFactory.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spoke Provider Factory
+ *
+ * Creates spoke providers for SODAX operations.
+ * Supports both local key signing and Bankr API execution.
+ *
+ * Flow:
+ * 1. Resolve wallet by nickname using WalletManager
+ * 2. Check if wallet supports requested chain
+ * 3. For local wallets: use SDK's EvmWalletProvider
+ * 4. For Bankr wallets: use BankrWalletProvider (submits to Bankr API)
+ */
+import { type SpokeProvider } from '@sodax/sdk';
+/**
+ * Get a spoke provider for the given wallet and chain
+ * Returns cached provider if available, otherwise creates a new one
+ *
+ * @param walletId - The wallet identifier/nickname
+ * @param chainId - The chain identifier
+ * @param raw - If true, still creates full provider (raw mode not yet supported)
+ * @returns The spoke provider instance
+ */
+export declare function getSpokeProvider(walletId: string, chainId: string, raw?: boolean): Promise<SpokeProvider>;
+/**
+ * Clear the provider cache
+ * Useful for testing or when wallet configuration changes
+ */
+export declare function clearProviderCache(): void;
+/**
+ * Get cache statistics
+ * @returns Object with cache size and keys
+ */
+export declare function getCacheStats(): {
+    size: number;
+    keys: string[];
+};
+export type { SpokeProvider };
+//# sourceMappingURL=spokeProviderFactory.d.ts.map

package/dist/providers/spokeProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spokeProviderFactory.d.ts","sourceRoot":"","sources":["../../src/providers/spokeProviderFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AA6MpB;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,UAAQ,GACV,OAAO,CAAC,aAAa,CAAC,CAoBxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKhE;AAGD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/providers/spokeProviderFactory.js

@@ -0,0 +1,212 @@
+/**
+ * Spoke Provider Factory
+ *
+ * Creates spoke providers for SODAX operations.
+ * Supports both local key signing and Bankr API execution.
+ *
+ * Flow:
+ * 1. Resolve wallet by nickname using WalletManager
+ * 2. Check if wallet supports requested chain
+ * 3. For local wallets: use SDK's EvmWalletProvider
+ * 4. For Bankr wallets: use BankrWalletProvider (submits to Bankr API)
+ */
+// Official SDK wallet provider
+import { EvmWalletProvider } from '@sodax/wallet-sdk-core';
+// Import spoke providers and chain config from SDK
+import { EvmSpokeProvider, SonicSpokeProvider } from '@sodax/sdk';
+// Import chain configuration from types
+import { spokeChainConfig } from '@sodax/types';
+// Import wallet management
+import { getWalletManager, createBankrWalletProvider } from '../wallet';
+import { getWalletAdapter } from '../wallet/skillWalletAdapter';
+import { normalizeChainId, getBankrChainId } from '../wallet/types';
+// Cache for providers: Map<cacheKey, SpokeProvider>
+const providerCache = new Map();
+// Sonic hub chain identifier
+const SONIC_CHAIN_ID = 'sonic';
+// Chain ID mapping for SDK (some chains need specific format)
+const CHAIN_ID_MAP = {
+    'sonic': 'sonic',
+    'ethereum': 'ethereum',
+    'arbitrum': '0xa4b1.arbitrum',
+    'optimism': '0xa.optimism',
+    'base': '0x2105.base',
+    'polygon': '0x89.polygon',
+    'bsc': '0x38.bsc',
+    'avalanche': '0xa86a.avax',
+    'lightlink': 'lightlink',
+    'hyperevm': 'hyper',
+    'hyper': 'hyper',
+};
+/**
+ * Get RPC URL for a chain
+ */
+async function getRpcUrl(chainId) {
+    const skillAdapter = getWalletAdapter();
+    return skillAdapter.getRpcUrl(chainId);
+}
+/**
+ * Get the SDK chain ID for a given chain
+ */
+function getSdkChainId(chainId) {
+    return (CHAIN_ID_MAP[chainId] || chainId);
+}
+/**
+ * Validate that wallet supports the requested chain
+ */
+function validateChainSupport(wallet, chainId) {
+    const normalizedForWallet = normalizeChainId(chainId);
+    if (!wallet.supportsChain(normalizedForWallet)) {
+        throw new Error(`Wallet "${wallet.nickname}" doesn't support chain "${chainId}". ` +
+            `Supported chains: ${wallet.supportedChains.join(', ')}. ` +
+            `Try a different wallet.`);
+    }
+}
+/**
+ * Create a spoke provider for local key signing
+ */
+async function createLocalSpokeProvider(wallet, chainId, rpcUrl) {
+    if (!wallet.getPrivateKey) {
+        throw new Error(`Wallet "${wallet.nickname}" does not support local signing`);
+    }
+    const privateKey = await wallet.getPrivateKey();
+    const sdkChainId = getSdkChainId(chainId);
+    // Get chain config from SDK
+    const chainConfig = spokeChainConfig[sdkChainId];
+    if (!chainConfig) {
+        throw new Error(`Chain config not found for: ${sdkChainId}. Available: ${Object.keys(spokeChainConfig).join(', ')}`);
+    }
+    // Create wallet provider using official SDK
+    const walletProvider = new EvmWalletProvider({
+        privateKey,
+        chainId: sdkChainId,
+        rpcUrl: rpcUrl,
+    });
+    // Use SonicSpokeProvider for Sonic hub chain, EvmSpokeProvider for others
+    if (chainId === SONIC_CHAIN_ID) {
+        console.log('[spokeProviderFactory] Creating SonicSpokeProvider', {
+            wallet: wallet.nickname,
+            chainId,
+        });
+        return new SonicSpokeProvider(walletProvider, chainConfig, rpcUrl);
+    }
+    else {
+        console.log('[spokeProviderFactory] Creating EvmSpokeProvider', {
+            wallet: wallet.nickname,
+            chainId,
+            sdkChainId,
+        });
+        return new EvmSpokeProvider(walletProvider, chainConfig, rpcUrl);
+    }
+}
+/**
+ * Create a spoke provider for Bankr wallet
+ * Uses BankrWalletProvider which submits transactions to Bankr API
+ */
+async function createBankrSpokeProvider(wallet, chainId, rpcUrl) {
+    const sdkChainId = getSdkChainId(chainId);
+    // Normalize chain ID for Bankr lookup (0x2105.base -> base)
+    const normalizedChainId = normalizeChainId(chainId);
+    const numericChainId = getBankrChainId(normalizedChainId);
+    console.log('[spokeProviderFactory] Bankr chain resolution', {
+        input: chainId,
+        normalized: normalizedChainId,
+        numeric: numericChainId,
+    });
+    // Get chain config from SDK
+    const chainConfig = spokeChainConfig[sdkChainId];
+    if (!chainConfig) {
+        throw new Error(`Chain config not found for: ${sdkChainId}`);
+    }
+    // Get Bankr API key from environment
+    const apiKey = process.env.BANKR_API_KEY;
+    if (!apiKey) {
+        throw new Error('BANKR_API_KEY environment variable not set');
+    }
+    // Get the Bankr wallet address (cached after first call)
+    const walletAddress = await wallet.getAddress();
+    // Create BankrWalletProvider which implements IEvmWalletProvider
+    const walletProvider = createBankrWalletProvider({
+        apiKey,
+        apiUrl: process.env.BANKR_API_URL,
+        chainId: numericChainId,
+        rpcUrl,
+        cachedAddress: walletAddress,
+    });
+    console.log('[spokeProviderFactory] Creating EvmSpokeProvider with Bankr backend', {
+        wallet: wallet.nickname,
+        chainId,
+        sdkChainId,
+        address: walletAddress?.slice(0, 10) + '...',
+    });
+    // Use standard EvmSpokeProvider with our BankrWalletProvider
+    // The SDK doesn't care how transactions are signed - it just calls the interface methods
+    return new EvmSpokeProvider(walletProvider, // BankrWalletProvider implements IEvmWalletProvider
+    chainConfig, rpcUrl);
+}
+/**
+ * Create a spoke provider for the given wallet and chain
+ *
+ * @param walletId - Wallet nickname (e.g., "main", "bankr", "trading")
+ * @param chainId - Chain identifier (e.g., "ethereum", "base")
+ */
+async function createSpokeProvider(walletId, chainId) {
+    // Get wallet from unified manager
+    const walletManager = getWalletManager();
+    const wallet = await walletManager.resolve(walletId);
+    // Validate chain support
+    validateChainSupport(wallet, chainId);
+    const rpcUrl = await getRpcUrl(chainId);
+    // Route based on wallet type
+    if (wallet.type === 'bankr') {
+        // Use BankrWalletProvider for Bankr wallets
+        return createBankrSpokeProvider(wallet, chainId, rpcUrl);
+    }
+    // Local key signing (evm-wallet-skill or env)
+    return createLocalSpokeProvider(wallet, chainId, rpcUrl);
+}
+/**
+ * Get a spoke provider for the given wallet and chain
+ * Returns cached provider if available, otherwise creates a new one
+ *
+ * @param walletId - The wallet identifier/nickname
+ * @param chainId - The chain identifier
+ * @param raw - If true, still creates full provider (raw mode not yet supported)
+ * @returns The spoke provider instance
+ */
+export async function getSpokeProvider(walletId, chainId, raw = false) {
+    const cacheKey = `${walletId}:${chainId}`;
+    // Check cache
+    const cached = providerCache.get(cacheKey);
+    if (cached) {
+        console.log('[spokeProviderFactory] Using cached provider', {
+            walletId,
+            chainId,
+        });
+        return cached;
+    }
+    // Create new provider
+    const provider = await createSpokeProvider(walletId, chainId);
+    // Cache the provider
+    providerCache.set(cacheKey, provider);
+    return provider;
+}
+/**
+ * Clear the provider cache
+ * Useful for testing or when wallet configuration changes
+ */
+export function clearProviderCache() {
+    providerCache.clear();
+    console.log('[spokeProviderFactory] Provider cache cleared');
+}
+/**
+ * Get cache statistics
+ * @returns Object with cache size and keys
+ */
+export function getCacheStats() {
+    return {
+        size: providerCache.size,
+        keys: Array.from(providerCache.keys()),
+    };
+}
+//# sourceMappingURL=spokeProviderFactory.js.map

package/dist/providers/spokeProviderFactory.js.map

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

package/dist/sodax/client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SODAX SDK Client Singleton
+ *
+ * Provides a singleton instance of the SODAX SDK client with lazy initialization.
+ * Uses dynamic configuration by default to fetch live token lists and routes.
+ */
+import { Sodax } from "@sodax/sdk";
+/**
+ * Get the singleton SODAX client instance
+ * Initializes on first call if not already initialized
+ */
+export declare function getSodaxClientAsync(): Promise<Sodax>;
+/**
+ * Synchronous accessor for the SODAX client
+ * Throws if the client hasn't been initialized yet
+ */
+export declare function getSodaxClient(): Sodax;
+/**
+ * Pre-initialize the SODAX client at plugin startup
+ */
+export declare function preInitializeSodax(): Promise<void>;
+/**
+ * Reset the SODAX client (useful for testing)
+ */
+export declare function resetSodaxClient(): void;
+/**
+ * SodaxClient class wrapper for backward compatibility
+ */
+export declare class SodaxClient {
+    private static instance;
+    static getClient(): Promise<Sodax>;
+    static reset(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/sodax/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sodax/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA+CnC;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,KAAK,CAAC,CAK1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAOtC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;WAEhC,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;IAQxC,MAAM,CAAC,KAAK,IAAI,IAAI;CAIrB"}