amped-defi 1.0.0

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

@@ -0,0 +1,107 @@
+/**
+ * Amped Wallet Provider
+ *
+ * Custom wallet provider implementing IEvmWalletProvider from @sodax/types.
+ *
+ * This replaces wallet-sdk-core's EvmWalletProvider with a more flexible
+ * implementation that:
+ * 1. Supports all chains including LightLink and HyperEVM
+ * 2. Has pluggable backends (local keys, Bankr, etc.)
+ * 3. Provides a unified interface for the SODAX SDK
+ *
+ * Architecture:
+ * \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ * \u2502       AmpedWalletProvider               \u2502
+ * \u2502  (implements IEvmWalletProvider)        \u2502
+ * \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
+ * \u2502  - SDK-compatible interface             \u2502
+ * \u2502  - Chain resolution (all chains)        \u2502
+ * \u2502  - Transaction formatting               \u2502
+ * \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+ *                 \u2502
+ *         \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ *         \u25bc               \u25bc
+ * \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ * \u2502 LocalKeyBack. \u2502 \u2502 BankrBackend  \u2502
+ * \u2502 (evm-wallet)  \u2502 \u2502 (API calls)   \u2502
+ * \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+ */
+import { createPublicClient, type Hash, type Address } from 'viem';
+import type { EvmRawTransaction, EvmRawTransactionReceipt } from '@sodax/types';
+import type { IWalletBackend, WalletBackendConfig, WalletBackendType, IAmpedWalletProvider, BankrBackendConfig } from './types';
+/**
+ * Amped Wallet Provider
+ *
+ * A drop-in replacement for wallet-sdk-core's EvmWalletProvider
+ * that supports all SODAX chains including LightLink and HyperEVM.
+ */
+export declare class AmpedWalletProvider implements IAmpedWalletProvider {
+    readonly publicClient: ReturnType<typeof createPublicClient>;
+    private readonly backend;
+    private readonly chainId;
+    private constructor();
+    /**
+     * Create an AmpedWalletProvider with a local key backend
+     *
+     * @param config - Configuration matching EvmWalletProvider's PrivateKeyEvmWalletConfig
+     * @returns AmpedWalletProvider instance
+     */
+    static fromPrivateKey(config: {
+        privateKey: `0x${string}`;
+        chainId: string | number;
+        rpcUrl?: string;
+    }): Promise<AmpedWalletProvider>;
+    /**
+     * Create an AmpedWalletProvider with a Bankr backend
+     *
+     * @param config - Bankr backend configuration
+     * @returns AmpedWalletProvider instance
+     */
+    static fromBankr(config: {
+        bankrApiUrl: string;
+        bankrApiKey: string;
+        userAddress: Address;
+        chainId: string | number;
+        rpcUrl?: string;
+        policy?: BankrBackendConfig['policy'];
+    }): Promise<AmpedWalletProvider>;
+    /**
+     * Create from generic backend configuration
+     */
+    static fromConfig(config: WalletBackendConfig): Promise<AmpedWalletProvider>;
+    /**
+     * Get the wallet address
+     */
+    getWalletAddress(): Promise<Address>;
+    /**
+     * Send a transaction
+     *
+     * Converts SDK's EvmRawTransaction format to internal format
+     * and delegates to the backend.
+     */
+    sendTransaction(evmRawTx: EvmRawTransaction): Promise<Hash>;
+    /**
+     * Wait for transaction receipt
+     *
+     * Converts internal receipt format to SDK's EvmRawTransactionReceipt format.
+     */
+    waitForTransactionReceipt(txHash: Hash): Promise<EvmRawTransactionReceipt>;
+    /**
+     * Get the underlying backend
+     */
+    getBackend(): IWalletBackend;
+    /**
+     * Get the backend type
+     */
+    getBackendType(): WalletBackendType;
+    /**
+     * Check if ready for transactions
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get chain ID
+     */
+    getChainId(): number;
+}
+export type { IAmpedWalletProvider };
+//# sourceMappingURL=AmpedWalletProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AmpedWalletProvider.d.ts","sourceRoot":"","sources":["../../../src/wallet/providers/AmpedWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,kBAAkB,EAElB,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAEV,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EAEpB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAKjB;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAE7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO;IASP;;;;;OAKG;WACU,cAAc,CAAC,MAAM,EAAE;QAClC,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmBhC;;;;;OAKG;WACU,SAAS,CAAC,MAAM,EAAE;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0BhC;;OAEG;WACU,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2BlF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE;;;;OAIG;IACG,yBAAyB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAkChF;;OAEG;IACH,UAAU,IAAI,cAAc;IAI5B;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAInC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB;AAGD,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/wallet/providers/AmpedWalletProvider.js

