gate-evm-tools 1.0.26 → 1.0.28

package/dist-runtime/workflow/lib/deployments.js

@@ -0,0 +1,240 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeploymentAddress = exports.findDeploymentAddress = exports.resolveDeployment = exports.planDeploymentAddress = exports.saveContractInfo = exports.loadContractInfo = exports.contractInfoKey = exports.deploymentInstanceId = exports.actualContractName = exports.cloneContractInfo = exports.validateContractInfo = exports.withContractInfoLock = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ethers_1 = require("ethers");
+const config_1 = require("./config");
+const contractInfoPath = (root) => {
+    return path_1.default.join(root, "contractInfo.json");
+};
+const sleepSync = (milliseconds) => {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
+};
+const errorCode = (error) => {
+    return error && typeof error === "object" && "code" in error
+        ? String(error.code)
+        : undefined;
+};
+const lockOwnerIsAlive = (lockPath) => {
+    let ownerPid;
+    try {
+        ownerPid = Number.parseInt(fs_1.default.readFileSync(lockPath, "utf8").split("-", 1)[0], 10);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return false;
+        return undefined;
+    }
+    if (!Number.isSafeInteger(ownerPid) || ownerPid <= 0)
+        return undefined;
+    try {
+        process.kill(ownerPid, 0);
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === "ESRCH")
+            return false;
+        return true;
+    }
+};
+const withContractInfoLock = (root, operation) => {
+    const filePath = contractInfoPath(root);
+    const lockPath = `${filePath}.lock`;
+    const token = `${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    const startedAt = Date.now();
+    const timeoutMs = 10_000;
+    const staleMs = 30_000;
+    let lockFile;
+    fs_1.default.mkdirSync(path_1.default.dirname(lockPath), { recursive: true });
+    while (lockFile === undefined) {
+        try {
+            const candidate = fs_1.default.openSync(lockPath, "wx");
+            try {
+                fs_1.default.writeFileSync(candidate, `${token}\n`);
+                lockFile = candidate;
+            }
+            catch (error) {
+                fs_1.default.closeSync(candidate);
+                fs_1.default.unlinkSync(lockPath);
+                throw error;
+            }
+        }
+        catch (error) {
+            if (errorCode(error) !== "EEXIST")
+                throw error;
+            try {
+                const ownerAlive = lockOwnerIsAlive(lockPath);
+                const lockAgeMs = Date.now() - fs_1.default.statSync(lockPath).mtimeMs;
+                if (ownerAlive === false ||
+                    (ownerAlive === undefined && lockAgeMs > staleMs)) {
+                    fs_1.default.unlinkSync(lockPath);
+                    continue;
+                }
+            }
+            catch (statError) {
+                if (errorCode(statError) === "ENOENT")
+                    continue;
+                throw statError;
+            }
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new Error(`Timed out waiting for contractInfo lock: ${lockPath}`);
+            }
+            sleepSync(25);
+        }
+    }
+    let operationFailed = false;
+    try {
+        return operation();
+    }
+    catch (error) {
+        operationFailed = true;
+        throw error;
+    }
+    finally {
+        try {
+            fs_1.default.closeSync(lockFile);
+            if (fs_1.default.readFileSync(lockPath, "utf8").trim() === token) {
+                fs_1.default.unlinkSync(lockPath);
+            }
+        }
+        catch (error) {
+            if (!operationFailed && errorCode(error) !== "ENOENT")
+                throw error;
+        }
+    }
+};
+exports.withContractInfoLock = withContractInfoLock;
+const isRecord = (value) => {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+};
+const validateContractInfo = (value) => {
+    if (!isRecord(value)) {
+        throw new Error("contractInfo.json must contain an object keyed by network");
+    }
+    const contractInfo = {};
+    for (const [targetId, targetValue] of Object.entries(value)) {
+        if (!isRecord(targetValue)) {
+            throw new Error(`contractInfo.json network ${targetId} must contain an object`);
+        }
+        const entries = {};
+        const instanceIds = new Set();
+        for (const [name, address] of Object.entries(targetValue)) {
+            const keyParts = name.split(":");
+            if (keyParts.length > 2 ||
+                keyParts.some((part) => !part.trim() || part !== part.trim())) {
+                throw new Error(`contractInfo.json key ${targetId}.${name} must use Contract or saveAs:Contract format`);
+            }
+            const instanceId = keyParts[0];
+            if (instanceIds.has(instanceId)) {
+                throw new Error(`contractInfo.json network ${targetId} defines deployment instance ${instanceId} more than once`);
+            }
+            instanceIds.add(instanceId);
+            if (typeof address !== "string" || !(0, ethers_1.isAddress)(address)) {
+                throw new Error(`contractInfo.json entry ${targetId}.${name} must be an address string with a valid EVM address`);
+            }
+            entries[name] = address;
+        }
+        contractInfo[targetId] = entries;
+    }
+    return contractInfo;
+};
+exports.validateContractInfo = validateContractInfo;
+const cloneContractInfo = (contractInfo) => {
+    return Object.fromEntries(Object.entries(contractInfo).map(([targetId, entries]) => [
+        targetId,
+        { ...entries },
+    ]));
+};
+exports.cloneContractInfo = cloneContractInfo;
+const actualContractName = (contractName) => {
+    const trimmed = contractName.trim();
+    if (!trimmed) {
+        throw new Error("Actual contract name must not be empty");
+    }
+    const separator = trimmed.lastIndexOf(":");
+    const actual = separator >= 0 ? trimmed.slice(separator + 1).trim() : trimmed;
+    if (!actual) {
+        throw new Error(`Invalid fully qualified contract name: ${contractName}`);
+    }
+    return actual;
+};
+exports.actualContractName = actualContractName;
+const deploymentInstanceId = (instanceId) => {
+    const normalizedInstanceId = instanceId.trim();
+    if (!normalizedInstanceId) {
+        throw new Error("Deployment saveAs must not be empty");
+    }
+    if (normalizedInstanceId.includes(":")) {
+        throw new Error(`Deployment saveAs "${normalizedInstanceId}" must not contain ":"`);
+    }
+    return normalizedInstanceId;
+};
+exports.deploymentInstanceId = deploymentInstanceId;
+const contractInfoKey = (instanceId, contractName) => {
+    const normalizedInstanceId = (0, exports.deploymentInstanceId)(instanceId);
+    const actual = (0, exports.actualContractName)(contractName);
+    return normalizedInstanceId === actual
+        ? actual
+        : `${normalizedInstanceId}:${actual}`;
+};
+exports.contractInfoKey = contractInfoKey;
+const loadContractInfo = (root, _config) => {
+    const filePath = contractInfoPath(root);
+    if (!fs_1.default.existsSync(filePath))
+        return {};
+    return (0, exports.validateContractInfo)((0, config_1.readJsonFile)(filePath));
+};
+exports.loadContractInfo = loadContractInfo;
+const saveContractInfo = (root, contractInfo) => {
+    (0, config_1.writeJsonFile)(contractInfoPath(root), (0, exports.validateContractInfo)(contractInfo));
+};
+exports.saveContractInfo = saveContractInfo;
+const planDeploymentAddress = (contractInfo, targetId, instanceId, contractName, address) => {
+    const key = (0, exports.contractInfoKey)(instanceId, contractName);
+    const normalizedInstanceId = (0, exports.deploymentInstanceId)(instanceId);
+    const planned = (0, exports.cloneContractInfo)(contractInfo);
+    const targetEntries = { ...(planned[targetId] || {}) };
+    for (const existingKey of Object.keys(targetEntries)) {
+        if (existingKey === normalizedInstanceId ||
+            existingKey.startsWith(`${normalizedInstanceId}:`)) {
+            delete targetEntries[existingKey];
+        }
+    }
+    targetEntries[key] = address;
+    planned[targetId] = targetEntries;
+    return { key, contractInfo: planned };
+};
+exports.planDeploymentAddress = planDeploymentAddress;
+const resolveDeployment = (contractInfo, targetId, name) => {
+    const entries = contractInfo[targetId] || {};
+    const exactAddress = entries[name];
+    if (exactAddress) {
+        return { key: name, address: exactAddress };
+    }
+    const aliases = Object.entries(entries).filter(([key]) => key.startsWith(`${name}:`));
+    if (aliases.length > 1) {
+        throw new Error(`Ambiguous contractInfo deployment ${targetId}.${name}; matches ${aliases.map(([key]) => key).join(", ")}`);
+    }
+    if (aliases.length === 1) {
+        return { key: aliases[0][0], address: aliases[0][1] };
+    }
+    return undefined;
+};
+exports.resolveDeployment = resolveDeployment;
+const findDeploymentAddress = (root, config, targetId, name) => {
+    return (0, exports.resolveDeployment)((0, exports.loadContractInfo)(root, config), targetId, name)?.address;
+};
+exports.findDeploymentAddress = findDeploymentAddress;
+const getDeploymentAddress = (root, config, targetId, name) => {
+    const deployment = (0, exports.resolveDeployment)((0, exports.loadContractInfo)(root, config), targetId, name);
+    if (!deployment) {
+        throw new Error(`Missing contractInfo address: ${targetId}.${name}`);
+    }
+    return deployment.address;
+};
+exports.getDeploymentAddress = getDeploymentAddress;
+//# sourceMappingURL=deployments.js.map

package/dist-runtime/workflow/lib/deployments.js.map

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

package/dist-runtime/workflow/lib/erc1967.d.ts

@@ -0,0 +1,5 @@
+import type { Provider } from "ethers";
+export declare const ERC1967_IMPLEMENTATION_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_ADMIN_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const getERC1967Implementation: (provider: Pick<Provider, "getStorage">, proxyAddress: string, blockTag?: number) => Promise<string | undefined>;
+export declare const getERC1967Admin: (provider: Pick<Provider, "getStorage">, proxyAddress: string, blockTag?: number) => Promise<string | undefined>;

package/dist-runtime/workflow/lib/erc1967.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getERC1967Admin = exports.getERC1967Implementation = exports.ERC1967_ADMIN_SLOT = exports.ERC1967_IMPLEMENTATION_SLOT = void 0;
+const ethers_1 = require("ethers");
+exports.ERC1967_IMPLEMENTATION_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+exports.ERC1967_ADMIN_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+const getERC1967Address = async (provider, proxyAddress, slot, label, blockTag) => {
+    if (!(0, ethers_1.isAddress)(proxyAddress)) {
+        throw new Error("Invalid proxy candidate address: " + proxyAddress);
+    }
+    const storage = await provider.getStorage(proxyAddress, slot, blockTag);
+    if (!/^0x[0-9a-fA-F]{64}$/.test(storage)) {
+        throw new Error(`Invalid ERC1967 ${label} slot value for ${proxyAddress}`);
+    }
+    const storedAddress = "0x" + storage.slice(-40);
+    if (storedAddress.toLowerCase() === "0x" + "00".repeat(20)) {
+        return undefined;
+    }
+    return (0, ethers_1.getAddress)(storedAddress);
+};
+const getERC1967Implementation = async (provider, proxyAddress, blockTag) => {
+    return getERC1967Address(provider, proxyAddress, exports.ERC1967_IMPLEMENTATION_SLOT, "implementation", blockTag);
+};
+exports.getERC1967Implementation = getERC1967Implementation;
+const getERC1967Admin = async (provider, proxyAddress, blockTag) => {
+    return getERC1967Address(provider, proxyAddress, exports.ERC1967_ADMIN_SLOT, "admin", blockTag);
+};
+exports.getERC1967Admin = getERC1967Admin;
+//# sourceMappingURL=erc1967.js.map

package/dist-runtime/workflow/lib/erc1967.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc1967.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/erc1967.ts"],"names":[],"mappings":";;;AACA,mCAA+C;AAElC,QAAA,2BAA2B,GACtC,oEAAoE,CAAC;AAE1D,QAAA,kBAAkB,GAC7B,oEAAoE,CAAC;AAEvE,MAAM,iBAAiB,GAAG,KAAK,EAC7B,QAAsC,EACtC,YAAoB,EACpB,IAAY,EACZ,KAAa,EACb,QAAiB,EACY,EAAE;IAC/B,IAAI,CAAC,IAAA,kBAAS,EAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,YAAY,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,mBAAmB,YAAY,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAA,mBAAU,EAAC,aAAa,CAAC,CAAC;AACnC,CAAC,CAAC;AAEK,MAAM,wBAAwB,GAAG,KAAK,EAC3C,QAAsC,EACtC,YAAoB,EACpB,QAAiB,EACY,EAAE;IAC/B,OAAO,iBAAiB,CACtB,QAAQ,EACR,YAAY,EACZ,mCAA2B,EAC3B,gBAAgB,EAChB,QAAQ,CACT,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,wBAAwB,4BAYnC;AAEK,MAAM,eAAe,GAAG,KAAK,EAClC,QAAsC,EACtC,YAAoB,EACpB,QAAiB,EACY,EAAE;IAC/B,OAAO,iBAAiB,CACtB,QAAQ,EACR,YAAY,EACZ,0BAAkB,EAClB,OAAO,EACP,QAAQ,CACT,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,eAAe,mBAY1B"}

package/dist-runtime/workflow/lib/errors.d.ts

@@ -0,0 +1,6 @@
+export type WorkflowErrorType = "transient" | "check_failed" | "parameter_error" | "config_error" | "contract_error" | "execution_reverted" | "unknown";
+export interface WorkflowErrorClassification {
+    errorType: WorkflowErrorType;
+    retryable: boolean;
+}
+export declare const classifyWorkflowError: (error: unknown) => WorkflowErrorClassification;

package/dist-runtime/workflow/lib/errors.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyWorkflowError = void 0;
+const messageOf = (error) => {
+    return error instanceof Error ? error.message : String(error);
+};
+const matchesAny = (message, patterns) => {
+    return patterns.some((pattern) => pattern.test(message));
+};
+const classifyWorkflowError = (error) => {
+    const message = messageOf(error);
+    if (matchesAny(message, [
+        /timeout/i,
+        /timed out/i,
+        /rate limit/i,
+        /too many requests/i,
+        /\b429\b/,
+        /\b503\b/,
+        /ECONNRESET/i,
+        /ETIMEDOUT/i,
+        /EAI_AGAIN/i,
+        /header not found/i,
+        /missing trie node/i,
+        /could not detect network/i,
+        /network error/i,
+        /connection/i,
+    ])) {
+        return { errorType: "transient", retryable: true };
+    }
+    if (matchesAny(message, [
+        /Check failed/i,
+    ])) {
+        return { errorType: "check_failed", retryable: false };
+    }
+    if (matchesAny(message, [
+        /Missing parameters/i,
+        /Reference not found/i,
+        /must resolve to an array/i,
+        /Invalid admin address/i,
+        /requires saveAs/i,
+        /Duplicate deploy saveAs/i,
+    ])) {
+        return { errorType: "parameter_error", retryable: false };
+    }
+    if (matchesAny(message, [
+        /Missing config\.yaml/i,
+        /Missing hardhat\.config\.ts network/i,
+        /cannot be forked/i,
+        /no factory address/i,
+        /no salt/i,
+        /simulation callers?/i,
+        /releaseTargetNetworks/i,
+        /release-target simulation/i,
+    ])) {
+        return { errorType: "config_error", retryable: false };
+    }
+    if (matchesAny(message, [
+        /Contract does not expose method/i,
+        /missing upgradeToAndCall/i,
+        /missing newImplementation/i,
+        /Unsupported step kind/i,
+    ])) {
+        return { errorType: "contract_error", retryable: false };
+    }
+    if (matchesAny(message, [
+        /revert/i,
+        /reverted/i,
+        /CALL_EXCEPTION/i,
+        /transaction failed/i,
+        /gate-tool validate failed/i,
+    ])) {
+        return { errorType: "execution_reverted", retryable: false };
+    }
+    return { errorType: "unknown", retryable: false };
+};
+exports.classifyWorkflowError = classifyWorkflowError;
+//# sourceMappingURL=errors.js.map

package/dist-runtime/workflow/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/errors.ts"],"names":[],"mappings":";;;AAcA,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE;IAC3C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,QAAkB,EAAW,EAAE;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEK,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAA+B,EAAE;IACnF,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,UAAU;QACV,YAAY;QACZ,aAAa;QACb,oBAAoB;QACpB,SAAS;QACT,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,mBAAmB;QACnB,oBAAoB;QACpB,2BAA2B;QAC3B,gBAAgB;QAChB,aAAa;KACd,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,eAAe;KAChB,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,qBAAqB;QACrB,sBAAsB;QACtB,2BAA2B;QAC3B,wBAAwB;QACxB,kBAAkB;QAClB,0BAA0B;KAC3B,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,uBAAuB;QACvB,sCAAsC;QACtC,mBAAmB;QACnB,qBAAqB;QACrB,UAAU;QACV,sBAAsB;QACtB,wBAAwB;QACxB,4BAA4B;KAC7B,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,kCAAkC;QAClC,2BAA2B;QAC3B,4BAA4B;QAC5B,wBAAwB;KACzB,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,SAAS;QACT,WAAW;QACX,iBAAiB;QACjB,qBAAqB;QACrB,4BAA4B;KAC7B,CAAC,EAAE,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC,CAAC;AAxEW,QAAA,qBAAqB,yBAwEhC"}

package/dist-runtime/workflow/lib/executionId.d.ts

@@ -0,0 +1,7 @@
+interface BuildExecutionIdOptions {
+    now?: Date;
+    random?: number;
+}
+export declare const validateExecutionId: (value: unknown, label?: string) => string;
+export declare const buildExecutionId: (targetId: string, options?: BuildExecutionIdOptions) => string;
+export {};

package/dist-runtime/workflow/lib/executionId.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExecutionId = exports.validateExecutionId = void 0;
+const EXECUTION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/;
+const MAX_EXECUTION_ID_LENGTH = 200;
+const validateExecutionId = (value, label = "executionId") => {
+    if (typeof value !== "string" || !EXECUTION_ID_PATTERN.test(value)) {
+        throw new Error(`${label} must match the canonical execution ID rule: `
+            + "1-200 letters, numbers, underscores, or hyphens, beginning with a letter or number");
+    }
+    return value;
+};
+exports.validateExecutionId = validateExecutionId;
+const buildExecutionId = (targetId, options = {}) => {
+    const timestamp = (options.now || new Date()).toISOString().replace(/\D/g, "");
+    const random = options.random ?? Math.random();
+    const nonce = random.toString(36).slice(2).padEnd(8, "0").slice(0, 8);
+    const prefix = `exec-${timestamp}-${nonce}`;
+    const targetBudget = MAX_EXECUTION_ID_LENGTH - prefix.length - 1;
+    const targetSlug = targetId
+        .replace(/[^A-Za-z0-9_-]/g, "-")
+        .slice(0, targetBudget);
+    return (0, exports.validateExecutionId)(`${prefix}-${targetSlug}`);
+};
+exports.buildExecutionId = buildExecutionId;
+//# sourceMappingURL=executionId.js.map

package/dist-runtime/workflow/lib/executionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionId.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/executionId.ts"],"names":[],"mappings":";;;AAAA,MAAM,oBAAoB,GAAG,mCAAmC,CAAC;AACjE,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAO7B,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACd,KAAK,GAAG,aAAa,EACb,EAAE;IACV,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,+CAA+C;cACrD,oFAAoF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAXW,QAAA,mBAAmB,uBAW9B;AAEK,MAAM,gBAAgB,GAAG,CAC9B,QAAgB,EAChB,UAAmC,EAAE,EAC7B,EAAE;IACV,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,QAAQ,SAAS,IAAI,KAAK,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,QAAQ;SACxB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAC1B,OAAO,IAAA,2BAAmB,EAAC,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC;AAbW,QAAA,gBAAgB,oBAa3B"}

package/dist-runtime/workflow/lib/executionPlan.d.ts

@@ -0,0 +1,85 @@
+export type ReleaseKind = "development" | "admin_release";
+export type ExecutionRoute = "operator" | "external";
+export interface ReleaseExecutionTransaction {
+    transactionId: string;
+    stepId: string;
+    transactionIndex: number;
+    route: ExecutionRoute;
+    executor: string;
+    to: string;
+    value: string;
+    data: string;
+    operation: 0 | 1;
+    scheme?: "zksync-eravm";
+    factoryDeps?: string[];
+}
+export interface ReleaseExecutionPlan {
+    version: 1;
+    taskId: string;
+    target: string;
+    executionId: string;
+    releaseKind: ReleaseKind;
+    operator: string;
+    transactions: ReleaseExecutionTransaction[];
+    planHash: string;
+    createdAt: string;
+}
+type PlanBody = Omit<ReleaseExecutionPlan, "planHash" | "createdAt">;
+export interface ReleaseExecutionTransactionInput {
+    stepId: string;
+    executor: string;
+    to: string;
+    value: string;
+    data: string;
+    operation: 0 | 1;
+    scheme?: "zksync-eravm";
+    factoryDeps?: string[];
+}
+export interface CompletedExecutionTransaction {
+    transactionId: string;
+    transactionHash: string;
+}
+export interface PlannedExecutionTransaction extends ReleaseExecutionTransaction {
+    executionAction: "execute" | "package" | "replay";
+    transactionHash?: string;
+}
+export declare class ExecutionSegmentDeferred extends Error {
+    readonly transactionId: string;
+    constructor(transactionId: string);
+}
+export declare class ReleaseExecutionPlanner {
+    private readonly body;
+    private readonly expected?;
+    private readonly transactions;
+    private readonly segmentedExecution;
+    private readonly completedTransactions;
+    private readonly segmentEnd;
+    constructor(input: {
+        taskId: string;
+        target: string;
+        executionId: string;
+        releaseKind: ReleaseKind;
+        operator: string;
+        expectedPlan?: ReleaseExecutionPlan;
+        segmentedExecution?: boolean;
+        completedTransactions?: CompletedExecutionTransaction[];
+    });
+    add(input: ReleaseExecutionTransactionInput): PlannedExecutionTransaction;
+    complete(options?: {
+        allowPartial?: boolean;
+    }): PlanBody;
+}
+export declare const writeReleaseExecutionPlan: (input: {
+    root: string;
+    taskDir: string;
+    plan: PlanBody;
+}) => ReleaseExecutionPlan;
+export declare const loadReleaseExecutionPlan: (input: {
+    root: string;
+    taskDir: string;
+    target: string;
+    executionId: string;
+    expectedHash?: string;
+}) => ReleaseExecutionPlan;
+export declare const releaseExecutionPlanRelativePath: (taskDir: string, plan: Pick<ReleaseExecutionPlan, "target" | "executionId">) => string;
+export {};