solana-meme-sdk 1.0.0

package/README.md

@@ -0,0 +1,160 @@
+# Solana Meme SDK
+
+[English](#english) | [中文](#中文)
+
+---
+
+## English
+
+A comprehensive TypeScript SDK for Solana meme token trading, creation, and bundle services. Optimized for speed, reliability, and high-density multi-wallet execution.
+
+### ✨ Key Features
+
+- 📂 **DEX Support**: Integrated with Pump.fun, Raydium (AMM/CLMM), Orca (Whirlpool), Meteora (DLMM), Jupiter (Aggregator), and PumpSwap.
+- 📦 **Batch Executor**: High-density atomic batch swaps supporting up to 50+ wallets in a single transaction.
+- ⚡ **Jito & Nozomi**: Native support for Jito Bundles and Nozomi acceleration to bypass network congestion.
+- 🪙 **Token Launch**: Unified API for SPL/Token-2022 creation, metadata uploading (IPFS/Arweave), and minting.
+- 🔍 **LP Inspector**: Real-time detection of token liquidity status across all major DEXs.
+- 🛠️ **Utility Pro**: Advanced Address Lookup Table (ALT) management and balance/transfer helpers.
+
+### ⚙️ Installation & Configuration
+
+```bash
+npm install solana-meme-sdk
+```
+
+**CRITICAL**: You must add these `overrides` to your root `package.json` to handle mandatory dependency resolution:
+
+```json
+{
+  "overrides": {
+    "@noble/hashes": "^1.8.0",
+    "bigint-buffer": "npm:four-flap-bigint-buffer@1.1.6",
+    "@solana/spl-token-registry": { "cross-fetch": "3.2.0" },
+    "node-fetch": "2.7.0"
+  }
+}
+```
+
+### 📖 API Reference
+
+#### 1. DEX Operations (`solana-meme-sdk/dex`)
+- **Pump.fun**: `getPumpBondingCurve(mint)`, `signPumpBuy(params)`, `signPumpSell(params)`
+- **Raydium**: `RaydiumAMM` client for swap/liquidity on V4 pools.
+- **Orca**: `WhirlpoolClient` for concentrated liquidity operations.
+- **Meteora**: `DLMMClient` for dynamic fee and position management.
+- **Jupiter**: `JupiterAggregator` for best-price routing and token pricing.
+- **BlockRazor**: `BlockRazorClient` for high-performance landing, sandwich mitigation, and gRPC Geyser data streams.
+
+#### 2. Batch Executor (`solana-meme-sdk/batch-executor`)
+Optimized for multi-wallet simultaneous trades using a specialized on-chain program.
+- `BatchExecutor` class:
+  - `buildBatchPumpBuyTx(params)` / `buildBatchPumpSellTx(params)`
+  - `buildBatchRaydiumSwapTx(params, accounts)`
+  - `buildBatchMeteoraSwapTx(params, accounts, binArrays)`
+  - `buildBatchOrcaSwapTx(params, accounts, aToB, sqrtPriceLimit)`
+  - `buildBatchJupiterSwapTx(wallets, jupAccounts)`
+  - `executeBatchPumpBuy(params)` (Helper for build + send)
+
+#### 3. Jito & MEV Service (`solana-meme-sdk/jito`)
+- `JitoBundleClient`: `sendBundle(transactions)`, `getJitoTipAccounts()`, `getNextJitoTipAccount()`
+
+#### 4. Nozomi Acceleration (`solana-meme-sdk/nozomi`)
+- `NozomiClient`: `sendTransaction(tx)`, `sendBundle(txs)`, `getNozomiTipAccounts()`
+
+#### 5. Token Management (`solana-meme-sdk/token`)
+- `createCompleteToken(params)`: One-click creation + metadata upload + initial mint.
+- `uploadMetadataToIpfs(data)`, `uploadMetadataToArweave(data)`.
+
+#### 6. Utilities & Inspection (`solana-meme-sdk/utils`)
+- `inspectSolanaTokenLP(mint)`: Returns platform, liquidity amount, and curve status.
+- `createALT(connection, payer, addresses)`, `waitForALTActivation(connection, altAddress)`.
+- `transferSol()`, `transferToken()`, `getSolBalance()`, `getTokenBalances()`.
+
+### 🚀 Example: Batch Trading (50 Wallets)
+
+```typescript
+import { BatchExecutor } from 'solana-meme-sdk';
+
+const executor = new BatchExecutor(connection, payerKeypair);
+
+const tx = await executor.buildBatchPumpBuyTx({
+  tokenMint: new PublicKey('...'),
+  wallets: [
+    { wallet: wallet1, amount: 100_000_000n, minAmountOut: 1n },
+    { wallet: wallet2, amount: 200_000_000n, minAmountOut: 1n },
+    // ... support up to ~50 wallets
+  ]
+});
+
+const sig = await executor.sendAndConfirm(tx);
+```
+
+---
+
+## 中文
+
+集成 Solana Meme 代币交易、创建、批量执行与加速服务的综合 TypeScript SDK。
+
+### ✨ 核心功能
+
+- 📂 **DEX 支持**: 深度集成 Pump.fun, Raydium (AMM/CLMM), Orca (Whirlpool), Meteora (DLMM), Jupiter (Aggregator) 及 PumpSwap。
+- 📦 **批量执行器 (Batch Executor)**: 基于定制化链上程序，支持在单笔交易中为 50+ 个钱包执行原子化 Swap。
+- ⚡ **Jito & Nozomi**: 原生支持 Jito Bundle 和 Nozomi 交易加速，有效应对网络拥堵与 MEV。
+- 🪙 **代币发射**: 统一封装 SPL/Token-2022 创建、元数据上传 (IPFS/Arweave) 及铸造流程。
+- 🔍 **LP 检测器**: 实时检测代币在各大 DEX 的流动性、内盘进度及池子状态。
+- 🛠️ **专业工具**: 高效的地址查询表 (ALT) 管理工具、资产查询及转账助手。
+
+### 📖 接口文档
+
+#### 1. DEX 交易
+- **Pump.fun**: `signPumpBuy`/`signPumpSell` (单钱包快速交易)。
+- **Raydium**: 支持 V4 AMM 的完整 Swap 逻辑。
+- **Jupiter**: `JupiterAggregator` 负责最优路径路由及代币实时定价。
+
+#### 2. 批量交易执行器 (Batch Executor)
+专为多钱包同步操作优化，利用 ALT 极大提升交易密度。
+- `BatchExecutor` 方法：
+  - `buildBatchPumpBuyTx` / `buildBatchPumpSellTx` (Pump.fun)
+  - `buildBatchRaydiumSwapTx` (Raydium)
+  - `buildBatchMeteoraSwapTx` (Meteora)
+  - `buildBatchJupiterSwapTx` (Jupiter 聚合)
+  - `executeBatchPumpBuy` (快捷构建并发送)
+
+#### 3. Jito & Nozomi 加速
+- `JitoBundleClient`: 支持多交易 Bundle 提交及 Tip 自动分配。
+- `NozomiClient`: 提供极速交易广播服务。
+
+#### 4. 代币管理
+- `createCompleteToken`: 一键完成代币创建、Logo/元数据上传及初始供应量铸造。
+
+#### 5. 工具类接口
+- `inspectSolanaTokenLP`: 输入 Mint 地址，返回所属平台、LP 详情及是否已毕业/上线。
+- `waitForALTActivation`: 确保地址查询表在交易发送前已在链上激活。
+
+### 🚀 代码示例：多钱包批量买入
+
+```typescript
+import { BatchExecutor } from 'solana-meme-sdk';
+
+const executor = new BatchExecutor(connection, payerKeypair);
+
+// 为多个钱包构建批量买入指令 (Atomic)
+const tx = await executor.buildBatchPumpBuyTx({
+  tokenMint: new PublicKey('...'),
+  wallets: [
+    { wallet: walletA, amount: 1_000_000_000n, minAmountOut: 0n },
+    { wallet: walletB, amount: 500_000_000n, minAmountOut: 0n },
+    // ...
+  ]
+});
+
+// 支持搭配 Jito 或常规发送
+const sig = await executor.sendAndConfirm(tx);
+```
+
+---
+
+## License
+
+MIT

package/dist/batch-executor/accounts.d.ts

@@ -0,0 +1,141 @@
+import { PublicKey } from '@solana/web3.js';
+export declare const PUMP_GLOBAL: PublicKey;
+export declare const PUMP_FEE_RECIPIENT: PublicKey;
+export declare const PUMP_EVENT_AUTHORITY: PublicKey;
+export interface PumpBuyAccounts {
+    pumpGlobal: PublicKey;
+    pumpFeeRecipient: PublicKey;
+    tokenMint: PublicKey;
+    bondingCurve: PublicKey;
+    bondingCurveTokenAccount: PublicKey;
+    pumpProgram: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram: PublicKey;
+    associatedTokenProgram: PublicKey;
+    rent: PublicKey;
+    eventAuthority: PublicKey;
+}
+export interface PumpSellAccounts {
+    pumpGlobal: PublicKey;
+    pumpFeeRecipient: PublicKey;
+    tokenMint: PublicKey;
+    bondingCurve: PublicKey;
+    bondingCurveTokenAccount: PublicKey;
+    pumpProgram: PublicKey;
+    tokenProgram: PublicKey;
+    eventAuthority: PublicKey;
+}
+export interface PumpSwapAccounts {
+    globalConfig: PublicKey;
+    feeRecipient: PublicKey;
+    pool: PublicKey;
+    poolBaseVault: PublicKey;
+    poolQuoteVault: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    pumpSwapProgram: PublicKey;
+    tokenProgram: PublicKey;
+    token2022Program: PublicKey;
+    systemProgram: PublicKey;
+    associatedTokenProgram: PublicKey;
+}
+export interface RaydiumSwapAccounts {
+    ammId: PublicKey;
+    ammAuthority: PublicKey;
+    ammOpenOrders: PublicKey;
+    ammTargetOrders: PublicKey;
+    poolCoinVault: PublicKey;
+    poolPcVault: PublicKey;
+    serumProgram: PublicKey;
+    serumMarket: PublicKey;
+    serumBids: PublicKey;
+    serumAsks: PublicKey;
+    serumEventQueue: PublicKey;
+    serumCoinVault: PublicKey;
+    serumPcVault: PublicKey;
+    serumVaultSigner: PublicKey;
+    tokenProgram: PublicKey;
+    raydiumProgram: PublicKey;
+}
+export interface MeteoraSwapAccounts {
+    lbPair: PublicKey;
+    binArrayBitmapExtension: PublicKey | null;
+    reserveX: PublicKey;
+    reserveY: PublicKey;
+    tokenXMint: PublicKey;
+    tokenYMint: PublicKey;
+    oracle: PublicKey;
+    hostFeeIn: PublicKey | null;
+    tokenProgram: PublicKey;
+    eventAuthority: PublicKey;
+    meteoraProgram: PublicKey;
+}
+export interface OrcaSwapAccounts {
+    whirlpool: PublicKey;
+    tokenVaultA: PublicKey;
+    tokenVaultB: PublicKey;
+    tickArray0: PublicKey;
+    tickArray1: PublicKey;
+    tickArray2: PublicKey;
+    oracle: PublicKey;
+    tokenProgram: PublicKey;
+    orcaProgram: PublicKey;
+}
+export interface LaunchLabBuyAccounts {
+    globalConfig: PublicKey;
+    feeConfig: PublicKey | null;
+    poolState: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseVault: PublicKey;
+    quoteVault: PublicKey;
+    protocolFeeRecipient: PublicKey;
+    tokenProgram: PublicKey;
+    token2022Program: PublicKey;
+    systemProgram: PublicKey;
+    launchlabProgram: PublicKey;
+}
+/**
+ * 获取 Pump.fun Bonding Curve 地址 (PDA)
+ */
+export declare function getPumpBondingCurvePDA(tokenMint: PublicKey): PublicKey;
+/**
+ * 获取 Bonding Curve Token Account
+ */
+export declare function getPumpBondingCurveTokenAccount(bondingCurve: PublicKey, tokenMint: PublicKey): PublicKey;
+/**
+ * 获取 Pump.fun Buy 所需的固定账户
+ */
+export declare function getPumpBuyAccounts(tokenMint: PublicKey): PumpBuyAccounts;
+/**
+ * 获取 Pump.fun Sell 所需的固定账户
+ */
+export declare function getPumpSellAccounts(tokenMint: PublicKey): PumpSellAccounts;
+/**
+ * 构建剩余账户列表的方法，根据每个 swap 需要的账户数量
+ * 对于 Pump, Raydium, LaunchLab 是 2 或 3 个，Meteora 是 4 个
+ */
+export declare function buildRemainingAccounts(wallets: {
+    publicKey: PublicKey;
+}[], tokenMint: PublicKey, tokenMintB?: PublicKey | null, // 有些 DEX 需要两个 Token Mint
+accountsPerWallet?: number, additionalAccountsFetcher?: (wallet: PublicKey) => PublicKey[]): {
+    pubkey: PublicKey;
+    isSigner: boolean;
+    isWritable: boolean;
+}[];
+/**
+ * 获取钱包的 Token ATA
+ */
+export declare function getWalletATA(wallet: PublicKey, tokenMint: PublicKey): PublicKey;
+/**
+ * 构建 Pump Buy remaining_accounts
+ * 格式: [wallet0, ata0, wallet1, ata1, ...]
+ */
+export declare function buildPumpRemainingAccounts(wallets: {
+    publicKey: PublicKey;
+}[], tokenMint: PublicKey): {
+    pubkey: PublicKey;
+    isSigner: boolean;
+    isWritable: boolean;
+}[];
+//# sourceMappingURL=accounts.d.ts.map

package/dist/batch-executor/accounts.d.ts.map

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

package/dist/batch-executor/accounts.js

@@ -0,0 +1,98 @@
+import { PublicKey, SystemProgram, SYSVAR_RENT_PUBKEY, } from '@solana/web3.js';
+import { TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync } from '@solana/spl-token';
+// ==================== Pump.fun Constants ====================
+export const PUMP_GLOBAL = new PublicKey('4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf');
+export const PUMP_FEE_RECIPIENT = new PublicKey('CebN5WGQ4jvEPvsVU4EoHEpgzq1VV7AbicfhtW4xC9iM');
+export const PUMP_EVENT_AUTHORITY = new PublicKey('Ce6TQqeHC9p8KetsN6JsjHK7UTZk7nasjjnr7XxXp9F1');
+// ==================== Account Fetchers ====================
+/**
+ * 获取 Pump.fun Bonding Curve 地址 (PDA)
+ */
+export function getPumpBondingCurvePDA(tokenMint) {
+    const [bondingCurve] = PublicKey.findProgramAddressSync([Buffer.from('bonding-curve'), tokenMint.toBuffer()], new PublicKey('6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P'));
+    return bondingCurve;
+}
+/**
+ * 获取 Bonding Curve Token Account
+ */
+export function getPumpBondingCurveTokenAccount(bondingCurve, tokenMint) {
+    return getAssociatedTokenAddressSync(tokenMint, bondingCurve, true);
+}
+/**
+ * 获取 Pump.fun Buy 所需的固定账户
+ */
+export function getPumpBuyAccounts(tokenMint) {
+    const bondingCurve = getPumpBondingCurvePDA(tokenMint);
+    const bondingCurveTokenAccount = getPumpBondingCurveTokenAccount(bondingCurve, tokenMint);
+    return {
+        pumpGlobal: PUMP_GLOBAL,
+        pumpFeeRecipient: PUMP_FEE_RECIPIENT,
+        tokenMint,
+        bondingCurve,
+        bondingCurveTokenAccount,
+        pumpProgram: new PublicKey('6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P'),
+        tokenProgram: TOKEN_PROGRAM_ID,
+        systemProgram: SystemProgram.programId,
+        associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+        rent: SYSVAR_RENT_PUBKEY,
+        eventAuthority: PUMP_EVENT_AUTHORITY,
+    };
+}
+/**
+ * 获取 Pump.fun Sell 所需的固定账户
+ */
+export function getPumpSellAccounts(tokenMint) {
+    const bondingCurve = getPumpBondingCurvePDA(tokenMint);
+    const bondingCurveTokenAccount = getPumpBondingCurveTokenAccount(bondingCurve, tokenMint);
+    return {
+        pumpGlobal: PUMP_GLOBAL,
+        pumpFeeRecipient: PUMP_FEE_RECIPIENT,
+        tokenMint,
+        bondingCurve,
+        bondingCurveTokenAccount,
+        pumpProgram: new PublicKey('6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P'),
+        tokenProgram: TOKEN_PROGRAM_ID,
+        eventAuthority: PUMP_EVENT_AUTHORITY,
+    };
+}
+/**
+ * 构建剩余账户列表的方法，根据每个 swap 需要的账户数量
+ * 对于 Pump, Raydium, LaunchLab 是 2 或 3 个，Meteora 是 4 个
+ */
+export function buildRemainingAccounts(wallets, tokenMint, tokenMintB = null, // 有些 DEX 需要两个 Token Mint
+accountsPerWallet = 2, additionalAccountsFetcher) {
+    const accounts = [];
+    for (const wallet of wallets) {
+        accounts.push({ pubkey: wallet.publicKey, isSigner: true, isWritable: true });
+        if (additionalAccountsFetcher) {
+            const extra = additionalAccountsFetcher(wallet.publicKey);
+            for (const acc of extra) {
+                accounts.push({ pubkey: acc, isSigner: false, isWritable: true });
+            }
+        }
+        else {
+            // 默认行为：wallet, source_ata, [dest_ata]
+            const sourceAta = getWalletATA(wallet.publicKey, tokenMint);
+            accounts.push({ pubkey: sourceAta, isSigner: false, isWritable: true });
+            if (tokenMintB) {
+                const destAta = getWalletATA(wallet.publicKey, tokenMintB);
+                accounts.push({ pubkey: destAta, isSigner: false, isWritable: true });
+            }
+        }
+    }
+    return accounts;
+}
+/**
+ * 获取钱包的 Token ATA
+ */
+export function getWalletATA(wallet, tokenMint) {
+    return getAssociatedTokenAddressSync(tokenMint, wallet, false);
+}
+/**
+ * 构建 Pump Buy remaining_accounts
+ * 格式: [wallet0, ata0, wallet1, ata1, ...]
+ */
+export function buildPumpRemainingAccounts(wallets, tokenMint) {
+    return buildRemainingAccounts(wallets, tokenMint, null, 2);
+}
+//# sourceMappingURL=accounts.js.map

package/dist/batch-executor/accounts.js.map

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

package/dist/batch-executor/batch-executor.d.ts

@@ -0,0 +1,27 @@
+import { Connection, PublicKey, VersionedTransaction, Keypair, AccountMeta } from '@solana/web3.js';
+import { BatchPumpBuyParams, BatchPumpSellParams, BatchRaydiumSwapParams, BatchMeteoraSwapParams, BatchOrcaSwapParams, BatchPumpSwapBuyParams, BatchPumpSwapSellParams, BatchLaunchLabBuyParams } from './types.js';
+import { RaydiumSwapAccounts, MeteoraSwapAccounts, OrcaSwapAccounts, PumpSwapAccounts, LaunchLabBuyAccounts } from './accounts.js';
+export declare class BatchExecutor {
+    private connection;
+    private payer;
+    constructor(connection: Connection, payer: Keypair);
+    private createVersionedTx;
+    private buildSwapInputs;
+    buildBatchPumpBuyTx(params: BatchPumpBuyParams): Promise<VersionedTransaction>;
+    buildBatchPumpSellTx(params: BatchPumpSellParams): Promise<VersionedTransaction>;
+    buildBatchPumpSwapBuyTx(params: BatchPumpSwapBuyParams, accounts: PumpSwapAccounts): Promise<VersionedTransaction>;
+    buildBatchPumpSwapSellTx(params: BatchPumpSwapSellParams, accounts: PumpSwapAccounts): Promise<VersionedTransaction>;
+    buildBatchRaydiumSwapTx(params: BatchRaydiumSwapParams, accounts: RaydiumSwapAccounts): Promise<VersionedTransaction>;
+    buildBatchMeteoraSwapTx(params: BatchMeteoraSwapParams, accounts: MeteoraSwapAccounts, binArrays: PublicKey[]): Promise<VersionedTransaction>;
+    buildBatchOrcaSwapTx(params: BatchOrcaSwapParams, accounts: OrcaSwapAccounts, aToB: boolean, sqrtPriceLimit: bigint): Promise<VersionedTransaction>;
+    buildBatchLaunchLabBuyTx(params: BatchLaunchLabBuyParams, accounts: LaunchLabBuyAccounts): Promise<VersionedTransaction>;
+    buildBatchJupiterSwapTx(wallets: {
+        wallet: Keypair;
+        instructionData: Buffer;
+    }[], jupAccounts: AccountMeta[]): Promise<VersionedTransaction>;
+    executeBatchPumpBuy(params: BatchPumpBuyParams): Promise<string>;
+    executeBatchPumpSell(params: BatchPumpSellParams): Promise<string>;
+    sendAndConfirm(tx: VersionedTransaction): Promise<string>;
+}
+export default BatchExecutor;
+//# sourceMappingURL=batch-executor.d.ts.map

package/dist/batch-executor/batch-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-executor.d.ts","sourceRoot":"","sources":["../../src/batch-executor/batch-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,SAAS,EAGT,oBAAoB,EACpB,OAAO,EACP,WAAW,EACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAKH,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIH,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACvB,MAAM,eAAe,CAAC;AAiBvB,qBAAa,aAAa;IAElB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK;gBADL,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,OAAO;YAGZ,iBAAiB;IAa/B,OAAO,CAAC,eAAe;IAUjB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2B9E,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0BhF,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2BlH,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6BpH,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuCrH,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4C7I,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiCnJ,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6BxH,uBAAuB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2B3I,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhE,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlE,cAAc,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAQlE;AAED,eAAe,aAAa,CAAC"}