amped-defi 1.0.0

package/dist/wallet/providers/BankrBackend.js

@@ -0,0 +1,327 @@
+/**
+ * Bankr Backend - Transaction Execution Layer
+ *
+ * CRITICAL: This backend is for EXECUTION ONLY, not routing.
+ *
+ * Architecture:
+ *   SODAX SDK (routing) → BankrBackend (execution) → Blockchain
+ *
+ * What Bankr DOES:
+ *   ✓ Signs the pre-computed transaction from SODAX
+ *   ✓ Submits to blockchain via Bankr API
+ *   ✓ Returns transaction hash
+ *
+ * What Bankr does NOT do:
+ *   ✗ NO routing decisions
+ *   ✗ NO DeFi protocol selection
+ *   ✗ NO swap optimization
+ *   ✗ NO interpretation of intent
+ *
+ * The SODAX SDK always handles routing logic. Bankr receives the exact
+ * transaction data (to, data, value, chainId) and submits it verbatim.
+ *
+ * @see SKILL.md "Transaction Execution Architecture" section
+ */
+import { resolveChainId } from './chainConfig';
+/**
+ * Serialize error objects for readable error messages
+ */
+function serializeError(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    try {
+        return JSON.stringify(error, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2);
+    }
+    catch {
+        return String(error);
+    }
+}
+/**
+ * Chain ID to chain name mapping for Bankr prompts
+ */
+const CHAIN_NAMES = {
+    1: 'ethereum',
+    8453: 'base',
+    137: 'polygon',
+    42161: 'arbitrum',
+    10: 'optimism',
+    1890: 'lightlink',
+    146: 'sonic',
+};
+/**
+ * Bankr execution backend
+ *
+ * Delegates transaction execution to Bankr's Agent API.
+ * The agent never has direct access to private keys.
+ */
+export class BankrBackend {
+    type = 'bankr';
+    apiUrl;
+    apiKey;
+    userAddress;
+    chainId;
+    policy;
+    // Polling configuration
+    pollIntervalMs = 2000;
+    maxPollAttempts = 150; // 5 minutes max
+    constructor(config) {
+        this.apiUrl = config.bankrApiUrl || 'https://api.bankr.bot';
+        this.apiKey = config.bankrApiKey;
+        this.userAddress = config.userAddress;
+        this.chainId = resolveChainId(config.chainId);
+        this.policy = config.policy;
+        console.log(`[BankrBackend] Initialized for chain ${this.chainId}`);
+        console.log(`[BankrBackend] User address: ${this.userAddress}`);
+        console.log(`[BankrBackend] API URL: ${this.apiUrl}`);
+    }
+    /**
+     * Get the wallet address (Bankr-provisioned)
+     */
+    async getAddress() {
+        return this.userAddress;
+    }
+    /**
+     * Send a transaction via Bankr Agent API
+     *
+     * Formats the transaction as a natural language prompt and submits
+     * to Bankr's async job system.
+     */
+    async sendTransaction(tx) {
+        console.log(`[BankrBackend] Sending transaction via Bankr API`);
+        console.log(`[BankrBackend] To: ${tx.to}`);
+        console.log(`[BankrBackend] Value: ${tx.value || 0n}`);
+        console.log(`[BankrBackend] Data: ${tx.data ? tx.data.slice(0, 20) + '...' : '0x'}`);
+        // Validate against policy
+        if (this.policy) {
+            await this.validatePolicy(tx);
+        }
+        // Format transaction as JSON for Bankr prompt
+        const txJson = JSON.stringify({
+            to: tx.to,
+            data: tx.data || '0x',
+            value: (tx.value || 0n).toString(),
+            chainId: this.chainId,
+        });
+        // Create natural language prompt for Bankr
+        const prompt = `Submit this transaction: ${txJson}`;
+        console.log(`[BankrBackend] Submitting prompt to Bankr API`);
+        // Submit job to Bankr
+        const jobId = await this.submitJob(prompt);
+        console.log(`[BankrBackend] Job submitted: ${jobId}`);
+        // Poll for completion
+        const result = await this.pollJobUntilComplete(jobId);
+        // Extract transaction hash from response
+        const txHash = this.extractTransactionHash(result);
+        if (!txHash) {
+            throw new Error(`[BankrBackend] Transaction failed: ${serializeError(result.response || result.error) || 'Unknown error'}`);
+        }
+        console.log(`[BankrBackend] Transaction hash: ${txHash}`);
+        return txHash;
+    }
+    /**
+     * Wait for transaction confirmation
+     *
+     * Note: With Bankr, the transaction is already confirmed when we get
+     * the response. This method exists for interface compatibility but
+     * returns a minimal receipt.
+     */
+    async waitForTransaction(txHash) {
+        console.log(`[BankrBackend] waitForTransaction called for: ${txHash}`);
+        // Bankr transactions are confirmed when the job completes
+        // We return a minimal receipt since we don't have full details
+        return {
+            transactionHash: txHash,
+            blockNumber: 0n, // Unknown - would need to query chain
+            blockHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+            from: this.userAddress,
+            to: null,
+            gasUsed: 0n,
+            status: 'success',
+            logs: [],
+        };
+    }
+    /**
+     * Check if backend is ready
+     *
+     * Verifies Bankr API connectivity with a simple balance query.
+     */
+    async isReady() {
+        if (!this.apiUrl || !this.apiKey || !this.userAddress) {
+            return false;
+        }
+        try {
+            // Test API connectivity with a simple query
+            const response = await fetch(`${this.apiUrl}/agent/prompt`, {
+                method: 'POST',
+                headers: {
+                    'X-API-Key': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ prompt: 'ping' }),
+            });
+            // Even a 4xx error means API is reachable
+            return response.status !== 503 && response.status !== 502;
+        }
+        catch (error) {
+            console.error('[BankrBackend] Connectivity check failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Get the chain ID
+     */
+    getChainId() {
+        return this.chainId;
+    }
+    /**
+     * Submit a job to Bankr Agent API
+     */
+    async submitJob(prompt) {
+        const response = await fetch(`${this.apiUrl}/agent/prompt`, {
+            method: 'POST',
+            headers: {
+                'X-API-Key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ prompt }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`[BankrBackend] Failed to submit job: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        if (!data.success || !data.jobId) {
+            throw new Error(`[BankrBackend] Invalid job submission response: ${JSON.stringify(data)}`);
+        }
+        return data.jobId;
+    }
+    /**
+     * Poll for job completion
+     */
+    async pollJobUntilComplete(jobId) {
+        let lastStatus = '';
+        for (let attempt = 0; attempt < this.maxPollAttempts; attempt++) {
+            await this.sleep(this.pollIntervalMs);
+            const result = await this.getJobStatus(jobId);
+            // Log status changes
+            if (result.status !== lastStatus) {
+                console.log(`[BankrBackend] Job ${jobId} status: ${result.status}`);
+                lastStatus = result.status;
+            }
+            // Log status updates
+            if (result.statusUpdates && result.statusUpdates.length > 0) {
+                const lastUpdate = result.statusUpdates[result.statusUpdates.length - 1];
+                console.log(`[BankrBackend] Progress: ${lastUpdate.message}`);
+            }
+            // Check for terminal states
+            switch (result.status) {
+                case 'completed':
+                    return result;
+                case 'failed':
+                    throw new Error(`[BankrBackend] Job failed: ${serializeError(result.error) || 'Unknown error'}`);
+                case 'cancelled':
+                    throw new Error(`[BankrBackend] Job was cancelled`);
+                case 'pending':
+                case 'processing':
+                    // Continue polling
+                    break;
+                default:
+                    console.warn(`[BankrBackend] Unknown status: ${result.status}`);
+            }
+        }
+        throw new Error(`[BankrBackend] Job ${jobId} timed out after ${this.maxPollAttempts * this.pollIntervalMs / 1000} seconds`);
+    }
+    /**
+     * Get job status from Bankr API
+     */
+    async getJobStatus(jobId) {
+        const response = await fetch(`${this.apiUrl}/agent/job/${jobId}`, {
+            method: 'GET',
+            headers: {
+                'X-API-Key': this.apiKey,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`[BankrBackend] Failed to get job status: ${response.status} ${error}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Extract transaction hash from Bankr response
+     *
+     * The response may contain the tx hash in various formats:
+     * - In richData array
+     * - In the response text (e.g., "Transaction hash: 0x...")
+     */
+    extractTransactionHash(result) {
+        // Check richData for transaction info
+        if (result.richData) {
+            for (const item of result.richData) {
+                if (item.transactionHash) {
+                    return item.transactionHash;
+                }
+                if (item.txHash) {
+                    return item.txHash;
+                }
+                if (item.hash) {
+                    return item.hash;
+                }
+            }
+        }
+        // Try to extract from response text
+        if (result.response) {
+            // Look for hex transaction hash pattern (0x followed by 64 hex chars)
+            const hashMatch = result.response.match(/0x[a-fA-F0-9]{64}/);
+            if (hashMatch) {
+                return hashMatch[0];
+            }
+            // Check if response indicates failure
+            if (result.response.toLowerCase().includes('reverted') ||
+                result.response.toLowerCase().includes('failed') ||
+                result.response.toLowerCase().includes('insufficient')) {
+                console.error(`[BankrBackend] Transaction failed: ${result.response}`);
+                return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Validate transaction against policy
+     */
+    async validatePolicy(tx) {
+        if (!this.policy)
+            return;
+        // Check max value per transaction
+        if (this.policy.maxValuePerTx && tx.value && tx.value > this.policy.maxValuePerTx) {
+            throw new Error(`Transaction value ${tx.value} exceeds max allowed ${this.policy.maxValuePerTx}`);
+        }
+        // Check allowed contracts
+        if (this.policy.allowedContracts && this.policy.allowedContracts.length > 0) {
+            if (!this.policy.allowedContracts.includes(tx.to)) {
+                throw new Error(`Contract ${tx.to} is not in the allowed contracts list`);
+            }
+        }
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create a BankrBackend from configuration
+ */
+export async function createBankrBackend(config) {
+    const backend = new BankrBackend(config);
+    // Verify connectivity
+    const ready = await backend.isReady();
+    if (!ready) {
+        console.warn('[BankrBackend] Backend created but connectivity check failed');
+    }
+    return backend;
+}
+//# sourceMappingURL=BankrBackend.js.map

package/dist/wallet/providers/BankrBackend.js.map

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

package/dist/wallet/providers/LocalKeyBackend.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Local Key Backend
+ *
+ * Wallet backend implementation using local private keys.
+ * Compatible with evm-wallet-skill's key storage.
+ *
+ * Uses viem for transaction signing and submission.
+ */
+import { createPublicClient, createWalletClient, type Hash, type Address } from 'viem';
+import type { IWalletBackend, LocalKeyBackendConfig, TransactionRequest, TransactionReceipt } from './types';
+/**
+ * Local private key wallet backend
+ *
+ * Signs transactions locally using the provided private key.
+ * This is the standard backend for self-custody wallets.
+ */
+export declare class LocalKeyBackend implements IWalletBackend {
+    readonly type: "localKey";
+    private readonly account;
+    private readonly walletClient;
+    private readonly _publicClient;
+    private readonly chainId;
+    private readonly chain;
+    constructor(config: LocalKeyBackendConfig);
+    /**
+     * Get the wallet address
+     */
+    getAddress(): Promise<Address>;
+    /**
+     * Send a transaction
+     *
+     * Signs locally and submits via RPC.
+     */
+    sendTransaction(tx: TransactionRequest): Promise<Hash>;
+    /**
+     * Wait for transaction confirmation
+     */
+    waitForTransaction(txHash: Hash): Promise<TransactionReceipt>;
+    /**
+     * Check if backend is ready
+     *
+     * For local key backend, we verify RPC connectivity.
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get the chain ID
+     */
+    getChainId(): number;
+    /**
+     * Get the public client (for external use)
+     */
+    getPublicClient(): ReturnType<typeof createPublicClient>;
+    /**
+     * Get the wallet client (for advanced use cases)
+     */
+    getWalletClient(): ReturnType<typeof createWalletClient>;
+}
+/**
+ * Create a LocalKeyBackend from configuration
+ */
+export declare function createLocalKeyBackend(config: LocalKeyBackendConfig): Promise<LocalKeyBackend>;
+//# sourceMappingURL=LocalKeyBackend.d.ts.map

package/dist/wallet/providers/LocalKeyBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalKeyBackend.d.ts","sourceRoot":"","sources":["../../../src/wallet/providers/LocalKeyBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAElB,KAAK,IAAI,EACT,KAAK,OAAO,EAEb,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,MAAM,EAAE,qBAAqB;IA2BzC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC;;;;OAIG;IACG,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB5D;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyBnE;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAUjC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,eAAe,IAAI,UAAU,CAAC,OAAO,kBAAkB,CAAC;IAIxD;;OAEG;IACH,eAAe,IAAI,UAAU,CAAC,OAAO,kBAAkB,CAAC;CAGzD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAUnG"}

package/dist/wallet/providers/LocalKeyBackend.js

@@ -0,0 +1,152 @@
+/**
+ * Local Key Backend
+ *
+ * Wallet backend implementation using local private keys.
+ * Compatible with evm-wallet-skill's key storage.
+ *
+ * Uses viem for transaction signing and submission.
+ */
+import { createPublicClient, createWalletClient, http, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { getViemChain, getDefaultRpcUrl, resolveChainId } from './chainConfig';
+/**
+ * Local private key wallet backend
+ *
+ * Signs transactions locally using the provided private key.
+ * This is the standard backend for self-custody wallets.
+ */
+export class LocalKeyBackend {
+    type = 'localKey';
+    account;
+    walletClient;
+    _publicClient;
+    chainId;
+    chain;
+    constructor(config) {
+        // Resolve chain configuration
+        this.chainId = resolveChainId(config.chainId);
+        this.chain = getViemChain(this.chainId);
+        // Get RPC URL (custom or default)
+        const rpcUrl = config.rpcUrl || getDefaultRpcUrl(this.chainId);
+        // Create account from private key
+        this.account = privateKeyToAccount(config.privateKey);
+        // Create viem clients
+        this._publicClient = createPublicClient({
+            chain: this.chain,
+            transport: http(rpcUrl),
+        });
+        this.walletClient = createWalletClient({
+            account: this.account,
+            chain: this.chain,
+            transport: http(rpcUrl),
+        });
+        console.log(`[LocalKeyBackend] Initialized for chain ${this.chain.name} (${this.chainId})`);
+        console.log(`[LocalKeyBackend] Address: ${this.account.address}`);
+    }
+    /**
+     * Get the wallet address
+     */
+    async getAddress() {
+        return this.account.address;
+    }
+    /**
+     * Send a transaction
+     *
+     * Signs locally and submits via RPC.
+     */
+    async sendTransaction(tx) {
+        console.log(`[LocalKeyBackend] Sending transaction to ${tx.to}`);
+        // Build transaction params
+        const txParams = {
+            account: this.account,
+            chain: this.chain,
+            to: tx.to,
+            value: tx.value || 0n,
+            data: tx.data,
+        };
+        // Add optional gas parameters
+        if (tx.gasLimit)
+            txParams.gas = tx.gasLimit;
+        if (tx.gasPrice)
+            txParams.gasPrice = tx.gasPrice;
+        if (tx.maxFeePerGas)
+            txParams.maxFeePerGas = tx.maxFeePerGas;
+        if (tx.maxPriorityFeePerGas)
+            txParams.maxPriorityFeePerGas = tx.maxPriorityFeePerGas;
+        if (tx.nonce !== undefined)
+            txParams.nonce = tx.nonce;
+        const hash = await this.walletClient.sendTransaction(txParams);
+        console.log(`[LocalKeyBackend] Transaction sent: ${hash}`);
+        return hash;
+    }
+    /**
+     * Wait for transaction confirmation
+     */
+    async waitForTransaction(txHash) {
+        console.log(`[LocalKeyBackend] Waiting for transaction: ${txHash}`);
+        const receipt = await this._publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        console.log(`[LocalKeyBackend] Transaction confirmed in block ${receipt.blockNumber}`);
+        return {
+            transactionHash: receipt.transactionHash,
+            blockNumber: receipt.blockNumber,
+            blockHash: receipt.blockHash,
+            from: receipt.from,
+            to: receipt.to,
+            gasUsed: receipt.gasUsed,
+            status: receipt.status === 'success' ? 'success' : 'reverted',
+            logs: receipt.logs.map((log) => ({
+                address: log.address,
+                topics: [...(log.topics || [])],
+                data: log.data,
+            })),
+        };
+    }
+    /**
+     * Check if backend is ready
+     *
+     * For local key backend, we verify RPC connectivity.
+     */
+    async isReady() {
+        try {
+            await this._publicClient.getChainId();
+            return true;
+        }
+        catch (error) {
+            console.error('[LocalKeyBackend] RPC connectivity check failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Get the chain ID
+     */
+    getChainId() {
+        return this.chainId;
+    }
+    /**
+     * Get the public client (for external use)
+     */
+    getPublicClient() {
+        return this._publicClient;
+    }
+    /**
+     * Get the wallet client (for advanced use cases)
+     */
+    getWalletClient() {
+        return this.walletClient;
+    }
+}
+/**
+ * Create a LocalKeyBackend from configuration
+ */
+export async function createLocalKeyBackend(config) {
+    const backend = new LocalKeyBackend(config);
+    // Verify connectivity
+    const ready = await backend.isReady();
+    if (!ready) {
+        console.warn('[LocalKeyBackend] Backend created but RPC connectivity check failed');
+    }
+    return backend;
+}
+//# sourceMappingURL=LocalKeyBackend.js.map

package/dist/wallet/providers/LocalKeyBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalKeyBackend.js","sourceRoot":"","sources":["../../../src/wallet/providers/LocalKeyBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,IAAI,GAIL,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAA0B,MAAM,eAAe,CAAC;AAO5E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,UAAmB,CAAC;IAEnB,OAAO,CAAoB;IAC3B,YAAY,CAAwC;IACpD,aAAa,CAAwC;IACrD,OAAO,CAAS;IAChB,KAAK,CAAQ;IAE9B,YAAY,MAA6B;QACvC,8BAA8B;QAC9B,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAExC,kCAAkC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/D,kCAAkC;QAClC,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEtD,sBAAsB;QACtB,IAAI,CAAC,aAAa,GAAG,kBAAkB,CAAC;YACtC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;SACxB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,2CAA2C,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5F,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,EAAsB;QAC1C,OAAO,CAAC,GAAG,CAAC,4CAA4C,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjE,2BAA2B;QAC3B,MAAM,QAAQ,GAAQ;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;YACrB,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,CAAC;QAEF,8BAA8B;QAC9B,IAAI,EAAE,CAAC,QAAQ;YAAE,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC5C,IAAI,EAAE,CAAC,QAAQ;YAAE,QAAQ,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QACjD,IAAI,EAAE,CAAC,YAAY;YAAE,QAAQ,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC;QAC7D,IAAI,EAAE,CAAC,oBAAoB;YAAE,QAAQ,CAAC,oBAAoB,GAAG,EAAE,CAAC,oBAAoB,CAAC;QACrF,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;QAEtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE/D,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAY;QACnC,OAAO,CAAC,GAAG,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;YACjE,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,oDAAoD,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAEvF,OAAO;YACL,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YAC7D,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;gBACpC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAoB;gBAClD,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAA6B;IACvE,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAE5C,sBAAsB;IACtB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}