gate-evm-tools 1.0.26 → 1.0.27

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

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorkflowSigner = exports.impersonateWorkflowSimulationSigner = exports.resolveSimulationSignerAddress = void 0;
+const ethers_1 = require("ethers");
+const custody_1 = require("gate-evm-tools/custody");
+const projectHardhat_1 = require("../../projectHardhat");
+const signerIdentity_1 = require("./signerIdentity");
+const SIMULATION_SIGNER_BALANCE = "0x3635C9ADC5DEA00000";
+const normalizedSimulationAddress = (value) => {
+    if (value === undefined)
+        return undefined;
+    const candidate = value.trim();
+    if (!(0, ethers_1.isAddress)(candidate) || (0, ethers_1.getAddress)(candidate) === ethers_1.ZeroAddress) {
+        throw new Error("simulation signer must be a valid non-zero EVM address");
+    }
+    return (0, ethers_1.getAddress)(candidate);
+};
+const resolveSimulationSignerAddress = (options) => {
+    const explicitAddress = normalizedSimulationAddress(options.explicitAddress);
+    const taskAddress = options.useLock
+        ? undefined
+        : normalizedSimulationAddress(options.taskAddress);
+    if (explicitAddress
+        && taskAddress
+        && explicitAddress.toLowerCase() !== taskAddress.toLowerCase()) {
+        throw new Error("simulation signer sources do not match");
+    }
+    const selectedAddress = explicitAddress || taskAddress;
+    if (!selectedAddress) {
+        throw new Error("Simulation requires an explicit signer address");
+    }
+    return selectedAddress;
+};
+exports.resolveSimulationSignerAddress = resolveSimulationSignerAddress;
+const impersonateWorkflowSimulationSigner = async (signerAddress) => {
+    if (projectHardhat_1.network.name !== "hardhat" && projectHardhat_1.network.name !== "zkFork") {
+        throw new Error("Simulation signer impersonation requires a local fork network");
+    }
+    await projectHardhat_1.network.provider.request({
+        method: "hardhat_impersonateAccount",
+        params: [signerAddress],
+    });
+    await projectHardhat_1.network.provider.request({
+        method: "hardhat_setBalance",
+        params: [signerAddress, SIMULATION_SIGNER_BALANCE],
+    });
+    if (projectHardhat_1.network.name === "zkFork") {
+        return (0, custody_1.createZkSyncNodeSigner)({
+            provider: projectHardhat_1.ethers.provider,
+            address: signerAddress,
+        });
+    }
+    return projectHardhat_1.ethers.getSigner(signerAddress);
+};
+exports.impersonateWorkflowSimulationSigner = impersonateWorkflowSimulationSigner;
+const resolveWorkflowSigner = async (mode, options = {}) => {
+    if (mode === "simulate") {
+        return (0, exports.impersonateWorkflowSimulationSigner)((0, exports.resolveSimulationSignerAddress)(options));
+    }
+    const executionCredential = mode === "execute"
+        ? (0, custody_1.resolveWalletCredential)(process.env)
+        : undefined;
+    const zkSync = projectHardhat_1.network.config.zksync === true;
+    if (mode === "execute" && zkSync) {
+        if (!executionCredential) {
+            throw new Error("zkSync development execution requires an explicit wallet credential");
+        }
+        const baseUrl = process.env.CUSTODY_API_BASE_URL?.trim() || undefined;
+        if (executionCredential.kind === "custody" && !baseUrl) {
+            throw new Error("Custody wallet mode requires CUSTODY_API_BASE_URL");
+        }
+        const credential = executionCredential.kind === "private-key"
+            ? executionCredential.privateKey
+            : `custody:${executionCredential.secret}:${executionCredential.address}`;
+        const signer = (0, custody_1.createZkSyncSigner)({
+            ethers: projectHardhat_1.ethers,
+            credential,
+            provider: projectHardhat_1.ethers.provider,
+            baseUrl,
+        });
+        (0, signerIdentity_1.assertExecutionSignerAddress)(await signer.getAddress(), options.taskAddress);
+        return signer;
+    }
+    if (executionCredential) {
+        const baseUrl = process.env.CUSTODY_API_BASE_URL?.trim() || undefined;
+        if (executionCredential.kind === "custody" && !baseUrl) {
+            throw new Error("Custody wallet mode requires CUSTODY_API_BASE_URL");
+        }
+        const credential = executionCredential.kind === "private-key"
+            ? executionCredential.privateKey
+            : `custody:${executionCredential.secret}:${executionCredential.address}`;
+        const signer = (0, custody_1.createSigner)({
+            ethers: projectHardhat_1.ethers,
+            credential,
+            provider: projectHardhat_1.ethers.provider,
+            baseUrl,
+        });
+        (0, signerIdentity_1.assertExecutionSignerAddress)(await signer.getAddress(), options.taskAddress);
+        return signer;
+    }
+    const [signer] = await projectHardhat_1.ethers.getSigners();
+    return signer;
+};
+exports.resolveWorkflowSigner = resolveWorkflowSigner;
+//# sourceMappingURL=signer.js.map

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

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

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

