gate-evm-tools 1.0.19 → 1.0.21

package/dist/utils/manifestTransaction.js

@@ -0,0 +1,291 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+const hashContents = (contents) => crypto
+    .createHash('sha256')
+    .update(contents ?? Buffer.from('<missing>'))
+    .digest('hex');
+const SAFE_MANIFEST_DIRECTORY = /^\.openzeppelin(?:\.[a-z0-9][a-z0-9-]*)?$/;
+const SAFE_MANIFEST_FILE = /^[a-z0-9][a-z0-9-]*\.json$/;
+const errorCode = (error) => (error && typeof error === 'object' && 'code' in error
+    ? String(error.code)
+    : undefined);
+const confinedManifestFile = (root, requestedFile) => {
+    const projectRoot = path.resolve(root);
+    const absolute = path.isAbsolute(requestedFile)
+        ? path.resolve(requestedFile)
+        : path.resolve(projectRoot, requestedFile);
+    const relative = path.relative(projectRoot, absolute);
+    if (!relative
+        || relative === '..'
+        || relative.startsWith(`..${path.sep}`)
+        || path.isAbsolute(relative)) {
+        throw new Error(`Manifest file escapes the project root: ${requestedFile}`);
+    }
+    const segments = relative.split(path.sep);
+    if (segments.length !== 2
+        || !SAFE_MANIFEST_DIRECTORY.test(segments[0])
+        || !SAFE_MANIFEST_FILE.test(segments[1])) {
+        throw new Error(`Manifest file is not a confined OpenZeppelin JSON path: ${relative}`);
+    }
+    const directory = path.dirname(absolute);
+    if (fs.existsSync(directory)) {
+        const directoryStat = fs.lstatSync(directory);
+        if (directoryStat.isSymbolicLink()) {
+            throw new Error(`Manifest directory cannot be a symlink: ${segments[0]}`);
+        }
+        if (!directoryStat.isDirectory()) {
+            throw new Error(`Manifest directory is not a directory: ${segments[0]}`);
+        }
+    }
+    else {
+        fs.mkdirSync(directory, { recursive: true });
+    }
+    if (fs.existsSync(absolute)) {
+        const fileStat = fs.lstatSync(absolute);
+        if (fileStat.isSymbolicLink()) {
+            throw new Error(`Manifest file cannot be a symlink: ${relative}`);
+        }
+        if (!fileStat.isFile()) {
+            throw new Error(`Manifest path is not a regular file: ${relative}`);
+        }
+    }
+    return { absolute, relative: segments.join('/') };
+};
+const confinedManifestPair = (options) => {
+    const root = path.resolve(options.root);
+    const manifest = confinedManifestFile(root, options.manifestFile);
+    const fallback = options.fallbackFile
+        ? confinedManifestFile(root, options.fallbackFile)
+        : manifest;
+    if (path.dirname(manifest.absolute) !== path.dirname(fallback.absolute)) {
+        throw new Error('Canonical and fallback manifests must use the same confined directory');
+    }
+    return { root, manifest, fallback };
+};
+const readRegularFile = (file) => {
+    if (!fs.existsSync(file.absolute))
+        return undefined;
+    const stat = fs.lstatSync(file.absolute);
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error(`Manifest path is not a regular file: ${file.relative}`);
+    }
+    return fs.readFileSync(file.absolute);
+};
+const snapshotManifestPair = (pair) => {
+    const manifest = readRegularFile(pair.manifest);
+    const distinctFallback = pair.fallback.absolute !== pair.manifest.absolute;
+    const fallback = distinctFallback ? readRegularFile(pair.fallback) : manifest;
+    if (distinctFallback && manifest !== undefined && fallback !== undefined) {
+        throw new Error(`Network manifest files with different names both exist: ${pair.manifest.relative} and ${pair.fallback.relative}`);
+    }
+    if (manifest !== undefined) {
+        return {
+            manifest,
+            fallback,
+            activeFile: pair.manifest,
+            activeContents: manifest,
+        };
+    }
+    if (fallback !== undefined) {
+        return {
+            manifest,
+            fallback,
+            activeFile: pair.fallback,
+            activeContents: fallback,
+        };
+    }
+    return { manifest, fallback };
+};
+const acquireTransactionLock = (manifestFile) => {
+    const lockFile = `${manifestFile}.gate-tool.lock`;
+    const token = `${process.pid}-${Date.now()}-${crypto.randomBytes(8).toString('hex')}`;
+    let descriptor;
+    try {
+        descriptor = fs.openSync(lockFile, 'wx', 0o600);
+    }
+    catch (error) {
+        if (errorCode(error) === 'EEXIST') {
+            throw new Error(`Manifest is locked by another gate-tool transaction: ${manifestFile}`);
+        }
+        throw error;
+    }
+    try {
+        fs.writeFileSync(descriptor, `${token}\n`);
+        fs.fsyncSync(descriptor);
+    }
+    catch (error) {
+        fs.closeSync(descriptor);
+        if (fs.existsSync(lockFile))
+            fs.unlinkSync(lockFile);
+        throw error;
+    }
+    return () => {
+        fs.closeSync(descriptor);
+        try {
+            if (fs.readFileSync(lockFile, 'utf8').trim() === token)
+                fs.unlinkSync(lockFile);
+        }
+        catch (error) {
+            if (errorCode(error) !== 'ENOENT')
+                throw error;
+        }
+    };
+};
+export const writeFileAtomic = (filePath, contents) => {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const temporary = `${filePath}.${process.pid}.${Date.now()}.${crypto.randomBytes(6).toString('hex')}.tmp`;
+    let descriptor;
+    try {
+        descriptor = fs.openSync(temporary, 'wx', 0o600);
+        fs.writeFileSync(descriptor, contents);
+        fs.fsyncSync(descriptor);
+        fs.closeSync(descriptor);
+        descriptor = undefined;
+        fs.renameSync(temporary, filePath);
+    }
+    catch (error) {
+        if (descriptor !== undefined)
+            fs.closeSync(descriptor);
+        if (fs.existsSync(temporary))
+            fs.unlinkSync(temporary);
+        throw error;
+    }
+};
+const restoreFile = (file, contents) => {
+    if (contents === undefined) {
+        if (fs.existsSync(file.absolute))
+            fs.unlinkSync(file.absolute);
+    }
+    else {
+        writeFileAtomic(file.absolute, contents);
+    }
+};
+const restoreManifestPair = (pair, before) => {
+    restoreFile(pair.manifest, before.manifest);
+    if (pair.fallback.absolute !== pair.manifest.absolute) {
+        restoreFile(pair.fallback, before.fallback);
+    }
+};
+const contextFor = (pair) => ({
+    manifestFile: pair.manifest.absolute,
+    fallbackFile: pair.fallback.absolute,
+    writeManifestAtomic: (contents) => writeFileAtomic(pair.manifest.absolute, contents),
+});
+const withLockedManifestPair = async (options, operation) => {
+    const pair = confinedManifestPair(options);
+    const releaseLock = acquireTransactionLock(pair.manifest.absolute);
+    try {
+        return await operation(pair);
+    }
+    finally {
+        releaseLock();
+    }
+};
+export async function withManifestLock(options) {
+    return withLockedManifestPair(options, async (pair) => {
+        snapshotManifestPair(pair);
+        return options.operation(contextFor(pair));
+    });
+}
+export async function withTemporaryManifestTransaction(options) {
+    return withLockedManifestPair(options, async (pair) => {
+        const before = snapshotManifestPair(pair);
+        try {
+            return await options.operation(contextFor(pair));
+        }
+        finally {
+            restoreManifestPair(pair, before);
+        }
+    });
+}
+export const defaultManifestReportFile = (root, manifestFile) => {
+    const confined = confinedManifestFile(root, manifestFile);
+    const [manifestDirectory, fileName] = confined.relative.split('/');
+    return path.join(path.resolve(root), `gate-tool-sync-report.${manifestDirectory.slice(1)}.${fileName}`);
+};
+const confinedReportFile = (root, requestedFile) => {
+    const projectRoot = path.resolve(root);
+    const reportFile = path.isAbsolute(requestedFile)
+        ? path.resolve(requestedFile)
+        : path.resolve(projectRoot, requestedFile);
+    if (path.dirname(reportFile) !== projectRoot) {
+        throw new Error(`Manifest transaction report must stay in the project root: ${requestedFile}`);
+    }
+    if (fs.existsSync(reportFile)) {
+        const stat = fs.lstatSync(reportFile);
+        if (stat.isSymbolicLink() || !stat.isFile()) {
+            throw new Error(`Manifest transaction report must be a regular file: ${requestedFile}`);
+        }
+    }
+    return reportFile;
+};
+const writeReport = (filePath, report) => {
+    writeFileAtomic(filePath, Buffer.from(`${JSON.stringify(report, null, 2)}\n`));
+};
+export async function withManifestTransaction(options) {
+    const now = options.now ?? (() => new Date().toISOString());
+    const startedAt = now();
+    return withLockedManifestPair(options, async (pair) => {
+        const reportFile = confinedReportFile(pair.root, options.reportFile ?? defaultManifestReportFile(pair.root, pair.manifest.absolute));
+        const before = snapshotManifestPair(pair);
+        const beforeHash = hashContents(before.activeContents);
+        try {
+            const value = await options.operation(contextFor(pair));
+            const after = snapshotManifestPair(pair);
+            if (!after.activeFile
+                || after.activeFile.absolute !== pair.manifest.absolute
+                || after.activeContents === undefined) {
+                throw new Error(`Manifest transaction did not create ${pair.manifest.relative}`);
+            }
+            const report = {
+                version: 1,
+                status: 'committed',
+                manifestFile: pair.manifest.relative,
+                ...(pair.fallback.absolute === pair.manifest.absolute
+                    ? {}
+                    : { fallbackFile: pair.fallback.relative }),
+                ...(before.activeFile ? { beforeFile: before.activeFile.relative } : {}),
+                afterFile: after.activeFile.relative,
+                beforeExisted: before.activeContents !== undefined,
+                beforeHash,
+                afterHash: hashContents(after.activeContents),
+                startedAt,
+                completedAt: now(),
+            };
+            writeReport(reportFile, report);
+            return { value, report, reportFile };
+        }
+        catch (error) {
+            let attempted;
+            try {
+                attempted = snapshotManifestPair(pair);
+            }
+            catch {
+                attempted = undefined;
+            }
+            restoreManifestPair(pair, before);
+            const restored = snapshotManifestPair(pair);
+            const report = {
+                version: 1,
+                status: 'rolled_back',
+                manifestFile: pair.manifest.relative,
+                ...(pair.fallback.absolute === pair.manifest.absolute
+                    ? {}
+                    : { fallbackFile: pair.fallback.relative }),
+                ...(before.activeFile ? { beforeFile: before.activeFile.relative } : {}),
+                ...(restored.activeFile ? { afterFile: restored.activeFile.relative } : {}),
+                beforeExisted: before.activeContents !== undefined,
+                beforeHash,
+                afterHash: hashContents(restored.activeContents),
+                attemptedHash: hashContents(attempted?.activeContents),
+                startedAt,
+                completedAt: now(),
+                error: error instanceof Error ? error.message : String(error),
+            };
+            writeReport(reportFile, report);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=manifestTransaction.js.map

package/dist/utils/manifestTransaction.js.map

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

package/dist/utils/openzeppelin.d.ts

@@ -0,0 +1,11 @@
+export declare function mergeUnsafeAllow(userUnsafeAllow?: string[], defaults?: readonly string[]): string[] | undefined;
+export interface OpenZeppelinManifestPaths {
+    file: string;
+    fallbackFile: string;
+}
+export declare function getOpenZeppelinManifestPaths(hre: any): Promise<OpenZeppelinManifestPaths>;
+export declare function getOpenZeppelinManifestFile(hre: any): Promise<string>;
+export declare function shouldRetryForceImport(error: any): boolean;
+export declare function forceImportWithRetry(hre: any, address: string, contractFactory: any, options: any): Promise<any>;
+export declare function getCodeStatus(hre: any, address: string): Promise<string>;
+//# sourceMappingURL=openzeppelin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openzeppelin.d.ts","sourceRoot":"","sources":["../../src/utils/openzeppelin.ts"],"names":[],"mappings":"AAWA,wBAAgB,gBAAgB,CAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,QAAQ,GAAE,SAAS,MAAM,EAAsC,GAC9D,MAAM,EAAE,GAAG,SAAS,CAGtB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,yBAAyB,CAAC,CAMpC;AAED,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAG1D;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,GAAG,EACpB,OAAO,EAAE,GAAG,gBAcb;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9E"}

package/dist/utils/openzeppelin.js

@@ -0,0 +1,49 @@
+import { Manifest } from '@openzeppelin/upgrades-core';
+const DEFAULT_FORCE_IMPORT_UNSAFE_ALLOW = [
+    'constructor',
+    'delegatecall',
+    'missing-public-upgradeto',
+    'missing-initializer',
+    'state-variable-assignment',
+    'state-variable-immutable',
+];
+export function mergeUnsafeAllow(userUnsafeAllow, defaults = DEFAULT_FORCE_IMPORT_UNSAFE_ALLOW) {
+    const merged = Array.from(new Set([...(defaults ?? []), ...(userUnsafeAllow ?? [])]));
+    return merged.length > 0 ? merged : undefined;
+}
+export async function getOpenZeppelinManifestPaths(hre) {
+    const manifest = await Manifest.forNetwork(hre.network.provider);
+    return {
+        file: manifest.file,
+        fallbackFile: manifest.fallbackFile,
+    };
+}
+export async function getOpenZeppelinManifestFile(hre) {
+    return (await getOpenZeppelinManifestPaths(hre)).file;
+}
+export function shouldRetryForceImport(error) {
+    const message = String(error?.message ?? '');
+    return message.includes('Removed from manifest');
+}
+export async function forceImportWithRetry(hre, address, contractFactory, options) {
+    try {
+        return await hre.upgrades.forceImport(address, contractFactory, options);
+    }
+    catch (error) {
+        if (!shouldRetryForceImport(error)) {
+            throw error;
+        }
+        console.log('   ⚠️  检测到 manifest 中存在失效部署记录，OpenZeppelin 已移除该记录');
+        console.log('   🔁 正在自动重试 forceImport...');
+        console.log('');
+        return await hre.upgrades.forceImport(address, contractFactory, options);
+    }
+}
+export async function getCodeStatus(hre, address) {
+    const code = await hre.ethers.provider.getCode(address);
+    if (code === '0x') {
+        return '链上未检测到代码';
+    }
+    return `链上代码长度: ${Math.max(0, (code.length - 2) / 2)} bytes`;
+}
+//# sourceMappingURL=openzeppelin.js.map

package/dist/utils/openzeppelin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openzeppelin.js","sourceRoot":"","sources":["../../src/utils/openzeppelin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,MAAM,iCAAiC,GAAG;IACxC,aAAa;IACb,cAAc;IACd,0BAA0B;IAC1B,qBAAqB;IACrB,2BAA2B;IAC3B,0BAA0B;CAClB,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAC9B,eAA0B,EAC1B,WAA8B,iCAAiC;IAE/D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,GAAQ;IAER,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,GAAQ;IACxD,OAAO,CAAC,MAAM,4BAA4B,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAU;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAQ,EACR,OAAe,EACf,eAAoB,EACpB,OAAY;IAEZ,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAQ,EAAE,OAAe;IAC3D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gate-evm-tools",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "Gate 智能合约工具集 - 字节码检查、合约升级验证、合约状态同步",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node bin/cli.js",
-    "test": "node bin/cli.js check"
+    "test": "node --test test/*.test.mjs"
   },
   "keywords": [
     "bytecode",