forgex-cli 1.0.0

package/dist/src/utils/index.d.ts

@@ -0,0 +1,13 @@
+import { Keypair } from '@solana/web3.js';
+export declare const formatWalletAddress: (address: string) => string;
+export declare const getSplitAmount: (amount: number | string, decimals: number) => number;
+export declare const getWalletAddress: (privateKey: string) => string;
+export declare const getWalletKeypair: (privateKey: string) => Keypair;
+export declare const formatNumber: (num: number | string) => string;
+export declare const getNativePriceFromAmountInOut: (amountIn: string, amountOut: string, tokenA: string, decimals?: number) => string;
+export declare const formatNumberToKMBT: (num: number) => string;
+export declare const formatSmallNumber: (num: string, threshold?: number, significantDigits?: number, trimTrailingZeros?: boolean) => string;
+export declare const normalNumber: (num: number | string, threshold?: number, decimalPlaces?: number, trimTrailingZeros?: boolean) => string;
+export declare const sleep: (ms: number) => Promise<unknown>;
+export declare const getValidPairs: (pairs: Pair[]) => Pair[];
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAoB,MAAM,iBAAiB,CAAC;AAO5D,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAGrD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,GAAG,MAAM,EAAE,UAAU,MAAM,KAAG,MAa1E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,MAErD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,OAErD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,GAAG,MAAM,WAMhD,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,QAAQ,MAAM,EACd,WAAU,MAAU,KACnB,MAmBF,CAAC;AAGF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,MAwBhD,CAAC;AAOF,eAAO,MAAM,iBAAiB,GAC5B,KAAK,MAAM,EACX,kBAAa,EACb,0BAAqB,EACrB,2BAAwB,KACvB,MAgEF,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,GAAG,MAAM,EACpB,kBAAa,EACb,sBAAiB,EACjB,2BAAwB,KACvB,MAUF,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAE/B,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,IAAI,EAAE,WAM1C,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,174 @@
+import { Keypair, LAMPORTS_PER_SOL } from '@solana/web3.js';
+import bs58 from 'bs58';
+import BigNumber from 'bignumber.js';
+import { NATIVE_MINT } from '@solana/spl-token';
+const validExchanges = ['Pump', 'PumpSwap', 'Raydium', 'Raydium CPMM', 'LaunchLab', 'Meteora'];
+export const formatWalletAddress = (address) => {
+    if (!address)
+        return '';
+    return address.slice(0, 6) + '...' + address.slice(-4);
+};
+export const getSplitAmount = (amount, decimals) => {
+    const splitStr = String(amount).split('.');
+    const left = splitStr[0];
+    if (decimals == 0)
+        return Number(left);
+    if (splitStr.length > 1) {
+        const right = splitStr[1];
+        if (right.length > decimals) {
+            return Number(left + '.' + right.slice(0, decimals));
+        }
+        else {
+            return Number(left + '.' + right);
+        }
+    }
+    return Number(left);
+};
+export const getWalletAddress = (privateKey) => {
+    return Keypair.fromSecretKey(bs58.decode(privateKey)).publicKey.toBase58();
+};
+export const getWalletKeypair = (privateKey) => {
+    return Keypair.fromSecretKey(bs58.decode(privateKey));
+};
+export const formatNumber = (num) => {
+    num = Number(num);
+    if (num >= 1e9)
+        return (num / 1e9).toFixed(2).replace(/\.00$/, '') + 'B';
+    if (num >= 1e6)
+        return (num / 1e6).toFixed(2).replace(/\.00$/, '') + 'M';
+    if (num >= 1e3)
+        return (num / 1e3).toFixed(2).replace(/\.00$/, '') + 'k';
+    return num.toString();
+};
+export const getNativePriceFromAmountInOut = (amountIn, amountOut, tokenA, decimals = 6) => {
+    try {
+        let price = '0';
+        if (tokenA === NATIVE_MINT.toBase58()) {
+            price = new BigNumber(amountIn)
+                .div(LAMPORTS_PER_SOL)
+                .div(new BigNumber(amountOut).div(10 ** decimals))
+                .toString(10);
+        }
+        else {
+            price = new BigNumber(amountOut)
+                .div(LAMPORTS_PER_SOL)
+                .div(new BigNumber(amountIn).div(10 ** decimals))
+                .toString(10);
+        }
+        return price;
+    }
+    catch (error) {
+        console.error(error);
+        return '0';
+    }
+};
+// 数字格式化为 k, m, b, t
+export const formatNumberToKMBT = (num) => {
+    // 处理正负数
+    const isNegative = num < 0;
+    const absNum = Math.abs(num);
+    // 进行格式化处理
+    let result;
+    if (absNum >= 1e12) {
+        result = (absNum / 1e12).toFixed(2) + 'T';
+    }
+    else if (absNum >= 1e9) {
+        result = (absNum / 1e9).toFixed(2) + 'B';
+    }
+    else if (absNum >= 1e6) {
+        result = (absNum / 1e6).toFixed(2) + 'M';
+    }
+    else if (absNum >= 1e3) {
+        result = (absNum / 1e3).toFixed(2) + 'K';
+    }
+    else {
+        result = absNum.toFixed(2);
+    }
+    // 去除末尾的 0 和不必要的小数点
+    result = result.replace(/\.?0+$/, '');
+    // 添加负号（如果原数为负）
+    return isNegative ? '-' + result : result;
+};
+/* @param {number} num - 要格式化的数字
+ * @param {number} threshold - 阈值，0的个数大于等于此值时进行处理
+ * @param {number} significantDigits - 保留的有效数字位数
+ * @returns {string} 格式化后的字符串
+ */
+export const formatSmallNumber = (num, threshold = 4, significantDigits = 6, trimTrailingZeros = true) => {
+    // 将数字转换为字符串，避免科学计数法
+    const numStr = num;
+    if (!numStr.includes('.'))
+        return numStr;
+    const [intPart, decimalPart] = numStr.split('.');
+    // 计算开头连续0的个数
+    let zeroCount = 0;
+    for (let i = 0; i < decimalPart.length; i++) {
+        if (decimalPart[i] === '0') {
+            zeroCount++;
+        }
+        else {
+            break;
+        }
+    }
+    // 如果0的个数大于阈值，使用下标格式
+    if (zeroCount >= threshold) {
+        const subscript = zeroCount
+            .toString()
+            .split('')
+            .map(n => '₀₁₂₃₄₅₆₇₈₉'[parseInt(n)])
+            .join('');
+        const remainingPart = decimalPart.slice(zeroCount);
+        // 取指定有效位数
+        let formattedRemaining = remainingPart.slice(0, significantDigits);
+        // 如果需要去掉末尾的0
+        if (trimTrailingZeros) {
+            formattedRemaining = formattedRemaining.replace(/0+$/, '');
+        }
+        else {
+            // 补 0
+            formattedRemaining = formattedRemaining.padEnd(significantDigits, '0');
+        }
+        // 如果去掉末尾的0后为空字符串，直接返回不包含小数点的结果
+        if (formattedRemaining === '') {
+            return `${intPart}.0${subscript}`;
+        }
+        return `${intPart}.0${subscript}${formattedRemaining}`;
+    }
+    // 否则从第一个非0数字开始计算位数
+    const firstNonZeroIndex = decimalPart.search(/[1-9]/);
+    if (firstNonZeroIndex === -1) {
+        // 如果小数部分全是0
+        return trimTrailingZeros ? `${intPart}` : `${intPart}.${decimalPart}`;
+    }
+    let formattedDecimal = decimalPart.slice(0, firstNonZeroIndex + significantDigits);
+    // 根据trimTrailingZeros参数决定是否去掉末尾的0
+    if (trimTrailingZeros) {
+        formattedDecimal = formattedDecimal.replace(/0+$/, '');
+        // 如果去掉末尾的0后为空字符串或者全是前导零，则不显示小数点
+        if (formattedDecimal === '' || formattedDecimal.match(/^0+$/)) {
+            return intPart;
+        }
+    }
+    return `${intPart}.${formattedDecimal}`;
+};
+export const normalNumber = (num, threshold = 3, decimalPlaces = 6, trimTrailingZeros = true) => {
+    if (isNaN(Number(num))) {
+        return '0';
+    }
+    const currentNum = new BigNumber(num).toString(10);
+    if (Math.abs(Number(currentNum)) > 0.9999) {
+        return formatNumberToKMBT(Number(currentNum));
+    }
+    else {
+        return formatSmallNumber(currentNum, threshold, decimalPlaces, trimTrailingZeros);
+    }
+};
+export const sleep = (ms) => {
+    return new Promise(resolve => setTimeout(resolve, ms));
+};
+export const getValidPairs = (pairs) => {
+    const filteredPairs = pairs.filter(item => validExchanges.includes(item.exchange.name));
+    const solPairs = filteredPairs.filter(item => item.tokenA === NATIVE_MINT.toBase58() || item.tokenB === NATIVE_MINT.toBase58());
+    return solPairs;
+};
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

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

