gate-evm-tools 1.0.26 → 1.0.27

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

@@ -0,0 +1,282 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeExternalExecutionPackage = exports.loadExternalExecutionPackage = exports.ExternalExecutionRequired = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+class ExternalExecutionRequired extends Error {
+    stepId;
+    calls;
+    constructor(stepId, calls) {
+        super(`External execution required for step ${stepId}`);
+        this.stepId = stepId;
+        this.calls = calls;
+        this.name = "ExternalExecutionRequired";
+    }
+}
+exports.ExternalExecutionRequired = ExternalExecutionRequired;
+const safeId = (value, label) => {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/.test(value)) {
+        throw new Error(`${label} is invalid`);
+    }
+    return value;
+};
+const normalizeAddress = (value, label) => {
+    if (!/^0x[0-9a-fA-F]{40}$/.test(value))
+        throw new Error(`${label} is invalid`);
+    return value.toLowerCase();
+};
+const normalizeValue = (value, label) => {
+    if (!/^(?:0[xX][0-9a-fA-F]+|[0-9]+)$/.test(value)) {
+        throw new Error(`${label} is invalid`);
+    }
+    return BigInt(value).toString(10);
+};
+const normalizeData = (value, label) => {
+    if (!/^0x(?:[0-9a-fA-F]{2})*$/.test(value))
+        throw new Error(`${label} is invalid`);
+    return value.toLowerCase();
+};
+const normalizeFactoryDeps = (value, label) => {
+    if (!Array.isArray(value))
+        throw new Error(`${label} must be an array`);
+    const output = [];
+    const seen = new Set();
+    for (const [index, dependency] of value.entries()) {
+        if (typeof dependency !== "string" || !/^0x(?:[0-9a-fA-F]{2})+$/.test(dependency)) {
+            throw new Error(`${label}[${index}] is invalid`);
+        }
+        const normalized = dependency.toLowerCase();
+        if (seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        output.push(normalized);
+    }
+    return output;
+};
+const canonicalCall = (call, index) => {
+    if (call.operation !== 0 && call.operation !== 1) {
+        throw new Error(`external call ${index} operation is invalid`);
+    }
+    if (call.scheme !== undefined && call.scheme !== "zksync-eravm") {
+        throw new Error(`external call ${index} scheme is invalid`);
+    }
+    if (call.scheme === "zksync-eravm" && call.factoryDeps === undefined) {
+        throw new Error(`external call ${index} factoryDeps is required for zkSync`);
+    }
+    if (call.scheme === undefined && call.factoryDeps !== undefined) {
+        throw new Error(`external call ${index} factoryDeps is only supported for zkSync`);
+    }
+    return {
+        transactionId: safeId(call.transactionId, `external call ${index} transactionId`),
+        stepId: safeId(call.stepId, `external call ${index} stepId`),
+        to: normalizeAddress(call.to, `external call ${index} to`),
+        value: normalizeValue(call.value, `external call ${index} value`),
+        data: normalizeData(call.data, `external call ${index} data`),
+        operation: call.operation,
+        ...(call.scheme === "zksync-eravm"
+            ? {
+                scheme: "zksync-eravm",
+                factoryDeps: normalizeFactoryDeps(call.factoryDeps, `external call ${index} factoryDeps`),
+            }
+            : {}),
+        method: String(call.method),
+        args: call.args,
+        executor: normalizeAddress(call.executor, `external call ${index} executor`),
+        reason: String(call.reason),
+    };
+};
+const groupAdjacentCalls = (calls) => {
+    const groups = [];
+    for (const call of calls) {
+        const previous = groups.at(-1);
+        if (previous && previous.executor === call.executor) {
+            previous.transactionIds.push(call.transactionId);
+            previous.calls.push(call);
+            continue;
+        }
+        groups.push({
+            groupId: `group-${String(groups.length + 1).padStart(4, "0")}`,
+            executor: call.executor,
+            transactionIds: [call.transactionId],
+            calls: [call],
+        });
+    }
+    return groups;
+};
+const packagePath = (taskDir, target, executionId) => {
+    safeId(target, "external package target");
+    safeId(executionId, "external package executionId");
+    const resolvedTask = path_1.default.resolve(taskDir);
+    const filePath = path_1.default.join(resolvedTask, "calldata", target, executionId, "external-execution.json");
+    const relative = path_1.default.relative(resolvedTask, filePath);
+    if (relative.startsWith("..") || path_1.default.isAbsolute(relative)) {
+        throw new Error("external package path escapes the task directory");
+    }
+    return filePath;
+};
+const writeAtomic = (filePath, value) => {
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+    const serialized = JSON.stringify(value, null, 2) + "\n";
+    const temporary = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        fs_1.default.writeFileSync(temporary, serialized, { flag: "wx", mode: 0o600 });
+        fs_1.default.renameSync(temporary, filePath);
+    }
+    catch (error) {
+        if (fs_1.default.existsSync(temporary))
+            fs_1.default.unlinkSync(temporary);
+        throw error;
+    }
+};
+const externalSegments = (plan) => {
+    const segments = [];
+    for (const transaction of plan.transactions) {
+        if (transaction.route !== "external")
+            continue;
+        const previous = segments.at(-1);
+        if (previous
+            && previous.transactions.at(-1).transactionIndex + 1 === transaction.transactionIndex) {
+            previous.transactions.push(transaction);
+            continue;
+        }
+        segments.push({ index: segments.length, transactions: [transaction] });
+    }
+    return segments;
+};
+const canonicalSegmentCalls = (plan, rawCalls) => {
+    if (rawCalls.length === 0) {
+        throw new Error("external package calls must cover one consecutive external segment");
+    }
+    const calls = rawCalls.map(canonicalCall);
+    const segments = externalSegments(plan);
+    const segmentIndex = segments.findIndex((segment) => (segment.transactions.length === calls.length
+        && segment.transactions.every((transaction, index) => (transaction.transactionId === calls[index].transactionId))));
+    if (segmentIndex < 0) {
+        throw new Error("external package calls must cover one consecutive external segment");
+    }
+    const transactions = segments[segmentIndex].transactions;
+    for (const [index, transaction] of transactions.entries()) {
+        const call = calls[index];
+        if (call.stepId !== transaction.stepId
+            || call.executor !== transaction.executor.toLowerCase()
+            || call.to !== transaction.to.toLowerCase()
+            || call.value !== BigInt(transaction.value).toString(10)
+            || call.data !== transaction.data.toLowerCase()
+            || call.operation !== transaction.operation
+            || call.scheme !== transaction.scheme
+            || JSON.stringify(call.factoryDeps) !== JSON.stringify(transaction.factoryDeps)) {
+            throw new Error(`external plan transaction ${transaction.transactionId} must match its segment call`);
+        }
+    }
+    return { segmentIndex, transactions, calls };
+};
+const assertExternalTransportSupported = (plan) => {
+    if (plan.transactions.some((transaction) => transaction.route === "external" && transaction.scheme === "zksync-eravm")) {
+        throw new Error("zkSync external Admin execution is not supported until an exact EIP-712 factoryDeps transport is implemented");
+    }
+};
+const parseExistingPackage = (filePath, plan) => {
+    if (!fs_1.default.existsSync(filePath))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`external execution package is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("external execution package must be an object");
+    }
+    const value = parsed;
+    if (value.version !== 1
+        || value.taskId !== plan.taskId
+        || value.target !== plan.target
+        || value.executionId !== plan.executionId
+        || value.operator !== plan.operator
+        || value.executionPlanHash !== plan.planHash
+        || !Array.isArray(value.segments)
+        || typeof value.createdAt !== "string"
+        || typeof value.updatedAt !== "string") {
+        throw new Error("external execution package does not match the execution plan");
+    }
+    const segments = externalSegments(plan);
+    for (const [index, rawSegment] of value.segments.entries()) {
+        if (!rawSegment || typeof rawSegment !== "object" || Array.isArray(rawSegment)) {
+            throw new Error(`external execution segment ${index} is invalid`);
+        }
+        const segment = rawSegment;
+        const expected = segments[index]?.transactions;
+        const calls = Array.isArray(segment.groups)
+            ? segment.groups.flatMap((group) => group.calls)
+            : [];
+        if (!expected
+            || segment.segmentId !== `segment-${String(index + 1).padStart(4, "0")}`
+            || segment.transactionStartIndex !== expected[0].transactionIndex
+            || !Array.isArray(segment.transactionIds)
+            || JSON.stringify(segment.transactionIds) !== JSON.stringify(expected.map((transaction) => transaction.transactionId))
+            || !Number.isSafeInteger(segment.handoffBlock)
+            || segment.handoffBlock < 0
+            || calls.length !== expected.length) {
+            throw new Error(`external execution segment ${index} does not match the execution plan`);
+        }
+        canonicalSegmentCalls(plan, calls);
+    }
+    return value;
+};
+const loadExternalExecutionPackage = (input) => {
+    assertExternalTransportSupported(input.plan);
+    const filePath = packagePath(input.taskDir, input.plan.target, input.plan.executionId);
+    const existing = parseExistingPackage(filePath, input.plan);
+    return existing ? { filePath, package: existing } : undefined;
+};
+exports.loadExternalExecutionPackage = loadExternalExecutionPackage;
+const writeExternalExecutionPackage = (input) => {
+    assertExternalTransportSupported(input.plan);
+    if (!Number.isSafeInteger(input.handoffBlock) || input.handoffBlock < 0) {
+        throw new Error("external package handoffBlock must be a nonnegative safe integer");
+    }
+    if (!input.plan.transactions.some((transaction) => transaction.route === "external")) {
+        throw new Error("external execution package requires external plan transactions");
+    }
+    const { segmentIndex, transactions, calls } = canonicalSegmentCalls(input.plan, input.calls);
+    const target = safeId(input.plan.target, "external package target");
+    const executionId = safeId(input.plan.executionId, "external package executionId");
+    const filePath = packagePath(input.taskDir, target, executionId);
+    const existing = parseExistingPackage(filePath, input.plan);
+    if (existing?.segments[segmentIndex]) {
+        return { filePath, package: existing };
+    }
+    if ((existing?.segments.length ?? 0) !== segmentIndex) {
+        throw new Error("external execution segments must be appended in plan order");
+    }
+    const now = (input.now || (() => new Date().toISOString()))();
+    const segment = {
+        segmentId: `segment-${String(segmentIndex + 1).padStart(4, "0")}`,
+        transactionStartIndex: transactions[0].transactionIndex,
+        transactionIds: transactions.map((transaction) => transaction.transactionId),
+        handoffBlock: input.handoffBlock,
+        groups: groupAdjacentCalls(calls),
+        createdAt: now,
+    };
+    const output = existing
+        ? { ...existing, segments: [...existing.segments, segment], updatedAt: now }
+        : {
+            version: 1,
+            taskId: safeId(input.plan.taskId, "external package taskId"),
+            target,
+            executionId,
+            operator: normalizeAddress(input.plan.operator, "external package operator"),
+            executionPlanHash: input.plan.planHash,
+            segments: [segment],
+            createdAt: now,
+            updatedAt: now,
+        };
+    writeAtomic(filePath, output);
+    return { filePath, package: output };
+};
+exports.writeExternalExecutionPackage = writeExternalExecutionPackage;
+//# sourceMappingURL=external.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/external.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AA8CxB,MAAa,yBAA0B,SAAQ,KAAK;IAEvC;IACA;IAFX,YACW,MAAc,EACd,KAAqB;QAE9B,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;QAH/C,WAAM,GAAN,MAAM,CAAQ;QACd,UAAK,GAAL,KAAK,CAAgB;QAG9B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AARD,8DAQC;AAED,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IACtD,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IAChE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IAC9D,IAAI,CAAC,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IAC7D,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAE,KAAa,EAAY,EAAE;IACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,cAAc,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAkB,EAAE,KAAa,EAAgB,EAAE;IACxE,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,uBAAuB,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,qCAAqC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,2CAA2C,CAAC,CAAC;IACrF,CAAC;IACD,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;QACjF,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,KAAK,SAAS,CAAC;QAC5D,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,KAAK,KAAK,CAAC;QAC1D,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,KAAK,QAAQ,CAAC;QACjE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAC7D,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,cAAc;YAChC,CAAC,CAAC;gBACE,MAAM,EAAE,cAAuB;gBAC/B,WAAW,EAAE,oBAAoB,CAC/B,IAAI,CAAC,WAAW,EAChB,iBAAiB,KAAK,cAAc,CACrC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,KAAK,WAAW,CAAC;QAC5E,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KAC5B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAqB,EAA4B,EAAE;IAC7E,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpD,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YAC9D,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC;YACpC,KAAK,EAAE,CAAC,IAAI,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,MAAc,EAAE,WAAmB,EAAU,EAAE;IACnF,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC1C,MAAM,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CACxB,YAAY,EACZ,UAAU,EACV,MAAM,EACN,WAAW,EACX,yBAAyB,CAC1B,CAAC;IACF,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,KAAc,EAAQ,EAAE;IAC7D,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACjE,IAAI,CAAC;QACH,YAAE,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,YAAE,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,IAA0B,EACoD,EAAE;IAChF,MAAM,QAAQ,GAAiF,EAAE,CAAC;IAClG,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,WAAW,CAAC,KAAK,KAAK,UAAU;YAAE,SAAS;QAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IACE,QAAQ;eACL,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,gBAAgB,GAAG,CAAC,KAAK,WAAW,CAAC,gBAAgB,EACtF,CAAC;YACD,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC5B,IAA0B,EAC1B,QAAwB,EAC6E,EAAE;IACvG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACnD,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;WACzC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CACpD,WAAW,CAAC,aAAa,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa,CACzD,CAAC,CACH,CAAC,CAAC;IACH,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC;IACzD,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IACE,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;eAC/B,IAAI,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE;eACpD,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE;eACxC,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;eACrD,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE;eAC5C,IAAI,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS;eACxC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;eAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,EAC/E,CAAC;YACD,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,CAAC,aAAa,8BAA8B,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,gCAAgC,GAAG,CAAC,IAA0B,EAAQ,EAAE;IAC5E,IACE,IAAI,CAAC,YAAY,CAAC,IAAI,CACpB,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK,UAAU,IAAI,WAAW,CAAC,MAAM,KAAK,cAAc,CAC3F,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,QAAgB,EAChB,IAA0B,EACY,EAAE;IACxC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,KAAK,GAAG,MAAiC,CAAC;IAChD,IACE,KAAK,CAAC,OAAO,KAAK,CAAC;WAChB,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;WAC5B,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;WAC5B,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW;WACtC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;WAChC,KAAK,CAAC,iBAAiB,KAAK,IAAI,CAAC,QAAQ;WACzC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;WAC9B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;WACnC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,aAAa,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,UAAsC,CAAC;QACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YACzC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;YAChD,CAAC,CAAC,EAAE,CAAC;QACP,IACE,CAAC,QAAQ;eACN,OAAO,CAAC,SAAS,KAAK,WAAW,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;eACrE,OAAO,CAAC,qBAAqB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB;eAC9D,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;eACtC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,SAAS,CAC1D,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CACzD;eACE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC;eAC3C,OAAO,CAAC,YAAY,GAAG,CAAC;eACxB,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,oCAAoC,CAAC,CAAC;QAC3F,CAAC;QACD,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAA4C,CAAC;AACtD,CAAC,CAAC;AAEK,MAAM,4BAA4B,GAAG,CAAC,KAG5C,EAAuE,EAAE;IACxE,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC,CAAC;AARW,QAAA,4BAA4B,gCAQvC;AAEK,MAAM,6BAA6B,GAAG,CAAC,KAM7C,EAA2D,EAAE;IAC5D,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,OAAO,GAA6B;QACxC,SAAS,EAAE,WAAW,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QACjE,qBAAqB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,gBAAgB;QACvD,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC;QAC5E,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,GAAG;KACf,CAAC;IACF,MAAM,MAAM,GAA6B,QAAQ;QAC/C,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QAC5E,CAAC,CAAC;YACE,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC;YAC5D,MAAM;YACN,WAAW;YACX,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,2BAA2B,CAAC;YAC5E,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;YACtC,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;IACN,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC,CAAC;AAjDW,QAAA,6BAA6B,iCAiDxC"}

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

@@ -0,0 +1,64 @@
+import { JsonRpcProvider } from "ethers";
+import { syncGateToolUups, type GateToolSyncHre } from "./gateToolSync";
+export type ExternalFinalityPolicy = {
+    mode: "rpc_finalized";
+} | {
+    mode: "confirmation_depth";
+    confirmations: number;
+};
+export interface ExternalReconciliationMatch {
+    transactionId: string;
+    transactionIndex: number;
+    route: "operator" | "external";
+    executor: string;
+    submittedBy: string;
+    executionKind: "eoa" | "safe_call" | "safe_multisend";
+    transactionHash: string;
+    blockNumber: number;
+    blockHash: string;
+    blockTransactionIndex: number;
+    innerCallIndex?: number;
+    receiptStatus: 0 | 1;
+    finalized: boolean;
+}
+export interface ExternalReconciliationReport {
+    version: 1;
+    status: "not_required" | "waiting_operator" | "waiting_finality" | "waiting_external" | "reconciled" | "failed";
+    taskId: string;
+    target: string;
+    executionId: string;
+    executionPlanHash: string;
+    packagePath?: string;
+    packageHash?: string;
+    segments?: Array<{
+        segmentId: string;
+        transactionIds: string[];
+        handoffBlock: number;
+        nextBlock: number;
+    }>;
+    finalizedBlock: number;
+    finalityPolicy: ExternalFinalityPolicy;
+    matchedTransactionIds: string[];
+    matches: ExternalReconciliationMatch[];
+    failure?: {
+        code: string;
+        message: string;
+        transactionId?: string;
+    };
+    reportPath: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export declare const reconcileExternalExecution: (input: {
+    root: string;
+    taskId: string;
+    network: string;
+    executionId: string;
+    provider: JsonRpcProvider;
+    batchSize?: number;
+    gateToolSyncHre?: GateToolSyncHre;
+    dependencies?: {
+        syncGateToolUups?: typeof syncGateToolUups;
+    };
+}) => Promise<ExternalReconciliationReport>;