gate-evm-tools 1.0.26 → 1.0.27

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

@@ -0,0 +1,465 @@
+"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 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("Multicall3", 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":";;;;;;AAAA,mCAAmC;AACnC,yDAAuD;AACvD,gDAAwB;AAMxB,gDAI0B;AAC1B,oDAM4B;AAE5B,8CAA0D;AAC1D,sDAAuD;AACvD,4CAA0D;AAC1D,sCAAqE;AACrE,kDAA+D;AAC/D,4CAIwB;AACxB,wCAAsE;AAEtE,0CAAoE;AACpE,kDAAoE;AAEpE,MAAM,gBAAgB,GAAG,CACvB,OAAwB,EACxB,KAAc,EACL,EAAE,CAAC,IAAA,yBAAY,EAAC,KAAK,EAAE;IAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,YAAY;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;CACrB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CACpB,OAAwB,EACxB,KAAc,EACW,EAAE;IAC3B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACpF,OAAO,QAAmC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,OAAwB,EACxB,KAAc,EACd,KAAa,EACF,EAAE;IACb,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;IACnF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,MAA+B,EAC/B,GAAW,EACS,EAAE,CAAC,CACvB,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACjF,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,OAAwB,EACxB,IAAkB,EAMlB,EAAE;IACF,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC;WAC/C,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;WAChC,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC;WACpC,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;WAC5F,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,4CAA4C,CAAC,CAAC;IAE5F,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC;QAC5C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAA,+BAAiB,EAAC,IAAA,8BAAgB,EAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClG,IAAI,CAAC,IAAA,kBAAS,EAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,YAAY,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAmB,CAAC,OAAO,CAAC;IAClF,MAAM,aAAa,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC;QACvC,CAAC,CAAC,IAAA,gCAAkB,EAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC,CAAC,kBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAA,kCAAoB,EAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,kBAAkB,EAAE,GAAG,IAAI,IAAA,6BAAe,EAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9F,OAAO;QACL,YAAY;QACZ,MAAM;QACN,eAAe,EAAE,WAAW;QAC5B,KAAK,EAAE;YACL,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;mBACjC,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YACnE,WAAW,EAAE,WAAW,CAAC,WAAW,KAAK,KAAK;gBAC5C,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC;YAC3C,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;gBACjD,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC,CAAC,SAAS;YACb,eAAe,EAAE,WAAW,CAAC,eAAe,KAAK,SAAS;gBACxD,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,eAAe,EAAE,QAAQ,IAAI,CAAC,EAAE,wBAAwB,CAAC;SAChG;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,OAAwB,EACxB,IAAkB,EAC2B,EAAE;IAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClE,OAAO,EAAE;QACP,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,IAAI,CAAC,EAAE,YAAY,CAAC,EAAE;QACnF,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC9B,YAAuC,EACvC,OAA2C,EAClB,EAAE;IAC3B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACvF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,cAAc,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC/B,WAAqC,EACb,EAAE;IAC1B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;IAC1F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,WAAoC,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,EAAE,WAAW,CAAC,EAAE;IACtB,KAAK,EAAE,WAAW,CAAC,KAAK;IACxB,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,SAAS,EAAE,WAAW,CAAC,SAAS;IAChC,GAAG,CAAC,WAAW,CAAC,WAAW,KAAK,SAAS;QACvC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,EAAE,MAAM,EAAE,cAAuB,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC;CAC/E,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,KAAK,EAChC,KAAa,EACb,cAAsB,EACP,EAAE;IACjB,MAAM,CAAC,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/E,uBAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QAC9B,uBAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;QACvC,IAAA,kCAAwB,EAAC,uBAAM,CAAC,QAAQ,EAAE,KAAK,CAAC;KACjD,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mDAAmD,cAAc,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,IACE,CAAC,qBAAqB;WACnB,qBAAqB,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,WAAW,EAAE,EACvE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,cAAc,KAAK,8CAA8C,cAAc,EAAE,CAClF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,cAAc,GAAG,KAAK,EACjC,OAAwB,EACxB,IAAkB,EACH,EAAE;IACjB,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAA,4CAA+B,EAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAA,gCAAkB,EAAC,YAAY,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7C,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,EAAE,MAAM,IAAI,KAAK,CAAC;IAC9C,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,mCAAmC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,eAAe,EAAE,mBAAmB,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,CAAC,EAAE,0DAA0D,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,YAAY,CAClC,OAAO,EACP,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,EACzD,QAAQ,IAAI,CAAC,EAAE,kBAAkB,CAClC,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAA,gCAAwB,EACjD,OAAO,CAAC,WAAW,EACnB,YAAY,EACZ,KAAK,CAAC,YAAY,CACnB,CAAC;IACF,MAAM,OAAO,GAAiC;QAC5C,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,OAAO,EAAE,wBAAO,CAAC,IAAI;QACrB,MAAM,EAAE,OAAO,CAAC,QAAQ;QACxB,QAAQ,EAAE,YAAY;QACtB,eAAe;QACf,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,kBAAkB;QAClB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;IACF,MAAM,mBAAmB,GAAG,cAAI,CAAC,IAAI,CACnC,OAAO,CAAC,OAAO,EACf,SAAS,EACT,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,EACnB,WAAW,EACX,OAAO,CAAC,IAAI,CACb,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,IAAA,kCAAuB,EAAC;QAC7C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,IAAI,CAAC,EAAE;QACrB,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,IAAI,KAAK,UAAU;YACvC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW;YAC1C,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CACxD,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,uBAAuB,CACjE,CAAC;IACF,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC9F,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9F,MAAM,cAAc,GAAqB;QACvC,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,cAAc;QACd,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,qBAAqB,EAAE,cAAc,CAAC,OAAO;QAC7C,kBAAkB;QAClB,eAAe;QACf,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,QAAQ,EAAE;YACR,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,QAAQ,CAAC,IAA0C;SAC1D;KACF,CAAC;IACF,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;QACrC,IAAA,6CAAsC,EACpC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,wBAAwB,EAChC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,4CAA4C,CAAC,CAAC;IACvF,CAAC;IACD,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElC,MAAM,aAAa,GAAG,MAAM,uBAAM,CAAC,aAAa,CAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,EAChC,KAAK,CAAC,YAAY,EAClB,OAAO,CAAC,MAAM,CACf,CAAC;IACF,MAAM,gBAAgB,GAAG,MAAM,IAAA,2BAAe,EAC5C,aAAa,EACb,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,aAAa,CACtB,CAAC;IACF,IACE,OAAO,CAAC,IAAI,KAAK,UAAU;WACxB,CAAC,OAAO,CAAC,0BAA0B;WACnC,CAAC,OAAO,CAAC,gBAAgB,EAC5B,CAAC;QACD,IAAA,oDAAwC,EAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,uBAAuB,GAAG,kBAAkB;QAChD,CAAC,CAAC,IAAA,+CAAqC,EACnC,eAAe,CAAC,mBAAmB,EACnC,CAAC;gBACC,MAAM,EAAE,kBAAkB,CAAC,EAAE;gBAC7B,KAAK,EAAE,kBAAkB,CAAC,KAAK;gBAC/B,IAAI,EAAE,kBAAkB,CAAC,IAAI;gBAC7B,GAAG,CAAC,kBAAkB,CAAC,WAAW,KAAK,SAAS;oBAC9C,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE,CAAC;aACrD,CAAC,EACF,MAAM,CACP;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,SAAS,GAAG,uBAAuB;QACvC,CAAC,CAAC,MAAM,uBAAM,CAAC,aAAa,CACxB,YAAY,EACZ,eAAe,CAAC,mBAAmB,EACnC,OAAO,CAAC,MAAM,CACf;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,uBAAuB,GAAG,SAAS;QACvC,CAAC,CAAC,MAAM,IAAA,8CAAkC,EACtC,SAIC,EACD,aAAa,CAAC,OAAO,EACrB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,aAAa,CACtB;QACH,CAAC,CAAC,SAAS,CAAC;IACd,IACE,MAAM,KAAK,cAAc;WACtB,CACD,gBAAgB,CAAC,IAAI,KAAK,SAAS;eAChC,uBAAuB,EAAE,IAAI,KAAK,UAAU,CAChD,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,CAAC,EAAE,uDAAuD,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,MAAM,0BAA0B,GAAG,OAAO,CAAC,IAAI,KAAK,UAAU;eACzD,OAAO,CAAC,0BAA0B,KAAK,IAAI,CAAC;QACjD,IACE,CAAC,0BAA0B;eACxB,CACD,gBAAgB,CAAC,IAAI,KAAK,SAAS;mBAChC,uBAAuB,EAAE,IAAI,KAAK,UAAU,CAChD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,mDAAmD,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,oBAAwC,CAAC;QAC7C,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,MAAM,IAAA,oDAA0C,EACzD,uBAAuB,EACvB,OAAO,CAAC,MAAM,CACf,CAAC;YACF,oBAAoB,GAAG,EAAE,CAAC,IAAI,CAAC;QACjC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,IAAA,yCAA+B,EACrD,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,OAAO,CAAC,MAAM,CACf,CAAC;QACF,MAAM,oBAAoB,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS;YAC7C,CAAC,CAAC,MAAM,IAAA,+BAAgB,EAAC;gBACrB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,mBAAmB;gBAChC,YAAY,EAAE,IAAI,CAAC,EAAE;gBACrB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;gBAC5B,OAAO,EAAE,wBAAO,CAAC,IAAI;gBACrB,MAAM,EAAE,OAAO,CAAC,QAAQ;gBACxB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW;gBACpD,KAAK,EAAE,KAAK,CAAC,YAAY;gBACzB,cAAc,EAAE,cAAc,CAAC,OAAO;gBACtC,QAAQ,EAAE,cAAc;gBACxB,eAAe;gBACf,eAAe,EAAE,SAAS,CAAC,IAAI;aAChC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,QAAQ,EAAE,KAAK,CAAC;gBACd,GAAG,cAAc;gBACjB,oBAAoB;gBACpB,MAAM,EAAE,SAAS,CAAC,IAAI;gBACtB,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,SAAS,EAAE;YAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,qBAAqB,EAAE,cAAc,CAAC,OAAO;YAC7C,kBAAkB;YAClB,oBAAoB;YACpB,MAAM,EAAE,SAAS,CAAC,IAAI;YACtB,YAAY;YACZ,YAAY,EAAE,YAAY,EAAE,UAAU;SACvC,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,SAAS;YACf,MAAM;YACN,QAAQ,EAAE,YAAY;YACtB,cAAc;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,qBAAqB,EAAE,cAAc,CAAC,OAAO;YAC7C,oBAAoB;YACpB,MAAM,EAAE,SAAS,CAAC,IAAI;YACtB,YAAY;SACb,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,2BAA+C,CAAC;IACpD,IAAI,oBAAwC,CAAC;IAC7C,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,IAAI,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;QACvD,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,IAAI,KAAK,SAAS;YACvE,CAAC,CAAC,OAAO,CAAC,aAAa;YACvB,CAAC,CAAC,uBAAuB,CAAC,QAAQ,CAAC;QACrC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,yCAAyC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,iBAAiB;YACnC,QAAQ,EAAE,sBAAsB;YAChC,EAAE,EAAE,uBAAuB,CAAC,MAAM;YAClC,KAAK,EAAE,uBAAuB,CAAC,KAAK;YACpC,IAAI,EAAE,uBAAuB,CAAC,IAAI;YAClC,SAAS,EAAE,CAAC;YACZ,GAAG,CAAC,uBAAuB,CAAC,MAAM,KAAK,SAAS;gBAC9C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,MAAM,EAAE,CAAC;YAC/C,GAAG,CAAC,uBAAuB,CAAC,WAAW,KAAK,SAAS;gBACnD,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,uBAAuB,CAAC,WAAW,EAAE,CAAC;SAC1D,CAAC,CAAC;QACH,2BAA2B,GAAG,OAAO,CAAC,aAAa,CAAC;QACpD,sBAAsB,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC;QACtD,IAAI,OAAO,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YACzC,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;QACjD,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;gBACzB,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,uBAAuB,CAAC,MAAM;gBACtC,IAAI,EAAE,uBAAuB,CAAC,KAAK;gBACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,uBAAuB,CAAC,MAAM;aACvC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU;gBACjD,CAAC,CAAC,MAAM,IAAA,4CAAmC,EAAC,OAAO,CAAC,QAAQ,CAAC;gBAC7D,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,GAAG,MAAM,IAAA,oDAA0C,EACzD,uBAAuB,EACvB,cAAc,CACf,CAAC;YACF,oBAAoB,GAAG,EAAE,CAAC,IAAI,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC/D,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;oBACpC,eAAe,EAAE,EAAE,CAAC,IAAI;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,KAAK,SAAS;QACzD,CAAC,CAAC,OAAO,CAAC,aAAa;QACvB,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAC9B,IAAI,CAAC,eAAe;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,EAAE,gCAAgC,CAAC,CAAC;IAC/F,MAAM,eAAe,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC;QACtD,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,QAAQ,EAAE,eAAe;QACzB,EAAE,EAAE,eAAe,CAAC,MAAM;QAC1B,KAAK,EAAE,eAAe,CAAC,KAAK;QAC5B,IAAI,EAAE,eAAe,CAAC,IAAI;QAC1B,SAAS,EAAE,CAAC;QACZ,GAAG,CAAC,eAAe,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC;QACnF,GAAG,CAAC,eAAe,CAAC,WAAW,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC;KAClD,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,QAAQ,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,aAAiC,CAAC;IACtC,IAAI,kBAAkB,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACpD,aAAa,GAAG,kBAAkB,CAAC,eAAe,CAAC;IACrD,CAAC;SAAM,IAAI,kBAAkB,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAClF,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;YACzB,aAAa,EAAE,kBAAkB,CAAC,aAAa;YAC/C,MAAM,EAAE,kBAAkB,CAAC,MAAM;YACjC,EAAE,EAAE,kBAAkB,CAAC,EAAE;YACzB,KAAK,EAAE,kBAAkB,CAAC,KAAK;YAC/B,IAAI,EAAE,kBAAkB,CAAC,IAAI;YAC7B,SAAS,EAAE,kBAAkB,CAAC,SAAS;YACvC,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC;YAC9B,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;YACrC,MAAM,EAAE,gBAAgB,CAAC,MAAM;SAChC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,KAAK,UAAU;YAC5D,CAAC,CAAC,MAAM,IAAA,4CAAmC,EAAC,kBAAkB,CAAC,QAAQ,CAAC;YACxE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,IAAA,yCAA+B,EAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QAClF,aAAa,GAAG,EAAE,CAAC,IAAI,CAAC;QACxB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,kBAAkB,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC1E,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBAC5B,aAAa,EAAE,kBAAkB,CAAC,aAAa;gBAC/C,eAAe,EAAE,EAAE,CAAC,IAAI;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IACE,OAAO,CAAC,IAAI,KAAK,SAAS;WACvB,CAAC,sBAAsB;WACvB,kBAAkB,CAAC,KAAK,KAAK,UAAU,EAC1C,CAAC;QACD,MAAM,oBAAoB,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAgB,EAAC;YAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,mBAAmB;YAChC,YAAY,EAAE,IAAI,CAAC,EAAE;YACrB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;YAC5B,OAAO,EAAE,wBAAO,CAAC,IAAI;YACrB,MAAM,EAAE,OAAO,CAAC,QAAQ;YACxB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW;YACpD,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,cAAc,EAAE,cAAc,CAAC,OAAO;YACtC,QAAQ,EAAE,cAAc;YACxB,eAAe;YACf,eAAe,EAAE,aAAa,IAAI,EAAE;SACrC,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC;YACd,GAAG,cAAc;YACjB,oBAAoB;YACpB,MAAM,EAAE,aAAa;YACrB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACvC,MAAM,oBAAoB,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,SAAS,EAAE;QAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,qBAAqB,EAAE,cAAc,CAAC,OAAO;QAC7C,kBAAkB;QAClB,oBAAoB;QACpB,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,sBAAsB,IAAI,kBAAkB,CAAC,KAAK,KAAK,UAAU;QAC3E,YAAY;KACb,CAAC,CAAC;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,kBAAkB,CAAC,KAAK;QAC9B,MAAM;QACN,2BAA2B;QAC3B,oBAAoB,EAAE,kBAAkB,CAAC,aAAa;QACtD,QAAQ,EAAE,YAAY;QACtB,cAAc;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,qBAAqB,EAAE,cAAc,CAAC,OAAO;QAC7C,oBAAoB;QACpB,MAAM,EAAE,aAAa;QACrB,YAAY;KACb,CAAC,CAAC;AACL,CAAC,CAAC;AAzZW,QAAA,cAAc,kBAyZzB"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gate-evm-tools",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "description": "Gate 智能合约工具集 - 字节码检查、合约升级验证、合约状态同步",
   "type": "module",
   "exports": {
@@ -23,7 +23,16 @@
       "types": "./dist/sync/index.d.ts",
       "import": "./dist/sync/index.js",
       "require": "./dist-cjs/sync/index.js"
-    }
+    },
+    "./runtime/*": {
+      "types": "./dist-runtime/workflow/*.d.ts",
+      "default": "./dist-runtime/workflow/*.js"
+    },
+    "./runtime-config/*": {
+      "types": "./dist-runtime/config/*.d.ts",
+      "default": "./dist-runtime/config/*.js"
+    },
+    "./runtime-source/*": "./runtime/*.ts"
   },
   "typesVersions": {
     "*": {
@@ -38,21 +47,30 @@
       ],
       "sync": [
         "dist/sync/index.d.ts"
+      ],
+      "runtime/*": [
+        "dist-runtime/workflow/*.d.ts"
+      ],
+      "runtime-config/*": [
+        "dist-runtime/config/*.d.ts"
       ]
     }
   },
   "bin": {
-    "gate-tool": "./bin/cli.js"
+    "gate-tool": "./bin/cli.js",
+    "gate-workflow": "./bin/workflow.cjs"
   },
   "files": [
     "bin/",
     "dist/",
     "dist-cjs/",
     "README.md",
-    "contractInfo.example.json"
+    "contractInfo.example.json",
+    "dist-runtime/",
+    "runtime/"
   ],
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.custody-cjs.json && node scripts/write-cjs-package.mjs",
+    "build": "tsc && tsc -p tsconfig.custody-cjs.json && node scripts/write-cjs-package.mjs && tsc -p tsconfig.runtime.json && node scripts/write-runtime-package.mjs",
     "dev": "tsc --watch",
     "start": "node bin/cli.js",
     "pretest": "npm run build",
