four-flap-meme-sdk 1.5.55 → 1.5.56

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

@@ -0,0 +1,235 @@
+/**
+ * 完整代币创建流程
+ * 包括：上传元数据 → 创建 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(),
+    };
+}

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

@@ -0,0 +1,57 @@
+/**
+ * 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;
+}>;

package/dist/sol/token/create-token.js

@@ -0,0 +1,230 @@
+/**
+ * Token-2022 / SPL Token 创建
+ * SDK 只负责构建和签名交易，提交到后端广播
+ * @module sol/token/create-token
+ */
+import { Keypair, PublicKey, SystemProgram, Transaction, } from '@solana/web3.js';
+import { TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, createInitializeMintInstruction, createAssociatedTokenAccountInstruction, createMintToInstruction, getAssociatedTokenAddressSync, getMintLen, ExtensionType, createInitializeTransferFeeConfigInstruction, createInitializeNonTransferableMintInstruction, createInitializePermanentDelegateInstruction, } from '@solana/spl-token';
+import { ACCOUNT_SIZE } from '../constants.js';
+/**
+ * 获取 Token Program ID
+ */
+function getTokenProgramId(standard = 'TOKEN_2022') {
+    return standard === 'TOKEN_2022' ? TOKEN_2022_PROGRAM_ID : TOKEN_PROGRAM_ID;
+}
+/**
+ * 计算 Mint 账户大小（包括扩展）
+ */
+function calculateMintSize(extensions) {
+    if (!extensions) {
+        return getMintLen([]);
+    }
+    const extensionTypes = [];
+    if (extensions.transferFee) {
+        extensionTypes.push(ExtensionType.TransferFeeConfig);
+    }
+    if (extensions.nonTransferable) {
+        extensionTypes.push(ExtensionType.NonTransferable);
+    }
+    if (extensions.permanentDelegate) {
+        extensionTypes.push(ExtensionType.PermanentDelegate);
+    }
+    return getMintLen(extensionTypes);
+}
+/**
+ * 构建创建 Mint 账户的指令
+ */
+async function buildCreateMintInstructions(connection, payer, mintKeypair, mintAuthority, freezeAuthority, decimals, tokenStandard, extensions) {
+    const instructions = [];
+    const programId = getTokenProgramId(tokenStandard);
+    // 计算账户大小和租金
+    const mintSize = tokenStandard === 'TOKEN_2022'
+        ? calculateMintSize(extensions)
+        : ACCOUNT_SIZE.MINT;
+    const lamports = await connection.getMinimumBalanceForRentExemption(mintSize);
+    // 1. 创建账户
+    instructions.push(SystemProgram.createAccount({
+        fromPubkey: payer,
+        newAccountPubkey: mintKeypair.publicKey,
+        space: mintSize,
+        lamports,
+        programId,
+    }));
+    // 2. 初始化扩展（Token-2022 only，必须在 InitializeMint 之前）
+    if (tokenStandard === 'TOKEN_2022' && extensions) {
+        // 转账手续费
+        if (extensions.transferFee) {
+            instructions.push(createInitializeTransferFeeConfigInstruction(mintKeypair.publicKey, mintAuthority, // transferFeeConfigAuthority
+            mintAuthority, // withdrawWithheldAuthority
+            extensions.transferFee.feeBasisPoints, extensions.transferFee.maxFee, programId));
+        }
+        // 不可转让
+        if (extensions.nonTransferable) {
+            instructions.push(createInitializeNonTransferableMintInstruction(mintKeypair.publicKey, programId));
+        }
+        // 永久代理
+        if (extensions.permanentDelegate) {
+            instructions.push(createInitializePermanentDelegateInstruction(mintKeypair.publicKey, extensions.permanentDelegate, programId));
+        }
+    }
+    // 3. 初始化 Mint
+    instructions.push(createInitializeMintInstruction(mintKeypair.publicKey, decimals, mintAuthority, freezeAuthority, programId));
+    return instructions;
+}
+/**
+ * 构建创建 ATA 和 Mint To 的指令
+ */
+function buildMintToInstructions(mint, destination, mintAuthority, amount, tokenStandard, payer) {
+    const instructions = [];
+    const programId = getTokenProgramId(tokenStandard);
+    // 获取 ATA 地址
+    const ata = getAssociatedTokenAddressSync(mint, destination, false, programId, ASSOCIATED_TOKEN_PROGRAM_ID);
+    // 1. 创建 ATA（如果不存在）
+    instructions.push(createAssociatedTokenAccountInstruction(payer, ata, destination, mint, programId, ASSOCIATED_TOKEN_PROGRAM_ID));
+    // 2. Mint To
+    instructions.push(createMintToInstruction(mint, ata, mintAuthority, amount, [], programId));
+    return instructions;
+}
+/**
+ * 构建并签名创建代币交易（不含 Metaplex 元数据）
+ * @param connection Solana 连接
+ * @param params 创建参数
+ * @returns 签名后的交易数据
+ */
+export async function signCreateTokenTransaction(connection, params) {
+    const { creator, decimals, initialSupply, mintAuthority = creator.publicKey, freezeAuthority = creator.publicKey, tokenStandard = 'TOKEN_2022', extensions, } = params;
+    // 生成 Mint Keypair
+    const mintKeypair = Keypair.generate();
+    const programId = getTokenProgramId(tokenStandard);
+    // 获取 blockhash
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('finalized');
+    // 构建指令
+    const instructions = [];
+    // 1. 创建 Mint
+    const createMintIxs = await buildCreateMintInstructions(connection, creator.publicKey, mintKeypair, mintAuthority, freezeAuthority, decimals, tokenStandard, extensions);
+    instructions.push(...createMintIxs);
+    // 2. 创建 ATA 并 Mint 初始供应量
+    if (initialSupply > 0) {
+        const mintToIxs = buildMintToInstructions(mintKeypair.publicKey, creator.publicKey, // mint 到创建者
+        mintAuthority, initialSupply * BigInt(10 ** decimals), tokenStandard, creator.publicKey);
+        instructions.push(...mintToIxs);
+    }
+    // 构建交易
+    const transaction = new Transaction();
+    transaction.add(...instructions);
+    transaction.recentBlockhash = blockhash;
+    transaction.feePayer = creator.publicKey;
+    // 签名（需要 creator 和 mintKeypair）
+    transaction.sign(creator, mintKeypair);
+    const serialized = transaction.serialize();
+    return {
+        mintKeypair,
+        mintAddress: mintKeypair.publicKey.toBase58(),
+        signedTransaction: {
+            data: Buffer.from(serialized).toString('base64'),
+            signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : '',
+        },
+        recentBlockhash: blockhash,
+        lastValidBlockHeight,
+    };
+}
+/**
+ * 构建并签名 Mint To 交易
+ * @param connection Solana 连接
+ * @param params Mint To 参数
+ */
+export async function signMintToTransaction(connection, params) {
+    try {
+        const { mint, destination, amount, mintAuthority, tokenStandard = 'TOKEN_2022', } = params;
+        const programId = getTokenProgramId(tokenStandard);
+        const mintPubkey = new PublicKey(mint);
+        const destinationPubkey = new PublicKey(destination);
+        // 获取 ATA 地址
+        const ata = getAssociatedTokenAddressSync(mintPubkey, destinationPubkey, false, programId, ASSOCIATED_TOKEN_PROGRAM_ID);
+        const { blockhash } = await connection.getLatestBlockhash('finalized');
+        // 构建交易
+        const transaction = new Transaction();
+        // 检查 ATA 是否存在
+        const ataInfo = await connection.getAccountInfo(ata);
+        if (!ataInfo) {
+            // 创建 ATA
+            transaction.add(createAssociatedTokenAccountInstruction(mintAuthority.publicKey, ata, destinationPubkey, mintPubkey, programId, ASSOCIATED_TOKEN_PROGRAM_ID));
+        }
+        // Mint To
+        transaction.add(createMintToInstruction(mintPubkey, ata, mintAuthority.publicKey, amount, [], programId));
+        transaction.recentBlockhash = blockhash;
+        transaction.feePayer = mintAuthority.publicKey;
+        transaction.sign(mintAuthority);
+        const serialized = transaction.serialize();
+        return {
+            success: true,
+            ataAddress: ata.toBase58(),
+            signedTransaction: {
+                data: Buffer.from(serialized).toString('base64'),
+                signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : '',
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 批量 Mint To（多个地址）
+ */
+export async function signBatchMintToTransaction(connection, params) {
+    try {
+        const { mint, mintAuthority, distributions, tokenStandard = 'TOKEN_2022', } = params;
+        if (distributions.length === 0) {
+            return { success: false, error: 'No distributions provided' };
+        }
+        if (distributions.length > 10) {
+            return { success: false, error: 'Too many distributions. Max 10 per transaction.' };
+        }
+        const programId = getTokenProgramId(tokenStandard);
+        const mintPubkey = new PublicKey(mint);
+        const { blockhash } = await connection.getLatestBlockhash('finalized');
+        const transaction = new Transaction();
+        const ataAddresses = [];
+        // 批量获取 ATA 信息
+        const atas = distributions.map(d => {
+            const destPubkey = new PublicKey(d.destination);
+            return getAssociatedTokenAddressSync(mintPubkey, destPubkey, false, programId, ASSOCIATED_TOKEN_PROGRAM_ID);
+        });
+        const ataInfos = await connection.getMultipleAccountsInfo(atas);
+        for (let i = 0; i < distributions.length; i++) {
+            const dist = distributions[i];
+            const ata = atas[i];
+            const ataInfo = ataInfos[i];
+            const destPubkey = new PublicKey(dist.destination);
+            ataAddresses.push(ata.toBase58());
+            // 创建 ATA（如果不存在）
+            if (!ataInfo) {
+                transaction.add(createAssociatedTokenAccountInstruction(mintAuthority.publicKey, ata, destPubkey, mintPubkey, programId, ASSOCIATED_TOKEN_PROGRAM_ID));
+            }
+            // Mint To
+            transaction.add(createMintToInstruction(mintPubkey, ata, mintAuthority.publicKey, dist.amount, [], programId));
+        }
+        transaction.recentBlockhash = blockhash;
+        transaction.feePayer = mintAuthority.publicKey;
+        transaction.sign(mintAuthority);
+        const serialized = transaction.serialize();
+        return {
+            success: true,
+            signedTransaction: {
+                data: Buffer.from(serialized).toString('base64'),
+                signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : '',
+            },
+            ataAddresses,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}

package/dist/sol/token/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Token 创建模块
+ * @module sol/token
+ */
+export * from './types.js';
+export * from './metadata-upload.js';
+export * from './create-token.js';
+export * from './metadata.js';
+export * from './create-complete.js';

package/dist/sol/token/index.js

@@ -0,0 +1,14 @@
+/**
+ * Token 创建模块
+ * @module sol/token
+ */
+// 类型导出
+export * from './types.js';
+// 元数据上传
+export * from './metadata-upload.js';
+// 代币创建
+export * from './create-token.js';
+// Metaplex 元数据
+export * from './metadata.js';
+// 完整创建流程
+export * from './create-complete.js';

package/dist/sol/token/metadata-upload.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 元数据上传（复用 Flap 官方 IPFS 接口）
+ * @module sol/token/metadata-upload
+ */
+import type { TokenMetadataInput, TokenMetadataJson } from './types.js';
+/**
+ * 上传结果
+ */
+export interface UploadResult {
+    success: boolean;
+    /** CID（bafkrei... 格式） */
+    cid?: string;
+    /** 完整 IPFS URI */
+    uri?: string;
+    error?: string;
+}
+/**
+ * Flap 元数据输入
+ */
+export interface FlapMetaInput {
+    /** 创建者地址 */
+    creator?: string;
+    /** 描述 */
+    description?: string;
+    /** Telegram 链接 */
+    telegram?: string | null;
+    /** Twitter 链接 */
+    twitter?: string | null;
+    /** 网站链接 */
+    website?: string | null;
+}
+/**
+ * 使用 Flap 官方 GraphQL 接口上传文件到 IPFS
+ * 同时上传图片和元数据，返回 bafkrei... 格式的 CIDv1
+ *
+ * @param file 图片文件（File 或 Uint8Array 或 Buffer）
+ * @param meta 元数据
+ * @returns CID
+ */
+export declare function uploadToFlapIPFS(file: File | Uint8Array | Buffer, meta: FlapMetaInput): Promise<UploadResult>;
+/**
+ * 上传图片和元数据到 IPFS（Flap 官方接口）
+ * 这是主要的上传方法
+ *
+ * @param imageBuffer 图片 Buffer
+ * @param metadata 代币元数据
+ * @returns 上传结果
+ */
+export declare function uploadTokenMetadata(imageBuffer: Buffer | Uint8Array, metadata: {
+    name: string;
+    symbol: string;
+    description: string;
+    creator?: string;
+    telegram?: string;
+    twitter?: string;
+    website?: string;
+}): Promise<UploadResult>;
+/**
+ * 从 File 对象上传（浏览器环境）
+ */
+export declare function uploadTokenMetadataFromFile(file: File, metadata: {
+    name: string;
+    symbol: string;
+    description: string;
+    creator?: string;
+    telegram?: string;
+    twitter?: string;
+    website?: string;
+}): Promise<UploadResult>;
+/**
+ * 构建完整的 Metaplex 元数据 JSON
+ * 用于已经上传图片后，构建标准的元数据格式
+ */
+export declare function buildMetaplexMetadataJson(metadata: TokenMetadataInput, imageCid: string): TokenMetadataJson;
+/**
+ * 构建元数据 JSON（不上传，用于已有图片 URL 的情况）
+ */
+export declare function buildMetadataJson(metadata: TokenMetadataInput): TokenMetadataJson;
+/**
+ * CID 转换为 IPFS URI
+ */
+export declare function cidToUri(cid: string): string;
+/**
+ * CID 转换为 HTTP 网关 URL
+ */
+export declare function cidToHttpUrl(cid: string, gateway?: string): string;