gate-evm-tools 1.0.28 → 1.2.0

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

@@ -0,0 +1,17 @@
+import ts from 'typescript';
+import { type ProjectNetworkSnapshot } from './protocol';
+export { stat, confinedFile, projectRoot, readFile, deliveryProjectMarker } from './project-files';
+export declare function parseProjectConfig(source: string): {
+    file: ts.SourceFile;
+    networks: Map<string, ts.Expression>;
+    fields: Map<string, ts.Expression>;
+};
+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

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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"));
+const typescript_1 = __importDefault(require("typescript"));
+const protocol_1 = require("./protocol");
+const policy_1 = require("./policy");
+var project_files_1 = require("./project-files");
+Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return project_files_1.stat; } });
+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, "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;
+    return node;
+}
+function properties(node, label) {
+    node = unwrap(node);
+    if (!typescript_1.default.isObjectLiteralExpression(node))
+        throw new Error(`${label} must be a static object literal`);
+    const map = new Map();
+    for (const item of node.properties) {
+        if (!typescript_1.default.isPropertyAssignment(item) || (!typescript_1.default.isIdentifier(item.name) && !typescript_1.default.isStringLiteral(item.name)))
+            throw new Error(`${label} has unsupported computed or spread fields`);
+        const key = item.name.text;
+        if (['__proto__', 'constructor', 'prototype'].includes(key))
+            throw new Error(`Reserved prototype property in ${label}`);
+        if (map.has(key))
+            throw new Error(`Duplicate ${label} field: ${key}`);
+        map.set(key, unwrap(item.initializer));
+    }
+    return map;
+}
+function parseProjectConfig(source) {
+    const file = typescript_1.default.createSourceFile('hardhat.config.ts', source, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.TS);
+    const diagnostics = file.parseDiagnostics;
+    if (diagnostics.length)
+        throw new Error('Invalid hardhat.config.ts syntax');
+    const exports = file.statements.filter(typescript_1.default.isExportAssignment);
+    if (exports.length !== 1 || exports[0].isExportEquals)
+        throw new Error('Config requires one default export');
+    let config = unwrap(exports[0].expression);
+    if (typescript_1.default.isIdentifier(config)) {
+        const name = config.text;
+        const declarations = file.statements.filter(typescript_1.default.isVariableStatement).flatMap(statement => [...statement.declarationList.declarations]
+            .map(declaration => ({ declaration, statement }))).filter(({ declaration }) => typescript_1.default.isIdentifier(declaration.name) && declaration.name.text === name);
+        if (declarations.length !== 1 || !(declarations[0].statement.declarationList.flags & typescript_1.default.NodeFlags.Const) || !declarations[0].declaration.initializer)
+            throw new Error('Config requires a static const object');
+        const declaration = declarations[0].declaration;
+        const references = [];
+        const visit = (node) => { if (typescript_1.default.isIdentifier(node) && node.text === name)
+            references.push(node); typescript_1.default.forEachChild(node, visit); };
+        visit(file);
+        if (references.some(node => node !== declaration.name && node !== config))
+            throw new Error('Ambiguous mutable config references');
+        config = unwrap(declaration.initializer);
+    }
+    const fields = properties(config, 'config');
+    const networkNode = fields.get('networks');
+    if (!networkNode)
+        throw new Error('Project config must declare networks');
+    return { file, networks: properties(networkNode, 'networks'), fields };
+}
+function projectSourcesDirectory(root) {
+    const { fields } = parseProjectConfig((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '');
+    const paths = fields.get('paths');
+    const sources = paths && properties(paths, 'paths').get('sources');
+    if (sources && !typescript_1.default.isStringLiteral(sources))
+        throw new Error('Project paths.sources must be a static string for dependency inspection');
+    const sourcePath = sources && typescript_1.default.isStringLiteral(sources) ? sources.text : 'contracts';
+    const relative = node_path_1.default.relative(root, node_path_1.default.resolve(root, sourcePath)).split(node_path_1.default.sep).join('/');
+    return (0, project_files_2.confinedFile)(root, relative, 'directory');
+}
+function projectDefaultNetwork(root) {
+    const { fields } = parseProjectConfig((0, project_files_2.readFile)(root, 'hardhat.config.ts') ?? '');
+    const network = fields.get('defaultNetwork');
+    if (!network)
+        return 'hardhat';
+    if (!typescript_1.default.isStringLiteral(network))
+        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, helper) {
+    node = unwrap(node);
+    if (typescript_1.default.isStringLiteral(node))
+        return node.text;
+    if (typescript_1.default.isPropertyAccessExpression(node) && typescript_1.default.isPropertyAccessExpression(node.expression)
+        && typescript_1.default.isIdentifier(node.expression.expression) && node.expression.expression.text === 'process'
+        && node.expression.name.text === 'env')
+        return env[node.name.text];
+    if (typescript_1.default.isElementAccessExpression(node) && typescript_1.default.isPropertyAccessExpression(node.expression)
+        && typescript_1.default.isIdentifier(node.expression.expression) && node.expression.expression.text === 'process'
+        && 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, helper);
+        return node.operatorToken.kind === typescript_1.default.SyntaxKind.QuestionQuestionToken
+            ? 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) {
+    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 { 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);
+        if (!selected || network === 'hardhat')
+            throw new Error(`Selected project network is missing or not an RPC target: ${network}`);
+        const fields = properties(selected, `network ${network}`);
+        const chainId = fields.get('chainId');
+        if (!chainId || !typescript_1.default.isNumericLiteral(chainId))
+            throw new Error(`Selected network ${network} requires a static chainId`);
+        if (fields.has('zksync') && fields.get('zksync').kind !== typescript_1.default.SyntaxKind.FalseKeyword)
+            throw new Error('Delivery requires an EVM network');
+        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, helper) ?? '' };
+    });
+}
+function integratedConfig(source) {
+    const { file } = parseProjectConfig(source);
+    const imports = file.statements.filter(typescript_1.default.isImportDeclaration);
+    const delivery = imports.filter(node => typescript_1.default.isStringLiteral(node.moduleSpecifier) && node.moduleSpecifier.text === 'gate-evm-tools/delivery-hardhat');
+    if (delivery.length > 1 || delivery.some(node => node.importClause))
+        throw new Error('Conflicting manual delivery plugin import');
+    // Place bootstrap before all imports, after leading comments/shebang/directives.
+    const first = file.statements.find(node => !(typescript_1.default.isExpressionStatement(node) && typescript_1.default.isStringLiteral(node.expression)));
+    if (!first)
+        throw new Error('Missing project config statements');
+    if (delivery.length) {
+        if (delivery[0] !== first)
+            throw new Error('Delivery plugin must be the first import; move it before other imports');
+        return source;
+    }
+    const at = first.getStart(file);
+    const newline = source.includes('\r\n') ? '\r\n' : '\n';
+    return source.slice(0, at) + `import "gate-evm-tools/delivery-hardhat";${newline}` + source.slice(at);
+}
+//# sourceMappingURL=project.js.map

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

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

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

