four-flap-meme-sdk 1.5.6 → 1.5.8

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

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

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

@@ -1,230 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,14 +0,0 @@
-/**
- * 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

@@ -1,86 +0,0 @@
-/**
- * 元数据上传（复用 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;