gate-evm-tools 1.0.26 → 1.0.27

package/dist-runtime/workflow/importState.js

@@ -0,0 +1,193 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ethers_1 = require("ethers");
+const config_1 = require("./lib/config");
+const migrationState_1 = require("./lib/migrationState");
+const erc1967_1 = require("./lib/erc1967");
+const parseArgs = (argv) => {
+    const parsed = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const item = argv[index];
+        if (!item.startsWith("--"))
+            throw new Error(`Unsupported argument: ${item}`);
+        const equalIndex = item.indexOf("=");
+        const key = item.slice(2, equalIndex > 2 ? equalIndex : undefined);
+        const inlineValue = equalIndex > 2 ? item.slice(equalIndex + 1) : undefined;
+        const next = argv[index + 1];
+        const value = inlineValue ?? (next && !next.startsWith("--") ? next : "true");
+        if (inlineValue === undefined && next && !next.startsWith("--"))
+            index += 1;
+        (parsed[key] ||= []).push(value);
+    }
+    return parsed;
+};
+const singleArg = (args, key, options = {}) => {
+    const values = args[key] || [];
+    if (values.length > 1)
+        throw new Error(`--${key} may be provided only once`);
+    const value = values[0]?.trim();
+    if (options.required && (!value || value === "true")) {
+        throw new Error(`--${key} is required`);
+    }
+    return value && value !== "true" ? value : undefined;
+};
+const confinedPlanPath = (root, requested) => {
+    return (0, migrationState_1.resolveConfinedMigrationPath)(root, requested, {
+        label: "Migration plan",
+        requireFile: true,
+    });
+};
+const commandName = (command) => (process.platform === "win32" ? `${command}.cmd` : command);
+const main = async () => {
+    const args = parseArgs(process.argv.slice(2));
+    const root = path_1.default.resolve(singleArg(args, "root") || process.cwd());
+    const planPath = confinedPlanPath(root, singleArg(args, "plan", { required: true }));
+    const plan = (0, migrationState_1.validateMigrationStatePlan)((0, config_1.readJsonFile)(planPath));
+    const confirmations = Object.keys(plan.networks).sort().map((network) => ({
+        network,
+        token: (0, migrationState_1.migrationConfirmationToken)(plan, network),
+    }));
+    if (args["print-confirmations"]?.length) {
+        console.log(JSON.stringify({ migrationId: plan.migrationId, confirmations }, null, 2));
+        return;
+    }
+    process.env.GATE_MIGRATION_READ_ONLY = "1";
+    const { artifacts, config: hardhatConfig, ethers: hardhatEthers, network: hardhatNetwork, run: hardhatRun, } = await Promise.resolve().then(() => __importStar(require("../projectHardhat")));
+    const workflowConfig = (0, config_1.loadConfig)(root);
+    const rpcProviders = new Map();
+    const providerFor = (networkName) => {
+        if (networkName === hardhatNetwork.name)
+            return hardhatEthers.provider;
+        const existing = rpcProviders.get(networkName);
+        if (existing)
+            return existing;
+        const networkConfig = hardhatConfig.networks[networkName];
+        if (!networkConfig || !("url" in networkConfig) || typeof networkConfig.url !== "string") {
+            throw new Error(`Hardhat network ${networkName} does not define an HTTP RPC URL`);
+        }
+        const provider = new ethers_1.JsonRpcProvider(networkConfig.url);
+        rpcProviders.set(networkName, provider);
+        return provider;
+    };
+    const inspect = async (networkName, contract) => {
+        const provider = providerFor(networkName);
+        const chainId = Number((await provider.getNetwork()).chainId);
+        const implementationAddress = await (0, erc1967_1.getERC1967Implementation)(provider, contract.address);
+        const adminAddress = implementationAddress
+            ? await (0, erc1967_1.getERC1967Admin)(provider, contract.address)
+            : undefined;
+        const proxyKind = implementationAddress
+            ? (adminAddress ? "transparent" : "uups")
+            : "none";
+        const contractCode = await provider.getCode(contract.address);
+        const implementationCode = implementationAddress
+            ? await provider.getCode(implementationAddress)
+            : undefined;
+        let artifactExists = true;
+        try {
+            await artifacts.readArtifact(contract.actualContract);
+        }
+        catch {
+            artifactExists = false;
+        }
+        return {
+            chainId,
+            hasCode: contractCode !== "0x"
+                && (implementationCode === undefined || implementationCode !== "0x"),
+            artifactExists,
+            proxyKind,
+            ...(implementationAddress ? { implementationAddress } : {}),
+            address: contract.address,
+        };
+    };
+    await hardhatRun("compile", { quiet: true });
+    try {
+        const evidence = await (0, migrationState_1.importMigrationState)({
+            root,
+            plan,
+            targets: workflowConfig,
+            confirmations: args.confirm || [],
+            inspect,
+            verifyCandidate: async (contractInfo) => {
+                const checkRoot = fs_1.default.mkdtempSync(path_1.default.join(root, ".gate-migration-check-"));
+                const candidatePath = path_1.default.join(checkRoot, "contractInfo.json");
+                const reportPath = path_1.default.join(checkRoot, "bytecode-check.json");
+                try {
+                    (0, config_1.writeJsonFile)(candidatePath, contractInfo);
+                    const result = (0, child_process_1.spawnSync)(commandName("npx"), [
+                        "--no-install",
+                        "gate-tool",
+                        "check",
+                        "--config",
+                        candidatePath,
+                        "--output",
+                        reportPath,
+                    ], {
+                        cwd: root,
+                        env: process.env,
+                        stdio: "inherit",
+                    });
+                    return (0, migrationState_1.resolveGateToolCandidateCheck)(result, reportPath);
+                }
+                finally {
+                    fs_1.default.rmSync(checkRoot, { recursive: true, force: true });
+                }
+            },
+        });
+        console.log(JSON.stringify({
+            status: evidence.status,
+            migrationId: evidence.migrationId,
+            planHash: evidence.planHash,
+            evidencePath: `scripts/migrations/${evidence.migrationId}/state-import.json`,
+        }));
+    }
+    finally {
+        for (const provider of rpcProviders.values())
+            provider.destroy();
+    }
+};
+void main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    console.error("Use --print-confirmations with the same --plan before importing state.");
+    process.exitCode = 1;
+});
+//# sourceMappingURL=importState.js.map

