movehat 0.2.4 → 0.2.5

package/src/harness/codeObject.ts

@@ -1,381 +0,0 @@
-import { PrivateKey, PrivateKeyVariants } from "@aptos-labs/ts-sdk";
-import type { MovehatRuntime } from "../types/runtime.js";
-import type {
-  DeployCodeObjectOptions,
-  UpgradeCodeObjectOptions,
-  CodeObjectInfo,
-} from "../types/harness.js";
-import { extractNamedAddresses } from "../commands/compile.js";
-import {
-  saveDeployment,
-  loadDeployment,
-  validateSafeName,
-  type DeploymentInfo,
-} from "../core/deployments.js";
-import { validatePathSafety } from "../core/shell.js";
-import {
-  CliExecutionError,
-  ModuleAlreadyDeployedError,
-  PostPublishError,
-} from "../errors.js";
-import { runCli } from "../utils/runCli.js";
-import { parseTxHash } from "../utils/parseCliOutput.js";
-import { logger, isVerbose } from "../ui/index.js";
-import {
-  writeTempKeyFile,
-  removeKeyFile,
-  removeKeyFileSyncBestEffort,
-  ensureSignalHandler,
-  cleanupCallbacks,
-} from "../core/movementProfile.js";
-
-/**
- * Deploy a Move package as a code object via `movement move deploy-object`.
- *
- * Mirrors `core/Publisher.deploy` exactly for the security-critical parts
- * (per-deploy unique profile, atomic ~/.aptos/config.yaml mutation under
- * the shared mutex, SIGINT-safe sync cleanup, stderr redaction via
- * `runCli`). The only differences are:
- *
- *   1. CLI subcommand: `deploy-object` instead of `publish` + a required
- *      `--address-name <moduleName>` flag that binds the derived object
- *      address to the package's named-address slot.
- *   2. `DeploymentInfo.address` is the derived **object address** parsed
- *      from CLI output, not the deployer's account address.
- *
- * @internal — called from `Harness.deployCodeObject`.
- */
-export async function deployCodeObject(
-  runtime: MovehatRuntime,
-  options: DeployCodeObjectOptions
-): Promise<CodeObjectInfo> {
-  return executeMovementMoveObject({
-    runtime,
-    moduleName: options.moduleName,
-    addressName: options.addressName,
-    packageDir: options.packageDir,
-    namedAddresses: options.namedAddresses,
-    includedArtifacts: options.includedArtifacts,
-    adapter: options.adapter,
-    subcommand: "deploy-object",
-    extraArgs: [],
-    checkIdempotency: true,
-  });
-}
-
-/**
- * Upgrade an existing code object via `movement move upgrade-object`.
- *
- * Requires {@link UpgradeCodeObjectOptions.objectAddress} — the address
- * of the existing on-chain object. The local `DeploymentInfo` record
- * for `moduleName` is overwritten with a new timestamp + txHash; the
- * address stays the same.
- *
- * @internal — called from `Harness.upgradeCodeObject`.
- */
-export async function upgradeCodeObject(
-  runtime: MovehatRuntime,
-  options: UpgradeCodeObjectOptions
-): Promise<CodeObjectInfo> {
-  if (!options.objectAddress) {
-    throw new Error(
-      "Harness.upgradeCodeObject requires options.objectAddress (the existing object's address)."
-    );
-  }
-  return executeMovementMoveObject({
-    runtime,
-    moduleName: options.moduleName,
-    addressName: options.addressName,
-    packageDir: options.packageDir,
-    namedAddresses: options.namedAddresses,
-    includedArtifacts: options.includedArtifacts,
-    adapter: options.adapter,
-    subcommand: "upgrade-object",
-    extraArgs: ["--object-address", options.objectAddress],
-    checkIdempotency: false,
-    fixedAddress: options.objectAddress,
-  });
-}
-
-interface ExecuteOptions {
-  runtime: MovehatRuntime;
-  moduleName: string;
-  /**
-   * Move.toml named address for the `--address-name` CLI flag.
-   * Defaults to `moduleName` when undefined.
-   */
-  addressName?: string | undefined;
-  packageDir?: string | undefined;
-  namedAddresses?: Record<string, string> | undefined;
-  includedArtifacts?: "none" | "sparse" | "all" | undefined;
-  adapter?: import("../utils/childProcessAdapter.js").ChildProcessAdapter | undefined;
-  subcommand: "deploy-object" | "upgrade-object";
-  extraArgs: readonly string[];
-  /** Whether to throw `ModuleAlreadyDeployedError` if a record exists. */
-  checkIdempotency: boolean;
-  /**
-   * For upgrade-object: the object's existing address. Skips the parse-
-   * from-stdout step (the address is known up front).
-   */
-  fixedAddress?: string;
-}
-
-async function executeMovementMoveObject(
-  opts: ExecuteOptions
-): Promise<CodeObjectInfo> {
-  const { runtime, moduleName, subcommand } = opts;
-  const config = runtime.config;
-  const account = runtime.account;
-
-  validateSafeName(moduleName, "module");
-
-  // Idempotency: deploy-object refuses re-deploy unless MH_CLI_REDEPLOY=true.
-  // Upgrade does not check this (the whole point is to overwrite).
-  const forceRedeploy = process.env.MH_CLI_REDEPLOY === "true";
-  if (opts.checkIdempotency) {
-    const existing = loadDeployment(config.network, moduleName);
-    if (existing && !forceRedeploy) {
-      const errorDetails = [
-        `Module "${moduleName}" is already deployed on ${config.network}`,
-        `Address: ${existing.address}`,
-        `Deployed at: ${new Date(existing.timestamp).toLocaleString()}`,
-        existing.txHash ? `Transaction: ${existing.txHash}` : null,
-        `\nTo redeploy, set MH_CLI_REDEPLOY=true or call harness.upgradeCodeObject({ objectAddress: "${existing.address}", ... }).`,
-      ]
-        .filter(Boolean)
-        .join("\n");
-
-      logger.error(
-        `Module "${moduleName}" is already deployed on ${config.network}`
-      );
-      logger.plain(`   Address: ${existing.address}`);
-      logger.plain(
-        `   Deployed at: ${new Date(existing.timestamp).toLocaleString()}`
-      );
-      if (existing.txHash) logger.plain(`   Transaction: ${existing.txHash}`);
-      logger.newline();
-
-      throw new ModuleAlreadyDeployedError(
-        errorDetails,
-        moduleName,
-        config.network,
-        existing.address,
-        existing.timestamp,
-        existing.txHash
-      );
-    }
-  }
-
-  const dir = opts.packageDir || config.moveDir;
-  const safeDir = validatePathSafety(dir, "package directory");
-
-  logger.step(
-    `${subcommand === "deploy-object" ? "Deploying" : "Upgrading"} module "${moduleName}" from ${dir}...`
-  );
-
-  try {
-    const deployerAddress = account.accountAddress.toString();
-
-    // Build named-addresses arg: auto-detected names from Move sources
-    // are bound to the deployer's address (Publisher convention).
-    // Caller-supplied `namedAddresses` overlay on top.
-    const detectedAddresses = extractNamedAddresses(dir);
-    const addrMap = new Map<string, string>();
-    for (const name of detectedAddresses) addrMap.set(name, deployerAddress);
-    if (opts.namedAddresses) {
-      for (const [k, v] of Object.entries(opts.namedAddresses)) addrMap.set(k, v);
-    }
-    const namedAddrArgs: string[] =
-      addrMap.size > 0
-        ? [
-            "--named-addresses",
-            Array.from(addrMap.entries())
-              .map(([k, v]) => `${k}=${v}`)
-              .join(","),
-          ]
-        : [];
-
-    // Build step (same as Publisher — produces the bytecode the
-    // subcommand will publish/upgrade).
-    logger.step("Building package...");
-    const buildResult = await runCli(
-      {
-        command: "movement",
-        args: ["move", "build", "--package-dir", safeDir, ...namedAddrArgs],
-        timeoutMs: 120000,
-      },
-      { adapter: opts.adapter }
-    );
-    if (isVerbose() && buildResult.stdout) logger.info(buildResult.stdout.trim(), 2);
-
-    // Format the private key into AIP-80 shape so the Movement CLI
-    // doesn't emit its raw-hex deprecation warning. `formatPrivateKey`
-    // is idempotent for already-prefixed inputs.
-    const formattedPrivateKey = PrivateKey.formatPrivateKey(
-      config.privateKey,
-      PrivateKeyVariants.Ed25519,
-    );
-
-    // Pass the private key via a 0o600 temp file (--private-key-file)
-    // and the on-chain address via --sender-account. This avoids the
-    // CLI's profile-yaml lookup entirely — no CWD / HOME / .aptos /
-    // .movement dance, no CLI-variant dependency.
-    const keyFilePath = writeTempKeyFile(formattedPrivateKey);
-
-    // Register SIGINT-safe sync cleanup BEFORE invoking the CLI so
-    // the private key never persists on disk after an abnormal exit.
-    // The signal-handler path uses the best-effort variant because the
-    // event loop is dead and we cannot logger.warning.
-    ensureSignalHandler();
-    const syncCleanup = () => removeKeyFileSyncBestEffort(keyFilePath);
-    cleanupCallbacks.add(syncCleanup);
-
-    let deployOut = "";
-    try {
-      logger.step(
-        `Running 'movement move ${subcommand}'${subcommand === "upgrade-object" ? "" : " (this may take a moment)"}...`
-      );
-      const includedArtifacts: ("--included-artifacts" | string)[] =
-        opts.includedArtifacts
-          ? ["--included-artifacts", opts.includedArtifacts]
-          : [];
-      const result = await runCli(
-        {
-          command: "movement",
-          args: [
-            "move",
-            subcommand,
-            "--address-name",
-            opts.addressName ?? moduleName,
-            "--package-dir",
-            safeDir,
-            "--url",
-            config.rpc,
-            "--private-key-file",
-            keyFilePath,
-            "--sender-account",
-            deployerAddress,
-            "--assume-yes",
-            ...includedArtifacts,
-            ...namedAddrArgs,
-            ...opts.extraArgs,
-          ],
-          timeoutMs: 180000, // 3 min — deploy-object can be slow with chunked publishing.
-        },
-        { adapter: opts.adapter }
-      );
-      deployOut = result.stdout;
-      // Both streams gated behind isVerbose(); see §9 — stream channel
-      // is not by itself a failure signal. Real failures throw via
-      // CliExecutionError and are surfaced from the catch below.
-      if (isVerbose() && result.stdout) logger.info(result.stdout.trim(), 2);
-      if (isVerbose() && result.stderr) logger.info(result.stderr.trim(), 2);
-    } finally {
-      // Unlink via the observable helper — emit a warning if the file
-      // could not be removed AND still exists on disk (private key
-      // would persist silently otherwise). ENOENT and races are
-      // treated as benign success.
-      const cleanupErr = removeKeyFile(keyFilePath);
-      if (cleanupErr) {
-        logger.warning(
-          `Failed to remove temp key file '${keyFilePath}': ${cleanupErr.message}. ` +
-            `The file has mode 0o600 but should be removed manually: rm ${keyFilePath}`
-        );
-      }
-      cleanupCallbacks.delete(syncCleanup);
-    }
-
-    // Parse object address (for deploy-object) and txHash (both flows).
-    const objectAddress = opts.fixedAddress ?? parseObjectAddress(deployOut);
-    const txHash = parseTxHash(deployOut);
-
-    if (!objectAddress) {
-      throw new Error(
-        `Could not parse object address from '${subcommand}' output. ` +
-          `Expected a line containing 'object address 0x...' or a JSON ` +
-          `'Result' block with an 'object_address' field. Captured stdout:\n${deployOut.slice(0, 1000)}`
-      );
-    }
-
-    logger.success(
-      `${subcommand === "deploy-object" ? "Module deployed" : "Module upgraded"} successfully!`
-    );
-
-    // Publish/upgrade succeeded. Everything below this point that throws
-    // is a local-side bookkeeping failure, not an on-chain failure.
-
-    const deployment: DeploymentInfo = {
-      address: objectAddress,
-      moduleName,
-      network: config.network,
-      deployer: deployerAddress,
-      timestamp: Date.now(),
-      ...(txHash !== undefined ? { txHash } : {}),
-    };
-
-    try {
-      saveDeployment(deployment);
-    } catch (error) {
-      const err = error instanceof Error ? error : new Error(String(error));
-      throw new PostPublishError(
-        `Module "${moduleName}" ${subcommand === "deploy-object" ? "deployed" : "upgraded"} to ${deployment.address} ` +
-          `but local deployment record could not be written: ${err.message}`,
-        deployment,
-        err
-      );
-    }
-
-    return deployment;
-  } catch (error) {
-    if (error instanceof PostPublishError) {
-      logger.warning(
-        `Module ${subcommand === "deploy-object" ? "deployed" : "upgraded"} successfully to ${error.deployment.address} ` +
-          `(tx=${error.deployment.txHash ?? "unknown"}) but local deployment record could not be written.`
-      );
-      logger.warning(`   Cause: ${error.cause.message}`);
-      logger.warning(
-        `   To recover, manually write the deployment to deployments/${error.deployment.network}/${error.deployment.moduleName}.json.`
-      );
-      throw error;
-    }
-    if (error instanceof CliExecutionError) {
-      if (error.stdoutPreview) logger.info(error.stdoutPreview, 2);
-      logger.error(
-        `Failed to ${subcommand === "deploy-object" ? "deploy" : "upgrade"} module: ${error.message}\n${error.stderr}`
-      );
-    } else {
-      const err = error instanceof Error ? error : new Error(String(error));
-      logger.error(
-        `Failed to ${subcommand === "deploy-object" ? "deploy" : "upgrade"} module: ${err.message}`
-      );
-    }
-    throw error;
-  }
-}
-
-/**
- * Extract a code-object address from `movement move deploy-object` stdout.
- *
- * Movement CLI typically emits the address in one of these shapes:
- *
- *   - Free text: `Code was successfully deployed to object address 0x…`
- *   - Free text: `Object address: 0x…`
- *   - JSON `Result` block with `"object_address": "0x…"`
- *
- * Falls through the patterns in order. Returns `undefined` on no match.
- */
-function parseObjectAddress(stdout: string): string | undefined {
-  // Pattern 1: phrase-context match.
-  const phraseMatch = stdout.match(
-    /object\s+address[:\s]+\b(0x[a-fA-F0-9]{1,64})\b/i
-  );
-  if (phraseMatch?.[1]) return phraseMatch[1];
-
-  // Pattern 2: JSON-shaped key.
-  const jsonMatch = stdout.match(
-    /"object_address"\s*:\s*"(0x[a-fA-F0-9]{1,64})"/
-  );
-  if (jsonMatch?.[1]) return jsonMatch[1];
-
-  return undefined;
-}