package/dist/src/wallet-store.d.ts

@@ -0,0 +1,124 @@
+/**
+ * ForgeX CLI 钱包存储
+ *
+ * 本地加密存储钱包组数据，替代前端的 IndexedDB 持久化方案。
+ * 使用 AES 加密私钥（静态加密），支持 KDF v3 格式导入/导出。
+ *
+ * 加密方案：
+ * - 每个 WalletInfo.privateKey 字段使用 CryptoJS AES 加密存储
+ * - master password 通过 FORGEX_PASSWORD 环境变量或 inquirer 交互输入
+ * - WalletStoreData.encrypted 标记区分加密格式和旧明文格式
+ * - 旧格式自动迁移到加密格式
+ */
+export interface WalletInfo {
+    walletAddress: string;
+    privateKey: string;
+    note: string;
+}
+export interface GroupInfo {
+    name: string;
+    groupId: number;
+    groupType: 'local' | 'monitor';
+    wallets: WalletInfo[];
+    monitorType: 'normal' | 'top100' | 'retail';
+    note: string;
+    monitorCA?: string;
+    filterGroupIds?: number[];
+}
+export interface WalletStoreData {
+    groups: Record<number, GroupInfo>;
+    notes: Record<string, string>;
+    devWallets: Record<string, string>;
+    /** 标记存储是否已加密。true 表示 privateKey 字段为 AES 密文 */
+    encrypted?: boolean;
+    /** 用于验证密码正确性的校验值（加密后的已知明文） */
+    passwordCheck?: string;
+}
+/**
+ * 设置 master password（供 CLI 入口调用）
+ * 密码将保存在内存中，仅在当前进程生命周期内有效。
+ */
+export declare function setMasterPassword(password: string): void;
+/**
+ * 获取当前 master password
+ * 优先级：内存中的密码 > 环境变量 FORGEX_PASSWORD
+ */
+export declare function getMasterPassword(): string | null;
+/**
+ * 确保 master password 已设置。
+ * 如果未设置，尝试从环境变量读取；如果仍未获取到，通过 inquirer 交互提示输入。
+ * 此函数为异步函数，因为可能需要等待用户输入。
+ */
+export declare function ensureMasterPassword(): Promise<string>;
+/**
+ * 解密单个 WalletInfo 的私钥（供 SDK 和命令调用）
+ *
+ * 如果存储未加密（旧格式），直接返回原始 privateKey。
+ * 如果已加密，使用 master password 解密后返回 Base58 明文私钥。
+ */
+export declare function getDecryptedPrivateKey(walletInfo: WalletInfo): string;
+/**
+ * 异步版本的解密函数，会自动确保密码已设置
+ */
+export declare function getDecryptedPrivateKeyAsync(walletInfo: WalletInfo): Promise<string>;
+/** 加载钱包存储数据（原始格式，不解密私钥） */
+export declare function loadWalletStore(): WalletStoreData;
+/** 保存钱包存储数据 */
+export declare function saveWalletStore(data: WalletStoreData): void;
+/**
+ * 检测存储是否为旧格式（未加密），如果是则提示并执行迁移。
+ *
+ * 此函数应在 CLI 入口处调用。迁移过程：
+ * 1. 读取明文存储
+ * 2. 确保用户设置了 master password
+ * 3. 加密所有 privateKey 字段
+ * 4. 添加 encrypted 标记和密码校验值
+ * 5. 保存加密后的存储
+ */
+export declare function migrateToEncryptedStore(): Promise<void>;
+/**
+ * 验证当前 master password 是否与存储中的密码校验值匹配。
+ * 如果存储未加密，返回 true。
+ */
+export declare function validateMasterPassword(): boolean;
+/**
+ * 确保密码已设置且正确。供 CLI 入口在执行需要私钥的命令前调用。
+ */
+export declare function ensurePasswordAndValidate(): Promise<void>;
+/** 获取所有钱包组 */
+export declare function getAllGroups(): GroupInfo[];
+/** 获取单个钱包组 */
+export declare function getGroup(groupId: number): GroupInfo | undefined;
+/** 保存钱包组（新增或更新） */
+export declare function saveGroup(group: GroupInfo): void;
+/** 删除钱包组 */
+export declare function removeGroup(groupId: number): boolean;
+/** 向钱包组添加钱包（私钥将根据存储状态自动加密） */
+export declare function addWalletsToGroup(groupId: number, wallets: WalletInfo[]): boolean;
+/** 从钱包组移除钱包 */
+export declare function removeWalletsFromGroup(groupId: number, addresses: string[]): boolean;
+/** 生成新钱包（返回明文私钥，存储时由 addWalletsToGroup 负责加密） */
+export declare function generateWallets(count: number): WalletInfo[];
+/** 从私钥恢复钱包信息 */
+export declare function walletFromPrivateKey(privateKey: string, note?: string): WalletInfo;
+/** 加密导出钱包存储（整体加密，用于备份） */
+export declare function encryptWalletStore(password: string): string;
+/** 解密导入钱包存储 */
+export declare function decryptWalletStore(encrypted: string, password: string): WalletStoreData | null;
+/** 导出钱包组为 CSV（自动解密私钥） */
+export declare function exportGroupToCsv(groupId: number): string | null;
+/** 从 CSV 导入钱包 */
+export declare function importWalletsFromCsv(csvContent: string): WalletInfo[];
+/** 导出所有钱包组为 JSON（兼容前端导入格式，自动解密私钥） */
+export declare function exportAllGroupsJson(): string;
+/** 导出加密的钱包组 JSON */
+export declare function exportEncryptedGroupsJson(password: string): string;
+/** 导入钱包组 JSON */
+export declare function importGroupsFromJson(jsonContent: string, password?: string): GroupInfo[] | null;
+/** 获取钱包备注 */
+export declare function getNote(address: string): string;
+/** 设置钱包备注 */
+export declare function setNote(address: string, note: string): void;
+/** 获取所有备注 */
+export declare function getAllNotes(): Record<string, string>;
+//# sourceMappingURL=wallet-store.d.ts.map

package/dist/src/wallet-store.d.ts.map

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