package/dist-runtime/workflow/importState.js.map

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

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

@@ -0,0 +1,28 @@
+import type { BaseContract } from "ethers";
+import { TargetConfig } from "./config";
+export interface AuthorityDecision {
+    mode: "execute" | "calldata";
+    signer: string;
+    configuredAdmin: string;
+    chainAdmin?: string;
+    executor?: string;
+    reason: string;
+}
+export declare const assertSelectedSimulationSignerAuthorized: (decision: AuthorityDecision, stepId: string) => void;
+interface ControlledMulticallAuthorityContract {
+    callers: (caller: string, overrides?: {
+        blockTag: number;
+    }) => Promise<boolean>;
+    factoryCallers: (factory: string, caller: string, overrides?: {
+        blockTag: number;
+    }) => Promise<boolean>;
+    owner?: (overrides?: {
+        blockTag: number;
+    }) => Promise<unknown>;
+    admin?: (overrides?: {
+        blockTag: number;
+    }) => Promise<unknown>;
+}
+export declare const decideControlledMulticallAuthority: (contract: ControlledMulticallAuthorityContract, factory: string, target: TargetConfig, signerAddress: string, blockTag?: number) => Promise<AuthorityDecision>;
+export declare const decideAuthority: (contract: BaseContract, target: TargetConfig, signerAddress: string, blockTag?: number) => Promise<AuthorityDecision>;
+export {};

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

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideAuthority = exports.decideControlledMulticallAuthority = exports.assertSelectedSimulationSignerAuthorized = void 0;
+const ethers_1 = require("ethers");
+const config_1 = require("./config");
+const assertSelectedSimulationSignerAuthorized = (decision, stepId) => {
+    if (decision.mode === "execute")
+        return;
+    const requiredExecutor = decision.executor || decision.configuredAdmin;
+    throw new Error(`selected simulation signer is not authorized for step ${stepId}; required executor ${requiredExecutor}`);
+};
+exports.assertSelectedSimulationSignerAuthorized = assertSelectedSimulationSignerAuthorized;
+const readChainAdmin = async (contract, blockTag) => {
+    const callable = contract;
+    for (const methodName of ["owner", "admin"]) {
+        const method = callable[methodName];
+        if (typeof method !== "function")
+            continue;
+        try {
+            const value = await method(...(blockTag === undefined ? [] : [{ blockTag }]));
+            if (typeof value === "string" && (0, ethers_1.isAddress)(value)) {
+                return (0, ethers_1.getAddress)(value);
+            }
+        }
+        catch {
+            // Some proxy admin methods intentionally revert for non-admin callers.
+        }
+    }
+    return undefined;
+};
+const decideControlledMulticallAuthority = async (contract, factory, target, signerAddress, blockTag) => {
+    const normalizedSignerAddress = (0, ethers_1.getAddress)(signerAddress);
+    const normalizedFactory = (0, ethers_1.getAddress)(factory);
+    let callerAllowed;
+    let factoryAllowed;
+    try {
+        [callerAllowed, factoryAllowed] = await Promise.all([
+            blockTag === undefined
+                ? contract.callers(normalizedSignerAddress)
+                : contract.callers(normalizedSignerAddress, { blockTag }),
+            blockTag === undefined
+                ? contract.factoryCallers(normalizedFactory, normalizedSignerAddress)
+                : contract.factoryCallers(normalizedFactory, normalizedSignerAddress, { blockTag }),
+        ]);
+    }
+    catch (error) {
+        throw new Error("Cannot determine controlled multicall authority: "
+            + (error instanceof Error ? error.message : String(error)));
+    }
+    const configuredAdmin = (0, config_1.resolveAdmin)(target, normalizedSignerAddress);
+    const chainAdmin = await readChainAdmin(contract, blockTag);
+    if (callerAllowed && factoryAllowed) {
+        return {
+            mode: "execute",
+            signer: normalizedSignerAddress,
+            configuredAdmin,
+            chainAdmin,
+            reason: "operator has controlled multicall caller and factory authority",
+        };
+    }
+    const explicitConfiguredAdmin = typeof target.admin === "string" && (0, ethers_1.isAddress)(target.admin)
+        ? (0, ethers_1.getAddress)(target.admin)
+        : undefined;
+    const executor = chainAdmin || explicitConfiguredAdmin;
+    if (!executor || executor.toLowerCase() === normalizedSignerAddress.toLowerCase()) {
+        throw new Error("Controlled multicall permissions are missing and cannot resolve an external executor");
+    }
+    return {
+        mode: "calldata",
+        signer: normalizedSignerAddress,
+        configuredAdmin,
+        chainAdmin,
+        executor,
+        reason: [
+            "controlled multicall authority requires external execution",
+            callerAllowed ? undefined : "caller permission missing",
+            factoryAllowed ? undefined : "factory caller permission missing",
+        ].filter(Boolean).join("; "),
+    };
+};
+exports.decideControlledMulticallAuthority = decideControlledMulticallAuthority;
+const decideAuthority = async (contract, target, signerAddress, blockTag) => {
+    const normalizedSignerAddress = (0, ethers_1.getAddress)(signerAddress);
+    const configuredAdmin = (0, config_1.resolveAdmin)(target, normalizedSignerAddress);
+    const chainAdmin = await readChainAdmin(contract, blockTag);
+    if (chainAdmin) {
+        if (chainAdmin.toLowerCase() === normalizedSignerAddress.toLowerCase()) {
+            return {
+                mode: "execute",
+                signer: normalizedSignerAddress,
+                configuredAdmin,
+                chainAdmin,
+                reason: "signer is chain admin",
+            };
+        }
+        return {
+            mode: "calldata",
+            signer: normalizedSignerAddress,
+            configuredAdmin,
+            chainAdmin,
+            executor: chainAdmin,
+            reason: "signer is not chain admin",
+        };
+    }
+    if (configuredAdmin.toLowerCase() !== normalizedSignerAddress.toLowerCase()) {
+        return {
+            mode: "calldata",
+            signer: normalizedSignerAddress,
+            configuredAdmin,
+            executor: configuredAdmin,
+            reason: "configured admin differs from signer",
+        };
+    }
+    return {
+        mode: "execute",
+        signer: normalizedSignerAddress,
+        configuredAdmin,
+        reason: "no chain admin check available",
+    };
+};
+exports.decideAuthority = decideAuthority;
+//# sourceMappingURL=authority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/authority.ts"],"names":[],"mappings":";;;AACA,mCAA+C;AAC/C,qCAAsD;AAW/C,MAAM,wCAAwC,GAAG,CACtD,QAA2B,EAC3B,MAAc,EACR,EAAE;IACR,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO;IACxC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,eAAe,CAAC;IACvE,MAAM,IAAI,KAAK,CACb,yDAAyD,MAAM,uBAAuB,gBAAgB,EAAE,CACzG,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,wCAAwC,4CASnD;AAEF,MAAM,cAAc,GAAG,KAAK,EAC1B,QAAsB,EACtB,QAAiB,EACY,EAAE;IAC/B,MAAM,QAAQ,GAAG,QAA8C,CAAC;IAEhE,KAAK,MAAM,UAAU,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,SAAS;QAE3C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAO,MAAmD,CACtE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAClD,CAAC;YACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,kBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,OAAO,IAAA,mBAAU,EAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;QACzE,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAaK,MAAM,kCAAkC,GAAG,KAAK,EACrD,QAA8C,EAC9C,OAAe,EACf,MAAoB,EACpB,aAAqB,EACrB,QAAiB,EACW,EAAE;IAC9B,MAAM,uBAAuB,GAAG,IAAA,mBAAU,EAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,aAAsB,CAAC;IAC3B,IAAI,cAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAClD,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC;gBAC3C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;YAC3D,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;gBACrE,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mDAAmD;cACjD,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,qBAAY,EAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAmC,EAAE,QAAQ,CAAC,CAAC;IACvF,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,uBAAuB;YAC/B,eAAe;YACf,UAAU;YACV,MAAM,EAAE,gEAAgE;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,uBAAuB,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAA,kBAAS,EAAC,MAAM,CAAC,KAAK,CAAC;QACzF,CAAC,CAAC,IAAA,mBAAU,EAAC,MAAM,CAAC,KAAK,CAAC;QAC1B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,QAAQ,GAAG,UAAU,IAAI,uBAAuB,CAAC;IACvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAAC,WAAW,EAAE,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,uBAAuB;QAC/B,eAAe;QACf,UAAU;QACV,QAAQ;QACR,MAAM,EAAE;YACN,4DAA4D;YAC5D,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAA2B;YACvD,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mCAAmC;SACjE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC,CAAC;AA5DW,QAAA,kCAAkC,sCA4D7C;AAEK,MAAM,eAAe,GAAG,KAAK,EAClC,QAAsB,EACtB,MAAoB,EACpB,aAAqB,EACrB,QAAiB,EACW,EAAE;IAC9B,MAAM,uBAAuB,GAAG,IAAA,mBAAU,EAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,IAAA,qBAAY,EAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5D,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAAC,WAAW,EAAE,EAAE,CAAC;YACvE,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,uBAAuB;gBAC/B,eAAe;gBACf,UAAU;gBACV,MAAM,EAAE,uBAAuB;aAChC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,uBAAuB;YAC/B,eAAe;YACf,UAAU;YACV,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,2BAA2B;SACpC,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5E,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,uBAAuB;YAC/B,eAAe;YACf,QAAQ,EAAE,eAAe;YACzB,MAAM,EAAE,sCAAsC;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,uBAAuB;QAC/B,eAAe;QACf,MAAM,EAAE,gCAAgC;KACzC,CAAC;AACJ,CAAC,CAAC;AA/CW,QAAA,eAAe,mBA+C1B"}

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

