gate-evm-tools 1.0.23 → 1.0.24

package/dist-cjs/core/syncUpgradeJson.js

@@ -0,0 +1,315 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncNetworkFile = syncNetworkFile;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const openzeppelin_js_1 = require("../utils/openzeppelin.js");
+const manifestTransaction_js_1 = require("../utils/manifestTransaction.js");
+/**
+ * 同步链上合约状态到本地 .openzeppelin 网络文件
+ *
+ * 使用场景：
+ * 当合约升级是通过 calldata 方式由其他人执行时，本地的 .openzeppelin 文件不会自动更新
+ * 使用此脚本可以从链上读取最新状态并更新本地文件，确保下次升级验证时有正确的参考
+ *
+ * @param options - 同步选项
+ */
+async function syncNetworkFile(options) {
+    const { proxyAddress, contractName, networkName, constructorArgs, skipTxHash, hre } = options;
+    console.log('\n🔄 开始同步链上状态到本地网络文件...');
+    console.log('=====================================\n');
+    const PROXY_ADDRESS = proxyAddress;
+    const CONTRACT_NAME = contractName;
+    const CONSTRUCTOR_ARGS = constructorArgs || [];
+    // 获取网络名称和 chainId
+    const network = await hre.ethers.provider.getNetwork();
+    const chainId = Number(network.chainId);
+    const NETWORK_NAME = networkName || network.name;
+    console.log('📋 同步配置:');
+    console.log('-------------------------------------');
+    console.log('代理合约地址:', PROXY_ADDRESS);
+    console.log('合约名称:', CONTRACT_NAME);
+    console.log('网络:', NETWORK_NAME);
+    console.log('Chain ID:', chainId);
+    if (CONSTRUCTOR_ARGS.length > 0) {
+        console.log('构造函数参数:', CONSTRUCTOR_ARGS);
+    }
+    console.log('-------------------------------------\n');
+    // Step 1: 编译合约以获取最新的存储布局
+    console.log('🔨 Step 1: 编译合约获取存储布局...');
+    try {
+        await hre.run('compile', { quiet: true });
+        console.log('✅ 编译完成\n');
+    }
+    catch (error) {
+        console.error('❌ 编译失败:', error.message);
+        throw error;
+    }
+    // Step 2: 从链上读取当前实现合约地址
+    console.log('🔍 Step 2: 读取链上实现合约地址...');
+    let currentImplementation;
+    try {
+        currentImplementation = await hre.upgrades.erc1967.getImplementationAddress(PROXY_ADDRESS);
+        console.log('✅ 当前实现合约:', currentImplementation);
+        console.log('');
+    }
+    catch (error) {
+        console.error('❌ 读取实现地址失败:', error.message);
+        throw error;
+    }
+    // Step 3: 获取实现合约的部署交易哈希（尝试从事件获取）
+    console.log('🔍 Step 3: 获取实现合约部署信息...');
+    let implTxHash = '0x0'; // 默认值，如果无法获取
+    if (skipTxHash) {
+        console.log('⏭️  已通过参数禁用 txHash 补充，跳过事件查询');
+    }
+    else {
+        try {
+            // 尝试通过 Upgraded 事件获取升级交易哈希
+            const proxyContract = await hre.ethers.getContractAt('UUPSUpgradeable', PROXY_ADDRESS);
+            const currentBlock = await hre.ethers.provider.getBlockNumber();
+            // 免费 RPC 节点通常限制查询范围，使用较小的区块范围
+            // 可以分批查询，从最近的区块开始往前查
+            const batchSize = 5000; // 每次查询 5000 个区块
+            const maxBatches = 3000; // 最多查 3000 批（15000000 个区块）
+            let found = false;
+            for (let i = 0; i < maxBatches && !found; i++) {
+                const toBlock = currentBlock - (i * batchSize);
+                const fromBlock = Math.max(0, toBlock - batchSize);
+                try {
+                    const filter = proxyContract.filters.Upgraded();
+                    const events = await proxyContract.queryFilter(filter, fromBlock, toBlock);
+                    if (events.length > 0) {
+                        // 找到最后一次升级到当前实现的事件
+                        const latestUpgrade = events
+                            .reverse()
+                            .find((event) => event.args && event.args[0].toLowerCase() === currentImplementation.toLowerCase());
+                        if (latestUpgrade) {
+                            implTxHash = latestUpgrade.transactionHash;
+                            console.log('✅ 找到升级交易:', implTxHash);
+                            found = true;
+                            break;
+                        }
+                    }
+                }
+                catch (batchError) {
+                    if (i === 0) {
+                        console.log(`⚠️  查询区块范围 ${fromBlock}-${toBlock} 失败: ${batchError.message}`);
+                    }
+                }
+            }
+            if (!found) {
+                console.log('⚠️  未找到对应的升级事件（可能需要查询更早的区块），使用默认交易哈希');
+            }
+        }
+        catch (error) {
+            console.log('⚠️  获取交易哈希失败，使用默认值:', error.message);
+        }
+    }
+    console.log('');
+    const projectRoot = process.cwd();
+    const manifestPaths = await (0, openzeppelin_js_1.getOpenZeppelinManifestPaths)(hre);
+    const networkFilePath = manifestPaths.file;
+    const transaction = await (0, manifestTransaction_js_1.withManifestTransaction)({
+        root: projectRoot,
+        manifestFile: networkFilePath,
+        fallbackFile: manifestPaths.fallbackFile,
+        operation: async ({ writeManifestAtomic }) => {
+            // Step 4: 使用 OpenZeppelin 官方的 forceImport 方法同步状态
+            console.log('📊 Step 4: 使用 forceImport 同步链上状态...');
+            console.log('   这会自动更新 .openzeppelin 文件，包括完整的存储布局和命名空间');
+            console.log('');
+            try {
+                const ContractFactory = await hre.ethers.getContractFactory(CONTRACT_NAME);
+                if (CONSTRUCTOR_ARGS.length > 0) {
+                    console.log(`   📝 使用构造函数参数:`, CONSTRUCTOR_ARGS);
+                    console.log('');
+                }
+                // forceImport: 强制导入已存在的代理，更新本地 .openzeppelin 文件
+                // 这是 OpenZeppelin 官方推荐的同步方式
+                const importOptions = {
+                    kind: 'uups',
+                    unsafeAllow: (0, openzeppelin_js_1.mergeUnsafeAllow)()
+                };
+                // 如果有构造函数参数，添加到选项中
+                if (CONSTRUCTOR_ARGS.length > 0) {
+                    importOptions.constructorArgs = CONSTRUCTOR_ARGS;
+                }
+                await (0, openzeppelin_js_1.forceImportWithRetry)(hre, PROXY_ADDRESS, ContractFactory, importOptions);
+                console.log('✅ forceImport 完成！');
+                console.log('');
+            }
+            catch (error) {
+                console.error('❌ forceImport 失败:', error.message);
+                console.error(`   代理合约状态: ${await (0, openzeppelin_js_1.getCodeStatus)(hre, PROXY_ADDRESS)}`);
+                console.error(`   实现合约状态: ${await (0, openzeppelin_js_1.getCodeStatus)(hre, currentImplementation)}`);
+                console.error('');
+                throw error;
+            }
+            // Step 5: 查找正确的网络文件并补充交易哈希
+            console.log('📊 Step 5: 查找网络文件并补充交易哈希...');
+            const actualNetworkName = path.basename(networkFilePath, '.json');
+            console.log('   ✅ OpenZeppelin manifest 文件:', path.basename(networkFilePath));
+            if (!fs.existsSync(networkFilePath)) {
+                const error = new Error('未找到 .openzeppelin 网络文件');
+                console.error('❌ 错误: 未找到 .openzeppelin 网络文件');
+                console.error(`   OpenZeppelin 预期文件: ${networkFilePath}`);
+                console.error('   请确认 forceImport 已成功执行');
+                throw error;
+            }
+            console.log('   📄 使用网络文件:', actualNetworkName + '.json');
+            console.log('');
+            let networkFile = JSON.parse(fs.readFileSync(networkFilePath, 'utf8'));
+            // 查找当前代理的实现信息
+            const proxyInfo = networkFile.proxies?.find((p) => p.address.toLowerCase() === PROXY_ADDRESS.toLowerCase());
+            if (!proxyInfo) {
+                const error = new Error('代理信息未找到');
+                console.error('❌ 错误: 代理信息未找到');
+                throw error;
+            }
+            // 查找实现合约的布局信息
+            let layoutInfo = null;
+            let layoutHash = '';
+            let needsSave = false;
+            for (const [hash, impl] of Object.entries(networkFile.impls || {})) {
+                const implData = impl;
+                // 检查是否匹配：
+                // 1. 直接匹配 address 字段
+                // 2. 在 allAddresses 数组中查找（多次升级可能共享相同布局）
+                const isMatch = implData.address.toLowerCase() === currentImplementation.toLowerCase() ||
+                    (implData.allAddresses && Array.isArray(implData.allAddresses) &&
+                        implData.allAddresses.some((addr) => addr.toLowerCase() === currentImplementation.toLowerCase()));
+                if (isMatch) {
+                    layoutHash = hash;
+                    layoutInfo = implData.layout;
+                    console.log('   ✅ 找到实现合约的布局信息');
+                    if (implData.allAddresses && implData.allAddresses.length > 1) {
+                        console.log(`   📋 该布局被 ${implData.allAddresses.length} 个实现合约共享`);
+                        console.log(`      主地址: ${implData.address}`);
+                        console.log(`      所有地址: ${implData.allAddresses.join(', ')}`);
+                    }
+                    console.log('');
+                    // 检查并补充交易哈希（只对主地址有效）
+                    if (implData.address.toLowerCase() === currentImplementation.toLowerCase()) {
+                        if (!implData.txHash && implTxHash && implTxHash !== '0x0') {
+                            console.log('   💾 补充交易哈希到记录...');
+                            console.log('      交易哈希:', implTxHash);
+                            // 重新构建对象，确保字段顺序
+                            const newImpl = {
+                                address: implData.address,
+                                txHash: implTxHash,
+                                layout: implData.layout
+                            };
+                            // 保留 allAddresses 字段（如果存在）
+                            if (implData.allAddresses) {
+                                newImpl.allAddresses = implData.allAddresses;
+                            }
+                            // 替换原有的实现记录
+                            networkFile.impls[hash] = newImpl;
+                            needsSave = true;
+                        }
+                        else if (implData.txHash) {
+                            console.log('   ✅ 交易哈希已存在:', implData.txHash);
+                        }
+                        else {
+                            console.log('   ⚠️  未获取到交易哈希');
+                        }
+                    }
+                    break;
+                }
+            }
+            // 保存更新后的文件
+            if (needsSave) {
+                try {
+                    writeManifestAtomic(Buffer.from(`${JSON.stringify(networkFile, null, 2)}\n`));
+                    console.log('   💾 文件已保存');
+                }
+                catch (error) {
+                    console.error('   ❌ 保存文件失败:', error.message);
+                    throw error;
+                }
+            }
+            console.log('');
+            if (!layoutInfo) {
+                const error = new Error('未找到实现合约的布局信息');
+                console.error('❌ 错误: 未找到实现合约的布局信息');
+                throw error;
+            }
+            console.log('✅ 同步结果验证通过！');
+            console.log('');
+            // 总结
+            console.log('=====================================');
+            console.log('✅ 同步完成！');
+            console.log('=====================================');
+            console.log('');
+            console.log('📋 同步摘要:');
+            console.log('-------------------------------------');
+            console.log('代理合约:', PROXY_ADDRESS);
+            console.log('实现合约:', currentImplementation);
+            console.log('布局哈希:', layoutHash.substring(0, 16) + '...');
+            console.log('存储变量:', layoutInfo.storage?.length || 0, '个');
+            console.log('命名空间:', Object.keys(layoutInfo.namespaces || {}).length, '个');
+            console.log('类型定义:', Object.keys(layoutInfo.types || {}).length, '个');
+            console.log('网络文件:', networkFilePath);
+            console.log('-------------------------------------');
+            console.log('');
+            // 显示命名空间详情
+            if (layoutInfo.namespaces && Object.keys(layoutInfo.namespaces).length > 0) {
+                console.log('📦 命名空间详情:');
+                for (const [namespace, vars] of Object.entries(layoutInfo.namespaces)) {
+                    console.log(`   - ${namespace}: ${vars.length} 个变量`);
+                }
+                console.log('');
+            }
+            return {
+                proxyAddress: PROXY_ADDRESS,
+                implementationAddress: currentImplementation,
+                layoutHash: layoutHash.substring(0, 16) + '...',
+                networkFile: networkFilePath,
+                success: true,
+            };
+        },
+    });
+    console.log('Manifest before hash:', transaction.report.beforeHash);
+    console.log('Manifest after hash:', transaction.report.afterHash);
+    console.log('Sync report:', transaction.reportFile);
+    return {
+        ...transaction.value,
+        manifestTransaction: transaction.report,
+        syncReport: transaction.reportFile,
+    };
+}
+//# sourceMappingURL=syncUpgradeJson.js.map