package/src/harness/errors.ts

@@ -1,22 +0,0 @@
-/**
- * Thrown synchronously when any method other than `cleanup` is invoked
- * on a Harness instance whose `cleanup()` has already run.
- *
- * The throw happens on property access (Proxy `get` trap), not after the
- * async method body. That means `await harness.deployCodeObject(...)`
- * throws *before* the call site awaits — callers can use a plain
- * `try`/`catch` or rely on the rejected promise; either form will fire.
- */
-export class HarnessDisposedError extends Error {
-  constructor(public readonly methodName: string) {
-    super(
-      `Harness is disposed; call to '${methodName}' is not allowed. ` +
-        `Create a new Harness via Harness.createLocal/createFork/createLive instead.`
-    );
-    this.name = "HarnessDisposedError";
-
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, HarnessDisposedError);
-    }
-  }
-}

package/src/harness/index.ts

@@ -1,3 +0,0 @@
-export { Harness } from "./Harness.js";
-export type { HarnessMode } from "./Harness.js";
-export { HarnessDisposedError } from "./errors.js";

package/src/harness/proxy.ts

@@ -1,40 +0,0 @@
-import { HarnessDisposedError } from "./errors.js";
-
-/**
- * Names of Harness methods that must throw `HarnessDisposedError`
- * synchronously once the harness has been disposed (via `cleanup()`).
- *
- * Properties NOT in this set — `cleanup`, `mode`, `poisoned`, the runtime
- * accessors, well-known Symbols, and the promise-protocol hooks
- * (`then`/`catch`/`finally`) — always pass through. That keeps:
- *  - `await harness` from breaking on `.then` access
- *  - debug tools (`console.log`, `util.inspect`) from throwing
- *  - idempotent `cleanup()` callable post-poisoning
- *
- * New Harness methods that should fail post-cleanup MUST be added here.
- */
-const POISONED_METHODS: ReadonlySet<string> = new Set([
-  "deployCodeObject",
-  "upgradeCodeObject",
-  "runViewFunction",
-  "runMoveScript",
-]);
-
-/**
- * Wrap a Harness instance in a Proxy that throws `HarnessDisposedError`
- * synchronously on access to any method in {@link POISONED_METHODS} once
- * `isPoisoned()` returns true.
- */
-export function createHarnessProxy<T extends object>(
-  target: T,
-  isPoisoned: () => boolean
-): T {
-  return new Proxy(target, {
-    get(obj, prop, receiver) {
-      if (typeof prop === "string" && POISONED_METHODS.has(prop) && isPoisoned()) {
-        throw new HarnessDisposedError(prop);
-      }
-      return Reflect.get(obj, prop, receiver);
-    },
-  });
-}