@@ -0,0 +1,2 @@
+import { Interface } from "ethers";
+export declare const encodeCall: (contractInterface: Interface, method: string, args: unknown[]) => string;

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeCall = void 0;
+const encodeCall = (contractInterface, method, args) => {
+    return contractInterface.encodeFunctionData(method, args);
+};
+exports.encodeCall = encodeCall;
+//# sourceMappingURL=calldata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calldata.js","sourceRoot":"","sources":["../../../runtime/workflow/lib/calldata.ts"],"names":[],"mappings":";;;AAEO,MAAM,UAAU,GAAG,CACxB,iBAA4B,EAC5B,MAAc,EACd,IAAe,EACP,EAAE;IACV,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB"}

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

@@ -0,0 +1,23 @@
+import type { BaseContract } from "ethers";
+import { WorkflowStep } from "./parameters";
+import type { WorkflowContext } from "../run";
+export interface ContractCall {
+    method: string;
+    args?: unknown[];
+    value?: string | number;
+    expect?: unknown;
+}
+export interface ResolvedContract {
+    contractName: string;
+    abiName: string;
+    address: string;
+    contract: BaseContract;
+}
+export declare const resolveContract: (context: WorkflowContext, step: WorkflowStep) => Promise<ResolvedContract>;
+export declare const resolveStepCalls: (step: WorkflowStep) => ContractCall[];
+export declare const resolveCallArgs: (context: WorkflowContext, call: ContractCall) => unknown[];
+export declare const stringifyCallResult: (value: unknown) => string;
+export declare const normalizeCallValue: (value: unknown) => string;
+export declare const runContractWriteCalls: (context: WorkflowContext, step: WorkflowStep) => Promise<void>;
+export declare const runContractViewCalls: (context: WorkflowContext, step: WorkflowStep) => Promise<void>;
+export declare const runContractCheckCalls: (context: WorkflowContext, step: WorkflowStep) => Promise<void>;