gate-evm-tools 1.0.27 → 1.0.31

package/dist-runtime/delivery/custom.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomPlanningSession = exports.parseNativeOperation = exports.parseCustomOperations = exports.parseCustomStep = exports.parseCustomEvidence = void 0;
+exports.ownedCustomSession = ownedCustomSession;
+const custom_format_1 = require("./custom-format");
+var custom_format_2 = require("./custom-format");
+Object.defineProperty(exports, "parseCustomEvidence", { enumerable: true, get: function () { return custom_format_2.parseCustomEvidence; } });
+Object.defineProperty(exports, "parseCustomStep", { enumerable: true, get: function () { return custom_format_2.parseCustomStep; } });
+Object.defineProperty(exports, "parseCustomOperations", { enumerable: true, get: function () { return custom_format_2.parseCustomOperations; } });
+Object.defineProperty(exports, "parseNativeOperation", { enumerable: true, get: function () { return custom_format_2.parseNativeOperation; } });
+const data_1 = require("./data");
+const input_files_1 = require("./input-files");
+/** Bounded module/data/package closure; aggregate release freeze is a separate layer. */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_crypto_1 = require("node:crypto");
+const custom_closure_1 = require("./custom-closure");
+const canonicalData_1 = require("../workflow/lib/canonicalData");
+const bytesHash = (bytes) => (0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex");
+function readPath(source, key) {
+    return (0, canonicalData_1.deepFreeze)((0, data_1.strictData)((0, data_1.ownPath)(source, key.split("."), "custom input")));
+}
+const sessionAuthority = new WeakMap();
+function ownedCustomSession(session, root, businessRoot) {
+    const owned = sessionAuthority.get(session);
+    if (!owned ||
+        owned.root !== node_fs_1.default.realpathSync(root) ||
+        owned.businessRoot !== (0, custom_closure_1.customBusinessRoot)(root, businessRoot))
+        throw new Error("Custom planning requires collector-owned session authority");
+    return owned;
+}
+class CustomPlanningSession {
+    #closure;
+    #lifecycle = { closed: false };
+    version = 1;
+    constructor(input) {
+        const businessRoot = (0, custom_closure_1.customBusinessRoot)(input.root, input.businessRoot);
+        this.#input = { ...input, businessRoot };
+        this.#closure = new custom_closure_1.CustomModuleClosure(input.root);
+        sessionAuthority.set(this, Object.freeze({
+            root: node_fs_1.default.realpathSync(input.root),
+            businessRoot,
+            evaluate: (step) => this.#evaluate(step),
+            seal: () => this.#closure.seal(),
+            closeReads: () => { this.#lifecycle.closed = true; this.#closure.closeReads(); },
+        }));
+    }
+    #input;
+    /** Target-specific ports share the same collector, captured bytes and session union. */
+    forTarget(input) {
+        if (this.#lifecycle.closed)
+            throw new Error("Custom input session is closed");
+        const session = new CustomPlanningSession({
+            ...input,
+            root: this.#input.root,
+        });
+        session.#closure = this.#closure;
+        session.#lifecycle = this.#lifecycle;
+        return session;
+    }
+    sealClosure() {
+        return this.#closure.seal();
+    }
+    evaluate(step) {
+        return this.#evaluate(step);
+    }
+    async #evaluate(step) {
+        if (this.#lifecycle.closed)
+            throw new Error("Custom input session is closed");
+        const s = (0, custom_format_1.parseCustomStep)(step);
+        const declarations = (0, custom_format_1.parseDeclarations)(s.reads);
+        const observations = [];
+        const observe = (kind, key, value, bytesDigest = null, inputPath = null) => {
+            const immutable = (0, canonicalData_1.deepFreeze)((0, data_1.strictData)(value));
+            observations.push({
+                kind,
+                key,
+                value: immutable,
+                digest: (0, canonicalData_1.semanticHash)(immutable),
+                bytesDigest,
+                inputPath,
+            });
+            return immutable;
+        };
+        let open = true;
+        const assertOpen = () => {
+            if (!open)
+                throw new Error("Custom input session is closed");
+        };
+        const read = (name) => {
+            assertOpen();
+            if (!declarations.files.includes(name))
+                throw new Error("Undeclared file read");
+            return this.#closure.readData(this.#input.businessRoot, name);
+        };
+        const ports = Object.freeze({
+            readJson: async (name) => {
+                const { bytes, path: inputPath } = read(name);
+                return observe("json", name, (0, input_files_1.parseInputDocument)(bytes, 'json'), bytesHash(bytes), inputPath);
+            },
+            readBytes: async (name) => {
+                const { bytes, path: inputPath } = read(name);
+                return observe("bytes", name, "0x" + bytes.toString("hex"), bytesHash(bytes), inputPath);
+            },
+            resolve: (key) => {
+                assertOpen();
+                const dot = key.indexOf("."), scope = key.slice(0, dot), field = key.slice(dot + 1);
+                const list = scope === "param"
+                    ? declarations.params
+                    : scope === "state"
+                        ? declarations.state
+                        : scope === "target"
+                            ? declarations.target
+                            : [];
+                if (!list.includes(field))
+                    throw new Error("Undeclared input resolution");
+                const source = scope === "param"
+                    ? this.#input.params
+                    : scope === "target"
+                        ? this.#input.target
+                        : typeof this.#input.state === "function"
+                            ? this.#input.state()
+                            : this.#input.state;
+                return observe("resolve", key, readPath(source, field));
+            },
+        });
+        const loaded = this.#closure.load((0, canonicalData_1.nonempty)(s.script, "script"));
+        const moduleIdentity = loaded.identity;
+        let operations;
+        try {
+            const mod = loaded.module;
+            if (!mod ||
+                ["default", "main", "run"].some((k) => Object.hasOwn(mod, k)) ||
+                typeof mod.planOperations !== "function")
+                throw new Error("Custom planning must export planOperations; legacy exports are rejected");
+            operations = (0, custom_format_1.parseCustomOperations)(this.#closure.normalize(await mod.planOperations(ports, (0, canonicalData_1.deepFreeze)((0, data_1.strictData)(s.input ?? null)))));
+            this.#closure.assertUnchanged();
+        }
+        finally {
+            open = false;
+        }
+        const body = {
+            version: 1,
+            sourceStepId: s.id,
+            module: moduleIdentity,
+            input: s.input ?? null,
+            declarations,
+            operations,
+            observations,
+            closure: this.#closure.seal(),
+        };
+        return (0, canonicalData_1.deepFreeze)({ ...body, evidenceHash: (0, canonicalData_1.semanticHash)(body) });
+    }
+}
+exports.CustomPlanningSession = CustomPlanningSession;
+//# sourceMappingURL=custom.js.map

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

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

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

@@ -0,0 +1,7 @@
+/** Delivery's own-data JSON boundary. Numbers are safe integers only; ABI integers may be decimal strings. */
+export declare function strictData<T = unknown>(raw: T, label?: string): T;
+/** Internal partial-value boundary: the only non-JSON value permitted is the caller's sentinel. */
+export declare function copyOwnData<T>(raw: T, label: string, sentinel?: symbol): T;
+export declare function ownPath(value: unknown, parts: readonly string[], label?: string): unknown;
+export declare const pointerPart: (key: string) => string;
+export declare function pointerParts(path: string): string[];

package/dist-runtime/delivery/data.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pointerPart = void 0;
+exports.strictData = strictData;
+exports.copyOwnData = copyOwnData;
+exports.ownPath = ownPath;
+exports.pointerParts = pointerParts;
+/** Delivery's own-data JSON boundary. Numbers are safe integers only; ABI integers may be decimal strings. */
+function strictData(raw, label = "delivery data") {
+    return copyOwnData(raw, label);
+}
+/** Internal partial-value boundary: the only non-JSON value permitted is the caller's sentinel. */
+function copyOwnData(raw, label, sentinel) {
+    const active = new Set();
+    const visit = (value, path) => {
+        if (sentinel !== undefined && value === sentinel)
+            return value;
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "boolean")
+            return value;
+        if (typeof value === "number" && Number.isSafeInteger(value))
+            return value;
+        if (!value || typeof value !== "object")
+            throw new Error(`${path} requires JSON own data (safe integer numbers only)`);
+        if (active.has(value))
+            throw new Error(`${path} contains a cycle`);
+        if (Object.getOwnPropertySymbols(value).length)
+            throw new Error(`${path} contains symbol fields`);
+        if (!(Array.isArray(value) ? [Array.prototype] : [Object.prototype, null]).includes(Object.getPrototypeOf(value)))
+            throw new Error(`${path} requires plain own data`);
+        active.add(value);
+        const result = Array.isArray(value)
+            ? []
+            : {};
+        const keys = Object.getOwnPropertyNames(value);
+        if (Array.isArray(value) &&
+            (keys.length !== value.length + 1 ||
+                keys.some((k) => k !== "length" &&
+                    (!/^(0|[1-9][0-9]*)$/.test(k) || Number(k) >= value.length))))
+            throw new Error(`${path} contains sparse or extra array data`);
+        for (const key of keys.sort()) {
+            if (Array.isArray(value) && key === "length")
+                continue;
+            const d = Object.getOwnPropertyDescriptor(value, key);
+            if (!d.enumerable || !("value" in d))
+                throw new Error(`${path}.${key} requires own enumerable data`);
+            Object.defineProperty(result, key, {
+                value: visit(d.value, `${path}.${key}`),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        active.delete(value);
+        return result;
+    };
+    return visit(raw, label);
+}
+function ownPath(value, parts, label = "reference") {
+    let current = value;
+    for (const part of parts) {
+        if (!current || typeof current !== "object")
+            throw new Error(`${label} not found`);
+        if (!(Array.isArray(current) ? [Array.prototype] : [Object.prototype, null]).includes(Object.getPrototypeOf(current)))
+            throw new Error(`${label} requires plain own data`);
+        const d = Object.getOwnPropertyDescriptor(current, part);
+        if (!d || !d.enumerable || !("value" in d) || d.value === undefined)
+            throw new Error(`${label} requires existing own data`);
+        current = d.value;
+    }
+    return current;
+}
+const pointerPart = (key) => key.replace(/~/g, "~0").replace(/\//g, "~1");
+exports.pointerPart = pointerPart;
+function pointerParts(path) {
+    if (path === "")
+        return [];
+    if (!path.startsWith("/") || /~(?![01])/.test(path))
+        throw new Error("Invalid JSON pointer");
+    return path
+        .slice(1)
+        .split("/")
+        .map((p) => p.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+//# sourceMappingURL=data.js.map

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

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

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

@@ -0,0 +1,91 @@
+import type { VerificationObservation } from '../workflow/lib/evidencePorts';
+import type { WorkflowStep } from '../workflow/lib/parameters';
+import type { WorkflowHre } from '../workflow/lib/context';
+import { type ContractInfo } from '../workflow/lib/deployments';
+import { type DeploymentInfo } from '../workflow/lib/deploymentInfo';
+import type { DeploymentChange } from '../workflow/lib/deploymentRecords';
+import { type PreparationEntry } from './journal';
+import type { DeliveryCollection } from './planning';
+import type { DeliveryAggregate, DeliveryAggregateOptions } from './aggregate';
+import { type EoaExecutionOptions, type EoaHashReferences } from './eoa';
+export declare function expectedDevelopmentAssertions(collection: Pick<DeliveryCollection, 'plan' | 'verification'>, steps: readonly WorkflowStep[]): VerificationObservation[];
+/** Pure candidate merge; preparations must come from the sealed journal parser. */
+export declare function mergeDevelopmentRegistration(input: {
+    registry: unknown;
+    metadata: unknown;
+    base: {
+        registry: ContractInfo;
+        metadata: DeploymentInfo;
+    };
+    target: string;
+    deploymentId: string;
+    executionId: string;
+    recordPath: string;
+    updatedAt: string;
+    changes: readonly (DeploymentChange & {
+        address: string;
+        proxyKind?: 'uups';
+    })[];
+    preparations: readonly PreparationEntry[];
+}): {
+    registry: ContractInfo;
+    metadata: DeploymentInfo;
+};
+export interface DevelopmentDeliveryOptions {
+    root: string;
+    source: DeliveryAggregateOptions;
+    aggregate: DeliveryAggregate;
+    target: string;
+    hre: WorkflowHre;
+    execution: Omit<EoaExecutionOptions, 'plan' | 'provider'>;
+    /** Optional durable file progress notification. Throwing leaves a recoverable file-only intent. */
+    onFileCommitted?: (path: string) => void;
+}
+/** Persist the returned aggregate separately to resume; never rerun producers/scripts for sends. */
+export declare function createDevelopmentDelivery(options: DevelopmentDeliveryOptions): Promise<Readonly<{
+    plan: import("./plan").DeliveryPlan;
+    continue(input?: {
+        unsigned?: unknown;
+        hashReferences?: EoaHashReferences;
+    }): Promise<{
+        status: string;
+        execution: import("./eoa").EoaExecutionResult;
+        acceptance?: undefined;
+    } | {
+        status: string;
+        acceptance: any;
+        execution?: undefined;
+    }>;
+    export: () => Promise<{
+        model: {
+            safeEnvelopes: {
+                schema: string;
+                version: number;
+                status: string;
+                plan: import("./plan").DeliveryPlan;
+                envelope: import("./safe").SafeEnvelope;
+                unsignedExecTransaction: string;
+            }[];
+            safePreparation: string;
+            version: 1;
+            schema: "gate-delivery-export";
+            status: "artifact-delivered";
+            plan: import("./plan").DeliveryPlan;
+            fullRange: {
+                start: number;
+                end: number;
+            };
+            actionableRange: {
+                start: number;
+                end: number;
+            } | null;
+            completed: import("./observations").TransactionObservation[];
+            dependencies: {
+                transactionId: string;
+                after: string[];
+            }[];
+        };
+        json: string;
+        markdown: string;
+    }>;
+}>>;