outsmart 2.0.0-alpha.0

package/dist/transactions/jito_tips_tx_executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jito_tips_tx_executor.d.ts","sourceRoot":"","sources":["../../src/transactions/jito_tips_tx_executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,OAAO,EACP,SAAS,EAGT,oBAAoB,EACpB,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAwBzB,wBAAgB,kBAAkB,IAAI,SAAS,CAG9C;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,oBAAoB,GAAG,WAAW,EAC/C,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,8BAA8B,EAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CA6DrB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,8BAA8B,GAC9C,OAAO,CAAC,UAAU,CAAC,CAYrB"}

package/dist/transactions/jito_tips_tx_executor.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRandomValidator = getRandomValidator;
+exports.jito_executeAndConfirm = jito_executeAndConfirm;
+exports.jito_confirm = jito_confirm;
+const web3_js_1 = require("@solana/web3.js");
+const axios_1 = __importDefault(require("axios"));
+const bs58_1 = __importDefault(require("bs58"));
+const config_1 = require("../helpers/config");
+const jito_Validators = [
+    "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+    "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+    "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT",
+    "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+    "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+    "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+    "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+    "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+];
+const endpoints = [
+    "https://mainnet.block-engine.jito.wtf/api/v1/bundles",
+    "https://amsterdam.mainnet.block-engine.jito.wtf/api/v1/bundles",
+    "https://frankfurt.mainnet.block-engine.jito.wtf/api/v1/bundles",
+    "https://ny.mainnet.block-engine.jito.wtf/api/v1/bundles",
+    "https://tokyo.mainnet.block-engine.jito.wtf/api/v1/bundles",
+];
+function getRandomValidator() {
+    const res = jito_Validators[Math.floor(Math.random() * jito_Validators.length)];
+    return new web3_js_1.PublicKey(res);
+}
+/**
+ * Executes and confirms a Jito bundle transaction.
+ */
+async function jito_executeAndConfirm(transaction, payer, latestBlockhash, jitofee) {
+    console.log("Executing transaction (jito)...");
+    const jito_validator_wallet = getRandomValidator();
+    console.log("Selected Jito Validator:", jito_validator_wallet.toBase58());
+    try {
+        const fee = Math.round(jitofee * web3_js_1.LAMPORTS_PER_SOL);
+        console.log(`Jito Fee: ${fee / web3_js_1.LAMPORTS_PER_SOL} SOL`);
+        const jitoFee_message = new web3_js_1.TransactionMessage({
+            payerKey: payer.publicKey,
+            recentBlockhash: latestBlockhash.blockhash,
+            instructions: [
+                web3_js_1.SystemProgram.transfer({
+                    fromPubkey: payer.publicKey,
+                    toPubkey: jito_validator_wallet,
+                    lamports: fee,
+                }),
+            ],
+        }).compileToV0Message();
+        const jitoFee_transaction = new web3_js_1.VersionedTransaction(jitoFee_message);
+        jitoFee_transaction.sign([payer]);
+        const jitoTxSignature = bs58_1.default.encode(jitoFee_transaction.signatures[0]);
+        const serializedJitoFeeTransaction = bs58_1.default.encode(jitoFee_transaction.serialize());
+        const serializedTransaction = bs58_1.default.encode(transaction instanceof web3_js_1.VersionedTransaction
+            ? transaction.serialize()
+            : transaction.serialize());
+        const final_transaction = [serializedJitoFeeTransaction, serializedTransaction];
+        const requests = endpoints.map((url) => axios_1.default.post(url, { jsonrpc: "2.0", id: 1, method: "sendBundle", params: [final_transaction] }, { timeout: 10000 }));
+        console.log("Sending tx to Jito validators...");
+        const res = await Promise.all(requests.map((p) => p.catch((e) => e)));
+        const success_res = res.filter((r) => !(r instanceof Error));
+        if (success_res.length > 0) {
+            console.log("Jito validator accepted the tx");
+            return await jito_confirm(jitoTxSignature, latestBlockhash);
+        }
+        else {
+            console.log("No Jito validators accepted the tx");
+            return { confirmed: false, signature: jitoTxSignature };
+        }
+    }
+    catch (e) {
+        if (e instanceof axios_1.default.AxiosError) {
+            console.log("Failed to execute the jito transaction");
+        }
+        else {
+            console.log("Error during jito transaction execution:", e);
+        }
+        return { confirmed: false, signature: null };
+    }
+}
+/**
+ * Confirms a transaction on the Solana blockchain.
+ */
+async function jito_confirm(signature, latestBlockhash) {
+    console.log("Confirming the jito transaction...");
+    const connection = (0, config_1.getConnection)();
+    const confirmation = await connection.confirmTransaction({
+        signature,
+        lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,
+        blockhash: latestBlockhash.blockhash,
+    }, "confirmed");
+    return { confirmed: !confirmation.value.err, signature };
+}
+//# sourceMappingURL=jito_tips_tx_executor.js.map

package/dist/transactions/jito_tips_tx_executor.js.map

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

package/dist/transactions/landing/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TX Landing Layer — Public API
+ *
+ * Usage:
+ *   import { landTransaction, getOrchestrator } from "./transactions/landing";
+ *
+ *   // Quick: submit with default concurrent strategy
+ *   const results = await landTransaction(ixs, signer, blockhash, { dex: "raydium-amm-v4", operation: "buy" });
+ *
+ *   // Advanced: configure orchestrator
+ *   const orchestrator = getOrchestrator({ strategy: "race", defaultTipSol: 0.002 });
+ *   const results = await orchestrator.submit(ixs, signer, blockhash, opts);
+ */
+export { ILandingProvider, LandingResult, SubmitOptions, OrchestratorConfig, SubmissionStrategy, TipAccount, extractBlockhash, pickRandom, } from "./types";
+export { LandingOrchestrator, getOrchestrator, landTransaction, } from "./orchestrator";
+export { NonceManager } from "./nonce-manager";
+export { TIP_ACCOUNTS, isTipAccount, getTipAccountProvider, getTipAccountsForProvider, } from "./tip-accounts";
+export { createProvider as createZeroSlotProvider } from "./providers/zero-slot";
+export { createProvider as createNozomiProvider } from "./providers/nozomi";
+export { createProvider as createHeliusSenderProvider } from "./providers/helius-sender";
+export { createProvider as createBlockrazorProvider } from "./providers/blockrazor";
+export { createProvider as createNode1Provider } from "./providers/node1";
+export { createProvider as createBloxrouteProvider } from "./providers/bloxroute";
+export { createProvider as createAstralaneProvider } from "./providers/astralane";
+export { createProvider as createStelliumProvider } from "./providers/stellium";
+export { createProvider as createFlashblockProvider } from "./providers/flashblock";
+export { createProvider as createJitoProvider } from "./providers/jito";
+export { createProvider as createNextblockProvider } from "./providers/nextblock";
+export { createProvider as createSoyasProvider } from "./providers/soyas";
+//# sourceMappingURL=index.d.ts.map

package/dist/transactions/landing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transactions/landing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/transactions/landing/index.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * TX Landing Layer — Public API
+ *
+ * Usage:
+ *   import { landTransaction, getOrchestrator } from "./transactions/landing";
+ *
+ *   // Quick: submit with default concurrent strategy
+ *   const results = await landTransaction(ixs, signer, blockhash, { dex: "raydium-amm-v4", operation: "buy" });
+ *
+ *   // Advanced: configure orchestrator
+ *   const orchestrator = getOrchestrator({ strategy: "race", defaultTipSol: 0.002 });
+ *   const results = await orchestrator.submit(ixs, signer, blockhash, opts);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSoyasProvider = exports.createNextblockProvider = exports.createJitoProvider = exports.createFlashblockProvider = exports.createStelliumProvider = exports.createAstralaneProvider = exports.createBloxrouteProvider = exports.createNode1Provider = exports.createBlockrazorProvider = exports.createHeliusSenderProvider = exports.createNozomiProvider = exports.createZeroSlotProvider = exports.getTipAccountsForProvider = exports.getTipAccountProvider = exports.isTipAccount = exports.TIP_ACCOUNTS = exports.NonceManager = exports.landTransaction = exports.getOrchestrator = exports.LandingOrchestrator = exports.pickRandom = exports.extractBlockhash = void 0;
+// Types
+var types_1 = require("./types");
+Object.defineProperty(exports, "extractBlockhash", { enumerable: true, get: function () { return types_1.extractBlockhash; } });
+Object.defineProperty(exports, "pickRandom", { enumerable: true, get: function () { return types_1.pickRandom; } });
+// Orchestrator
+var orchestrator_1 = require("./orchestrator");
+Object.defineProperty(exports, "LandingOrchestrator", { enumerable: true, get: function () { return orchestrator_1.LandingOrchestrator; } });
+Object.defineProperty(exports, "getOrchestrator", { enumerable: true, get: function () { return orchestrator_1.getOrchestrator; } });
+Object.defineProperty(exports, "landTransaction", { enumerable: true, get: function () { return orchestrator_1.landTransaction; } });
+// Nonce manager for durable nonce accounts (concurrent strategy safety)
+var nonce_manager_1 = require("./nonce-manager");
+Object.defineProperty(exports, "NonceManager", { enumerable: true, get: function () { return nonce_manager_1.NonceManager; } });
+// Tip account registry
+var tip_accounts_1 = require("./tip-accounts");
+Object.defineProperty(exports, "TIP_ACCOUNTS", { enumerable: true, get: function () { return tip_accounts_1.TIP_ACCOUNTS; } });
+Object.defineProperty(exports, "isTipAccount", { enumerable: true, get: function () { return tip_accounts_1.isTipAccount; } });
+Object.defineProperty(exports, "getTipAccountProvider", { enumerable: true, get: function () { return tip_accounts_1.getTipAccountProvider; } });
+Object.defineProperty(exports, "getTipAccountsForProvider", { enumerable: true, get: function () { return tip_accounts_1.getTipAccountsForProvider; } });
+// Individual provider factories (for advanced usage)
+var zero_slot_1 = require("./providers/zero-slot");
+Object.defineProperty(exports, "createZeroSlotProvider", { enumerable: true, get: function () { return zero_slot_1.createProvider; } });
+var nozomi_1 = require("./providers/nozomi");
+Object.defineProperty(exports, "createNozomiProvider", { enumerable: true, get: function () { return nozomi_1.createProvider; } });
+var helius_sender_1 = require("./providers/helius-sender");
+Object.defineProperty(exports, "createHeliusSenderProvider", { enumerable: true, get: function () { return helius_sender_1.createProvider; } });
+var blockrazor_1 = require("./providers/blockrazor");
+Object.defineProperty(exports, "createBlockrazorProvider", { enumerable: true, get: function () { return blockrazor_1.createProvider; } });
+var node1_1 = require("./providers/node1");
+Object.defineProperty(exports, "createNode1Provider", { enumerable: true, get: function () { return node1_1.createProvider; } });
+var bloxroute_1 = require("./providers/bloxroute");
+Object.defineProperty(exports, "createBloxrouteProvider", { enumerable: true, get: function () { return bloxroute_1.createProvider; } });
+var astralane_1 = require("./providers/astralane");
+Object.defineProperty(exports, "createAstralaneProvider", { enumerable: true, get: function () { return astralane_1.createProvider; } });
+var stellium_1 = require("./providers/stellium");
+Object.defineProperty(exports, "createStelliumProvider", { enumerable: true, get: function () { return stellium_1.createProvider; } });
+var flashblock_1 = require("./providers/flashblock");
+Object.defineProperty(exports, "createFlashblockProvider", { enumerable: true, get: function () { return flashblock_1.createProvider; } });
+var jito_1 = require("./providers/jito");
+Object.defineProperty(exports, "createJitoProvider", { enumerable: true, get: function () { return jito_1.createProvider; } });
+var nextblock_1 = require("./providers/nextblock");
+Object.defineProperty(exports, "createNextblockProvider", { enumerable: true, get: function () { return nextblock_1.createProvider; } });
+var soyas_1 = require("./providers/soyas");
+Object.defineProperty(exports, "createSoyasProvider", { enumerable: true, get: function () { return soyas_1.createProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/transactions/landing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transactions/landing/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,QAAQ;AACR,iCASiB;AAFf,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AAGZ,eAAe;AACf,+CAIwB;AAHtB,mHAAA,mBAAmB,OAAA;AACnB,+GAAA,eAAe,OAAA;AACf,+GAAA,eAAe,OAAA;AAGjB,wEAAwE;AACxE,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,uBAAuB;AACvB,+CAKwB;AAJtB,4GAAA,YAAY,OAAA;AACZ,4GAAA,YAAY,OAAA;AACZ,qHAAA,qBAAqB,OAAA;AACrB,yHAAA,yBAAyB,OAAA;AAG3B,qDAAqD;AACrD,mDAAiF;AAAxE,mHAAA,cAAc,OAA0B;AACjD,6CAA4E;AAAnE,8GAAA,cAAc,OAAwB;AAC/C,2DAAyF;AAAhF,2HAAA,cAAc,OAA8B;AACrD,qDAAoF;AAA3E,sHAAA,cAAc,OAA4B;AACnD,2CAA0E;AAAjE,4GAAA,cAAc,OAAuB;AAC9C,mDAAkF;AAAzE,oHAAA,cAAc,OAA2B;AAClD,mDAAkF;AAAzE,oHAAA,cAAc,OAA2B;AAClD,iDAAgF;AAAvE,kHAAA,cAAc,OAA0B;AACjD,qDAAoF;AAA3E,sHAAA,cAAc,OAA4B;AACnD,yCAAwE;AAA/D,0GAAA,cAAc,OAAsB;AAC7C,mDAAkF;AAAzE,oHAAA,cAAc,OAA2B;AAClD,2CAA0E;AAAjE,4GAAA,cAAc,OAAuB"}

package/dist/transactions/landing/nonce-manager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Durable Nonce Account Manager
+ *
+ * Manages durable nonce accounts for concurrent TX landing safety.
+ *
+ * Problem: The "concurrent" landing strategy fires the SAME transaction to
+ * 9+ providers in parallel. Without a durable nonce, if multiple providers
+ * land it, the user gets DUPLICATE BUYS — spending 2-9x more SOL than intended.
+ *
+ * Solution: Durable nonce transactions use a nonce account's stored blockhash.
+ * Once consumed by the first successful landing, all other copies become
+ * invalid on-chain. This guarantees exactly-once execution.
+ *
+ * How it works:
+ * 1. NonceManager.create() creates a nonce account on-chain (~0.0015 SOL)
+ * 2. Before concurrent submission, NonceManager.get() fetches the current nonce
+ * 3. NonceManager.buildAdvanceIx() is prepended as the FIRST instruction
+ * 4. The nonce value replaces the blockhash in the transaction message
+ * 5. Providers treat the nonce as a regular blockhash — no provider changes needed
+ *
+ * Config is stored at ~/.outsmart/nonce.json
+ */
+import { Connection, Keypair, PublicKey, TransactionInstruction } from "@solana/web3.js";
+export declare class NonceManager {
+    private connection;
+    private authority;
+    private nonceAddress;
+    private configLoaded;
+    /**
+     * @param connection - Solana RPC connection
+     * @param authority - Wallet keypair that controls the nonce account
+     */
+    constructor(connection: Connection, authority: Keypair);
+    /** Directory for outsmart config files */
+    static get configDir(): string;
+    /** Path to nonce config JSON */
+    static get configPath(): string;
+    /** Path to nonce keypair JSON */
+    static get keypairPath(): string;
+    private readConfig;
+    private writeConfig;
+    private deleteConfig;
+    /**
+     * Check if a valid nonce account exists (config + on-chain).
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Create a new nonce account on-chain.
+     *
+     * Cost: ~0.0015 SOL (rent-exempt minimum for nonce account).
+     *
+     * @returns The nonce account address and initial nonce value
+     */
+    create(): Promise<{
+        nonceAccount: PublicKey;
+        nonce: string;
+    }>;
+    /**
+     * Load the nonce account from config and fetch its current on-chain state.
+     *
+     * @returns Nonce address, current nonce value, and authority
+     * @throws Error if no nonce config exists or account is invalid
+     */
+    load(): Promise<{
+        address: PublicKey;
+        nonce: string;
+        authority: PublicKey;
+    }>;
+    /**
+     * Get the current nonce value (fetches fresh from chain every time).
+     *
+     * IMPORTANT: Nonce value changes after each use. Always call get() fresh
+     * before building a transaction.
+     */
+    get(): Promise<{
+        nonce: string;
+        address: PublicKey;
+    }>;
+    /**
+     * Build a nonceAdvance instruction.
+     *
+     * This MUST be the FIRST instruction in any transaction using a durable nonce.
+     * The Solana runtime recognizes the nonceAdvance instruction and validates
+     * the nonce value as the blockhash.
+     *
+     * @returns TransactionInstruction for SystemProgram.nonceAdvance
+     */
+    buildAdvanceIx(): TransactionInstruction;
+    /**
+     * Ensure a nonce account exists, prompting the user to create one if needed.
+     *
+     * In non-interactive mode (piped stdin), defaults to false (skip nonce creation).
+     *
+     * @returns true if a nonce account exists (or was just created), false if user declined
+     */
+    ensureExists(): Promise<boolean>;
+    /**
+     * Close the nonce account and reclaim the rent (~0.0015 SOL).
+     *
+     * Withdraws all lamports back to the authority wallet and deletes
+     * the local config files.
+     */
+    close(): Promise<{
+        txSignature: string;
+        confirmed: boolean;
+    }>;
+    /**
+     * Get the nonce account address, if loaded.
+     */
+    getAddress(): PublicKey | null;
+    /**
+     * Prompt the user for input via readline.
+     */
+    private promptUser;
+}
+//# sourceMappingURL=nonce-manager.d.ts.map

package/dist/transactions/landing/nonce-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce-manager.d.ts","sourceRoot":"","sources":["../../../src/transactions/landing/nonce-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EAIT,sBAAsB,EAIvB,MAAM,iBAAiB,CAAC;AAyBzB,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAS;IAE7B;;;OAGG;gBACS,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO;IAStD,0CAA0C;IAC1C,MAAM,KAAK,SAAS,IAAI,MAAM,CAG7B;IAED,gCAAgC;IAChC,MAAM,KAAK,UAAU,IAAI,MAAM,CAE9B;IAED,iCAAiC;IACjC,MAAM,KAAK,WAAW,IAAI,MAAM,CAE/B;IAMD,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBhC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA0FnE;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC;QACpB,OAAO,EAAE,SAAS,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,SAAS,CAAC;KACtB,CAAC;IA8BF;;;;;OAKG;IACG,GAAG,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC;IAqB3D;;;;;;;;OAQG;IACH,cAAc,IAAI,sBAAsB;IAaxC;;;;;;OAMG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAuCtC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAoEnE;;OAEG;IACH,UAAU,IAAI,SAAS,GAAG,IAAI;IAI9B;;OAEG;IACH,OAAO,CAAC,UAAU;CAanB"}