solana-meme-sdk 1.0.0

package/dist/nozomi/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Nozomi 类型定义
+ * @module sol/nozomi/types
+ */
+/**
+ * Nozomi 区域
+ */
+export type NozomiRegion = 'auto' | 'pit' | 'tyo' | 'sgp' | 'ewr' | 'ams' | 'fra';
+/**
+ * Nozomi 客户端配置
+ */
+export interface NozomiClientConfig {
+    /** 最快提交 API Key */
+    apiKeyFast: string;
+    /** MEV 保护 API Key (可选，如果不提供则使用 apiKeyFast) */
+    apiKeyMev?: string;
+    /** 默认区域 */
+    defaultRegion?: NozomiRegion;
+    /** 默认是否使用 MEV 保护 */
+    defaultUseMevProtection?: boolean;
+    /** 请求超时（毫秒） */
+    timeout?: number;
+}
+/**
+ * Nozomi 发送选项
+ */
+export interface NozomiSendOptions {
+    /** 是否使用 MEV 保护 */
+    useMevProtection?: boolean;
+    /** 区域节点 */
+    region?: NozomiRegion;
+    /** 是否跳过预检 */
+    skipPreflight?: boolean;
+    /** 最大重试次数（Nozomi 内部重试） */
+    maxRetries?: number;
+}
+/**
+ * Nozomi 发送结果
+ */
+export interface NozomiSendResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 交易签名 */
+    signature?: string;
+    /** 错误信息 */
+    error?: string;
+    /** 延迟（毫秒） */
+    latency?: number;
+}
+/**
+ * Nozomi 批量发送结果
+ */
+export interface NozomiBatchSendResult {
+    /** 总数 */
+    total: number;
+    /** 成功数 */
+    successCount: number;
+    /** 失败数 */
+    failCount: number;
+    /** 各交易结果 */
+    results: NozomiSendResult[];
+    /** 总耗时（毫秒） */
+    totalLatency: number;
+}
+/**
+ * 交易构建选项
+ */
+export interface NozomiTransactionBuildOptions {
+    /** 是否添加 Nozomi Tip */
+    addTip?: boolean;
+    /** Tip 金额（lamports），默认 0.001 SOL */
+    tipLamports?: bigint;
+    /** 指定 Tip 账户，默认随机选择 */
+    tipAccount?: string;
+    /** 计算单元限制 */
+    computeUnitLimit?: number;
+    /** 计算单元价格（microlamports），建议 1,000,000 */
+    computeUnitPrice?: number;
+}
+/**
+ * Nozomi RPC 错误
+ */
+export interface NozomiRpcError {
+    code: number;
+    message: string;
+    data?: string;
+}
+/**
+ * Nozomi RPC 响应
+ */
+export interface NozomiRpcResponse<T = string> {
+    jsonrpc: string;
+    id: number;
+    result?: T;
+    error?: NozomiRpcError;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/nozomi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nozomi/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,oBAAoB;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW;IACX,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS;IACT,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}

package/dist/nozomi/types.js