@@ -0,0 +1,49 @@
+export type DeliveryEnvironment = 'dev' | 'prod';
+export type DeliveryMode = 'simulate' | 'execute' | 'export-calldata' | 'reconcile' | 'verify';
+export interface DeliveryRequest {
+    version: 1;
+    environment: DeliveryEnvironment;
+    purpose: 'dev-execution' | 'prod-qualification' | 'prod-execution';
+    mode: DeliveryMode;
+    network: string;
+    sourceRef: {
+        path: string;
+        taskId: string;
+        planKey: string;
+        rev: number;
+    };
+    releaseRef?: {
+        path: string;
+        releaseId: string;
+        inputsHash: string;
+    };
+    fork?: {
+        blockNumber: number;
+        blockHash: string;
+        readOnly: true;
+    };
+    devSigner?: string;
+    operator?: string;
+}
+export interface ProjectNetworkSnapshot {
+    network: string;
+    chainId: number;
+    url: string;
+}
+export declare function object(value: unknown, label: string, keys?: string[]): Record<string, unknown>;
+export declare function safeId(value: unknown, label: string): string;
+export declare function portablePath(value: unknown, label: string): string;
+export declare function address(value: unknown, label: string): string;
+export declare function positiveInteger(value: unknown, label: string): number;
+export declare function parseDeliveryRequest(input: unknown): DeliveryRequest;
+export interface ChainIdProvider {
+    request(args: {
+        method: 'eth_chainId';
+        params: [];
+    }): Promise<unknown>;
+}
+/** Does not load HRE, signers, verify source contents, or grant execution authority. */
+export declare function validateDeliveryRpc(input: unknown, snapshot: ProjectNetworkSnapshot, loadProvider: (snapshot: ProjectNetworkSnapshot) => Promise<ChainIdProvider>): Promise<{
+    request: DeliveryRequest;
+    chainId: number;
+}>;