package/src/harness/script.ts

@@ -1,200 +0,0 @@
-import { existsSync } from "fs";
-import { extname } from "path";
-import { PrivateKey, PrivateKeyVariants } from "@aptos-labs/ts-sdk";
-import type { MovehatRuntime } from "../types/runtime.js";
-import type {
-  RunMoveScriptOptions,
-  MoveScriptResult,
-} from "../types/harness.js";
-import { validatePathSafety } from "../core/shell.js";
-import { CliExecutionError } from "../errors.js";
-import { runCli } from "../utils/runCli.js";
-import { parseTxHash } from "../utils/parseCliOutput.js";
-import { logger, isVerbose } from "../ui/index.js";
-import {
-  writeTempKeyFile,
-  removeKeyFile,
-  removeKeyFileSyncBestEffort,
-  ensureSignalHandler,
-  cleanupCallbacks,
-} from "../core/movementProfile.js";
-
-/**
- * Execute a Move script via `movement move run-script`.
- *
- * Auto-detects the script kind from the extension:
- *   - `.move` source → `--script-path` (CLI compiles inline)
- *   - `.mv` compiled bytecode → `--compiled-script-path`
- *
- * Reuses Publisher's security model via the shared `movementProfile`
- * helpers: per-invocation temp key file (0o600), SIGINT-safe sync
- * cleanup, `--private-key-file` auth (key never appears in `ps`
- * output or in the user's `~/.aptos/config.yaml`).
- *
- * Returns {@link MoveScriptResult}. `txHash` is guaranteed; `success`
- * and `vmStatus` are best-effort parsed from the CLI's Result JSON.
- *
- * @internal — called from `Harness.runMoveScript`.
- */
-export async function runMoveScript(
-  runtime: MovehatRuntime,
-  options: RunMoveScriptOptions
-): Promise<MoveScriptResult> {
-  const config = runtime.config;
-  const account = runtime.account;
-
-  // Synchronous validation before any CLI call.
-  if (!options.scriptPath || typeof options.scriptPath !== "string") {
-    throw new Error(
-      "Harness.runMoveScript requires options.scriptPath (string path to .move or .mv)."
-    );
-  }
-  const ext = extname(options.scriptPath).toLowerCase();
-  let scriptFlag: "--script-path" | "--compiled-script-path";
-  if (ext === ".move") {
-    scriptFlag = "--script-path";
-  } else if (ext === ".mv") {
-    scriptFlag = "--compiled-script-path";
-  } else {
-    throw new Error(
-      `Harness.runMoveScript: unsupported script extension '${ext || "<none>"}'. ` +
-        `Expected '.move' (source — CLI auto-compiles) or '.mv' (pre-compiled bytecode).`
-    );
-  }
-  if (!existsSync(options.scriptPath)) {
-    throw new Error(
-      `Harness.runMoveScript: script not found at '${options.scriptPath}'.`
-    );
-  }
-
-  const safeScriptPath = validatePathSafety(options.scriptPath, "script path");
-
-  logger.step(
-    `Running Move script '${options.scriptPath}' on ${config.network}...`
-  );
-
-  try {
-    const deployerAddress = account.accountAddress.toString();
-
-    // Format the private key into AIP-80 shape before writing to the
-    // temp key file. `formatPrivateKey` is idempotent for already-
-    // prefixed inputs.
-    const formattedPrivateKey = PrivateKey.formatPrivateKey(
-      config.privateKey,
-      PrivateKeyVariants.Ed25519,
-    );
-
-    // Pass the private key via a 0o600 temp file (--private-key-file)
-    // and the on-chain address via --sender-account. Avoids the CLI's
-    // profile-yaml lookup chain entirely (no CWD / HOME / .aptos /
-    // .movement dance, no CLI-variant dependency).
-    const keyFilePath = writeTempKeyFile(formattedPrivateKey);
-
-    // SIGINT-safe sync cleanup BEFORE the CLI call so the private key
-    // never persists on disk after an abnormal exit. The signal-handler
-    // path uses the best-effort variant because the event loop is dead
-    // and we cannot logger.warning.
-    ensureSignalHandler();
-    const syncCleanup = () => removeKeyFileSyncBestEffort(keyFilePath);
-    cleanupCallbacks.add(syncCleanup);
-
-    let scriptOut = "";
-    try {
-      const typeArgsFragment: string[] =
-        options.typeArgs && options.typeArgs.length > 0
-          ? ["--type-args", ...options.typeArgs]
-          : [];
-      const argsFragment: string[] =
-        options.args && options.args.length > 0
-          ? ["--args", ...options.args]
-          : [];
-
-      const result = await runCli(
-        {
-          command: "movement",
-          args: [
-            "move",
-            "run-script",
-            "--private-key-file",
-            keyFilePath,
-            "--sender-account",
-            deployerAddress,
-            "--url",
-            config.rpc,
-            "--assume-yes",
-            scriptFlag,
-            safeScriptPath,
-            ...typeArgsFragment,
-            ...argsFragment,
-          ],
-          timeoutMs: 120000,
-        },
-        { adapter: options.adapter }
-      );
-      scriptOut = result.stdout;
-      // Both streams gated behind isVerbose(); Movement CLI uses
-      // stderr for progress messages too. Real failures throw via
-      // CliExecutionError and are surfaced from the catch below.
-      if (isVerbose() && result.stdout) logger.info(result.stdout.trim(), 2);
-      if (isVerbose() && result.stderr) logger.info(result.stderr.trim(), 2);
-    } finally {
-      // Observable cleanup — emit a warning if the unlink failed and
-      // the file is still on disk (private key would persist silently
-      // otherwise).
-      const cleanupErr = removeKeyFile(keyFilePath);
-      if (cleanupErr) {
-        logger.warning(
-          `Failed to remove temp key file '${keyFilePath}': ${cleanupErr.message}. ` +
-            `The file has mode 0o600 but should be removed manually: rm ${keyFilePath}`
-        );
-      }
-      cleanupCallbacks.delete(syncCleanup);
-    }
-
-    const txHash = parseTxHash(scriptOut);
-    if (!txHash) {
-      throw new Error(
-        `Could not parse transaction hash from 'move run-script' output. ` +
-          `Captured stdout:\n${scriptOut.slice(0, 1000)}`
-      );
-    }
-
-    const success = parseSuccess(scriptOut);
-    const vmStatus = parseVmStatus(scriptOut);
-
-    logger.success(`Move script executed (tx ${txHash}).`);
-
-    const out: MoveScriptResult = { txHash };
-    if (success !== undefined) out.success = success;
-    if (vmStatus !== undefined) out.vmStatus = vmStatus;
-    return out;
-  } catch (error) {
-    if (error instanceof CliExecutionError) {
-      if (error.stdoutPreview) logger.info(error.stdoutPreview, 2);
-      logger.error(`Failed to run Move script: ${error.message}\n${error.stderr}`);
-    } else {
-      const err = error instanceof Error ? error : new Error(String(error));
-      logger.error(`Failed to run Move script: ${err.message}`);
-    }
-    throw error;
-  }
-}
-
-/**
- * Best-effort parse of the `"success": true|false` field from
- * Movement CLI's Result JSON block. Returns `undefined` on no match.
- */
-function parseSuccess(stdout: string): boolean | undefined {
-  const m = stdout.match(/"success"\s*:\s*(true|false)/);
-  if (!m) return undefined;
-  return m[1] === "true";
-}
-
-/**
- * Best-effort parse of the `"vm_status"` string. Returns `undefined`
- * on no match.
- */
-function parseVmStatus(stdout: string): string | undefined {
-  const m = stdout.match(/"vm_status"\s*:\s*"([^"]*)"/);
-  return m?.[1];
-}

package/src/harness/view.ts

@@ -1,34 +0,0 @@
-import type { MoveFunctionId } from "@aptos-labs/ts-sdk";
-import type { MovehatRuntime } from "../types/runtime.js";
-import type { RunViewFunctionOptions } from "../types/harness.js";
-
-/**
- * Execute a Move view function via the Aptos SDK (no CLI invocation).
- *
- * Returns the SDK's raw `unknown[]` — the Move boundary may return a
- * tuple of any arity. Callers destructure:
- *
- * ```ts
- * const [count] = await harness.runViewFunction({
- *   function: "0xCAFE::counter::get",
- *   functionArguments: ["0xdeployer"],
- * });
- * ```
- *
- * Works on all 3 harness modes (createLocal, createFork, createLive) —
- * view functions read on-chain state without writing.
- *
- * @internal — called from `Harness.runViewFunction`.
- */
-export async function runViewFunction(
-  runtime: MovehatRuntime,
-  options: RunViewFunctionOptions
-): Promise<unknown[]> {
-  return runtime.aptos.view({
-    payload: {
-      function: options.function as MoveFunctionId,
-      typeArguments: options.typeArguments ?? [],
-      functionArguments: (options.functionArguments ?? []) as never[],
-    },
-  });
-}