@@ -0,0 +1,6 @@
+/**
+ * Nozomi 类型定义
+ * @module sol/nozomi/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/nozomi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/nozomi/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/token/create-complete.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 完整代币创建流程
+ * 包括：上传元数据 → 创建 Mint → 创建 Metadata → Mint 初始供应
+ * @module sol/token/create-complete
+ */
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+import type { TokenStandard } from './types.js';
+/**
+ * 完整代币创建参数
+ */
+export interface CreateTokenCompleteParams {
+    /** 代币名称 */
+    name: string;
+    /** 代币符号 */
+    symbol: string;
+    /** 代币描述 */
+    description: string;
+    /** 精度（小数位数） */
+    decimals: number;
+    /** 初始供应量（不含精度，如 1000000 表示 100万） */
+    initialSupply: bigint;
+    /** 图片 Buffer（用于上传 IPFS） */
+    imageBuffer?: Buffer | Uint8Array;
+    /** 图片 File 对象（浏览器环境） */
+    imageFile?: File;
+    /** 已上传的元数据 CID（如果已有，则不需要上传） */
+    metadataCid?: string;
+    /** 创建者 Keypair */
+    creator: Keypair;
+    /** Mint 权限（默认为 creator） */
+    mintAuthority?: PublicKey;
+    /** 冻结权限（null 表示不可冻结） */
+    freezeAuthority?: PublicKey | null;
+    /** 代币标准（默认 TOKEN_2022） */
+    tokenStandard?: TokenStandard;
+    /** 社交链接 */
+    social?: {
+        telegram?: string;
+        twitter?: string;
+        website?: string;
+    };
+}
+/**
+ * 完整代币创建结果
+ */
+export interface CreateTokenCompleteResult {
+    success: boolean;
+    /** Mint 地址 */
+    mint?: string;
+    /** Mint Keypair（需要保存用于后续操作） */
+    mintKeypair?: Keypair;
+    /** Metadata 账户地址 */
+    metadataAddress?: string;
+    /** 元数据 URI（IPFS） */
+    metadataUri?: string;
+    /** 创建者 ATA 地址 */
+    creatorAta?: string;
+    /** 签名后的交易列表（按顺序提交） */
+    signedTransactions?: Array<{
+        data: string;
+        signature: string;
+        description: string;
+    }>;
+    /** blockhash */
+    recentBlockhash?: string;
+    /** 最后有效区块高度 */
+    lastValidBlockHeight?: number;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 创建完整代币（上传元数据 + 创建 Mint + 创建 Metadata + Mint 初始供应）
+ *
+ * 流程：
+ * 1. 上传图片和元数据到 IPFS（使用 Flap 官方接口）
+ * 2. 创建 Mint 账户 + Mint 初始供应量
+ * 3. 创建 Metaplex Metadata 账户
+ *
+ * @param connection Solana 连接
+ * @param params 创建参数
+ */
+export declare function createTokenComplete(connection: Connection, params: CreateTokenCompleteParams): Promise<CreateTokenCompleteResult>;
+/**
+ * 创建代币（不上传元数据，使用已有 URI）
+ * 适用于元数据已经上传的情况
+ */
+export declare function createTokenWithUri(connection: Connection, params: {
+    name: string;
+    symbol: string;
+    metadataUri: string;
+    decimals: number;
+    initialSupply: bigint;
+    creator: Keypair;
+    mintAuthority?: PublicKey;
+    freezeAuthority?: PublicKey | null;
+    tokenStandard?: TokenStandard;
+}): Promise<CreateTokenCompleteResult>;
+/**
+ * 将创建结果转换为后端 API 格式
+ */
+export declare function toBackendCreateTokenRequest(result: CreateTokenCompleteResult): {
+    mint: string;
+    metadataAddress: string;
+    metadataUri: string;
+    imageUri?: string;
+    creatorAta: string;
+    transactions: Array<{
+        data: string;
+        signature: string;
+        description: string;
+    }>;
+    recentBlockhash: string;
+    lastValidBlockHeight: number;
+    timestamp: number;
+} | null;
+//# sourceMappingURL=create-complete.d.ts.map

package/dist/token/create-complete.d.ts.map

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

package/dist/token/create-complete.js

@@ -0,0 +1,236 @@
+/**
+ * 完整代币创建流程
+ * 包括：上传元数据 → 创建 Mint → 创建 Metadata → Mint 初始供应
+ * @module sol/token/create-complete
+ */
+import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, } from '@solana/spl-token';
+import { signCreateTokenTransaction } from './create-token.js';
+import { signCreateMetadataTransaction } from './metadata.js';
+import { uploadTokenMetadata, uploadTokenMetadataFromFile, cidToUri } from './metadata-upload.js';
+/**
+ * 创建完整代币（上传元数据 + 创建 Mint + 创建 Metadata + Mint 初始供应）
+ *
+ * 流程：
+ * 1. 上传图片和元数据到 IPFS（使用 Flap 官方接口）
+ * 2. 创建 Mint 账户 + Mint 初始供应量
+ * 3. 创建 Metaplex Metadata 账户
+ *
+ * @param connection Solana 连接
+ * @param params 创建参数
+ */
+export async function createTokenComplete(connection, params) {
+    try {
+        const { name, symbol, description, decimals, initialSupply, imageBuffer, imageFile, metadataCid, creator, mintAuthority = creator.publicKey, freezeAuthority = creator.publicKey, tokenStandard = 'TOKEN_2022', social, } = params;
+        // ==================== Step 1: 上传元数据 ====================
+        let metadataUri;
+        if (metadataCid) {
+            // 已有元数据 CID
+            metadataUri = cidToUri(metadataCid);
+        }
+        else if (imageBuffer) {
+            // 上传图片和元数据（使用 Flap 官方 IPFS 接口）
+            const uploadResult = await uploadTokenMetadata(imageBuffer, {
+                name,
+                symbol,
+                description,
+                creator: creator.publicKey.toBase58(),
+                telegram: social?.telegram,
+                twitter: social?.twitter,
+                website: social?.website,
+            });
+            if (!uploadResult.success) {
+                return {
+                    success: false,
+                    error: `IPFS upload failed: ${uploadResult.error}`,
+                };
+            }
+            metadataUri = uploadResult.uri;
+        }
+        else if (imageFile) {
+            // 从 File 对象上传（浏览器环境）
+            const uploadResult = await uploadTokenMetadataFromFile(imageFile, {
+                name,
+                symbol,
+                description,
+                creator: creator.publicKey.toBase58(),
+                telegram: social?.telegram,
+                twitter: social?.twitter,
+                website: social?.website,
+            });
+            if (!uploadResult.success) {
+                return {
+                    success: false,
+                    error: `IPFS upload failed: ${uploadResult.error}`,
+                };
+            }
+            metadataUri = uploadResult.uri;
+        }
+        else {
+            return {
+                success: false,
+                error: 'Either metadataCid, imageBuffer, or imageFile is required',
+            };
+        }
+        // ==================== Step 2: 创建 Mint + Mint To ====================
+        const createTokenResult = await signCreateTokenTransaction(connection, {
+            creator,
+            decimals,
+            initialSupply,
+            mintAuthority,
+            freezeAuthority,
+            tokenStandard,
+        });
+        const mintKeypair = createTokenResult.mintKeypair;
+        const mintAddress = createTokenResult.mintAddress;
+        // ==================== Step 3: 创建 Metadata ====================
+        const metadataResult = await signCreateMetadataTransaction(connection, {
+            mint: mintKeypair.publicKey,
+            mintAuthority: creator,
+            payer: creator,
+            name,
+            symbol,
+            uri: metadataUri,
+            sellerFeeBasisPoints: 0,
+            creators: [
+                {
+                    address: creator.publicKey,
+                    verified: true,
+                    share: 100,
+                },
+            ],
+            isMutable: true,
+        });
+        if (!metadataResult.success) {
+            return {
+                success: false,
+                error: `Metadata creation failed: ${metadataResult.error}`,
+            };
+        }
+        // ==================== 获取 ATA 地址 ====================
+        const programId = tokenStandard === 'TOKEN_2022' ? TOKEN_2022_PROGRAM_ID : TOKEN_PROGRAM_ID;
+        const creatorAta = getAssociatedTokenAddressSync(mintKeypair.publicKey, creator.publicKey, false, programId, ASSOCIATED_TOKEN_PROGRAM_ID);
+        // ==================== 组装结果 ====================
+        return {
+            success: true,
+            mint: mintAddress,
+            mintKeypair,
+            metadataAddress: metadataResult.metadataAddress,
+            metadataUri,
+            creatorAta: creatorAta.toBase58(),
+            signedTransactions: [
+                {
+                    data: createTokenResult.signedTransaction.data,
+                    signature: createTokenResult.signedTransaction.signature,
+                    description: 'Create Mint + Mint Initial Supply',
+                },
+                {
+                    data: metadataResult.signedTransaction.data,
+                    signature: metadataResult.signedTransaction.signature,
+                    description: 'Create Metadata',
+                },
+            ],
+            recentBlockhash: createTokenResult.recentBlockhash,
+            lastValidBlockHeight: createTokenResult.lastValidBlockHeight,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 创建代币（不上传元数据，使用已有 URI）
+ * 适用于元数据已经上传的情况
+ */
+export async function createTokenWithUri(connection, params) {
+    try {
+        const { name, symbol, metadataUri, decimals, initialSupply, creator, mintAuthority = creator.publicKey, freezeAuthority = creator.publicKey, tokenStandard = 'TOKEN_2022', } = params;
+        // 创建 Mint + Mint To
+        const createTokenResult = await signCreateTokenTransaction(connection, {
+            creator,
+            decimals,
+            initialSupply,
+            mintAuthority,
+            freezeAuthority,
+            tokenStandard,
+        });
+        const mintKeypair = createTokenResult.mintKeypair;
+        const mintAddress = createTokenResult.mintAddress;
+        // 创建 Metadata
+        const metadataResult = await signCreateMetadataTransaction(connection, {
+            mint: mintKeypair.publicKey,
+            mintAuthority: creator,
+            payer: creator,
+            name,
+            symbol,
+            uri: metadataUri,
+            sellerFeeBasisPoints: 0,
+            creators: [
+                {
+                    address: creator.publicKey,
+                    verified: true,
+                    share: 100,
+                },
+            ],
+            isMutable: true,
+        });
+        if (!metadataResult.success) {
+            return {
+                success: false,
+                error: `Metadata creation failed: ${metadataResult.error}`,
+            };
+        }
+        // 获取 ATA 地址
+        const programId = tokenStandard === 'TOKEN_2022' ? TOKEN_2022_PROGRAM_ID : TOKEN_PROGRAM_ID;
+        const creatorAta = getAssociatedTokenAddressSync(mintKeypair.publicKey, creator.publicKey, false, programId, ASSOCIATED_TOKEN_PROGRAM_ID);
+        return {
+            success: true,
+            mint: mintAddress,
+            mintKeypair,
+            metadataAddress: metadataResult.metadataAddress,
+            metadataUri,
+            creatorAta: creatorAta.toBase58(),
+            signedTransactions: [
+                {
+                    data: createTokenResult.signedTransaction.data,
+                    signature: createTokenResult.signedTransaction.signature,
+                    description: 'Create Mint + Mint Initial Supply',
+                },
+                {
+                    data: metadataResult.signedTransaction.data,
+                    signature: metadataResult.signedTransaction.signature,
+                    description: 'Create Metadata',
+                },
+            ],
+            recentBlockhash: createTokenResult.recentBlockhash,
+            lastValidBlockHeight: createTokenResult.lastValidBlockHeight,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 将创建结果转换为后端 API 格式
+ */
+export function toBackendCreateTokenRequest(result) {
+    if (!result.success || !result.signedTransactions) {
+        return null;
+    }
+    return {
+        mint: result.mint,
+        metadataAddress: result.metadataAddress,
+        metadataUri: result.metadataUri,
+        creatorAta: result.creatorAta,
+        transactions: result.signedTransactions,
+        recentBlockhash: result.recentBlockhash,
+        lastValidBlockHeight: result.lastValidBlockHeight,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=create-complete.js.map

package/dist/token/create-complete.js.map

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

package/dist/token/create-token.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Token-2022 / SPL Token 创建
+ * SDK 只负责构建和签名交易，提交到后端广播
+ * @module sol/token/create-token
+ */
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+import type { TokenStandard, Token2022Extensions, MintToParams, MintToResult } from './types.js';
+/**
+ * 构建并签名创建代币交易（不含 Metaplex 元数据）
+ * @param connection Solana 连接
+ * @param params 创建参数
+ * @returns 签名后的交易数据
+ */
+export declare function signCreateTokenTransaction(connection: Connection, params: {
+    creator: Keypair;
+    decimals: number;
+    initialSupply: bigint;
+    mintAuthority?: PublicKey;
+    freezeAuthority?: PublicKey | null;
+    tokenStandard?: TokenStandard;
+    extensions?: Token2022Extensions;
+}): Promise<{
+    mintKeypair: Keypair;
+    mintAddress: string;
+    signedTransaction: {
+        data: string;
+        signature: string;
+    };
+    recentBlockhash: string;
+    lastValidBlockHeight: number;
+}>;
+/**
+ * 构建并签名 Mint To 交易
+ * @param connection Solana 连接
+ * @param params Mint To 参数
+ */
+export declare function signMintToTransaction(connection: Connection, params: MintToParams): Promise<MintToResult>;
+/**
+ * 批量 Mint To（多个地址）
+ */
+export declare function signBatchMintToTransaction(connection: Connection, params: {
+    mint: string;
+    mintAuthority: Keypair;
+    distributions: Array<{
+        destination: string;
+        amount: bigint;
+    }>;
+    tokenStandard?: TokenStandard;
+}): Promise<{
+    success: boolean;
+    signedTransaction?: {
+        data: string;
+        signature: string;
+    };
+    ataAddresses?: string[];
+    error?: string;
+}>;
+//# sourceMappingURL=create-token.d.ts.map

package/dist/token/create-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-token.d.ts","sourceRoot":"","sources":["../../src/token/create-token.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EAIV,MAAM,iBAAiB,CAAC;AAgBzB,OAAO,KAAK,EAGV,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAuKpB;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IACN,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,GACA,OAAO,CAAC;IACT,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,CAoED;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA4EvB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,KAAK,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,GACA,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA6FD"}