gate-evm-tools 1.0.26 → 1.0.28

package/dist-runtime/workflow/steps/upgrade.js

@@ -0,0 +1,466 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUpgradeStep = void 0;
+const controlledMulticallAbi_1 = require("../lib/controlledMulticallAbi");
+const ethers_1 = require("ethers");
+const projectHardhat_1 = require("../../projectHardhat");
+const path_1 = __importDefault(require("path"));
+const authority_1 = require("../lib/authority");
+const deployments_1 = require("../lib/deployments");
+const gateTool_1 = require("../lib/gateTool");
+const gateToolSync_1 = require("../lib/gateToolSync");
+const erc1967_1 = require("../lib/erc1967");
+const lock_1 = require("../lib/lock");
+const parameters_1 = require("../lib/parameters");
+const create2_1 = require("../lib/create2");
+const proxy_1 = require("../lib/proxy");
+const signer_1 = require("../lib/signer");
+const simulation_1 = require("../lib/simulation");
+const resolveInContext = (context, value) => (0, parameters_1.resolveValue)(value, {
+    targetId: context.targetId,
+    target: context.target,
+    params: context.targetParams,
+    state: context.state,
+});
+const resolveObject = (context, value) => {
+    const resolved = resolveInContext(context, value || {});
+    if (!resolved || typeof resolved !== "object" || Array.isArray(resolved))
+        return {};
+    return resolved;
+};
+const resolveArray = (context, value, label) => {
+    const resolved = resolveInContext(context, value || []);
+    if (!Array.isArray(resolved))
+        throw new Error(`${label} must resolve to an array`);
+    return resolved;
+};
+const stringField = (source, key) => (typeof source[key] === "string" && source[key] ? String(source[key]) : undefined);
+const proxyReference = (context, step) => {
+    const proxyObject = resolveObject(context, step.proxy);
+    const rawProxy = stringField(proxyObject, "address")
+        || stringField(proxyObject, "name")
+        || stringField(proxyObject, "contract")
+        || (typeof step.proxy === "string" ? String(resolveInContext(context, step.proxy)) : undefined)
+        || (typeof step.address === "string" ? String(resolveInContext(context, step.address)) : undefined);
+    if (!rawProxy)
+        throw new Error(`Step ${step.id} requires proxy address or deployment name`);
+    const registryDeployment = (0, ethers_1.isAddress)(rawProxy)
+        ? undefined
+        : (0, deployments_1.resolveDeployment)((0, deployments_1.loadContractInfo)(context.root, context.config), context.targetId, rawProxy);
+    if (!(0, ethers_1.isAddress)(rawProxy) && !registryDeployment) {
+        throw new Error(`Missing contractInfo address: ${context.targetId}.${rawProxy}`);
+    }
+    const proxyAddress = (0, ethers_1.isAddress)(rawProxy) ? rawProxy : registryDeployment.address;
+    const defaultSaveAs = (0, ethers_1.isAddress)(rawProxy)
+        ? (0, deployments_1.actualContractName)(String(step.contract))
+        : registryDeployment.key.split(":", 1)[0];
+    const saveAs = (0, deployments_1.deploymentInstanceId)(String(step.saveAs || defaultSaveAs));
+    const registryKey = registryDeployment?.key || (0, deployments_1.contractInfoKey)(saveAs, String(step.contract));
+    return {
+        proxyAddress,
+        saveAs,
+        contractInfoKey: registryKey,
+        proxy: {
+            kind: stringField(proxyObject, "kind")
+                || (typeof step.proxyKind === "string" ? step.proxyKind : "uups"),
+            initializer: proxyObject.initializer === false
+                ? false
+                : stringField(proxyObject, "initializer"),
+            unsafeAllow: Array.isArray(proxyObject.unsafeAllow)
+                ? proxyObject.unsafeAllow.map((item) => String(item))
+                : undefined,
+            constructorArgs: proxyObject.constructorArgs === undefined
+                ? undefined
+                : resolveArray(context, proxyObject.constructorArgs, `Step ${step.id} proxy.constructorArgs`),
+        },
+    };
+};
+const upgradeCall = (context, step) => {
+    const call = resolveObject(context, step.call);
+    const fn = stringField(call, "fn") || stringField(call, "method");
+    return fn
+        ? { fn, args: resolveArray(context, call.args || [], `Step ${step.id} call.args`) }
+        : undefined;
+};
+const requiredPlanTransaction = (transactions, purpose) => {
+    const selected = transactions.filter((transaction) => transaction.purpose === purpose);
+    if (selected.length !== 1) {
+        throw new Error(`GateTool plan must contain exactly one ${purpose} transaction`);
+    }
+    return selected[0];
+};
+const implementationDeployment = (deployments) => {
+    const selected = deployments.filter((deployment) => deployment.role === "implementation");
+    if (selected.length !== 1) {
+        throw new Error("GateTool plan must contain exactly one implementation deployment");
+    }
+    return selected[0];
+};
+const transactionEnvelope = (transaction) => ({
+    target: transaction.to,
+    value: transaction.value,
+    data: transaction.data,
+    operation: transaction.operation,
+    ...(transaction.factoryDeps === undefined
+        ? {}
+        : { scheme: "zksync-eravm", factoryDeps: transaction.factoryDeps }),
+});
+const assertUupsChainState = async (proxy, implementation) => {
+    const [proxyCode, implementationCode, currentImplementation] = await Promise.all([
+        projectHardhat_1.ethers.provider.getCode(proxy),
+        projectHardhat_1.ethers.provider.getCode(implementation),
+        (0, erc1967_1.getERC1967Implementation)(projectHardhat_1.ethers.provider, proxy),
+    ]);
+    if (!proxyCode || proxyCode === "0x") {
+        throw new Error(`UUPS proxy is missing deployed code at ${proxy}`);
+    }
+    if (!implementationCode || implementationCode === "0x") {
+        throw new Error(`UUPS implementation is missing deployed code at ${implementation}`);
+    }
+    if (!currentImplementation
+        || currentImplementation.toLowerCase() !== implementation.toLowerCase()) {
+        throw new Error(`UUPS proxy ${proxy} does not point to GateTool implementation ${implementation}`);
+    }
+};
+const runUpgradeStep = async (context, step) => {
+    if (!context.signer || !context.signerAddress) {
+        throw new Error(`Upgrade step ${step.id} requires a signer`);
+    }
+    const contractName = String(step.contract);
+    const proxy = proxyReference(context, step);
+    if ((proxy.proxy.kind || "uups") !== "uups") {
+        throw new Error(`Upgrade step ${step.id} only supports UUPS proxies`);
+    }
+    if (context.mode === "simulate") {
+        await (0, simulation_1.assertSimulationUupsSourceState)(context.simulation, proxy.proxyAddress);
+    }
+    const call = upgradeCall(context, step);
+    const actualContract = (0, deployments_1.actualContractName)(contractName);
+    const targetCreate2 = context.target.create2;
+    const targetMulticall = context.target.multicall;
+    const scheme = targetCreate2?.scheme || "evm";
+    if (scheme !== "evm" && scheme !== "zksync-eravm") {
+        throw new Error(`Upgrade step ${step.id} target create2 scheme is invalid`);
+    }
+    if (!targetCreate2?.factory || !targetMulticall?.controlledMulticall) {
+        throw new Error(`Upgrade step ${step.id} requires target create2 factory and controlledMulticall`);
+    }
+    const constructorArgs = resolveArray(context, step.constructorArgs || proxy.proxy.constructorArgs || [], `Step ${step.id} constructorArgs`);
+    const implementationSalt = (0, proxy_1.deriveImplementationSalt)(context.executionId, contractName, proxy.proxyAddress);
+    const request = {
+        version: 1,
+        kind: "uups-upgrade",
+        scheme,
+        network: projectHardhat_1.network.name,
+        target: context.targetId,
+        contract: contractName,
+        constructorArgs,
+        factory: targetCreate2.factory,
+        proxyKind: "uups",
+        proxy: proxy.proxyAddress,
+        implementationSalt,
+        ...(proxy.proxy.unsafeAllow ? { unsafeAllow: proxy.proxy.unsafeAllow } : {}),
+        ...(call ? { call: { method: call.fn, args: call.args } } : {}),
+    };
+    const gateToolEvidenceDir = path_1.default.join(context.taskDir, "results", context.targetId, context.executionId, "gate-tool", context.mode);
+    const prepared = await (0, gateTool_1.prepareGateToolWorkflow)({
+        root: context.root,
+        evidenceDir: gateToolEvidenceDir,
+        evidenceName: step.id,
+        request,
+        readBlockTag: context.mode === "simulate"
+            ? context.simulation.snapshot?.blockNumber
+            : undefined,
+    });
+    const implementation = implementationDeployment(prepared.plan.deployments);
+    const implementationCall = prepared.plan.transactions.find((transaction) => transaction.purpose === "deploy-implementation");
+    const proxyUpgradeCall = requiredPlanTransaction(prepared.plan.transactions, "upgrade-proxy");
+    const gateToolPlan = path_1.default.relative(context.root, prepared.planPath).split(path_1.default.sep).join("/");
+    const preparedChange = {
+        stepId: step.id,
+        kind: "upgrade",
+        instanceId: proxy.saveAs,
+        actualContract,
+        contractInfoKey: proxy.contractInfoKey,
+        strategy: "gate-tool",
+        proxyKind: "uups",
+        proxyAddress: proxy.proxyAddress,
+        implementationAddress: implementation.address,
+        implementationSalt,
+        constructorArgs,
+        factory: targetCreate2.factory,
+        gateTool: {
+            outputPath: gateToolPlan,
+            data: prepared.plan,
+        },
+    };
+    if (context.parameterLockExecutionId) {
+        (0, lock_1.recordParameterLockImplementationSalts)(context.taskDir, context.parameterLockExecutionId, { [`${step.id}.implementation`]: implementationSalt });
+    }
+    const recorder = context.mode === "execute" ? context.deploymentRecorder : undefined;
+    if (context.mode === "execute" && !recorder) {
+        throw new Error(`Upgrade step ${step.id} requires an execution deployment recorder`);
+    }
+    recorder?.prepare(preparedChange);
+    const proxyContract = await projectHardhat_1.ethers.getContractAt(String(step.abi || contractName), proxy.proxyAddress, context.signer);
+    const upgradeAuthority = await (0, authority_1.decideAuthority)(proxyContract, context.target, context.signerAddress);
+    if (context.mode === "simulate"
+        && !context.configuredSimulationCaller
+        && !context.executionPlanner) {
+        (0, authority_1.assertSelectedSimulationSignerAuthorized)(upgradeAuthority, step.id);
+    }
+    const implementationMulticall = implementationCall
+        ? (0, create2_1.prepareControlledMulticallTransaction)(targetMulticall.controlledMulticall, [{
+                target: implementationCall.to,
+                value: implementationCall.value,
+                data: implementationCall.data,
+                ...(implementationCall.factoryDeps === undefined
+                    ? {}
+                    : { factoryDeps: implementationCall.factoryDeps }),
+            }], scheme)
+        : undefined;
+    const multicall = implementationMulticall
+        ? await projectHardhat_1.ethers.getContractAt(controlledMulticallAbi_1.CONTROLLED_MULTICALL_AUTHORITY_ABI, targetMulticall.controlledMulticall, context.signer)
+        : undefined;
+    const implementationAuthority = multicall
+        ? await (0, authority_1.decideControlledMulticallAuthority)(multicall, targetCreate2.factory, context.target, context.signerAddress)
+        : undefined;
+    if (scheme === "zksync-eravm"
+        && (upgradeAuthority.mode !== "execute"
+            || implementationAuthority?.mode === "calldata")) {
+        throw new Error(`Upgrade step ${step.id} requires unsupported zkSync external Admin execution`);
+    }
+    if (!context.executionPlanner) {
+        const configuredCallerSimulation = context.mode === "simulate"
+            && context.configuredSimulationCaller === true;
+        if (!configuredCallerSimulation
+            && (upgradeAuthority.mode !== "execute"
+                || implementationAuthority?.mode === "calldata")) {
+            throw new Error(`Upgrade step ${step.id} requires a locked mixed-authority execution plan`);
+        }
+        let implementationTxHash;
+        if (implementationMulticall) {
+            const tx = await (0, create2_1.sendPreparedControlledMulticallTransaction)(implementationMulticall, context.signer);
+            implementationTxHash = tx.hash;
+        }
+        const upgradeTx = await (0, create2_1.sendPreparedWorkflowTransaction)(transactionEnvelope(proxyUpgradeCall), context.signer);
+        await assertUupsChainState(proxy.proxyAddress, implementation.address);
+        const gateToolSync = context.mode === "execute"
+            ? await (0, gateToolSync_1.syncGateToolUups)({
+                root: context.root,
+                evidenceDir: gateToolEvidenceDir,
+                evidenceName: step.id,
+                scheme: prepared.plan.scheme,
+                network: projectHardhat_1.network.name,
+                target: context.targetId,
+                manifestDir: context.target.openzeppelin.manifestDir,
+                proxy: proxy.proxyAddress,
+                implementation: implementation.address,
+                contract: actualContract,
+                constructorArgs,
+                transactionHash: upgradeTx.hash,
+            })
+            : undefined;
+        if (context.mode === "execute") {
+            recorder?.apply({
+                ...preparedChange,
+                implementationTxHash,
+                txHash: upgradeTx.hash,
+                gateToolSync,
+            });
+        }
+        context.state.set(`${proxy.saveAs}Upgrade`, {
+            proxyAddress: proxy.proxyAddress,
+            implementationAddress: implementation.address,
+            implementationSalt,
+            implementationTxHash,
+            txHash: upgradeTx.hash,
+            gateToolPlan,
+            gateToolSync: gateToolSync?.outputPath,
+        });
+        context.reporter.result("execution", {
+            stepId: step.id,
+            kind: step.kind,
+            mode: "execute",
+            scheme,
+            contract: contractName,
+            actualContract,
+            saveAs: proxy.saveAs,
+            contractInfoKey: proxy.contractInfoKey,
+            proxy: proxy.proxyAddress,
+            implementationAddress: implementation.address,
+            implementationTxHash,
+            txHash: upgradeTx.hash,
+            gateToolPlan,
+        });
+        return;
+    }
+    let implementationTransactionId;
+    let implementationTxHash;
+    let implementationExternal = false;
+    if (implementationMulticall && implementationAuthority) {
+        const implementationExecutor = implementationAuthority.mode === "execute"
+            ? context.signerAddress
+            : implementationAuthority.executor;
+        if (!implementationExecutor) {
+            throw new Error(`Upgrade step ${step.id} cannot resolve implementation executor`);
+        }
+        const planned = context.executionPlanner.add({
+            stepId: `${step.id}-implementation`,
+            executor: implementationExecutor,
+            to: implementationMulticall.target,
+            value: implementationMulticall.value,
+            data: implementationMulticall.data,
+            operation: 0,
+            ...(implementationMulticall.scheme === undefined
+                ? {}
+                : { scheme: implementationMulticall.scheme }),
+            ...(implementationMulticall.factoryDeps === undefined
+                ? {}
+                : { factoryDeps: implementationMulticall.factoryDeps }),
+        });
+        implementationTransactionId = planned.transactionId;
+        implementationExternal = planned.route === "external";
+        if (planned.executionAction === "replay") {
+            implementationTxHash = planned.transactionHash;
+        }
+        else if (planned.route === "external" && context.mode !== "simulate") {
+            context.externalCalls.push({
+                transactionId: planned.transactionId,
+                stepId: planned.stepId,
+                to: planned.to,
+                value: planned.value,
+                data: planned.data,
+                operation: planned.operation,
+                method: implementationMulticall.method,
+                args: implementationMulticall.calls,
+                executor: planned.executor,
+                reason: implementationAuthority.reason,
+            });
+        }
+        else {
+            const selectedSigner = planned.route === "external"
+                ? await (0, signer_1.impersonateWorkflowSimulationSigner)(planned.executor)
+                : context.signer;
+            const tx = await (0, create2_1.sendPreparedControlledMulticallTransaction)(implementationMulticall, selectedSigner);
+            implementationTxHash = tx.hash;
+            if (context.mode === "execute" && planned.route === "operator") {
+                context.operatorReceipts.push({
+                    transactionId: planned.transactionId,
+                    transactionHash: tx.hash,
+                });
+            }
+        }
+    }
+    const upgradeExecutor = upgradeAuthority.mode === "execute"
+        ? context.signerAddress
+        : upgradeAuthority.executor;
+    if (!upgradeExecutor)
+        throw new Error(`Upgrade step ${step.id} cannot resolve proxy executor`);
+    const upgradeEnvelope = transactionEnvelope(proxyUpgradeCall);
+    const upgradeTransaction = context.executionPlanner.add({
+        stepId: step.id,
+        executor: upgradeExecutor,
+        to: upgradeEnvelope.target,
+        value: upgradeEnvelope.value,
+        data: upgradeEnvelope.data,
+        operation: 0,
+        ...(upgradeEnvelope.scheme === undefined ? {} : { scheme: upgradeEnvelope.scheme }),
+        ...(upgradeEnvelope.factoryDeps === undefined
+            ? {}
+            : { factoryDeps: upgradeEnvelope.factoryDeps }),
+    });
+    if (context.mode === "execute") {
+        recorder?.bindProxyTransaction(step.id, upgradeTransaction.transactionId);
+    }
+    let upgradeTxHash;
+    if (upgradeTransaction.executionAction === "replay") {
+        upgradeTxHash = upgradeTransaction.transactionHash;
+    }
+    else if (upgradeTransaction.route === "external" && context.mode !== "simulate") {
+        context.externalCalls.push({
+            transactionId: upgradeTransaction.transactionId,
+            stepId: upgradeTransaction.stepId,
+            to: upgradeTransaction.to,
+            value: upgradeTransaction.value,
+            data: upgradeTransaction.data,
+            operation: upgradeTransaction.operation,
+            method: "upgradeToAndCall",
+            args: [implementation.address],
+            executor: upgradeTransaction.executor,
+            reason: upgradeAuthority.reason,
+        });
+    }
+    else {
+        const selectedSigner = upgradeTransaction.route === "external"
+            ? await (0, signer_1.impersonateWorkflowSimulationSigner)(upgradeTransaction.executor)
+            : context.signer;
+        const tx = await (0, create2_1.sendPreparedWorkflowTransaction)(upgradeEnvelope, selectedSigner);
+        upgradeTxHash = tx.hash;
+        if (context.mode === "execute" && upgradeTransaction.route === "operator") {
+            context.operatorReceipts.push({
+                transactionId: upgradeTransaction.transactionId,
+                transactionHash: tx.hash,
+            });
+        }
+    }
+    if (context.mode === "execute"
+        && !implementationExternal
+        && upgradeTransaction.route === "operator") {
+        await assertUupsChainState(proxy.proxyAddress, implementation.address);
+        const gateToolSync = await (0, gateToolSync_1.syncGateToolUups)({
+            root: context.root,
+            evidenceDir: gateToolEvidenceDir,
+            evidenceName: step.id,
+            scheme: prepared.plan.scheme,
+            network: projectHardhat_1.network.name,
+            target: context.targetId,
+            manifestDir: context.target.openzeppelin.manifestDir,
+            proxy: proxy.proxyAddress,
+            implementation: implementation.address,
+            contract: actualContract,
+            constructorArgs,
+            transactionHash: upgradeTxHash || "",
+        });
+        recorder?.apply({
+            ...preparedChange,
+            implementationTxHash,
+            txHash: upgradeTxHash,
+            gateToolSync,
+        });
+    }
+    else if (context.mode === "simulate") {
+        await assertUupsChainState(proxy.proxyAddress, implementation.address);
+    }
+    context.state.set(`${proxy.saveAs}Upgrade`, {
+        proxyAddress: proxy.proxyAddress,
+        implementationAddress: implementation.address,
+        implementationSalt,
+        implementationTxHash,
+        txHash: upgradeTxHash,
+        external: implementationExternal || upgradeTransaction.route === "external",
+        gateToolPlan,
+    });
+    context.reporter.result("execution", {
+        stepId: step.id,
+        kind: step.kind,
+        mode: upgradeTransaction.route,
+        scheme,
+        implementationTransactionId,
+        upgradeTransactionId: upgradeTransaction.transactionId,
+        contract: contractName,
+        actualContract,
+        saveAs: proxy.saveAs,
+        contractInfoKey: proxy.contractInfoKey,
+        proxy: proxy.proxyAddress,
+        implementationAddress: implementation.address,
+        implementationTxHash,
+        txHash: upgradeTxHash,
+        gateToolPlan,
+    });
+};
+exports.runUpgradeStep = runUpgradeStep;
+//# sourceMappingURL=upgrade.js.map

