gate-evm-tools 1.0.28 → 1.0.31

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

@@ -0,0 +1,35 @@
+import { type RuntimeEvidence } from './configuration-runtime';
+import { type PlanCodecObservation } from './codec';
+import type { DeepReadonly } from './source';
+export interface DeliveryConfigurationOptions {
+    workspaceRoot: string;
+    projectRoot: string;
+    network: string;
+}
+export interface DeliveryConfigurationEvidence {
+    version: 1;
+    files: Array<{
+        path: string;
+        digest: string;
+    }>;
+    configuration: Record<string, any>;
+    runtime: RuntimeEvidence;
+    codec: Readonly<PlanCodecObservation>;
+    compiler: {
+        adapter: string;
+        stableDigest: string;
+        exactDigest: string;
+    } | null;
+    /** Contributor identity only. C must bind this with all other actual inputs. */
+    configurationRuntimeHash: string;
+}
+export interface DeliveryConfigurationHandle {
+    readonly snapshot: DeepReadonly<DeliveryConfigurationEvidence>;
+    /** Reread without compile, producer evaluation, RPC or preparation. Failure revokes the owner. */
+    assertUnchanged(): void;
+    /** Terminal observation includes modules first loaded after open. */
+    seal(): DeepReadonly<DeliveryConfigurationEvidence>;
+    close(): void;
+}
+/** The initialized project singleton is looked up internally; a caller HRE/JSON is never accepted. */
+export declare function openDeliveryConfiguration(raw: DeliveryConfigurationOptions): DeliveryConfigurationHandle;

package/dist-runtime/delivery/configuration.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openDeliveryConfiguration = openDeliveryConfiguration;
+/** Owned configuration/runtime contributor. It grants no planning, signing or execution authority. */
+const node_path_1 = __importDefault(require("node:path"));
+const project_files_1 = require("./project-files");
+const input_files_1 = require("./input-files");
+const configuration_definition_1 = require("./configuration-definition");
+const configuration_hre_1 = require("./configuration-hre");
+const configuration_runtime_1 = require("./configuration-runtime");
+const codec_1 = require("./codec");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+/** The initialized project singleton is looked up internally; a caller HRE/JSON is never accepted. */
+function openDeliveryConfiguration(raw) {
+    let runtime, codec;
+    try {
+        (0, canonicalData_1.exactObject)(raw, ['workspaceRoot', 'projectRoot', 'network'], 'configuration options');
+        const root = (0, project_files_1.projectRoot)(raw.workspaceRoot, raw.projectRoot);
+        if (node_path_1.default.resolve(process.cwd()) !== root)
+            throw new Error();
+        const config = (0, input_files_1.readInputBytes)(root, 'hardhat.config.ts'), marker = (0, input_files_1.readInputBytes)(root, '.gate-template.json');
+        // Marker describes generation provenance; current source is independently observed.
+        (0, project_files_1.parseCoreMarker)(marker);
+        const parsed = (0, configuration_definition_1.parseConfigurationDefinition)(config, raw.network);
+        runtime = new configuration_runtime_1.RuntimeObservation(root);
+        codec = (0, codec_1.openPlanCodecObservation)();
+        const hre = (0, configuration_hre_1.observeConfigurationHre)(root, raw.network, parsed, runtime.files);
+        const files = [{ path: 'hardhat.config.ts', digest: (0, input_files_1.inputDigest)(config) }, { path: '.gate-template.json', digest: (0, input_files_1.inputDigest)(marker) }];
+        const observe = () => {
+            // Reuse the actual owned compiler association when present, without recapturing any compiler jobs.
+            const { ownedDeliveryCompiler } = require('./compiler');
+            const compiler = ownedDeliveryCompiler(hre.hre)?.evidence();
+            const body = { version: 1, files, configuration: hre.configuration, runtime: runtime.observe(), codec: codec.snapshot,
+                compiler: compiler ? { adapter: compiler.adapter, stableDigest: compiler.stableDigest, exactDigest: compiler.exactDigest } : null };
+            return (0, canonicalData_1.deepFreeze)({ ...body, configurationRuntimeHash: (0, canonicalData_1.semanticHash)({ ...body, compiler: compiler ? { adapter: compiler.adapter, stableDigest: compiler.stableDigest } : null }) });
+        };
+        const snapshot = observe();
+        let status = 'open';
+        const close = () => { runtime.close(); codec.close(); };
+        const check = () => {
+            const current = (0, input_files_1.readInputBytes)(root, 'hardhat.config.ts');
+            if ((0, input_files_1.inputDigest)(current) !== files[0].digest || (0, input_files_1.inputDigest)((0, input_files_1.readInputBytes)(root, '.gate-template.json')) !== files[1].digest)
+                throw new Error();
+            hre.assertUnchanged((0, configuration_definition_1.parseConfigurationDefinition)(current, raw.network));
+            codec.assertUnchanged();
+            runtime.assertUnchanged();
+        };
+        const assertOpen = () => { if (status !== 'open')
+            throw new Error('Delivery configuration session closed'); };
+        return Object.freeze({ snapshot,
+            assertUnchanged() { assertOpen(); try {
+                check();
+            }
+            catch {
+                status = 'failed';
+                close();
+                throw new Error('Delivery configuration/runtime drift or mismatch');
+            } },
+            seal() { assertOpen(); status = 'failed'; try {
+                check();
+                const result = observe();
+                codec.seal();
+                status = 'sealed';
+                return result;
+            }
+            catch {
+                throw new Error('Delivery configuration/runtime drift or mismatch');
+            }
+            finally {
+                close();
+            } },
+            close() { status = 'closed'; close(); }, });
+    }
+    catch {
+        runtime?.close();
+        codec?.close();
+        throw new Error('Unsupported delivery configuration/runtime observation');
+    }
+}
+//# sourceMappingURL=configuration.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { Create2FieldKind } from "../workflow/lib/validation";
+/** Check supplied fields before shared extraction can discard or fall back from them. */
+export declare function validateCreate2Fields(raw: unknown, kind: Create2FieldKind, allowDeferred?: boolean): Record<string, unknown>;