@@ -79,6 +97,7 @@
     "fs-extra": "^11.2.0",
     "ora": "^7.0.1",
     "prompts": "^2.4.2",
+    "semver": "^7.8.5",
     "yaml": "2.8.1",
     "zksync-ethers": "6.15.0"
   },
@@ -93,6 +112,7 @@
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.7.2",
     "@types/prompts": "^2.4.9",
+    "@types/semver": "^7.8.0",
     "ethers": "^6.15.0",
     "ethers5": "npm:ethers@5.7.2",
     "hardhat": "2.27.1",

package/runtime/config/hardhatAdapters.ts

@@ -0,0 +1,50 @@
+import type { HardhatUserConfig } from "hardhat/types";
+import { withZkSyncSolcOnPath } from "./zksyncSolcPath";
+
+export function registerZkSyncSolcAdapter(subtask: typeof import("hardhat/config").subtask, taskName: string): void {
+  subtask(taskName).setAction(async (args, hre, runSuper) => {
+    if ((hre.network as { zksync?: boolean }).zksync !== true) return runSuper(args);
+    const solcPath = (args as { solcPath?: unknown }).solcPath;
+    if (typeof solcPath !== "string" || !solcPath.trim()) {
+      throw new Error("zkSync compilation requires Hardhat to provide solcPath");
+    }
+    return withZkSyncSolcOnPath(solcPath, () => runSuper(args));
+  });
+}
+
+export function requestedHardhatNetwork(argv: string[], env: NodeJS.ProcessEnv = process.env): string | undefined {
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+    if (argument === "--network") {
+      const value = argv[index + 1]?.trim();
+      if (!value || value.startsWith("-")) {
+        throw new Error("--network requires a network name");
+      }
+      return value;
+    }
+    if (argument.startsWith("--network=")) {
+      const value = argument.slice("--network=".length).trim();
+      if (!value) throw new Error("--network requires a network name");
+      return value;
+    }
+  }
+  return env.HARDHAT_NETWORK?.trim() || undefined;
+}
+
+
+/** Returns a config with scheme-specific output paths, preserving compiler settings. */
+export function withTemplateArtifactPaths(config: HardhatUserConfig, argv: string[] = process.argv, env: NodeJS.ProcessEnv = process.env): HardhatUserConfig {
+  const selectedHardhatNetwork = requestedHardhatNetwork(argv, env);
+  const selectedNetworkConfig = selectedHardhatNetwork
+    ? config.networks?.[selectedHardhatNetwork] as ({ zksync?: boolean } | undefined)
+    : undefined;
+  const useZkSyncArtifacts = selectedNetworkConfig?.zksync === true;
+  return {
+    ...config,
+    paths: {
+      ...config.paths,
+      cache: useZkSyncArtifacts ? "./cache-zk" : "./cache",
+      artifacts: useZkSyncArtifacts ? "./artifacts-zk" : "./artifacts",
+    },
+  };
+}