package/dist-runtime/workflow/steps/upgrade.js.map

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

package/dist-runtime/workflow/steps/view.d.ts

@@ -0,0 +1,3 @@
+import { WorkflowContext } from "../run";
+import { WorkflowStep } from "../lib/parameters";
+export declare const runViewStep: (context: WorkflowContext, step: WorkflowStep) => Promise<void>;

package/dist-runtime/workflow/steps/view.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runViewStep = void 0;
+const calls_1 = require("../lib/calls");
+const runViewStep = async (context, step) => {
+    await (0, calls_1.runContractViewCalls)(context, step);
+};
+exports.runViewStep = runViewStep;
+//# sourceMappingURL=view.js.map

package/dist-runtime/workflow/steps/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../runtime/workflow/steps/view.ts"],"names":[],"mappings":";;;AAEA,wCAAoD;AAE7C,MAAM,WAAW,GAAG,KAAK,EAC9B,OAAwB,EACxB,IAAkB,EACH,EAAE;IACjB,MAAM,IAAA,4BAAoB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC;AALW,QAAA,WAAW,eAKtB"}

package/docs/direct-package-acceptance.md

@@ -0,0 +1,20 @@
+# Direct-package template acceptance — 2026-09-09
+
+New full projects use `gate-workflow` directly through the existing npm command names. Hardhat and tests import `gate-evm-tools/runtime-config/*` and `runtime/*`; the template no longer contains `scripts/workflow` or `scripts/config` forwarding directories. Business contracts, task/custom scripts, configuration and state remain project-owned.
+
+Local artifact: `/Users/vector/gate/local-packages/direct-package/gate-evm-tools-1.1.0-local.0.tgz`. Its SHA-256 is recorded alongside it in `sha256.txt`. This preview is unpublished. The installed runtime digest is `612a6704b8bd379c97ee352a47a04402615a49c38718bc3542ca0f6252097de2`.
+
+Validation:
+
+- GateTool: 131 tests passed after rebuilding the migration utility.
+- EVM generator/template: build and all 374 tests passed, including direct commands, legacy upgrades and conflict handling.
+- Isolated full project: installed the tarball and refreshed its existing npm lockfile, then `npm ci`, 9 Hardhat tests and a two-custom-step simulation (`direct-final-2`) passed.
+- GateFlow `evm-runtime-check`: accepted the direct-package fixture and reported the matching version/digest.
+- Historical full-template baseline: migration removed 72 recognized files, updated 4 consumers, and backed up originals. All 72 backups matched the baseline. Hardhat differed only in import paths; compiler settings were unchanged. A repeated migration reported 72 current entries and made no changes.
+- Migration skill: quick validation and 89 workflow policy tests passed.
+
+Logs, migration plans, GateFlow output and tarball metadata are in the artifact directory above. The historical baseline check shares the isolated project's installed node_modules for resolution; the isolated full project itself was validated using a real frozen npm install.
+
+Migration refuses custom/unknown executable references and unsafe paths instead of deleting them. Install the approved package and update dependency/lockfile first, review `gate-workflow migrate`, then apply once. Later compatible upgrades update the exact package and existing lockfile; breaking API/config changes still need migration. Active execution bindings must stay on their original runtime build.
+
+No remote transaction broadcast, npm publication, commit/push or active SuperTask mutation was performed in this acceptance.

