four-flap-meme-sdk 1.4.90 → 1.4.92

package/dist/sol/utils/wallet.js

@@ -0,0 +1,210 @@
+/**
+ * Solana 钱包工具
+ * @module sol/utils/wallet
+ */
+import { Keypair, PublicKey } from '@solana/web3.js';
+import bs58 from 'bs58';
+/**
+ * 生成新的 Solana 钱包
+ * @returns 钱包信息
+ */
+export function generateKeypair() {
+    const keypair = Keypair.generate();
+    return {
+        publicKey: keypair.publicKey.toBase58(),
+        secretKey: keypair.secretKey,
+        secretKeyBase58: bs58.encode(keypair.secretKey),
+        address: keypair.publicKey.toBase58(),
+    };
+}
+/**
+ * 批量生成钱包
+ * @param count 数量
+ * @returns 钱包列表
+ */
+export function generateKeypairs(count) {
+    const wallets = [];
+    for (let i = 0; i < count; i++) {
+        wallets.push(generateKeypair());
+    }
+    return wallets;
+}
+/**
+ * 批量生成钱包（增强版，返回更多信息）
+ * @param count 数量
+ * @returns 详细结果
+ */
+export function batchGenerateWallets(count) {
+    const wallets = [];
+    const addresses = [];
+    const secretKeys = [];
+    const keypairs = [];
+    for (let i = 0; i < count; i++) {
+        const keypair = Keypair.generate();
+        const address = keypair.publicKey.toBase58();
+        const secretKeyBase58 = bs58.encode(keypair.secretKey);
+        wallets.push({
+            publicKey: address,
+            secretKey: keypair.secretKey,
+            secretKeyBase58,
+            address,
+        });
+        addresses.push(address);
+        secretKeys.push(secretKeyBase58);
+        keypairs.push(keypair);
+    }
+    return {
+        wallets,
+        count,
+        addresses,
+        secretKeys,
+        keypairs,
+    };
+}
+/**
+ * 从私钥列表批量导入钱包
+ * @param secretKeys 私钥列表（base58 字符串）
+ * @returns 导入结果
+ */
+export function batchImportWallets(secretKeys) {
+    const keypairs = [];
+    const addresses = [];
+    const failed = [];
+    for (let i = 0; i < secretKeys.length; i++) {
+        try {
+            const keypair = keypairFromSecretKey(secretKeys[i]);
+            keypairs.push(keypair);
+            addresses.push(keypair.publicKey.toBase58());
+        }
+        catch (error) {
+            failed.push({
+                index: i,
+                secretKey: secretKeys[i].slice(0, 8) + '...', // 只显示前8位
+                error: error.message,
+            });
+        }
+    }
+    return {
+        keypairs,
+        addresses,
+        failed,
+    };
+}
+/**
+ * 从私钥导入钱包
+ * @param secretKey 私钥（Uint8Array 或 base58 字符串）
+ * @returns Keypair
+ */
+export function keypairFromSecretKey(secretKey) {
+    try {
+        let keyArray;
+        if (typeof secretKey === 'string') {
+            // base58 格式
+            keyArray = bs58.decode(secretKey);
+        }
+        else {
+            keyArray = secretKey;
+        }
+        // 验证私钥长度
+        if (keyArray.length !== 64) {
+            throw new Error(`Invalid secret key length: ${keyArray.length}, expected 64`);
+        }
+        return Keypair.fromSecretKey(keyArray);
+    }
+    catch (error) {
+        throw new Error(`Failed to import keypair: ${error.message}`);
+    }
+}
+/**
+ * 导出私钥为 base58 格式
+ * @param keypair Keypair
+ * @returns base58 编码的私钥
+ */
+export function exportSecretKey(keypair) {
+    return bs58.encode(keypair.secretKey);
+}
+/**
+ * 导出私钥为 Uint8Array
+ * @param keypair Keypair
+ * @returns Uint8Array 私钥
+ */
+export function exportSecretKeyArray(keypair) {
+    return keypair.secretKey;
+}
+/**
+ * 验证 Solana 地址格式
+ * @param address 地址字符串
+ * @returns 是否有效
+ */
+export function isValidAddress(address) {
+    try {
+        new PublicKey(address);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 验证私钥格式
+ * @param secretKey 私钥（base58 字符串）
+ * @returns 是否有效
+ */
+export function isValidSecretKey(secretKey) {
+    try {
+        const decoded = bs58.decode(secretKey);
+        return decoded.length === 64;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 从私钥获取公钥/地址
+ * @param secretKey 私钥（Uint8Array 或 base58 字符串）
+ * @returns 公钥地址
+ */
+export function getAddressFromSecretKey(secretKey) {
+    const keypair = keypairFromSecretKey(secretKey);
+    return keypair.publicKey.toBase58();
+}
+/**
+ * 创建 PublicKey 对象
+ * @param address 地址字符串
+ * @returns PublicKey
+ */
+export function toPublicKey(address) {
+    if (!isValidAddress(address)) {
+        throw new Error(`Invalid Solana address: ${address}`);
+    }
+    return new PublicKey(address);
+}
+/**
+ * 比较两个地址是否相同
+ * @param addr1 地址1
+ * @param addr2 地址2
+ * @returns 是否相同
+ */
+export function isSameAddress(addr1, addr2) {
+    try {
+        const pk1 = new PublicKey(addr1);
+        const pk2 = new PublicKey(addr2);
+        return pk1.equals(pk2);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 缩短地址显示
+ * @param address 完整地址
+ * @param prefixLength 前缀长度（默认4）
+ * @param suffixLength 后缀长度（默认4）
+ * @returns 缩短后的地址
+ */
+export function shortenAddress(address, prefixLength = 4, suffixLength = 4) {
+    if (address.length <= prefixLength + suffixLength + 3) {
+        return address;
+    }
+    return `${address.slice(0, prefixLength)}...${address.slice(-suffixLength)}`;
+}

package/dist/xlayer/aa-account.d.ts

@@ -0,0 +1,240 @@
+/**
+ * XLayer AA 账户管理器
+ *
+ * 核心功能：
+ * - AA 账户（Sender）地址预测和部署
+ * - UserOperation 构建和签名
+ * - 余额管理和资金充值
+ * - initCode 生成
+ */
+import { ethers, JsonRpcProvider, Wallet, Contract } from 'ethers';
+import type { UserOperation, SignedUserOp, AAAccount, XLayerConfig } from './types.js';
+import { BundlerClient } from './bundler.js';
+/**
+ * AA 账户管理器
+ *
+ * 管理 ERC-4337 SimpleAccount：
+ * - 地址预测（无需部署即可知道地址）
+ * - UserOp 构建和签名
+ * - Gas 估算和 Prefund 计算
+ * - 支持 Paymaster（免 Gas）
+ */
+export declare class AAAccountManager {
+    private provider;
+    private chainId;
+    private factory;
+    private entryPoint;
+    private factoryAddress;
+    private entryPointAddress;
+    private salt;
+    private bundler;
+    private paymaster?;
+    private paymasterData?;
+    private gasLimitMultiplier;
+    constructor(config?: XLayerConfig);
+    /**
+     * 获取 Provider
+     */
+    getProvider(): JsonRpcProvider;
+    /**
+     * 获取 EntryPoint 合约
+     */
+    getEntryPoint(): Contract;
+    /**
+     * 获取 EntryPoint 地址
+     */
+    getEntryPointAddress(): string;
+    /**
+     * 获取 Bundler 客户端
+     */
+    getBundler(): BundlerClient;
+    /**
+     * 获取当前 Fee Data
+     */
+    getFeeData(): Promise<ethers.FeeData>;
+    /**
+     * 预测 AA Sender 地址
+     *
+     * @param ownerAddress Owner EOA 地址
+     * @param salt 可选的 salt 覆盖
+     * @returns 预测的 Sender 地址
+     */
+    predictSenderAddress(ownerAddress: string, salt?: bigint): Promise<string>;
+    /**
+     * 获取完整的 AA 账户信息
+     */
+    getAccountInfo(ownerAddress: string, salt?: bigint): Promise<AAAccount>;
+    /**
+     * 生成 initCode（用于在 UserOp 中部署账户）
+     */
+    generateInitCode(ownerAddress: string, salt?: bigint): string;
+    /**
+     * 构建 paymasterAndData
+     */
+    private buildPaymasterAndData;
+    /**
+     * 构建未签名的 UserOperation（使用 Bundler 估算 Gas）
+     */
+    buildUserOpWithBundlerEstimate(params: {
+        ownerWallet: Wallet;
+        sender: string;
+        callData: string;
+        nonce: bigint;
+        initCode?: string;
+    }): Promise<{
+        userOp: UserOperation;
+        prefundWei: bigint;
+    }>;
+    /**
+     * 构建未签名的 UserOperation（本地估算 Gas，不依赖 Bundler）
+     *
+     * 适用于无法通过 Bundler 估算的场景（如尚未授权的 sell 操作）
+     */
+    buildUserOpWithLocalEstimate(params: {
+        ownerWallet: Wallet;
+        sender: string;
+        callData: string;
+        nonce: bigint;
+        initCode?: string;
+        callGasLimit?: bigint;
+    }): Promise<{
+        userOp: UserOperation;
+        prefundWei: bigint;
+    }>;
+    /**
+     * 签名 UserOperation
+     */
+    signUserOp(userOp: UserOperation, ownerWallet: Wallet): Promise<SignedUserOp>;
+    /**
+     * 构建并签名 UserOperation（完整流程）
+     */
+    buildAndSignUserOp(params: {
+        ownerWallet: Wallet;
+        callData: string;
+        value?: bigint;
+        useBundlerEstimate?: boolean;
+        callGasLimit?: bigint;
+    }): Promise<SignedUserOp>;
+    /**
+     * 确保 Sender 有足够的 OKB 余额
+     *
+     * @param ownerWallet Owner 钱包（用于转账）
+     * @param sender Sender 地址
+     * @param requiredWei 所需余额（wei）
+     * @param tag 日志标签
+     * @returns 是否进行了转账
+     */
+    ensureSenderBalance(ownerWallet: Wallet, sender: string, requiredWei: bigint, tag?: string): Promise<{
+        funded: boolean;
+        txHash?: string;
+    }>;
+    /**
+     * 批量获取多个 owner 的 AA 账户信息
+     */
+    getMultipleAccountInfo(ownerAddresses: string[]): Promise<AAAccount[]>;
+}
+/**
+ * 编码 SimpleAccount.execute 调用
+ */
+export declare function encodeExecute(dest: string, value: bigint, data: string): string;
+/**
+ * 编码 SimpleAccount.executeBatch 调用
+ */
+export declare function encodeExecuteBatch(dests: string[], values: bigint[], datas: string[]): string;
+/**
+ * 创建 AA 账户管理器
+ */
+export declare function createAAAccountManager(config?: XLayerConfig): AAAccountManager;
+/**
+ * 快速预测 Sender 地址
+ */
+export declare function predictSender(ownerAddress: string, config?: XLayerConfig): Promise<string>;
+/**
+ * 从私钥创建连接了 Provider 的 Wallet
+ */
+export declare function createWallet(privateKey: string, config?: XLayerConfig): Wallet;
+/**
+ * 生成的钱包信息（包含 AA 地址）
+ */
+export interface GeneratedAAWallet {
+    /** 索引 */
+    index: number;
+    /** Owner EOA 地址 */
+    owner: string;
+    /** Owner 私钥 */
+    privateKey: string;
+    /** AA Sender 地址（预测） */
+    sender: string;
+    /** 助记词（仅当使用 generateAAWalletsFromMnemonic 时） */
+    mnemonic?: string;
+    /** 派生路径（仅当使用 generateAAWalletsFromMnemonic 时） */
+    derivationPath?: string;
+}
+/**
+ * 批量生成钱包参数
+ */
+export interface GenerateAAWalletsParams {
+    /** 生成数量 */
+    count: number;
+    /** 配置 */
+    config?: XLayerConfig;
+}
+/**
+ * 批量生成钱包结果
+ */
+export interface GenerateAAWalletsResult {
+    /** 生成的钱包列表 */
+    wallets: GeneratedAAWallet[];
+    /** 所有 owner 地址 */
+    owners: string[];
+    /** 所有私钥 */
+    privateKeys: string[];
+    /** 所有 AA sender 地址 */
+    senders: string[];
+    /** 格式化输出（方便复制） */
+    formatted: string;
+}
+/**
+ * 批量生成随机钱包并预测 AA 地址
+ *
+ * @param params 生成参数
+ * @returns 钱包列表和汇总信息
+ *
+ * @example
+ * ```typescript
+ * const result = await generateAAWallets({ count: 5 });
+ *
+ * console.log(result.formatted);
+ * // 输出:
+ * // === XLayer AA Wallets ===
+ * // #1
+ * //   Owner:  0x1234...
+ * //   Sender: 0xabcd...
+ * //   Key:    0x...
+ * // ...
+ *
+ * // 直接使用私钥列表
+ * await bundleBuy({
+ *   tokenAddress: '0x...',
+ *   privateKeys: result.privateKeys,
+ *   buyAmounts: ['0.01', '0.01', '0.01', '0.01', '0.01'],
+ * });
+ * ```
+ */
+export declare function generateAAWallets(params: GenerateAAWalletsParams): Promise<GenerateAAWalletsResult>;
+/**
+ * 从助记词批量派生钱包并预测 AA 地址
+ *
+ * @param mnemonic 助记词
+ * @param count 派生数量
+ * @param startIndex 起始索引（默认 0）
+ * @param config 配置
+ */
+export declare function generateAAWalletsFromMnemonic(mnemonic: string, count: number, startIndex?: number, config?: XLayerConfig): Promise<GenerateAAWalletsResult>;
+/**
+ * 从私钥列表预测 AA 地址
+ *
+ * @param privateKeys 私钥列表
+ * @param config 配置
+ */
+export declare function predictSendersFromPrivateKeys(privateKeys: string[], config?: XLayerConfig): Promise<GenerateAAWalletsResult>;