package/dist-runtime/delivery/create2.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCreate2Fields = validateCreate2Fields;
+const ethers_1 = require("ethers");
+const data_1 = require("./data");
+const references_1 = require("./references");
+const abi_1 = require("./abi");
+/** Check supplied fields before shared extraction can discard or fall back from them. */
+function validateCreate2Fields(raw, kind, allowDeferred = false) {
+    const value = (0, data_1.copyOwnData)(raw, `CREATE2 ${kind}`, allowDeferred ? references_1.DEFERRED : undefined);
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`CREATE2 ${kind} requires an object`);
+    const fields = value;
+    const addresses = kind === "step"
+        ? ["factory", "expectedAddress"]
+        : kind === "target"
+            ? ["factory", "caller"]
+            : kind === "uups" ? ["placeholderImplementation"] : ["controlledMulticall"];
+    for (const key of addresses) {
+        if (!Object.hasOwn(fields, key))
+            continue;
+        (0, abi_1.validateAbiValue)(ethers_1.ParamType.from("address"), fields[key], `CREATE2 ${kind}.${key}`, allowDeferred);
+        if (typeof fields[key] === "string" && /^0x0{40}$/i.test(fields[key]))
+            throw new Error(`CREATE2 ${kind}.${key} requires a nonzero address`);
+    }
+    if (kind === "target" && Object.hasOwn(fields, "scheme") &&
+        !(allowDeferred && fields.scheme === references_1.DEFERRED) && fields.scheme !== "evm")
+        throw new Error("Delivery CREATE2 scheme must be evm");
+    if (kind === "step" && Object.hasOwn(fields, "salt"))
+        (0, abi_1.validateAbiValue)(ethers_1.ParamType.from("bytes32"), fields.salt, "CREATE2 salt", allowDeferred);
+    if ((kind === "step" || kind === "target") && Object.hasOwn(fields, "leadingZeroBytes")) {
+        const zeroes = fields.leadingZeroBytes;
+        if (!(allowDeferred && zeroes === references_1.DEFERRED) &&
+            (typeof zeroes !== "number" || !Number.isSafeInteger(zeroes) || zeroes < 0 || zeroes > 20))
+            throw new Error("CREATE2 leadingZeroBytes must be an integer from 0 to 20");
+    }
+    if (kind === "step") {
+        for (const key of ["create2ForwardValue", "callForwardValue"]) {
+            if (!Object.hasOwn(fields, key))
+                continue;
+            (0, abi_1.validateTransactionValue)(fields[key], allowDeferred);
+            if (typeof fields[key] === "number")
+                fields[key] = String(fields[key]);
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=create2.js.map

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

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

package/dist-runtime/delivery/custom-closure.d.ts

@@ -0,0 +1,27 @@
+import { type CustomInputClosure } from "./closure-format";
+export { parseCustomInputClosure, type ClosureFile, type ClosureEdge, type ClosurePackage, type CustomInputClosure } from "./closure-format";
+/** Validate before normalization; only the supplied project root and its realpath are aliases. */
+export declare function customBusinessRoot(root: string, businessRoot: string): string;
+/** Same restrictions for business ports and project imports: config/provenance is a separate future projection. */
+export declare function assertBusinessInput(relative: string, packageCode?: boolean): void;
+export declare class CustomModuleClosure {
+    #private;
+    constructor(root: string);
+    /** Normalize only this collector's own VM prototypes; never invoke getters or toJSON. */
+    normalize(raw: unknown): unknown;
+    closeReads(): void;
+    load(relative: string): {
+        module: any;
+        identity: {
+            path: string;
+            digest: string;
+        };
+    };
+    readData(root: string, relative: string): {
+        bytes: Buffer;
+        path: string;
+    };
+    assertUnchanged(): void;
+    seal(): CustomInputClosure;
+}
+/** Pure structural parser; only collector-owned sessions establish collection authority. */