@@ -0,0 +1,208 @@
+/**
+ * Amped Wallet Provider
+ *
+ * Custom wallet provider implementing IEvmWalletProvider from @sodax/types.
+ *
+ * This replaces wallet-sdk-core's EvmWalletProvider with a more flexible
+ * implementation that:
+ * 1. Supports all chains including LightLink and HyperEVM
+ * 2. Has pluggable backends (local keys, Bankr, etc.)
+ * 3. Provides a unified interface for the SODAX SDK
+ *
+ * Architecture:
+ * \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ * \u2502       AmpedWalletProvider               \u2502
+ * \u2502  (implements IEvmWalletProvider)        \u2502
+ * \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
+ * \u2502  - SDK-compatible interface             \u2502
+ * \u2502  - Chain resolution (all chains)        \u2502
+ * \u2502  - Transaction formatting               \u2502
+ * \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+ *                 \u2502
+ *         \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ *         \u25bc               \u25bc
+ * \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+ * \u2502 LocalKeyBack. \u2502 \u2502 BankrBackend  \u2502
+ * \u2502 (evm-wallet)  \u2502 \u2502 (API calls)   \u2502
+ * \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+ */
+import { createPublicClient, http, } from 'viem';
+import { createLocalKeyBackend } from './LocalKeyBackend';
+import { createBankrBackend } from './BankrBackend';
+import { getViemChain, getDefaultRpcUrl, resolveChainId } from './chainConfig';
+/**
+ * Amped Wallet Provider
+ *
+ * A drop-in replacement for wallet-sdk-core's EvmWalletProvider
+ * that supports all SODAX chains including LightLink and HyperEVM.
+ */
+export class AmpedWalletProvider {
+    publicClient;
+    backend;
+    chainId;
+    constructor(backend, publicClient) {
+        this.backend = backend;
+        this.publicClient = publicClient;
+        this.chainId = backend.getChainId();
+        console.log(`[AmpedWalletProvider] Initialized with ${backend.type} backend`);
+        console.log(`[AmpedWalletProvider] Chain ID: ${this.chainId}`);
+    }
+    /**
+     * Create an AmpedWalletProvider with a local key backend
+     *
+     * @param config - Configuration matching EvmWalletProvider's PrivateKeyEvmWalletConfig
+     * @returns AmpedWalletProvider instance
+     */
+    static async fromPrivateKey(config) {
+        const chainId = resolveChainId(config.chainId);
+        const rpcUrl = config.rpcUrl || getDefaultRpcUrl(chainId);
+        const chain = getViemChain(chainId);
+        // Create backend
+        const backend = await createLocalKeyBackend({
+            type: 'localKey',
+            privateKey: config.privateKey,
+            chainId: config.chainId,
+            rpcUrl,
+        });
+        // Use the backend's public client
+        const publicClient = backend.getPublicClient();
+        return new AmpedWalletProvider(backend, publicClient);
+    }
+    /**
+     * Create an AmpedWalletProvider with a Bankr backend
+     *
+     * @param config - Bankr backend configuration
+     * @returns AmpedWalletProvider instance
+     */
+    static async fromBankr(config) {
+        const chainId = resolveChainId(config.chainId);
+        const rpcUrl = config.rpcUrl || getDefaultRpcUrl(chainId);
+        const chain = getViemChain(chainId);
+        // Create backend
+        const backend = await createBankrBackend({
+            type: 'bankr',
+            bankrApiUrl: config.bankrApiUrl,
+            bankrApiKey: config.bankrApiKey,
+            userAddress: config.userAddress,
+            chainId: config.chainId,
+            rpcUrl,
+            policy: config.policy,
+        });
+        // Create public client (for read operations)
+        // Bankr backend doesn't have its own public client
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(rpcUrl),
+        }); // Type cast needed due to viem's strict typing
+        return new AmpedWalletProvider(backend, publicClient);
+    }
+    /**
+     * Create from generic backend configuration
+     */
+    static async fromConfig(config) {
+        switch (config.type) {
+            case 'localKey':
+                return AmpedWalletProvider.fromPrivateKey({
+                    privateKey: config.privateKey,
+                    chainId: config.chainId,
+                    rpcUrl: config.rpcUrl,
+                });
+            case 'bankr':
+                const bankrConfig = config;
+                return AmpedWalletProvider.fromBankr({
+                    bankrApiUrl: bankrConfig.bankrApiUrl,
+                    bankrApiKey: bankrConfig.bankrApiKey,
+                    userAddress: bankrConfig.userAddress,
+                    chainId: config.chainId,
+                    rpcUrl: config.rpcUrl,
+                    policy: bankrConfig.policy,
+                });
+            default:
+                throw new Error(`Unsupported backend type: ${config.type}`);
+        }
+    }
+    // ===== IEvmWalletProvider Implementation =====
+    /**
+     * Get the wallet address
+     */
+    async getWalletAddress() {
+        return this.backend.getAddress();
+    }
+    /**
+     * Send a transaction
+     *
+     * Converts SDK's EvmRawTransaction format to internal format
+     * and delegates to the backend.
+     */
+    async sendTransaction(evmRawTx) {
+        console.log(`[AmpedWalletProvider] sendTransaction`);
+        console.log(`[AmpedWalletProvider] From: ${evmRawTx.from}`);
+        console.log(`[AmpedWalletProvider] To: ${evmRawTx.to}`);
+        console.log(`[AmpedWalletProvider] Value: ${evmRawTx.value}`);
+        return this.backend.sendTransaction({
+            to: evmRawTx.to,
+            value: evmRawTx.value,
+            data: evmRawTx.data,
+        });
+    }
+    /**
+     * Wait for transaction receipt
+     *
+     * Converts internal receipt format to SDK's EvmRawTransactionReceipt format.
+     */
+    async waitForTransactionReceipt(txHash) {
+        console.log(`[AmpedWalletProvider] waitForTransactionReceipt: ${txHash}`);
+        const receipt = await this.backend.waitForTransaction(txHash);
+        // Convert to SDK format
+        return {
+            transactionHash: receipt.transactionHash,
+            transactionIndex: '0x0', // Not tracked in our simplified receipt
+            blockHash: receipt.blockHash,
+            blockNumber: `0x${receipt.blockNumber.toString(16)}`,
+            from: receipt.from,
+            to: receipt.to,
+            cumulativeGasUsed: '0x0', // Not tracked
+            gasUsed: `0x${receipt.gasUsed.toString(16)}`,
+            contractAddress: null, // Would need to check if this was a deployment
+            logs: receipt.logs.map(log => ({
+                address: log.address,
+                topics: log.topics,
+                data: log.data,
+                blockHash: receipt.blockHash,
+                blockNumber: `0x${receipt.blockNumber.toString(16)}`,
+                logIndex: '0x0',
+                transactionHash: receipt.transactionHash,
+                transactionIndex: '0x0',
+                removed: false,
+            })),
+            logsBloom: '0x',
+            status: receipt.status === 'success' ? '0x1' : '0x0',
+        };
+    }
+    // ===== IAmpedWalletProvider Extensions =====
+    /**
+     * Get the underlying backend
+     */
+    getBackend() {
+        return this.backend;
+    }
+    /**
+     * Get the backend type
+     */
+    getBackendType() {
+        return this.backend.type;
+    }
+    /**
+     * Check if ready for transactions
+     */
+    async isReady() {
+        return this.backend.isReady();
+    }
+    /**
+     * Get chain ID
+     */
+    getChainId() {
+        return this.chainId;
+    }
+}
+//# sourceMappingURL=AmpedWalletProvider.js.map

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

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

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