package/docs/external-infrastructure-acceptance.md

@@ -0,0 +1,33 @@
+# External infrastructure template acceptance
+
+The full template no longer ships Multicall3.sol or UUPSPlaceholder.sol. GateTool queries deployed Multicall authority with a packaged ABI. New proxy deployment steps identify the same business implementation in contract and firstUpgrade.contract; the old placeholder identifier remains supported without loading that artifact.
+
+No project proxy Solidity entry remains. registerWorkflowDependencyCompiler adds the canonical OpenZeppelin ERC1967Proxy source name to Hardhat compilation through the project subtask API. Project compiler settings remain authoritative. No infrastructure addresses, salts, deployments or existing project source files were changed by this template update.
+
+Pending versions: GateTool 1.0.28, EVM generator 2.1.23 (^1.0.28 dependency), GateFlow 4.2.2. The template capability workflow.external-infrastructure.v1 selects the new integrity checks; historical templates retain their source/artifact checks. Upgrade GateFlow and workflow skills before using this template in a task. The migration helper does not delete existing infrastructure source automatically.
+
+Validation:
+- GateTool: 135 tests passed.
+- EVM generator: final full run 374 tests passed, including source-level deployment and upgrade lifecycle regression.
+- GateFlow: 34 tests passed; CLI build passed.
+- ai-workflows: 89 policy tests passed; migration skill validation passed. Initialization accepted the real new fixture without either infrastructure source.
+- Local 1.0.28 tarball installed into an isolated full project, npm ci succeeded, clean Hardhat compilation and 9 tests passed without the two source files.
+- OpenZeppelin proxy bytecode and deployedBytecode were byte-for-byte identical when compiling with and without the two infrastructure sources. Final fixture was cleaned and rebuilt without them.
+- GateFlow accepted the real compiled project with the new capability, actual installed runtime and proxy artifact.
+- Direct dependency compilation without any proxy import source passed 9 Hardhat tests and zkSync compilation (9 sources). EVM proxy bytecode and deployedBytecode matched the original import-based compilation exactly.
+
+Local tarball: /Users/vector/gate/local-packages/external-infrastructure/gate-evm-tools-1.0.28.tgz. Final direct OpenZeppelin compilation logs use /tmp/direct-oz-* and are archived beside the tarball; earlier logs use /tmp/external-infra-*; the isolated project is /Users/vector/gate/local-packages/direct-package/full-runtime-check.
+
+No broadcast, npm publication, commit or push performed. Existing execution bindings cannot resume under a changed runtime digest; use the original runtime to finish those tasks.
+
+## New-workflow package acceptance
+
+Both gate-evm-tools-1.0.28.tgz and gate-evm-hardhat-foundry-2.1.23.tgz were built and inspected. The generator tarball contains none of the three removed Solidity files. The GateTool tarball contains the compiled authority ABI and dependency compiler adapter.
+
+Installed the generator tarball in an isolated directory, generated a fresh project, installed the local GateTool tarball and ran npm ci with lifecycle scripts enabled. The retained OpenZeppelin patch applied successfully. Nine Hardhat tests, EVM compilation, zkSync compilation, and static validation of a normal task created from the example passed. The reserved _examples/counter-rollout path is not accepted as a static-validation deployment ID; copy the example to a normal task ID before validating it.
+
+GateFlow: 34 tests passed again, and frontend/server/CLI/Electron code builds passed after restoring dependencies from the existing Bun lockfile. The built CLI accepted the fresh generated project. Updated the bundled Universal workflow as well as ai-workflows so new tasks no longer require removed source files. This run did not produce a desktop installer or replace the installed application.
+
+ai-workflows: 89 tests passed, all 62 workflow YAML files parsed, initialization and migration skills validated. Acceptance scope is the new workflow only.
+
+Artifacts and release-removal-* logs are in /Users/vector/gate/local-packages/external-infrastructure; SHA256SUMS records both tarballs. The fresh project is release-removal-check/project under that directory. No publication, push or remote transaction broadcast was performed.

