gate-evm-tools 1.0.0

package/dist/index.js

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { checkBytecode } from './commands/check.js';
+import { syncUpgrade } from './commands/sync.js';
+import { validateUpgrade } from './commands/validate.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 读取 package.json 获取版本号
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('gate-tool')
+    .description('🛠️  Gate 智能合约工具集 - 字节码检查、合约升级验证')
+    .version(packageJson.version, '-v, --version', '显示版本号');
+// check 命令
+program
+    .command('check')
+    .description('执行字节码检查')
+    .option('-c, --contract <name>', '指定要检查的合约名称')
+    .option('-n, --network <name>', '指定要检查的网络名称')
+    .option('--config <path>', '指定配置文件路径 (默认: ./contractInfo.json)')
+    .option('-o, --output <path>', '指定输出报告文件路径 (默认: ./bytecode-check-report.json)')
+    .action(async (options) => {
+    try {
+        await checkBytecode(options);
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ 执行失败:'), error.message);
+        process.exit(1);
+    }
+});
+// sync 命令
+program
+    .command('sync')
+    .description('同步链上合约状态到本地 .openzeppelin 文件')
+    .requiredOption('--proxy <address>', '代理合约地址')
+    .requiredOption('--contract <name>', '合约名称')
+    .option('-n, --network <name>', '网络名称')
+    .action(async (options) => {
+    try {
+        await syncUpgrade(options);
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ 执行失败:'), error.message);
+        process.exit(1);
+    }
+});
+// validate 命令
+program
+    .command('validate')
+    .description('验证合约升级安全性并生成 calldata')
+    .requiredOption('--proxy <address>', '代理合约地址')
+    .requiredOption('--old <name>', '旧合约名称')
+    .requiredOption('--new <name>', '新合约名称')
+    .option('-n, --network <name>', '网络名称')
+    .option('-o, --output <path>', '输出文件路径 (默认: ./upgradeCalldata.json)')
+    .action(async (options) => {
+    try {
+        await validateUpgrade(options);
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ 执行失败:'), error.message);
+        process.exit(1);
+    }
+});
+// 显示帮助信息（无命令时）
+program.action(() => {
+    program.outputHelp();
+});
+export async function run() {
+    program.parse(process.argv);
+    // 如果没有提供命令，显示帮助
+    if (!process.argv.slice(2).length) {
+        program.outputHelp();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export interface ContractInfo {
+    name: string;
+    address: string;
+    network: string;
+}
+export interface CheckResult {
+    contract: string;
+    contractName: string;
+    network: string;
+    address: string;
+    matches: boolean;
+    error: string | null;
+    reason: string;
+    onChainBytecodeLength: number;
+    localBytecodeLength: number;
+}
+export interface NetworkConfig {
+    [contractName: string]: string;
+}
+export interface ContractConfig {
+    [network: string]: NetworkConfig;
+}
+export interface CheckOptions {
+    contract?: string;
+    network?: string;
+    config?: string;
+    output?: string;
+}
+export interface SyncOptions {
+    proxy: string;
+    contract: string;
+    network?: string;
+}
+export interface ValidateOptions {
+    proxy: string;
+    old: string;
+    new: string;
+    network?: string;
+    output?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/files.d.ts

@@ -0,0 +1,18 @@
+import { ContractConfig } from '../types.js';
+/**
+ * 查找配置文件
+ */
+export declare function findConfigFile(configPath?: string): string;
+/**
+ * 读取配置文件
+ */
+export declare function readConfigFile(configPath: string): ContractConfig;
+/**
+ * 保存报告文件
+ */
+export declare function saveReport(data: any, outputPath?: string): string;
+/**
+ * 合并报告（增量更新）
+ */
+export declare function mergeReports(existingReport: any, newResults: any): any;
+//# sourceMappingURL=files.d.ts.map

package/dist/utils/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CA6B1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAOjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,GAAG,GAAG,CActE"}

package/dist/utils/files.js

@@ -0,0 +1,75 @@
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * 查找配置文件
+ */
+export function findConfigFile(configPath) {
+    const cwd = process.cwd();
+    // 如果用户指定了配置文件路径
+    if (configPath) {
+        const absolutePath = path.isAbsolute(configPath) ? configPath : path.join(cwd, configPath);
+        if (fs.existsSync(absolutePath)) {
+            return absolutePath;
+        }
+        throw new Error(`配置文件不存在: ${configPath}`);
+    }
+    // 默认查找位置
+    const defaultPaths = [
+        path.join(cwd, 'contractInfo.json'),
+        path.join(cwd, 'config', 'contractInfo.json'),
+        path.join(cwd, 'contracts', 'contractInfo.json'),
+    ];
+    for (const filePath of defaultPaths) {
+        if (fs.existsSync(filePath)) {
+            return filePath;
+        }
+    }
+    throw new Error('未找到配置文件 contractInfo.json，请在项目根目录或 config/ 或 contracts/ 目录下创建配置文件，' +
+        '或使用 --config 参数指定配置文件路径');
+}
+/**
+ * 读取配置文件
+ */
+export function readConfigFile(configPath) {
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`读取配置文件失败: ${error.message}`);
+    }
+}
+/**
+ * 保存报告文件
+ */
+export function saveReport(data, outputPath) {
+    const cwd = process.cwd();
+    const reportPath = outputPath
+        ? (path.isAbsolute(outputPath) ? outputPath : path.join(cwd, outputPath))
+        : path.join(cwd, 'bytecode-check-report.json');
+    try {
+        fs.writeFileSync(reportPath, JSON.stringify(data, null, 2), 'utf-8');
+        return reportPath;
+    }
+    catch (error) {
+        throw new Error(`保存报告失败: ${error.message}`);
+    }
+}
+/**
+ * 合并报告（增量更新）
+ */
+export function mergeReports(existingReport, newResults) {
+    const merged = { ...existingReport };
+    for (const [networkName, networkData] of Object.entries(newResults)) {
+        if (!merged[networkName]) {
+            merged[networkName] = networkData;
+        }
+        else {
+            const existingNetwork = merged[networkName];
+            const newNetwork = networkData;
+            merged[networkName] = { ...existingNetwork, ...newNetwork };
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=files.js.map

package/dist/utils/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAmB;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,gBAAgB;IAChB,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3F,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;IACT,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,mBAAmB,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,mBAAmB,CAAC;KACjD,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,oEAAoE;QACpE,yBAAyB,CAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAS,EAAE,UAAmB;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,cAAmB,EAAE,UAAe;IAC/D,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAwB,CAAC;YACnE,MAAM,UAAU,GAAG,WAAkC,CAAC;YACtD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,UAAU,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,14 @@
+import { CheckResult } from '../types.js';
+/**
+ * 打印检查结果摘要
+ */
+export declare function printSummary(results: CheckResult[]): void;
+/**
+ * 打印进度信息
+ */
+export declare function printProgress(message: string, type?: 'info' | 'success' | 'error' | 'warning'): void;
+/**
+ * 打印配置信息
+ */
+export declare function printConfig(config: any, configPath: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,QA2ClD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAkB,QASrG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,QAS1D"}

package/dist/utils/output.js

@@ -0,0 +1,67 @@
+import chalk from 'chalk';
+/**
+ * 打印检查结果摘要
+ */
+export function printSummary(results) {
+    console.log('\n' + '='.repeat(80));
+    console.log(chalk.bold.cyan('字节码检查报告'));
+    console.log('='.repeat(80));
+    const matches = results.filter(r => r.matches && !r.error);
+    const mismatches = results.filter(r => !r.matches && !r.error);
+    const errors = results.filter(r => r.error);
+    console.log(`\n${chalk.bold('总计检查:')} ${results.length}`);
+    console.log(`${chalk.green('✓ 匹配:')} ${matches.length}`);
+    console.log(`${chalk.red('✗ 不匹配:')} ${mismatches.length}`);
+    console.log(`${chalk.yellow('⚠ 错误:')} ${errors.length}`);
+    if (mismatches.length > 0) {
+        console.log('\n' + chalk.red.bold('❌ 不匹配的合约:'));
+        console.log('-'.repeat(80));
+        mismatches.forEach(result => {
+            console.log(chalk.red(`\n${result.contract} (${result.network})`));
+            console.log(`  地址: ${chalk.gray(result.address)}`);
+            console.log(`  原因: ${result.reason}`);
+            console.log(`  链上字节码长度: ${result.onChainBytecodeLength}`);
+            console.log(`  本地字节码长度: ${result.localBytecodeLength}`);
+        });
+    }
+    if (matches.length > 0) {
+        console.log('\n' + chalk.green.bold('✅ 匹配的合约:'));
+        console.log('-'.repeat(80));
+        matches.forEach(result => {
+            console.log(chalk.green(`${result.contract} (${result.network}): ${result.reason}`));
+        });
+    }
+    if (errors.length > 0) {
+        console.log('\n' + chalk.yellow.bold('⚠ 错误:'));
+        console.log('-'.repeat(80));
+        errors.forEach(result => {
+            console.log(chalk.yellow(`${result.contract} (${result.network}): ${result.error}`));
+        });
+    }
+    console.log('\n' + '='.repeat(80) + '\n');
+}
+/**
+ * 打印进度信息
+ */
+export function printProgress(message, type = 'info') {
+    const icons = {
+        info: chalk.cyan('ℹ'),
+        success: chalk.green('✓'),
+        error: chalk.red('✗'),
+        warning: chalk.yellow('⚠')
+    };
+    console.log(`${icons[type]} ${message}`);
+}
+/**
+ * 打印配置信息
+ */
+export function printConfig(config, configPath) {
+    console.log(chalk.cyan('\n配置文件:'), chalk.gray(configPath));
+    console.log(chalk.cyan('网络数量:'), Object.keys(config).length);
+    for (const [network, contracts] of Object.entries(config)) {
+        const contractCount = Object.keys(contracts).length;
+        console.log(chalk.cyan(`  - ${network}:`), `${contractCount} 个合约`);
+    }
+    console.log();
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "gate-evm-tools",
+  "version": "1.0.0",
+  "description": "Gate 智能合约工具集 - 字节码检查、合约升级验证、合约状态同步",
+  "type": "module",
+  "bin": {
+    "gate-tool": "./bin/cli.js"
+  }, 
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "contractInfo.example.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node bin/cli.js",
+    "test": "node bin/cli.js check"
+  },
+  "keywords": [
+    "bytecode",
+    "hardhat",
+    "ethereum",
+    "solidity",
+    "verification",
+    "cli",
+    "upgrade",
+    "uups",
+    "proxy",
+    "openzeppelin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^7.0.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@openzeppelin/hardhat-upgrades": "^3.9.1",
+    "@openzeppelin/upgrades-core": "^1.44.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.7.2",
+    "@types/prompts": "^2.4.9",
+    "ethers": "^6.15.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@openzeppelin/hardhat-upgrades": "^2.5.0",
+    "@openzeppelin/upgrades-core": "^1.0.0",
+    "ethers": "^6.0.0",
+    "hardhat": "^2.26.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}