@@ -0,0 +1 @@
+export declare const assertExecutionSignerAddress: (actualAddress: string, expectedTaskAddress?: string) => string;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertExecutionSignerAddress = void 0;
+const ethers_1 = require("ethers");
+const normalizedAddress = (value, label) => {
+    const candidate = value.trim();
+    if (!(0, ethers_1.isAddress)(candidate) || (0, ethers_1.getAddress)(candidate) === ethers_1.ZeroAddress) {
+        throw new Error(`${label} must be a valid non-zero EVM address`);
+    }
+    return (0, ethers_1.getAddress)(candidate);
+};
+const assertExecutionSignerAddress = (actualAddress, expectedTaskAddress) => {
+    const actual = normalizedAddress(actualAddress, "execution signer");
+    if (expectedTaskAddress === undefined)
+        return actual;
+    const expected = normalizedAddress(expectedTaskAddress, "deployment signer address");
+    if (actual.toLowerCase() !== expected.toLowerCase()) {
+        throw new Error("execution signer does not match deployment signer address");
+    }
+    return actual;
+};
+exports.assertExecutionSignerAddress = assertExecutionSignerAddress;
+//# sourceMappingURL=signerIdentity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signerIdentity.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/signerIdentity.ts"],"names":[],"mappings":";;;AAAA,mCAA4D;AAE5D,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAA,kBAAS,EAAC,SAAS,CAAC,IAAI,IAAA,mBAAU,EAAC,SAAS,CAAC,KAAK,oBAAW,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uCAAuC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEK,MAAM,4BAA4B,GAAG,CAC1C,aAAqB,EACrB,mBAA4B,EACpB,EAAE;IACV,MAAM,MAAM,GAAG,iBAAiB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IACpE,IAAI,mBAAmB,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACrD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC;IACrF,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAXW,QAAA,4BAA4B,gCAWvC"}

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

