gate-evm-tools 1.0.31 → 1.2.1

package/dist-runtime/delivery/project-files.js.map

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

package/dist-runtime/delivery/project-rpc.d.ts

@@ -0,0 +1,19 @@
+/** Fixed template RPC syntax. Inspection reads local env data without evaluating project code. */
+import ts from 'typescript';
+export declare const PROJECT_ENV_BOOTSTRAP = "for (const file of [\"rpc.env\", \".env\"]) {\n  const envFile = join(__dirname, file);\n  if (existsSync(envFile)) {\n    try {\n      process.loadEnvFile(envFile);\n    } catch (error) {\n      if (file !== \".env\" || ![\"ENOENT\", \"EPERM\", \"EACCES\"].includes((error as NodeJS.ErrnoException).code ?? \"\")) throw error;\n      console.warn(\"Project credentials are unavailable; compilation and public checks can continue. Use the application host for credential-bearing delivery operations.\");\n    }\n  }\n}";
+export declare const PROJECT_RPC_HELPER: string;
+export declare function projectRpcSyntax(file: ts.SourceFile): {
+    statements: Set<ts.Statement>;
+    bootstrap: boolean;
+    helper: boolean;
+};
+export declare function projectRpcOptions(node: ts.CallExpression): {
+    route: string;
+    publicFallback: ts.Expression;
+    useBaseRpc: boolean;
+};
+export declare function resolveProjectRpc(route: string, publicFallback: string | undefined, useBaseRpc: boolean, env: NodeJS.ProcessEnv): string;
+/** Static diagnostics never access the credential file, even when it is readable. */
+export declare function projectPublicRpcEnvironment(root: string, source: string, env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Actual runtime observation must retain the same environment semantics as Hardhat. */
+export declare function projectRpcEnvironment(root: string, source: string, env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist-runtime/delivery/project-rpc.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJECT_RPC_HELPER = exports.PROJECT_ENV_BOOTSTRAP = void 0;
+exports.projectRpcSyntax = projectRpcSyntax;
+exports.projectRpcOptions = projectRpcOptions;
+exports.resolveProjectRpc = resolveProjectRpc;
+exports.projectPublicRpcEnvironment = projectPublicRpcEnvironment;
+exports.projectRpcEnvironment = projectRpcEnvironment;
+/** Fixed template RPC syntax. Inspection reads local env data without evaluating project code. */
+const typescript_1 = __importDefault(require("typescript"));
+const node_util_1 = require("node:util");
+const project_files_1 = require("./project-files");
+exports.PROJECT_ENV_BOOTSTRAP = `for (const file of ["rpc.env", ".env"]) {
+  const envFile = join(__dirname, file);
+  if (existsSync(envFile)) {
+    try {
+      process.loadEnvFile(envFile);
+    } catch (error) {
+      if (file !== ".env" || !["ENOENT", "EPERM", "EACCES"].includes((error as NodeJS.ErrnoException).code ?? "")) throw error;
+      console.warn("Project credentials are unavailable; compilation and public checks can continue. Use the application host for credential-bearing delivery operations.");
+    }
+  }
+}`;
+exports.PROJECT_RPC_HELPER = [
+    "function rpcUrl(options: { route: string; publicFallback: string | undefined; useBaseRpc: boolean }): string {",
+    "  const fallback = options.publicFallback?.trim() || \"\";",
+    "  const base = process.env.BASE_RPC_URI?.trim();",
+    "  if (!options.useBaseRpc || !base) return fallback;",
+    "  return `${base.replace(/\\/+$/, \"\")}/${options.route}/`;",
+    "}",
+].join('\n');
+const printer = typescript_1.default.createPrinter({ removeComments: true });
+function syntax(node, file) {
+    return printer.printNode(typescript_1.default.EmitHint.Unspecified, node, file);
+}
+function statement(source) {
+    const file = typescript_1.default.createSourceFile('rpc.ts', source, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.TS);
+    return syntax(file.statements[0], file);
+}
+const bootstrapSyntax = statement(exports.PROJECT_ENV_BOOTSTRAP), helperSyntax = statement(exports.PROJECT_RPC_HELPER);
+function projectRpcSyntax(file) {
+    const statements = new Set();
+    let bootstrap = false, helper = false;
+    const imports = new Set();
+    for (const node of file.statements) {
+        if (typescript_1.default.isImportDeclaration(node) && typescript_1.default.isStringLiteral(node.moduleSpecifier)
+            && ['node:fs', 'node:path'].includes(node.moduleSpecifier.text)) {
+            const name = node.moduleSpecifier.text, clause = node.importClause;
+            const wanted = name === 'node:fs' ? 'existsSync' : 'join';
+            if (imports.has(name) || node.attributes || !clause || clause.name || clause.isTypeOnly
+                || !clause.namedBindings || !typescript_1.default.isNamedImports(clause.namedBindings)
+                || clause.namedBindings.elements.length !== 1 || clause.namedBindings.elements[0].name.text !== wanted
+                || clause.namedBindings.elements[0].propertyName)
+                throw Error('Unsupported project RPC import');
+            imports.add(name);
+            statements.add(node);
+        }
+        else if (typescript_1.default.isForOfStatement(node) && syntax(node, file) === bootstrapSyntax) {
+            if (bootstrap)
+                throw Error('Duplicate project RPC loader');
+            bootstrap = true;
+            statements.add(node);
+        }
+        else if (typescript_1.default.isFunctionDeclaration(node) && node.name?.text === 'rpcUrl') {
+            if (helper || syntax(node, file) !== helperSyntax)
+                throw Error('Unsupported project RPC helper');
+            helper = true;
+            statements.add(node);
+        }
+    }
+    if (bootstrap !== (imports.size === 2) || (!bootstrap && imports.size))
+        throw Error('Incomplete project RPC loader');
+    const config = file.statements.findIndex(node => typescript_1.default.isVariableStatement(node) || typescript_1.default.isExportAssignment(node));
+    if (bootstrap && config >= 0 && [...statements].some(node => typescript_1.default.isForOfStatement(node) && file.statements.indexOf(node) > config))
+        throw Error('Project RPC loader must precede configuration');
+    return { statements, bootstrap, helper };
+}
+function projectRpcOptions(node) {
+    if (!typescript_1.default.isIdentifier(node.expression) || node.expression.text !== 'rpcUrl' || node.arguments.length !== 1 || node.typeArguments)
+        throw Error('Unsupported project RPC call');
+    const options = node.arguments[0];
+    if (!typescript_1.default.isObjectLiteralExpression(options))
+        throw Error('Unsupported project RPC options');
+    const fields = new Map();
+    for (const property of options.properties) {
+        if (!typescript_1.default.isPropertyAssignment(property) || (!typescript_1.default.isIdentifier(property.name) && !typescript_1.default.isStringLiteral(property.name)))
+            throw Error('Unsupported project RPC option');
+        const name = property.name.text;
+        if (!['route', 'publicFallback', 'useBaseRpc'].includes(name) || fields.has(name))
+            throw Error('Unsupported project RPC option');
+        fields.set(name, property.initializer);
+    }
+    const route = fields.get('route'), useBaseRpc = fields.get('useBaseRpc'), publicFallback = fields.get('publicFallback');
+    if (!route || !typescript_1.default.isStringLiteral(route) || !/^[a-zA-Z0-9][a-zA-Z0-9-]*$/.test(route.text))
+        throw Error('Unsupported project RPC route');
+    if (!publicFallback || !useBaseRpc || ![typescript_1.default.SyntaxKind.TrueKeyword, typescript_1.default.SyntaxKind.FalseKeyword].includes(useBaseRpc.kind))
+        throw Error('Project RPC requires a literal useBaseRpc boolean and publicFallback');
+    return { route: route.text, publicFallback, useBaseRpc: useBaseRpc.kind === typescript_1.default.SyntaxKind.TrueKeyword };
+}
+function resolveProjectRpc(route, publicFallback, useBaseRpc, env) {
+    const base = env.BASE_RPC_URI?.trim();
+    return useBaseRpc && base ? `${base.replace(/\/+$/, '')}/${route}/` : publicFallback?.trim() || '';
+}
+function projectEnvironment(root, source, env, files) {
+    const file = typescript_1.default.createSourceFile('hardhat.config.ts', source, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.TS);
+    if (!projectRpcSyntax(file).bootstrap)
+        return env;
+    const effective = { ...env };
+    for (const name of files) {
+        try {
+            const contents = (0, project_files_1.readFile)(root, name);
+            if (contents === undefined)
+                continue;
+            for (const [key, value] of Object.entries((0, node_util_1.parseEnv)(contents)))
+                if (effective[key] === undefined)
+                    effective[key] = value;
+        }
+        catch (error) {
+            if (name === '.env' && ['EPERM', 'EACCES'].includes(error.code ?? '')) {
+                throw Error('Project credential environment is protected; run credential-bearing delivery operations through the trusted application host. Configure public RPCs in rpc.env.');
+            }
+            throw Error(`Cannot read local project RPC environment (${name})`);
+        }
+    }
+    return effective;
+}
+/** Static diagnostics never access the credential file, even when it is readable. */
+function projectPublicRpcEnvironment(root, source, env) {
+    return projectEnvironment(root, source, env, ['rpc.env']);
+}
+/** Actual runtime observation must retain the same environment semantics as Hardhat. */
+function projectRpcEnvironment(root, source, env) {
+    return projectEnvironment(root, source, env, ['rpc.env', '.env']);
+}
+//# sourceMappingURL=project-rpc.js.map

package/dist-runtime/delivery/project-rpc.js.map

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

package/dist-runtime/delivery/project.d.ts

@@ -1,6 +1,6 @@
 import ts from 'typescript';
 import { type ProjectNetworkSnapshot } from './protocol';
-export { stat, confinedFile, projectRoot, readFile, coreMarker } from './project-files';
+export { stat, confinedFile, projectRoot, readFile, deliveryProjectMarker } from './project-files';
 export declare function parseProjectConfig(source: string): {
     file: ts.SourceFile;
     networks: Map<string, ts.Expression>;
@@ -10,6 +10,8 @@ export declare function projectSourcesDirectory(root: string): string;
 export declare function projectDefaultNetwork(root: string): string;
 /** Read the project-owned definitions without evaluating the config, plugins or HRE. */
 export declare function readProjectNetworkSnapshots(root: string, aliases: string[], env?: NodeJS.ProcessEnv): ProjectNetworkSnapshot[];
+/** Public preflight only: RPCs must be in rpc.env or the supplied environment, never .env. */
+export declare function readPublicProjectNetworkSnapshots(root: string, aliases: string[], env?: NodeJS.ProcessEnv): ProjectNetworkSnapshot[];
 /** Parse one captured project definition without rereading files or evaluating plugins/HRE. */
 export declare function parseProjectNetworkSnapshots(source: string, aliases: string[], env?: NodeJS.ProcessEnv): ProjectNetworkSnapshot[];
 export declare function integratedConfig(source: string): string;

package/dist-runtime/delivery/project.js

@@ -3,11 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.coreMarker = exports.readFile = exports.projectRoot = exports.confinedFile = exports.stat = void 0;
+exports.deliveryProjectMarker = exports.readFile = exports.projectRoot = exports.confinedFile = exports.stat = void 0;
 exports.parseProjectConfig = parseProjectConfig;
 exports.projectSourcesDirectory = projectSourcesDirectory;
 exports.projectDefaultNetwork = projectDefaultNetwork;
 exports.readProjectNetworkSnapshots = readProjectNetworkSnapshots;
+exports.readPublicProjectNetworkSnapshots = readPublicProjectNetworkSnapshots;
 exports.parseProjectNetworkSnapshots = parseProjectNetworkSnapshots;
 exports.integratedConfig = integratedConfig;
 const node_path_1 = __importDefault(require("node:path"));
@@ -19,8 +20,9 @@ Object.defineProperty(exports, "stat", { enumerable: true, get: function () { re
 Object.defineProperty(exports, "confinedFile", { enumerable: true, get: function () { return project_files_1.confinedFile; } });
 Object.defineProperty(exports, "projectRoot", { enumerable: true, get: function () { return project_files_1.projectRoot; } });
 Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return project_files_1.readFile; } });
-Object.defineProperty(exports, "coreMarker", { enumerable: true, get: function () { return project_files_1.coreMarker; } });
+Object.defineProperty(exports, "deliveryProjectMarker", { enumerable: true, get: function () { return project_files_1.deliveryProjectMarker; } });
 const project_files_2 = require("./project-files");
+const project_rpc_1 = require("./project-rpc");
 function unwrap(node) {
     while (typescript_1.default.isParenthesizedExpression(node) || typescript_1.default.isAsExpression(node) || typescript_1.default.isSatisfiesExpression(node))
         node = node.expression;
@@ -92,7 +94,7 @@ function projectDefaultNetwork(root) {
         throw new Error('Project defaultNetwork must be a static string for delivery routing');
     return (0, policy_1.validateNetworkAlias)(network.text, 'defaultNetwork');
 }
-function rpcValue(node, env) {
+function rpcValue(node, env, helper) {
     node = unwrap(node);
     if (typescript_1.default.isStringLiteral(node))
         return node.text;
@@ -105,19 +107,30 @@ function rpcValue(node, env) {
         && node.expression.name.text === 'env' && typescript_1.default.isStringLiteral(node.argumentExpression))
         return env[node.argumentExpression.text];
     if (typescript_1.default.isBinaryExpression(node) && [typescript_1.default.SyntaxKind.BarBarToken, typescript_1.default.SyntaxKind.QuestionQuestionToken].includes(node.operatorToken.kind)) {
-        const left = rpcValue(node.left, env);
+        const left = rpcValue(node.left, env, helper);
         return node.operatorToken.kind === typescript_1.default.SyntaxKind.QuestionQuestionToken
-            ? left ?? rpcValue(node.right, env) : left || rpcValue(node.right, env);
+            ? left ?? rpcValue(node.right, env, helper) : left || rpcValue(node.right, env, helper);
+    }
+    if (helper && typescript_1.default.isCallExpression(node)) {
+        const options = (0, project_rpc_1.projectRpcOptions)(node);
+        return (0, project_rpc_1.resolveProjectRpc)(options.route, rpcValue(options.publicFallback, env, false), options.useBaseRpc, env);
     }
     throw new Error('Selected network URL must be a literal or process.env reference');
 }
 /** Read the project-owned definitions without evaluating the config, plugins or HRE. */
 function readProjectNetworkSnapshots(root, aliases, env = process.env) {
-    return parseProjectNetworkSnapshots((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '', aliases, env);
+    const source = (0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '';
+    return parseProjectNetworkSnapshots(source, aliases, (0, project_rpc_1.projectRpcEnvironment)(root, source, env));
+}
+/** Public preflight only: RPCs must be in rpc.env or the supplied environment, never .env. */
+function readPublicProjectNetworkSnapshots(root, aliases, env = process.env) {
+    const source = (0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '';
+    return parseProjectNetworkSnapshots(source, aliases, (0, project_rpc_1.projectPublicRpcEnvironment)(root, source, env));
 }
 /** Parse one captured project definition without rereading files or evaluating plugins/HRE. */
 function parseProjectNetworkSnapshots(source, aliases, env = process.env) {
-    const { networks } = parseProjectConfig(source);
+    const { file, networks } = parseProjectConfig(source);
+    const { helper } = (0, project_rpc_1.projectRpcSyntax)(file);
     return aliases.map(network => {
         (0, policy_1.validateNetworkAlias)(network, 'network', false);
         const selected = networks.get(network);
@@ -132,7 +145,7 @@ function parseProjectNetworkSnapshots(source, aliases, env = process.env) {
         const url = fields.get('url');
         if (!url)
             throw new Error(`Selected network ${network} requires an RPC URL definition`);
-        return { network, chainId: (0, protocol_1.positiveInteger)(Number(chainId.text), 'network chainId'), url: rpcValue(url, env) ?? '' };
+        return { network, chainId: (0, protocol_1.positiveInteger)(Number(chainId.text), 'network chainId'), url: rpcValue(url, env, helper) ?? '' };
     });
 }
 function integratedConfig(source) {

package/dist-runtime/delivery/project.js.map

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

package/dist-runtime/delivery/public-calldata.d.ts

@@ -0,0 +1,25 @@
+import { type ExpandedDetails } from './calldata-details';
+import type { WorkflowStep } from '../workflow/lib/parameters';
+export { archiveDeliveryCalls } from './calldata-archive';
+export { serializeDeliveryCalls, deliveryCalldataPath } from './calldata-format';
+export interface DeliveryCall {
+    chains: string[];
+    executor: string;
+    to: string;
+    name: string;
+    description: string;
+    abi: string[];
+    calldata: string;
+    value?: string;
+    details?: ExpandedDetails;
+}
+export interface PublicCalldataInput {
+    plan: unknown;
+    calldata: unknown;
+    operations: readonly WorkflowStep[];
+    preparations?: unknown;
+}
+/** Frozen parameters independently re-encode and compare before any public projection. */
+export declare function projectDeliveryCalls(input: PublicCalldataInput): readonly DeliveryCall[];
+/** Merge matching logical occurrences, never globally deduplicate calldata. */
+export declare function mergeDeliveryCalls(inputs: readonly PublicCalldataInput[]): readonly DeliveryCall[];

package/dist-runtime/delivery/public-calldata.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deliveryCalldataPath = exports.serializeDeliveryCalls = exports.archiveDeliveryCalls = void 0;
+exports.projectDeliveryCalls = projectDeliveryCalls;
+exports.mergeDeliveryCalls = mergeDeliveryCalls;
+/** Public business projection. Internal provenance and runtime progress stay separate. */
+const export_1 = require("./export");
+const calldata_review_1 = require("./calldata-review");
+const calldata_details_1 = require("./calldata-details");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+var calldata_archive_1 = require("./calldata-archive");
+Object.defineProperty(exports, "archiveDeliveryCalls", { enumerable: true, get: function () { return calldata_archive_1.archiveDeliveryCalls; } });
+var calldata_format_1 = require("./calldata-format");
+Object.defineProperty(exports, "serializeDeliveryCalls", { enumerable: true, get: function () { return calldata_format_1.serializeDeliveryCalls; } });
+Object.defineProperty(exports, "deliveryCalldataPath", { enumerable: true, get: function () { return calldata_format_1.deliveryCalldataPath; } });
+/** Frozen parameters independently re-encode and compare before any public projection. */
+function projectDeliveryCalls(input) {
+    const plan = (0, export_1.immutableDeliveryPlan)(input.plan);
+    const reviews = (0, calldata_review_1.parseCalldataReviews)(input.calldata, plan.transactions);
+    const journal = input.preparations ?? [];
+    const preparations = Array.isArray(journal) && !journal.length && !plan.deploymentBindings.length ? []
+        : require('./journal').parsePreparationJournal(journal, plan.transactions, plan.derivedBindings, { target: plan.target, chainId: plan.chainId, expectedStepIds: plan.deploymentBindings.map(d => d.stepId) });
+    return (0, canonicalData_1.deepFreeze)(plan.transactions.map((tx, index) => {
+        if (tx.operation !== 0)
+            throw Error('Public calldata supports ordinary CALL only');
+        const binding = plan.transactionBindings[index], operation = plan.operationBindings.find(o => o.stepId === binding.stepId);
+        if (!operation)
+            throw Error('Public calldata operation binding missing');
+        const source = operation.operationId === null ? input.operations.find(s => s.id === operation.sourceStepId)
+            : plan.customBindings.find(s => s.sourceStepId === operation.sourceStepId)?.operations.find(s => s.id === operation.operationId);
+        if (!source)
+            throw Error('Frozen operation intent missing');
+        const call = binding.callIndex === null ? undefined : source.calls?.[binding.callIndex];
+        const name = (0, canonicalData_1.nonempty)(call?.name ?? source.name, 'operation name');
+        const description = (0, canonicalData_1.nonempty)(call?.description ?? source.description, 'operation description');
+        const invocation = reviews[index].invocation;
+        if (invocation.kind !== 'function')
+            throw Error('Outer public transaction requires function ABI');
+        const entry = preparations.find(p => p.mappings.some(m => m.transactionId === tx.transactionId));
+        const details = (0, calldata_details_1.expandDeliveryInvocation)(invocation, tx.to, { name, description }, entry);
+        return { chains: [plan.chainId], executor: tx.executor, to: tx.to, name, description: (0, calldata_details_1.describeDeliveryInvocation)(description, invocation),
+            abi: (0, calldata_details_1.readableInvocationAbi)(invocation), calldata: tx.data, ...(BigInt(tx.value) === 0n ? {} : { value: tx.value }), ...(details ? { details } : {}) };
+    }));
+}
+/** Merge matching logical occurrences, never globally deduplicate calldata. */
+function mergeDeliveryCalls(inputs) {
+    if (!inputs.length)
+        throw Error('At least one independently frozen network is required');
+    const chains = new Set(), sequences = [];
+    const nodes = new Map();
+    for (const input of inputs) {
+        const plan = (0, export_1.immutableDeliveryPlan)(input.plan), chain = plan.chainId, calls = projectDeliveryCalls(input);
+        if (chains.has(chain))
+            throw Error('Duplicate chain projection');
+        chains.add(chain);
+        const keys = calls.map((call, index) => {
+            const binding = plan.transactionBindings[index], operation = plan.operationBindings.find(o => o.stepId === binding.stepId);
+            const { chains: _, ...content } = call;
+            const key = (0, canonicalData_1.semanticHash)({ logical: [operation.sourceStepId, operation.operationId, binding.role, binding.callIndex], content });
+            const existing = nodes.get(key);
+            if (existing) {
+                if (existing.call.chains.includes(chain))
+                    throw Error('Duplicate logical occurrence on one chain');
+                existing.call.chains.push(chain);
+            }
+            else
+                nodes.set(key, { call: { ...call, chains: [chain] }, next: new Set(), incoming: 0 });
+            return key;
+        });
+        sequences.push({ chain, calls, keys });
+        for (let i = 1; i < keys.length; i++) {
+            const a = nodes.get(keys[i - 1]), b = nodes.get(keys[i]);
+            if (!a.next.has(keys[i])) {
+                a.next.add(keys[i]);
+                b.incoming++;
+            }
+        }
+    }
+    const queue = [...nodes].filter(([, n]) => n.incoming === 0).map(([key]) => key), ordered = [];
+    for (let at = 0; at < queue.length; at++) {
+        const node = nodes.get(queue[at]);
+        ordered.push(node.call);
+        for (const key of node.next) {
+            const next = nodes.get(key);
+            if (--next.incoming === 0)
+                queue.push(key);
+        }
+    }
+    // Conflicting cross-chain ordering cannot share occurrences; keep exact per-chain sequences.
+    const result = ordered.length === nodes.size ? ordered : sequences.flatMap(s => s.calls.map(call => ({ ...call, chains: [s.chain] })));
+    const content = (call) => { const { chains: _, ...rest } = call; return rest; };
+    for (const sequence of sequences)
+        if ((0, canonicalData_1.canonicalJson)(result.filter(c => c.chains.includes(sequence.chain)).map(content)) !== (0, canonicalData_1.canonicalJson)(sequence.calls.map(content)))
+            throw Error('Merged calldata changed per-chain order or coverage');
+    return (0, canonicalData_1.deepFreeze)(result);
+}
+//# sourceMappingURL=public-calldata.js.map

package/dist-runtime/delivery/public-calldata.js.map

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

package/dist-runtime/delivery/release-graph.d.ts

@@ -1,3 +1,5 @@
+/** Actual-file release graph classification. No caller-selected roots or target subsets. */
+import { deploymentPurpose } from './source';
 export interface ReleaseGraphOptions {
     workspaceRoot: string;
     projectRoot: string;
@@ -11,6 +13,8 @@ export interface ReleaseGraphOptions {
     };
 }
 export declare const sameReleaseData: (a: unknown, b: unknown, label: string) => void;
+/** A completed simulation-only script task supplies reports, never on-chain acceptance. */
+export declare function isDevelopmentAcceptancePrerequisite(task: Parameters<typeof deploymentPurpose>[0]): any;
 export declare function readReleaseUniverse(input: Omit<ReleaseGraphOptions, 'releaseRef'>): {
     workspace: string;
     root: string;
@@ -50,13 +54,13 @@ export declare function readReleaseGraph(input: ReleaseGraphOptions): {
         readonly tasks: readonly {
             readonly planKey: string;
             readonly rev: number;
-            readonly objective: string;
-            readonly acceptance: readonly string[];
-            readonly dependsOn: readonly string[];
             readonly step?: string | undefined;
             readonly scope?: {
                 readonly [x: string]: unknown;
             } | undefined;
+            readonly objective: string;
+            readonly acceptance: readonly string[];
+            readonly dependsOn: readonly string[];
             readonly parameters?: readonly unknown[] | undefined;
             readonly expectedArtifacts?: readonly string[] | undefined;
             readonly allowedChanges?: readonly string[] | undefined;