package/docs/network-runtime-acceptance.md

@@ -0,0 +1,18 @@
+# Network/RPC extraction — local acceptance
+
+The full-template Hardhat configuration now calls GateTool's compiled runtime-config exports. RPC parsing and zksyncSolcPath retain compatibility shims. Standard networks and fork validation live in networks.ts; project-provided Hardhat APIs register the solc adapter, without loading an HRE from inside config helpers.
+
+The Hardhat config went from 401 to 90 lines. Its Solidity and zkSolc sections were compared byte-for-byte and are unchanged. Overlay projects retain old compiler versions/settings/overrides and merge only helper integration. Per-network `overrides` shallow-merge named network fields; other networks keep their defaults. Manifest/plugin/env/account loading order stays in the project.
+
+Validation:
+
+- GateTool: 128 tests passed, including differential comparison of all 36 network entries against the original config under fallback, Base RPC and fork environments; overrides and compiler preservation; fork parameter rejection; project-owned compiler hook registration.
+- Template generator: build and all 372 tests passed, including legacy upgrade and packaged config preservation.
+- Generated isolated project: installed the local tarball, completed npm ci, passed 9 Hardhat tests and a two-custom-step no-broadcast workflow simulation. Installed runtime identity matches the build.
+- Migration utility: 72 baseline workflow/helper files replaced; repeated apply is a no-op; hardhat.config.ts remains byte-for-byte unchanged by the migration utility.
+- GateFlow: 32 readiness/context/integrity/RPC tests passed; the built CLI accepted the new installed runtime.
+- Migration skill: 9 policy tests and skill validation passed. The skill now describes helper-based network migration while preserving old compiler settings.
+
+The template generator's legacy upgrader also recognizes packaged network config/RPC shims and preserves them rather than injecting old inline logic. Historical upgrade coverage keeps an explicit old-config fixture. The template source tests read network/adapter implementation from the installed package, while separate installed-package integration verifies the real Hardhat boundary.
+
+Local artifact and logs: `/Users/vector/gate/local-packages/network-extraction/`. This is a new local build of `1.1.0-local.0` with a distinct runtime digest/tarball hash; the earlier workflow-extraction artifact is retained. Existing execution bindings must not be reused with this different build. No npm publication, commit/push, live SuperTask change or remote transaction broadcast.