@@ -0,0 +1,35 @@
+import { CapturedChainSnapshotV1, ForkSnapshotV1 } from "./forkSnapshot";
+export type WorkflowMode = "execute" | "simulate" | "verify";
+export interface SimulationFork {
+    snapshot?: ForkSnapshotV1;
+}
+type WithoutVersion<T> = T extends unknown ? Omit<T, "version"> : never;
+type ZkSyncForkSnapshot = Extract<ForkSnapshotV1, {
+    runner: {
+        kind: "anvil-zksync";
+    };
+}>;
+type EvmForkSnapshot = Exclude<ForkSnapshotV1, ZkSyncForkSnapshot>;
+export type SimulationForkEvidence = WithoutVersion<EvmForkSnapshot> | (WithoutVersion<ZkSyncForkSnapshot> & {
+    runnerProtocolVersion: number;
+});
+export declare const resolveWorkflowMode: (args: Record<string, string | boolean>) => WorkflowMode;
+interface SimulationInfrastructureTarget {
+    create2?: {
+        factory?: string;
+    };
+    multicall?: {
+        controlledMulticall?: string;
+    };
+    uups?: {
+        placeholderImplementation?: string;
+    };
+}
+export declare const assertCurrentStateInfrastructure: (targetId: string, target: SimulationInfrastructureTarget, snapshot: CapturedChainSnapshotV1 | undefined) => Promise<void>;
+export declare const assertSimulationSourceInfrastructure: (targetId: string, target: SimulationInfrastructureTarget, simulation: SimulationFork) => Promise<void>;
+export declare const assertCurrentStateUupsSourceState: (snapshot: CapturedChainSnapshotV1 | undefined, proxy: string) => Promise<void>;
+export declare const assertSimulationUupsSourceState: (simulation: SimulationFork, proxy: string) => Promise<void>;
+export declare const verifySimulationForkSnapshot: (simulation: SimulationFork) => Promise<void>;
+export declare const simulationForkEvidence: (simulation: SimulationFork) => SimulationForkEvidence | undefined;
+export declare const setupSimulationFork: (targetId: string) => Promise<SimulationFork>;
+export {};

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

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupSimulationFork = exports.simulationForkEvidence = exports.verifySimulationForkSnapshot = exports.assertSimulationUupsSourceState = exports.assertCurrentStateUupsSourceState = exports.assertSimulationSourceInfrastructure = exports.assertCurrentStateInfrastructure = exports.resolveWorkflowMode = void 0;
+const ethers_1 = require("ethers");
+const projectHardhat_1 = require("../../projectHardhat");
+const forkSnapshot_1 = require("./forkSnapshot");
+const erc1967_1 = require("./erc1967");
+const zksyncForkCapability_1 = require("./zksyncForkCapability");
+const zksyncForkRunner_1 = require("./zksyncForkRunner");
+const resolveWorkflowMode = (args) => {
+    const mode = typeof args.mode === "string" ? args.mode : "execute";
+    if (mode !== "execute"
+        && mode !== "simulate"
+        && mode !== "verify") {
+        throw new Error(`Unsupported workflow mode: ${mode}`);
+    }
+    return mode;
+};
+exports.resolveWorkflowMode = resolveWorkflowMode;
+const sourceProxyUrl = () => {
+    const value = process.env.GATE_SIMULATION_SOURCE_RPC_URL?.trim();
+    if (!value)
+        throw new Error("Simulation source-chain proxy URL is missing");
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error("Simulation source-chain proxy URL is invalid");
+    }
+    if (parsed.protocol !== "http:"
+        || parsed.hostname !== "127.0.0.1"
+        || !parsed.port
+        || parsed.pathname === "/"
+        || parsed.username
+        || parsed.password
+        || parsed.search
+        || parsed.hash) {
+        throw new Error("Simulation source-chain proxy must use a tokenized loopback URL");
+    }
+    return parsed.toString();
+};
+const rpcRequest = async (url, method, params) => {
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+        });
+    }
+    catch {
+        throw new Error(`Simulation source RPC ${method} request failed`);
+    }
+    if (!response.ok) {
+        throw new Error(`Simulation source RPC ${method} request failed`);
+    }
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        throw new Error(`Simulation source RPC ${method} returned invalid JSON`);
+    }
+    if (!body || typeof body !== "object" || Array.isArray(body)) {
+        throw new Error(`Simulation source RPC ${method} returned an invalid response`);
+    }
+    const envelope = body;
+    if (envelope.error !== undefined || envelope.result === undefined) {
+        throw new Error(`Simulation source RPC ${method} failed`);
+    }
+    return envelope.result;
+};
+const blockTag = (blockNumber) => `0x${blockNumber.toString(16)}`;
+const rpcQuantity = (value, label) => {
+    if (typeof value !== "string" || !/^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$/.test(value)) {
+        throw new Error(`${label} must be a canonical RPC quantity`);
+    }
+    const parsed = BigInt(value);
+    if (parsed > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error(`${label} exceeds the safe integer range`);
+    }
+    return Number(parsed);
+};
+const assertBlockHash = (block, snapshot, label) => {
+    if (!block || typeof block !== "object" || Array.isArray(block)) {
+        throw new Error(`${label} fork block is missing`);
+    }
+    const hash = block.hash;
+    if (typeof hash !== "string"
+        || hash.toLowerCase() !== snapshot.blockHash.toLowerCase()) {
+        throw new Error(`${label} fork block hash mismatch at ${snapshot.blockNumber}`);
+    }
+};
+const requiredInfrastructureAddress = (value, label) => {
+    if (!value || !(0, ethers_1.isAddress)(value)) {
+        throw new Error(`${label} must be configured as an EVM address for simulation`);
+    }
+    return value;
+};
+const assertCurrentStateInfrastructure = async (targetId, target, snapshot) => {
+    if (!snapshot)
+        return;
+    const infrastructure = [
+        {
+            label: "CREATE2 Factory",
+            address: requiredInfrastructureAddress(target.create2?.factory, "CREATE2 Factory"),
+        },
+        {
+            label: "Controlled Multicall",
+            address: requiredInfrastructureAddress(target.multicall?.controlledMulticall, "Controlled Multicall"),
+        },
+        {
+            label: "UUPS Placeholder",
+            address: requiredInfrastructureAddress(target.uups?.placeholderImplementation, "UUPS Placeholder"),
+        },
+    ];
+    const code = await Promise.all(infrastructure.map((entry) => (projectHardhat_1.ethers.provider.getCode(entry.address, snapshot.blockNumber))));
+    for (const [index, entry] of infrastructure.entries()) {
+        if (!code[index] || code[index] === "0x") {
+            throw new Error(`${entry.label} on ${targetId} captured block ${snapshot.blockNumber} is missing code at ${entry.address}`);
+        }
+    }
+};
+exports.assertCurrentStateInfrastructure = assertCurrentStateInfrastructure;
+const assertSimulationSourceInfrastructure = async (targetId, target, simulation) => (0, exports.assertCurrentStateInfrastructure)(targetId, target, simulation.snapshot);
+exports.assertSimulationSourceInfrastructure = assertSimulationSourceInfrastructure;
+const assertCurrentStateUupsSourceState = async (snapshot, proxy) => {
+    if (!snapshot)
+        return;
+    const [proxyCode, oldImplementation] = await Promise.all([
+        projectHardhat_1.ethers.provider.getCode(proxy, snapshot.blockNumber),
+        (0, erc1967_1.getERC1967Implementation)(projectHardhat_1.ethers.provider, proxy, snapshot.blockNumber),
+    ]);
+    if (!proxyCode || proxyCode === "0x") {
+        throw new Error(`UUPS proxy ${proxy} is missing code at captured block ${snapshot.blockNumber}`);
+    }
+    if (!oldImplementation) {
+        throw new Error(`UUPS proxy ${proxy} has no implementation at captured block ${snapshot.blockNumber}`);
+    }
+    const implementationCode = await projectHardhat_1.ethers.provider.getCode(oldImplementation, snapshot.blockNumber);
+    if (!implementationCode || implementationCode === "0x") {
+        throw new Error(`UUPS implementation ${oldImplementation} is missing code at captured block ${snapshot.blockNumber}`);
+    }
+};
+exports.assertCurrentStateUupsSourceState = assertCurrentStateUupsSourceState;
+const assertSimulationUupsSourceState = async (simulation, proxy) => (0, exports.assertCurrentStateUupsSourceState)(simulation.snapshot, proxy);
+exports.assertSimulationUupsSourceState = assertSimulationUupsSourceState;
+const verifySimulationForkSnapshot = async (simulation) => {
+    const snapshot = simulation.snapshot;
+    if (!snapshot)
+        return;
+    const [sourceBlock, localBlock, sourceZkSyncBlockDetails] = await Promise.all([
+        rpcRequest(sourceProxyUrl(), "eth_getBlockByNumber", [blockTag(snapshot.blockNumber), false]),
+        projectHardhat_1.network.provider.request({
+            method: "eth_getBlockByNumber",
+            params: [blockTag(snapshot.blockNumber), false],
+        }),
+        snapshot.runner.kind === "anvil-zksync"
+            ? rpcRequest(sourceProxyUrl(), "zks_getBlockDetails", [snapshot.blockNumber])
+            : Promise.resolve(undefined),
+    ]);
+    assertBlockHash(sourceBlock, snapshot, "Source-chain");
+    assertBlockHash(localBlock, snapshot, snapshot.runner.kind === "hardhat" ? "Local EVM" : "Local EraVM");
+    if (snapshot.runner.kind === "anvil-zksync"
+        && (0, forkSnapshot_1.isCapturedZkSyncChainSnapshot)(snapshot)) {
+        const metadata = (0, forkSnapshot_1.parseZkSyncBlockDetails)(sourceZkSyncBlockDetails, snapshot.blockNumber);
+        if (metadata.protocolVersion !== snapshot.protocolVersion
+            || metadata.l1BatchNumber !== snapshot.l1BatchNumber) {
+            throw new Error("Source-chain zkSync protocol metadata mismatch");
+        }
+    }
+};
+exports.verifySimulationForkSnapshot = verifySimulationForkSnapshot;
+const simulationForkEvidence = (simulation) => {
+    const snapshot = simulation.snapshot;
+    if (!snapshot)
+        return undefined;
+    if (snapshot.runner.kind === "anvil-zksync") {
+        if (!(0, forkSnapshot_1.isCapturedZkSyncChainSnapshot)(snapshot)) {
+            throw new Error("zkSync simulation snapshot is missing protocol metadata");
+        }
+        const capability = (0, zksyncForkCapability_1.resolveZkSyncForkCapability)(snapshot.protocolVersion);
+        if (!capability || capability.runner.version !== snapshot.runner.version) {
+            throw new Error(`zkSync protocol ${snapshot.protocolVersion} does not have an approved fork runner`);
+        }
+        return {
+            sourceNetwork: snapshot.sourceNetwork,
+            chainId: snapshot.chainId,
+            blockNumber: snapshot.blockNumber,
+            blockHash: snapshot.blockHash,
+            protocolVersion: snapshot.protocolVersion,
+            runnerProtocolVersion: capability.runnerProtocolVersion,
+            l1BatchNumber: snapshot.l1BatchNumber,
+            runner: { ...snapshot.runner },
+        };
+    }
+    return {
+        sourceNetwork: snapshot.sourceNetwork,
+        chainId: snapshot.chainId,
+        blockNumber: snapshot.blockNumber,
+        blockHash: snapshot.blockHash,
+        runner: { ...snapshot.runner },
+    };
+};
+exports.simulationForkEvidence = simulationForkEvidence;
+const setupSimulationFork = async (targetId) => {
+    const targetNetwork = projectHardhat_1.config.networks[targetId];
+    if (targetNetwork?.zksync === true) {
+        if (projectHardhat_1.network.name !== "zkFork"
+            || projectHardhat_1.network.config.zksync !== true) {
+            throw new Error(`zkSync target "${targetId}" requires the pinned EraVM fork network`);
+        }
+        const snapshot = (0, forkSnapshot_1.parseForkSnapshotJson)(process.env.GATE_SIMULATION_FORK_SNAPSHOT_JSON, targetId);
+        if (snapshot.runner.kind !== "anvil-zksync"
+            || !(0, forkSnapshot_1.isCapturedZkSyncChainSnapshot)(snapshot)) {
+            throw new Error(`zkSync target "${targetId}" requires an anvil-zksync fork snapshot`);
+        }
+        const approvedRunner = (0, zksyncForkRunner_1.resolveZkSyncForkRunner)(snapshot.protocolVersion);
+        if (!approvedRunner || snapshot.runner.version !== approvedRunner.version) {
+            throw new Error(`zkSync protocol ${snapshot.protocolVersion} does not have an approved fork runner`);
+        }
+        const [runtimeChainId, forkBlock] = await Promise.all([
+            projectHardhat_1.network.provider.request({ method: "eth_chainId", params: [] }),
+            projectHardhat_1.network.provider.request({
+                method: "eth_getBlockByNumber",
+                params: [blockTag(snapshot.blockNumber), false],
+            }),
+        ]);
+        if (typeof runtimeChainId !== "string"
+            || !/^0x[0-9a-fA-F]+$/.test(runtimeChainId)
+            || BigInt(runtimeChainId) !== BigInt(snapshot.chainId)) {
+            throw new Error(`EraVM simulation chainId does not match target chainId ${snapshot.chainId}`);
+        }
+        assertBlockHash(forkBlock, snapshot, "Local EraVM");
+        return { snapshot };
+    }
+    if (projectHardhat_1.network.name !== "hardhat") {
+        throw new Error("Simulation mode must run with --network hardhat");
+    }
+    if (targetId === "hardhat") {
+        return {};
+    }
+    const snapshot = (0, forkSnapshot_1.parseForkSnapshotJson)(process.env.GATE_SIMULATION_FORK_SNAPSHOT_JSON, targetId);
+    if (snapshot.runner.kind !== "hardhat") {
+        throw new Error(`EVM target "${targetId}" requires a Hardhat fork snapshot`);
+    }
+    const forkRpcUrl = sourceProxyUrl();
+    const sourceBlock = await rpcRequest(forkRpcUrl, "eth_getBlockByNumber", [blockTag(snapshot.blockNumber), false]);
+    assertBlockHash(sourceBlock, snapshot, "Source-chain");
+    await projectHardhat_1.network.provider.request({
+        method: "hardhat_reset",
+        params: [
+            {
+                forking: {
+                    jsonRpcUrl: forkRpcUrl,
+                    blockNumber: snapshot.blockNumber,
+                },
+            },
+        ],
+    });
+    const [runtimeChainId, forkBlock] = await Promise.all([
+        projectHardhat_1.network.provider.request({ method: "eth_chainId", params: [] }),
+        projectHardhat_1.network.provider.request({
+            method: "eth_getBlockByNumber",
+            params: [blockTag(snapshot.blockNumber), false],
+        }),
+    ]);
+    if (typeof runtimeChainId !== "string"
+        || !/^0x[0-9a-fA-F]+$/.test(runtimeChainId)
+        || BigInt(runtimeChainId) !== BigInt(snapshot.chainId)) {
+        throw new Error(`Simulation fork chainId does not match target chainId ${snapshot.chainId}`);
+    }
+    assertBlockHash(forkBlock, snapshot, "Local EVM");
+    await projectHardhat_1.network.provider.request({
+        method: "hardhat_mine",
+        params: ["0x1"],
+    });
+    return { snapshot };
+};
+exports.setupSimulationFork = setupSimulationFork;
+//# sourceMappingURL=simulation.js.map

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

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

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