package/dist-runtime/delivery/protocol.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.object = object;
+exports.safeId = safeId;
+exports.portablePath = portablePath;
+exports.address = address;
+exports.positiveInteger = positiveInteger;
+exports.parseDeliveryRequest = parseDeliveryRequest;
+exports.validateDeliveryRpc = validateDeliveryRpc;
+/** Syntax and routing constraints only. Source verification and host authorization are separate gates. */
+const policy_1 = require("./policy");
+function object(value, label, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)
+        || ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        throw new Error(`${label} must be an object`);
+    const result = value;
+    if (keys && Object.keys(result).some(key => !keys.includes(key)))
+        throw new Error(`${label} has unknown fields`);
+    return result;
+}
+function safeId(value, label) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/.test(value)
+        || ['__proto__', 'prototype', 'constructor'].includes(value))
+        throw new Error(`Invalid ${label}`);
+    return value;
+}
+function portablePath(value, label) {
+    if (typeof value !== 'string' || !value || /[\\\0:]/.test(value)
+        || value.split('/').some(part => !part || part === '.' || part === '..'
+            || ['__proto__', 'prototype', 'constructor'].includes(part)))
+        throw new Error(`Invalid relative ${label}`);
+    return value;
+}
+function address(value, label) {
+    if (typeof value !== 'string' || !/^0x[\da-fA-F]{40}$/.test(value) || /^0x0{40}$/.test(value))
+        throw new Error(`Invalid ${label} address`);
+    return value;
+}
+function positiveInteger(value, label) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0)
+        throw new Error(`Invalid ${label}`);
+    return value;
+}
+function parseDeliveryRequest(input) {
+    const value = object(input, 'delivery request', ['version', 'environment', 'purpose', 'mode', 'network', 'sourceRef', 'releaseRef', 'fork', 'devSigner', 'operator']);
+    if (value.version !== 1)
+        throw new Error('Unsupported delivery request version');
+    if (typeof value.environment !== 'string' || !['dev', 'prod'].includes(value.environment))
+        throw new Error('environment must be dev or prod');
+    if (typeof value.purpose !== 'string' || !['dev-execution', 'prod-qualification', 'prod-execution'].includes(value.purpose))
+        throw new Error('Invalid purpose');
+    const dev = value.purpose === 'dev-execution';
+    if (value.environment !== (dev ? 'dev' : 'prod'))
+        throw new Error('purpose conflicts with environment');
+    const modes = dev ? ['simulate', 'execute', 'reconcile', 'verify'] : value.purpose === 'prod-qualification' ? ['simulate', 'verify'] : ['simulate', 'execute', 'export-calldata', 'reconcile', 'verify'];
+    if (typeof value.mode !== 'string' || !modes.includes(value.mode))
+        throw new Error('Explicit valid mode is required for purpose');
+    (0, policy_1.validateNetworkAlias)(value.network, 'network', false);
+    const source = object(value.sourceRef, 'sourceRef', ['path', 'taskId', 'planKey', 'rev']);
+    portablePath(source.path, 'sourceRef.path');
+    safeId(source.taskId, 'taskId');
+    safeId(source.planKey, 'planKey');
+    positiveInteger(source.rev, 'rev');
+    if (dev) {
+        address(value.devSigner, 'devSigner');
+        if ('operator' in value)
+            throw new Error('devSigner and prod operator are separate roles');
+    }
+    else {
+        address(value.operator, 'operator');
+        if ('devSigner' in value)
+            throw new Error('prod operator cannot inherit devSigner');
+    }
+    if (value.purpose === 'prod-execution') {
+        const release = object(value.releaseRef, 'releaseRef', ['path', 'releaseId', 'inputsHash']);
+        portablePath(release.path, 'releaseRef.path');
+        safeId(release.releaseId, 'releaseId');
+        if (typeof release.inputsHash !== 'string' || !/^[a-f0-9]{64}$/.test(release.inputsHash))
+            throw new Error('Invalid releaseRef.inputsHash');
+    }
+    else if ('releaseRef' in value)
+        throw new Error('releaseRef requires prod-execution');
+    if (value.purpose === 'prod-qualification' && value.mode === 'simulate' && !value.fork)
+        throw new Error('prod-qualification simulate requires a pinned read-only fork');
+    if ('fork' in value) {
+        const fork = object(value.fork, 'fork', ['blockNumber', 'blockHash', 'readOnly']);
+        if (typeof fork.blockNumber !== 'number' || !Number.isSafeInteger(fork.blockNumber) || fork.blockNumber < 0)
+            throw new Error('Invalid fork.blockNumber');
+        if (fork.readOnly !== true || typeof fork.blockHash !== 'string' || !/^0x[\da-fA-F]{64}$/.test(fork.blockHash))
+            throw new Error('fork must pin a block hash and be readOnly');
+        if (value.mode !== 'simulate')
+            throw new Error('fork is only valid for simulate mode');
+    }
+    // Return detached data so callers cannot change routing during an asynchronous provider load.
+    return JSON.parse(JSON.stringify(value));
+}
+/** Does not load HRE, signers, verify source contents, or grant execution authority. */
+async function validateDeliveryRpc(input, snapshot, loadProvider) {
+    const request = parseDeliveryRequest(input);
+    if (snapshot.network !== request.network)
+        throw new Error('Selected project network snapshot mismatch');
+    const expected = positiveInteger(snapshot.chainId, 'snapshot.chainId');
+    const provider = await loadProvider({ ...snapshot });
+    const raw = await provider.request({ method: 'eth_chainId', params: [] });
+    if (typeof raw !== 'string' || !/^0x[\da-fA-F]+$/.test(raw))
+        throw new Error('Invalid RPC eth_chainId response');
+    const actual = BigInt(raw);
+    if (actual !== BigInt(expected))
+        throw new Error(`RPC chainId mismatch: expected ${expected}, actual ${actual}`);
+    return { request, chainId: expected };
+}
+//# sourceMappingURL=protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../runtime/delivery/protocol.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[];