gate-evm-tools 1.0.25 → 1.0.27

package/runtime/migrate.ts

@@ -0,0 +1,154 @@
+import { satisfies, validRange } from 'semver';
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
+
+interface Entry { sha256: string; replacement: string }
+interface Change { path: string; status: 'current' | 'remove' | 'update' | 'conflict'; reason?: string }
+const commands: Record<string, string> = {
+  cli: 'run', checkCode: 'checkcode', checkCodePlan: 'checkcode-plan',
+  checkCodeFinalize: 'checkcode-finalize', staticValidate: 'static-validate',
+  create2Hashes: 'create2-hashes', releaseFinalize: 'release-finalize',
+  importState: 'import-state', reconcileExternal: 'reconcile-external',
+  commitContractInfo: 'commit-contract-info',
+};
+
+/** Plan first; preserve custom files/state. Only known sources/shims are removable. */
+export function migrateTemplate(projectRoot: string, apply = false) {
+  const root = fs.realpathSync(projectRoot);
+  const baseline: { templateVersion: string; files: Record<string, Entry> } = JSON.parse(
+    fs.readFileSync(path.join(__dirname, 'template-migration.json'), 'utf8'),
+  );
+  const plan: Change[] = [];
+  const edits = new Map<string, string>();
+  const originals = new Map<string, string>();
+  const conflict = (relative: string, reason: string) => plan.push({ path: relative, status: 'conflict', reason });
+  const unsafe = (relative: string) => {
+    const file = path.resolve(root, relative);
+    if (!file.startsWith(root + path.sep)) return true;
+    return relative.split('/').some((_, i, parts) => {
+      try { return fs.lstatSync(path.join(root, ...parts.slice(0, i + 1))).isSymbolicLink(); }
+      catch (error) { if ((error as NodeJS.ErrnoException).code === 'ENOENT') return false; throw error; }
+    });
+  };
+
+  for (const [relative, entry] of Object.entries(baseline.files)) {
+    const file = path.join(root, relative);
+    if (unsafe(relative)) { conflict(relative, 'Symlinked or unconfined runtime path'); continue; }
+    if (!fs.existsSync(file)) { plan.push({ path: relative, status: 'current' }); continue; }
+    if (!fs.statSync(file).isFile()) { conflict(relative, 'Runtime path must be a regular file'); continue; }
+    const source = fs.readFileSync(file, 'utf8');
+    if (source !== entry.replacement && createHash('sha256').update(source).digest('hex') !== entry.sha256) {
+      conflict(relative, 'Customized runtime file requires manual merge'); continue;
+    }
+    originals.set(relative, source);
+    plan.push({ path: relative, status: 'remove' });
+  }
+
+  const packagePath = path.join(root, 'package.json');
+  if (unsafe('package.json') || !fs.existsSync(packagePath)) conflict('package.json', 'Project package.json must exist and be a regular local file');
+  else {
+    const source = fs.readFileSync(packagePath, 'utf8');
+    const pkg = JSON.parse(source);
+    try {
+      if (!(pkg.devDependencies?.['gate-evm-tools'] ?? pkg.dependencies?.['gate-evm-tools'])) throw new Error('gate-evm-tools is not declared');
+      const projectRequire = createRequire(packagePath);
+      const installedRoot = path.resolve(path.dirname(projectRequire.resolve('gate-evm-tools/runtime/cli')), '../..');
+      const installed = JSON.parse(fs.readFileSync(path.join(installedRoot, 'package.json'), 'utf8'));
+      const declared = pkg.devDependencies?.['gate-evm-tools'] ?? pkg.dependencies?.['gate-evm-tools'];
+      if (typeof declared !== 'string' || (!declared.startsWith('file:') && (!validRange(declared) || !satisfies(installed.version, declared)))) throw new Error('Install a version satisfying the declared dependency range first');
+      const lockPath = path.join(root, 'package-lock.json');
+      if (fs.existsSync(lockPath)) {
+        const lock = JSON.parse(fs.readFileSync(lockPath, 'utf8'));
+        const locked = lock.packages?.['node_modules/gate-evm-tools'] ?? lock.dependencies?.['gate-evm-tools'];
+        if (locked?.version !== installed.version) throw new Error('Lockfile version differs from installation');
+      }
+      for (const entry of Object.values(baseline.files)) {
+        const specifier = entry.replacement.match(/export \* from "([^"]+)"/)?.[1];
+        if (!specifier || !fs.statSync(projectRequire.resolve(specifier)).isFile()) throw new Error('Missing packaged runtime export');
+      }
+    } catch {
+      conflict('package.json', 'Install the approved GateTool package and existing lockfile with all runtime exports before removing scripts');
+    }
+    let changed = false;
+    for (const [name, command] of Object.entries(pkg.scripts ?? {})) {
+      if (typeof command !== 'string') continue;
+      const match = command.match(/^ts-node scripts\/workflow\/([A-Za-z0-9]+)\.ts(?=\s|$)/);
+      if (match && commands[match[1]!]) {
+        pkg.scripts[name] = command.replace(match[0], `gate-workflow ${commands[match[1]!]}`);
+        changed = true;
+      }
+    }
+    const next = changed ? JSON.stringify(pkg, null, source.match(/\n(\s+)"/)?.[1] ?? 2) + '\n' : source;
+    if (next.includes('scripts/workflow') || next.includes('scripts\\\\workflow')) conflict('package.json', 'Unrecognized workflow command/reference; update manually');
+    else if (changed) { originals.set('package.json', source); edits.set('package.json', next); plan.push({ path: 'package.json', status: 'update' }); }
+  }
+
+  const moduleTarget = (file: string, specifier: string): string | undefined => {
+    if (!specifier.startsWith('.')) return undefined;
+    const absolute = path.resolve(path.dirname(file), specifier).replace(/\.(?:ts|js)$/, '') + '.ts';
+    const relative = path.relative(root, absolute).split(path.sep).join('/');
+    return baseline.files[relative]?.replacement.match(/export \* from "([^"]+)"/)?.[1];
+  };
+  const ignored = new Set(['node_modules', '.git', '.gateflow', '.codex', 'dist', 'build', 'out', 'results', 'runtime-bindings', 'calldata', 'tx-requests']);
+  const visit = (directory: string) => {
+    for (const item of fs.readdirSync(directory, { withFileTypes: true })) {
+      if (ignored.has(item.name) || /^(?:artifacts|cache|typechain|\.openzeppelin|\.gate-workflow-backup)/.test(item.name)) continue;
+      const file = path.join(directory, item.name);
+      const relative = path.relative(root, file).split(path.sep).join('/');
+      if (baseline.files[relative] || relative === 'package.json') continue;
+      if (item.isSymbolicLink()) { conflict(relative, 'Cannot inspect symlink for legacy runtime references'); continue; }
+      if (item.isDirectory()) { visit(file); continue; }
+      if (relative.startsWith('scripts/workflow/')) { conflict(relative, 'Unrecognized custom workflow file'); continue; }
+      if (!item.isFile() || !/\.(?:[cm]?[jt]sx?|json|ya?ml|sh|toml)$/.test(item.name) || item.name.endsWith('.lock.json') || /(?:package-lock|yarn.lock|pnpm-lock)/.test(item.name)) continue;
+      const source = fs.readFileSync(file, 'utf8');
+      let next = source;
+      if (/\.[cm]?[jt]sx?$/.test(item.name)) {
+        // Only static module specifiers are rewritten; filesystem paths/commands require review.
+        next = source.replace(/(\bfrom\s*|\b(?:require|import)\s*\(\s*|\bimport\s*)(["'])(\.[^"'\n]+)\2/g,
+          (all, prefix: string, quote: string, specifier: string) => {
+            const target = moduleTarget(file, specifier);
+            return target ? `${prefix}${quote}${target}${quote}` : all;
+          });
+      }
+      const unresolvedModule = [...next.matchAll(/["'](\.[^"'\n]+)["']/g)].some(match => moduleTarget(file, match[1]!) !== undefined);
+      if (unresolvedModule || /scripts[\\/]workflow|scripts[\\/]config[\\/](?:rpc|openzeppelin|zksyncSolcPath)/.test(next)) {
+        conflict(relative, 'Unresolved runtime path/reference; update manually before removal'); continue;
+      }
+      if (next !== source) { originals.set(relative, source); edits.set(relative, next); plan.push({ path: relative, status: 'update' }); }
+    }
+  };
+  visit(root);
+  const conflicts = plan.filter(item => item.status === 'conflict');
+  if (apply && conflicts.length) throw new Error('Runtime migration requires manual merge: ' + conflicts.map(item => `${item.path}: ${item.reason}`).join('; '));
+  let backup: string | undefined;
+  if (apply && originals.size > 0) {
+    // Recheck every input before creating the backup or applying changes.
+    for (const [relative, source] of originals) {
+      if (unsafe(relative) || fs.readFileSync(path.join(root, relative), 'utf8') !== source) throw new Error(`Migration input changed: ${relative}`);
+    }
+    backup = fs.mkdtempSync(path.join(root, '.gate-workflow-backup-'));
+    for (const [relative, source] of originals) {
+      const saved = path.join(backup, relative);
+      fs.mkdirSync(path.dirname(saved), { recursive: true });
+      fs.writeFileSync(saved, source);
+    }
+    try {
+      // Rewrite consumers first, then remove the now-unreferenced known files.
+      for (const [relative, source] of edits) fs.writeFileSync(path.join(root, relative), source);
+      for (const item of plan.filter(item => item.status === 'remove')) fs.unlinkSync(path.join(root, item.path));
+    } catch (error) {
+      for (const [relative, source] of originals) fs.writeFileSync(path.join(root, relative), source);
+      throw error;
+    }
+    const prune = (directory: string) => {
+      if (!fs.existsSync(directory) || fs.lstatSync(directory).isSymbolicLink()) return;
+      for (const item of fs.readdirSync(directory, { withFileTypes: true })) if (item.isDirectory()) prune(path.join(directory, item.name));
+      if (fs.readdirSync(directory).length === 0) fs.rmdirSync(directory);
+    };
+    prune(path.join(root, 'scripts/workflow'));
+    prune(path.join(root, 'scripts/config'));
+  }
+  return { applied: apply, baselineVersion: baseline.templateVersion, backup, plan };
+}

package/runtime/projectHardhat.ts

@@ -0,0 +1,10 @@
+import path from 'node:path';
+import { createRequire } from 'node:module';
+// Runtime modules must use the selected project's HRE, not a package/global HRE.
+const projectRequire = createRequire(path.join(process.cwd(), 'package.json'));
+projectRequire('hardhat/register');
+const hre: typeof import('hardhat') = projectRequire('hardhat');
+export default hre;
+export const { ethers, artifacts, network, config, upgrades } = hre;
+
+export const run = hre.run.bind(hre);

package/runtime/template-migration.json

@@ -0,0 +1,293 @@
+{
+  "templateVersion": "2.1.21",
+  "files": {
+    "scripts/workflow/checkCodeFinalize.ts": {
+      "sha256": "e1b49b9c824588a39e4760d58336ce5e57e7b2a6f0d1f1f1d9e014b21e4d0564",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/checkCodeFinalize\";\n"
+    },
+    "scripts/workflow/importState.ts": {
+      "sha256": "af3f3a45a362e71b6a692b17da84303ff56b2aabf401ed30924113eb512c33a2",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/importState\";\n"
+    },
+    "scripts/workflow/reconcileExternalRun.ts": {
+      "sha256": "8070927b4f9049abf93981beafa806c0840c9c035b784d69248d4d16de6fc42d",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/reconcileExternalRun\";\n"
+    },
+    "scripts/workflow/cli.ts": {
+      "sha256": "9a917b5f909eeaa6a2f9623286d3e29413a6fe9cb9fa8a5b1be1f950d77853c4",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/cli\";\n"
+    },
+    "scripts/workflow/commitContractInfo.ts": {
+      "sha256": "ccd38dfc780eb3654d62a5ea742273f835c1d183b44499a2c7e59fd120e00184",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/commitContractInfo\";\n"
+    },
+    "scripts/workflow/checkCode.ts": {
+      "sha256": "67e08273b9d1c6f03b616f39b5c875647a1085a8c19f3043d33caa1f0ca355ba",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/checkCode\";\n"
+    },
+    "scripts/workflow/create2Hashes.ts": {
+      "sha256": "3d3b6792bbb9524e82adfb555e78e9a6d62cc79d8c9dd51931da7fbdaf4ab6a9",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/create2Hashes\";\n"
+    },
+    "scripts/workflow/staticValidate.ts": {
+      "sha256": "322aa439d18a124c0ffc86dd51c106b545eaa78491e3004373daee1ab0dc8158",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/staticValidate\";\n"
+    },
+    "scripts/workflow/checkCodePlan.ts": {
+      "sha256": "807804e3240af7089818099a4fe31948aaa1580402523b433a80dec5c4fbe838",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/checkCodePlan\";\n"
+    },
+    "scripts/workflow/forkSourceProxy.ts": {
+      "sha256": "a9727a9b4810ecfc0486f1db434515014b6c2e8e5a92d154656ff7a445f6ec9e",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/forkSourceProxy\";\n"
+    },
+    "scripts/workflow/run.ts": {
+      "sha256": "80f099d13f54b17ab5ae83251062eac155d561afc6dc2f460198cc35526baebc",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/run\";\n"
+    },
+    "scripts/workflow/reconcileExternal.ts": {
+      "sha256": "d47d4b654a16c6f834288ea013d640486bac89846339d7b7b32641ca46c14ca5",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/reconcileExternal\";\n"
+    },
+    "scripts/workflow/releaseFinalize.ts": {
+      "sha256": "667c08ddd16275ad34c91e06690ae2a3cfa948abf3e71f6381332a06fbfc6a9b",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/releaseFinalize\";\n"
+    },
+    "scripts/workflow/steps/call.ts": {
+      "sha256": "234fc6083e09918784a184001836661be978a1e0e4e20074911f148d0b796835",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/call\";\n"
+    },
+    "scripts/workflow/steps/view.ts": {
+      "sha256": "64cea8472e96786c8ca498d13c2e2ef3882149381dae54fb872928258383573e",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/view\";\n"
+    },
+    "scripts/workflow/steps/upgrade.ts": {
+      "sha256": "f0f9cbe665f8d063c3fc62b7bb208e780cb7a7b7a39ba45e1d53ff9a107385a9",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/upgrade\";\n"
+    },
+    "scripts/workflow/steps/custom.ts": {
+      "sha256": "f52af4ef5a30af9411e0f4e40027218f48d2361731929875cdee4f4f59362f9a",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/custom\";\n"
+    },
+    "scripts/workflow/steps/deploy.ts": {
+      "sha256": "57c54bbdaf7fbf05aecb5f35a63e81e0414f141a27c1f3f7a0ef17a81680f599",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/deploy\";\n"
+    },
+    "scripts/workflow/steps/check.ts": {
+      "sha256": "6acd1ac039a61c09d5c0cfe29e76d85fc95564a03b9a6cc374e80c8f9e2632b3",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/steps/check\";\n"
+    },
+    "scripts/workflow/lib/executionProgress.ts": {
+      "sha256": "5f595a3b5f1d697b3832d20a83a9489338ba7b703f843b00162ac306ef1bb356",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/executionProgress\";\n"
+    },
+    "scripts/workflow/lib/externalExecutionScanner.ts": {
+      "sha256": "8deeae99765f8e75e5aae209d4d67125b8b4e83495ee1aa579904b790abea5a7",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/externalExecutionScanner\";\n"
+    },
+    "scripts/workflow/lib/gateTool.ts": {
+      "sha256": "d32df22fbf21ed288953cb58911f3936b50ddd63f9b9b67c9ceaea3768fe6cd8",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/gateTool\";\n"
+    },
+    "scripts/workflow/lib/state.ts": {
+      "sha256": "697883f3290707960b1ebee39202a4bcc39caa26195ec7d0c5aa81ce56e0db30",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/state\";\n"
+    },
+    "scripts/workflow/lib/sourceRpcPolicy.ts": {
+      "sha256": "20c7152ed1a569e5a761b7c28129427957e260bf1f594feff22fa504a27f2f5f",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/sourceRpcPolicy\";\n"
+    },
+    "scripts/workflow/lib/calls.ts": {
+      "sha256": "8fea7b66b675f7e5c9a502b03a17e79b7f69cbe5538c341176e4cfa19ab505b9",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/calls\";\n"
+    },
+    "scripts/workflow/lib/operatorExecution.ts": {
+      "sha256": "9047e7bf2c8782048c212e868d23c96be6eef5c47571264956a3898837e1f4f8",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/operatorExecution\";\n"
+    },
+    "scripts/workflow/lib/external.ts": {
+      "sha256": "0c20dc8ed20e5f006f3ff25ac74f1737330f789321d29e7ce4b73099ea51dd0c",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/external\";\n"
+    },
+    "scripts/workflow/lib/signer.ts": {
+      "sha256": "2a087fe4bd2cee9c88fd3c2369614f7e78f21dd6daa02c3b059089bc1610fff1",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/signer\";\n"
+    },
+    "scripts/workflow/lib/pendingDeploymentReuse.ts": {
+      "sha256": "32547f0acda5e8fb540fb92c968943fba23ef21549aa714e7c57577d86907706",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/pendingDeploymentReuse\";\n"
+    },
+    "scripts/workflow/lib/migrationState.ts": {
+      "sha256": "34f048ce919c90b35baaaf660dfba6e5ed02494850fce13e6fef017af3208e3d",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/migrationState\";\n"
+    },
+    "scripts/workflow/lib/signerIdentity.ts": {
+      "sha256": "2ff5510bea0bb34f8dae7045a9ed89d3cbc9c3aa601f964f791e0d4d471c79e8",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/signerIdentity\";\n"
+    },
+    "scripts/workflow/lib/checkCodeReport.ts": {
+      "sha256": "868a1fe34702bee1f9b8a7eb64e91ee104ee9239ab4c7e7a6d8351a737541557",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCodeReport\";\n"
+    },
+    "scripts/workflow/lib/errors.ts": {
+      "sha256": "43ca35a3c858d62e7ddfda620fb976997f66b24d90a9d29378099935514a5c55",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/errors\";\n"
+    },
+    "scripts/workflow/lib/deployments.ts": {
+      "sha256": "ff4792e2bf0920e24d3dadb9f10870e38c29fe2de96cfdb9d9bcc49992c2f9b6",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/deployments\";\n"
+    },
+    "scripts/workflow/lib/parameters.ts": {
+      "sha256": "fb35cfb88366abb922b7fcafc8ddc8442dbfaa6cf5d28b20ac3a1590c5c5c5dc",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/parameters\";\n"
+    },
+    "scripts/workflow/lib/authority.ts": {
+      "sha256": "bf6f239e9f0b39cbb98b68c7dfbf2ae15c5e53b7768c116be81f0febc7bcae73",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/authority\";\n"
+    },
+    "scripts/workflow/lib/registryCommit.ts": {
+      "sha256": "b414d779b60d5f24bc00de035f72b8b32e084c9d590e2df602fdfda6d160758a",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/registryCommit\";\n"
+    },
+    "scripts/workflow/lib/lock.ts": {
+      "sha256": "c06259f2f15d33e36e77c0385349ed85e53eaba070be2691454338f73ac1e065",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/lock\";\n"
+    },
+    "scripts/workflow/lib/executionPlan.ts": {
+      "sha256": "3ee88d53b65967ab486f5a389a28b1a23c8d1a626e36c1ec1929dac5c99133f3",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/executionPlan\";\n"
+    },
+    "scripts/workflow/lib/forkSnapshot.ts": {
+      "sha256": "7696cea4d2c3083751702472c4dbb79d46d164414f8994a13242299113ffd243",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/forkSnapshot\";\n"
+    },
+    "scripts/workflow/lib/simulationCallers.ts": {
+      "sha256": "1f5bacb13cbdfe715d4de386494b90e15e5870ea5a7a9d8f9632f4bdc4fad079",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/simulationCallers\";\n"
+    },
+    "scripts/workflow/lib/create2.ts": {
+      "sha256": "e2f10d28bf146ea34e0725cf264c2ce2760be7189fe00d432c2d2846044532e1",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/create2\";\n"
+    },
+    "scripts/workflow/lib/deploymentRecords.ts": {
+      "sha256": "dbfbd807c8145509be20b7a6fc348f4a10efd110f4c3fc32ac0e0b28cb1de69e",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/deploymentRecords\";\n"
+    },
+    "scripts/workflow/lib/calldata.ts": {
+      "sha256": "719ff73b01076ce2208f37ebedbec021c221ce1a8cb1298a322a964620b8f479",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/calldata\";\n"
+    },
+    "scripts/workflow/lib/staticValidation.ts": {
+      "sha256": "190495f4f4351d4171db2d352f024f904a84f345029fafe8fbcdd187c5be3928",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/staticValidation\";\n"
+    },
+    "scripts/workflow/lib/zksyncForkRunner.ts": {
+      "sha256": "9085e54653a8d0f4326f496c3a4c43e2214b62f4378680b2a50368f449bab250",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/zksyncForkRunner\";\n"
+    },
+    "scripts/workflow/lib/reporter.ts": {
+      "sha256": "b6a13433516b54532e48cee74330ae03ddcfecc206d7aad57c91230c161e47e3",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/reporter\";\n"
+    },
+    "scripts/workflow/lib/proxy.ts": {
+      "sha256": "7535524e1cc40c07add9ebaf7d7e648a51be897a61f74bf9b17e92bcc1ee4c2a",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/proxy\";\n"
+    },
+    "scripts/workflow/lib/cliTool.ts": {
+      "sha256": "387745f187193dce14c57242b388b956bc1c8abea060cd961f6d1cc49a480666",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/cliTool\";\n"
+    },
+    "scripts/workflow/lib/contractInfoCandidates.ts": {
+      "sha256": "da8f29aa4bcab642ac427f9e2da5f0b179821afab7c59d170b95249457e30c13",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/contractInfoCandidates\";\n"
+    },
+    "scripts/workflow/lib/resultPaths.ts": {
+      "sha256": "1c8bb134fd5f0f9e0e3367a6f900cc9dcd8d852a66a14dc3a3b2daabad9d3788",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/resultPaths\";\n"
+    },
+    "scripts/workflow/lib/releaseParameters.ts": {
+      "sha256": "1203f9f04672760b77a1efaa3dd7de65eca9abb5e3d5ab75e0822690207f4961",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/releaseParameters\";\n"
+    },
+    "scripts/workflow/lib/create2Hashes.ts": {
+      "sha256": "2e033317c016d14f71b41ba1f122f75b2f140f146e4517dc3e07ecaa32ba4d9c",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/create2Hashes\";\n"
+    },
+    "scripts/workflow/lib/executionId.ts": {
+      "sha256": "1a66bdc10c596f27d2fcf52d33c3d38b0066ded464732b9d561757f52d0d1d85",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/executionId\";\n"
+    },
+    "scripts/workflow/lib/checkCodeRunner.ts": {
+      "sha256": "455a6bd825c101b2217e5e9201491590e5c70bb0391cb2b5f22d55f5346ac8e7",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCodeRunner\";\n"
+    },
+    "scripts/workflow/lib/config.ts": {
+      "sha256": "bf2412e1731834f9612e318a7331207dc5cde946c354efe7bc65ba8f1d997a84",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/config\";\n"
+    },
+    "scripts/workflow/lib/release.ts": {
+      "sha256": "bbb14bf3614a3568b9d2c0b6b21d74ba9da8f936432f88a4290a94b7a4bebf67",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/release\";\n"
+    },
+    "scripts/workflow/lib/erc1967.ts": {
+      "sha256": "1d94061d282914ec5bd3f0bc0f9f3ea18c95e983c012c55d4772a926b5fab34c",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/erc1967\";\n"
+    },
+    "scripts/workflow/lib/zksyncForkCapability.ts": {
+      "sha256": "a839c5dea3c9086ddfce6eb91ce61d09d207cdfa0864c645f3818d577dd902fd",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/zksyncForkCapability\";\n"
+    },
+    "scripts/workflow/lib/gateToolSync.ts": {
+      "sha256": "e60eadc9f6cd9dfea5e37b440e4c720ffbbe11d968a5aa7f414692c0ba8818c7",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/gateToolSync\";\n"
+    },
+    "scripts/workflow/lib/deploymentInfo.ts": {
+      "sha256": "d415f01d40d49a176ec01de4f178566a51e2a80c7b256316673555710052c2f1",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/deploymentInfo\";\n"
+    },
+    "scripts/workflow/lib/simulation.ts": {
+      "sha256": "80b4e28737b23f89cc0daef8af6dcffea15eb8760876f4defc91d89c7c3d6f8b",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/simulation\";\n"
+    },
+    "scripts/workflow/lib/releaseFinalize.ts": {
+      "sha256": "723e83c56a4aef7a46a575d452da5976c68899c2aa9933f28e087accf73f9a92",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/releaseFinalize\";\n"
+    },
+    "scripts/workflow/lib/checkCode/dependencies.ts": {
+      "sha256": "e99b4d3e5503bf2d5f4f51647624b66fc4a6de2cd1a0c723fccec2e441df0243",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/dependencies\";\n"
+    },
+    "scripts/workflow/lib/checkCode/args.ts": {
+      "sha256": "163c78dae13b9e9b30cfd55f3400995ca4073c1e7eabd7586222132b4c667105",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/args\";\n"
+    },
+    "scripts/workflow/lib/checkCode/finalize.ts": {
+      "sha256": "1007b9c680a13efd0527f750d5cc2b94328df84fa9ef4e68233beb8ac03c9c0f",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/finalize\";\n"
+    },
+    "scripts/workflow/lib/checkCode/index.ts": {
+      "sha256": "73c6140ff67535e83fdc83d532c4647c61cb7d3ebf407c50a5755612ab76b9f1",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/index\";\n"
+    },
+    "scripts/workflow/lib/checkCode/command.ts": {
+      "sha256": "d3c5dd581261c9c7a5b33a76b75052173223a374ff98d0c22eb3127ebb51703e",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/command\";\n"
+    },
+    "scripts/workflow/lib/checkCode/plan.ts": {
+      "sha256": "8c239eb1c1bed485c096d9f769f8a62f32e483244fc7f2c5a50f01dcc9b69b00",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime/lib/checkCode/plan\";\n"
+    },
+    "scripts/config/openzeppelin.ts": {
+      "sha256": "04281ccaa0b2c2fb134d76c1df2d6d746e05ef4d3fe9b3689b598b4696447add",
+      "replacement": "// Shared manifest policy is owned by GateTool.\nexport * from \"gate-evm-tools/runtime-config/openzeppelin\";\n"
+    },
+    "scripts/config/rpc.ts": {
+      "sha256": "019833e499a3b0e68290416fbdaaac29589e0297e4a0cf88f73460bbdfc6ce7c",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime-config/rpc\";\n"
+    },
+    "scripts/config/zksyncSolcPath.ts": {
+      "sha256": "5eba5d47d773de75624f84f41841a7079780907b4635dabbd089d9875a620add",
+      "replacement": "// Compatibility entrypoint; implementation is owned by GateTool.\nexport * from \"gate-evm-tools/runtime-config/zksyncSolcPath\";\n"
+    }
+  }
+}

package/runtime/workflow/checkCode.ts

@@ -0,0 +1,13 @@
+import { runCheckCodeWorkflow } from "./lib/checkCode";
+
+void runCheckCodeWorkflow().then((report) => {
+  console.log(JSON.stringify({
+    status: report.status,
+    runId: report.runId,
+    reportPath: report.reportPath,
+  }));
+  if (report.status !== "succeeded") process.exitCode = 1;
+}).catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/runtime/workflow/checkCodeFinalize.ts

@@ -0,0 +1,8 @@
+import { runDevelopmentCheckCodeFinalizeCli } from "./lib/checkCode/finalize";
+
+try {
+  console.log(JSON.stringify(runDevelopmentCheckCodeFinalizeCli(process.argv.slice(2))));
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}

package/runtime/workflow/checkCodePlan.ts

@@ -0,0 +1,8 @@
+import { runCheckCodePlanCli } from "./lib/checkCode/plan";
+
+try {
+  console.log(JSON.stringify(runCheckCodePlanCli(process.argv.slice(2))));
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}