@@ -0,0 +1,44 @@
+export interface SimulationCallerNetworkInput {
+    default: string;
+    steps?: Record<string, string>;
+}
+export interface SimulationCallersDocument {
+    version: 1;
+    networks: Record<string, SimulationCallerNetworkInput>;
+}
+export interface ResolvedSimulationCaller {
+    stepId: string;
+    callerAddress: string;
+    source: "step" | "network_default";
+}
+export interface SimulationCallerNetworkBinding {
+    network: string;
+    manifestHash: string;
+    defaultAddress: string;
+    resolved: ResolvedSimulationCaller[];
+    networkHash: string;
+}
+interface ManifestStepInput {
+    id: string;
+    kind: string;
+}
+export declare const parseSimulationCallersYaml: (text: string) => SimulationCallersDocument;
+export declare const validateSimulationCallersDocument: (input: {
+    document: SimulationCallersDocument;
+    targetNetworks: string[];
+    manifestSteps: ManifestStepInput[];
+}) => SimulationCallersDocument;
+export declare const buildSimulationCallerNetworkBinding: (input: {
+    document: SimulationCallersDocument;
+    network: string;
+    manifestText: string;
+    manifestSteps: ManifestStepInput[];
+}) => SimulationCallerNetworkBinding;
+export declare const loadSimulationCallerNetwork: (input: {
+    taskDir: string;
+    targetNetworks: string[];
+    network: string;
+    manifestText: string;
+    manifestSteps: ManifestStepInput[];
+}) => SimulationCallerNetworkBinding;
+export {};