@@ -0,0 +1,105 @@
+/**
+ * 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 type { Hash, Address } from 'viem';
+import type { IWalletBackend, BankrBackendConfig, TransactionRequest, TransactionReceipt } from './types';
+/**
+ * Bankr execution backend
+ *
+ * Delegates transaction execution to Bankr's Agent API.
+ * The agent never has direct access to private keys.
+ */
+export declare class BankrBackend implements IWalletBackend {
+    readonly type: "bankr";
+    private readonly apiUrl;
+    private readonly apiKey;
+    private readonly userAddress;
+    private readonly chainId;
+    private readonly policy?;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(config: BankrBackendConfig);
+    /**
+     * Get the wallet address (Bankr-provisioned)
+     */
+    getAddress(): Promise<Address>;
+    /**
+     * Send a transaction via Bankr Agent API
+     *
+     * Formats the transaction as a natural language prompt and submits
+     * to Bankr's async job system.
+     */
+    sendTransaction(tx: TransactionRequest): Promise<Hash>;
+    /**
+     * 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.
+     */
+    waitForTransaction(txHash: Hash): Promise<TransactionReceipt>;
+    /**
+     * Check if backend is ready
+     *
+     * Verifies Bankr API connectivity with a simple balance query.
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get the chain ID
+     */
+    getChainId(): number;
+    /**
+     * Submit a job to Bankr Agent API
+     */
+    private submitJob;
+    /**
+     * Poll for job completion
+     */
+    private pollJobUntilComplete;
+    /**
+     * Get job status from Bankr API
+     */
+    private getJobStatus;
+    /**
+     * 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...")
+     */
+    private extractTransactionHash;
+    /**
+     * Validate transaction against policy
+     */
+    private validatePolicy;
+    /**
+     * Sleep helper
+     */
+    private sleep;
+}
+/**
+ * Create a BankrBackend from configuration
+ */
+export declare function createBankrBackend(config: BankrBackendConfig): Promise<BankrBackend>;
+//# sourceMappingURL=BankrBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BankrBackend.d.ts","sourceRoot":"","sources":["../../../src/wallet/providers/BankrBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAqDjB;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA+B;IAGvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAO;gBAE3B,MAAM,EAAE,kBAAkB;IAYtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C5D;;;;;;OAMG;IACG,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBnE;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAwBjC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;YACW,SAAS;IAwBvB;;OAEG;YACW,oBAAoB;IAwClC;;OAEG;YACW,YAAY;IAgB1B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAU1F"}