package/docs/plans/2026-09-09-workflow-extraction.md

@@ -0,0 +1,16 @@
+# Packaged workflow extraction
+
+Scope: Move the full template workflow into GateTool, retaining existing project commands, data paths and business hooks. No npm publication or blockchain broadcast. Local tarball installation is the acceptance source. Existing proxy-check changes are preserved.
+
+- [x] Record template baseline and GateFlow callers.
+- [x] Package runtime implementations with explicit project runtime resolution and public type/module entrypoints.
+- [x] Preserve old script paths through thin compatibility shims; resolve internal child entrypoints from the installed package.
+- [x] Add runtime version compatibility guards for resumable executions without rewriting old state.
+- [x] Build and pack locally; install the tarball into an isolated full-template fixture.
+- [x] Run configuration, checks, execution/retry/custom-step and template/GateFlow compatibility tests without broadcasting.
+- [x] Provide a migration plan/apply tool that only replaces unchanged known template files, preserving custom files and running task records.
+- [x] Document supported upgrades, limitations, validation results, and rollback.
+
+Non-goals: npm publication, moving business contracts or data into node_modules, implementation vanity-policy changes, modifying live SuperTask execution state.
+
+Acceptance: `docs/workflow-runtime-acceptance.md`. Tests use packaged source fixtures plus a separately installed compiled-runtime project. No remote EVM or zkSync transaction was broadcast.