package/dist-cjs/core/syncUpgradeJson.js.map

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

package/dist-cjs/sync/index.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncWithHre = syncWithHre;
+const syncUpgradeJson_js_1 = require("../core/syncUpgradeJson.js");
+const zkManifestSync_js_1 = require("../core/preparation/zkManifestSync.js");
+const parseConstructorArgs = (raw) => {
+    if (raw === undefined)
+        return [];
+    if (Array.isArray(raw))
+        return raw;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`构造函数参数格式错误: ${message}`);
+    }
+    if (!Array.isArray(parsed))
+        throw new Error('构造函数参数必须是一个数组');
+    return parsed;
+};
+async function syncWithHre(options, hre, root = process.cwd(), dependencies = {
+    syncEvm: syncUpgradeJson_js_1.syncNetworkFile,
+    syncZk: zkManifestSync_js_1.syncZkManifest,
+}) {
+    if (options.network && options.network !== hre.network.name) {
+        throw new Error(`sync network ${options.network} does not match Hardhat network ${hre.network.name}`);
+    }
+    const scheme = options.scheme ?? 'evm';
+    const constructorArgs = parseConstructorArgs(options.constructorArgs);
+    if (scheme === 'zksync-eravm') {
+        if (!options.network)
+            throw new Error('zkSync sync network is required');
+        if (!options.target)
+            throw new Error('zkSync sync target is required');
+        return dependencies.syncZk({
+            root,
+            scheme,
+            network: options.network,
+            target: options.target,
+            proxy: options.proxy,
+            contract: options.contract,
+            constructorArgs,
+            transactionHash: options.transactionHash,
+            hre,
+        });
+    }
+    if (scheme !== 'evm')
+        throw new Error('sync scheme must be evm or zksync-eravm');
+    return dependencies.syncEvm({
+        proxyAddress: options.proxy,
+        contractName: options.contract,
+        networkName: options.network,
+        constructorArgs,
+        skipTxHash: options.skipTxHash,
+        hre,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist-cjs/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":";;AAuBA,kCAwCC;AA9DD,mEAA6D;AAC7D,6EAAuE;AAOvE,MAAM,oBAAoB,GAAG,CAAC,GAAmC,EAAa,EAAE;IAC9E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEK,KAAK,UAAU,WAAW,CAC/B,OAAoB,EACpB,GAAQ,EACR,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EACpB,eAAiC;IAC/B,OAAO,EAAE,oCAAe;IACxB,MAAM,EAAE,kCAAc;CACvB;IAED,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,gBAAgB,OAAO,CAAC,OAAO,mCAAmC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CACrF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACvE,OAAO,YAAY,CAAC,MAAM,CAAC;YACzB,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,eAAe;YACf,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACjF,OAAO,YAAY,CAAC,OAAO,CAAC;QAC1B,YAAY,EAAE,OAAO,CAAC,KAAK;QAC3B,YAAY,EAAE,OAAO,CAAC,QAAQ;QAC9B,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,eAAe;QACf,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist-cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-cjs/types.js.map

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