movehat 0.1.8 → 0.2.0

package/dist/node/LocalNodeManager.js

@@ -1,6 +1,7 @@
-import { spawn } from "child_process";
 import { existsSync, rmSync } from "fs";
 import { join } from "path";
+import { defaultChildProcessAdapter, } from "../utils/childProcessAdapter.js";
+import { logger } from "../ui/index.js";
 /**
  * Manages the lifecycle of a local Movement node
  *
@@ -11,10 +12,13 @@ import { join } from "path";
  * - Cleanup on shutdown
  */
 export class LocalNodeManager {
-    process = null;
+    spawned = null;
+    killed = false;
     options;
+    adapter;
     starting = false;
     constructor(options = {}) {
+        this.adapter = options.adapter ?? defaultChildProcessAdapter;
         this.options = {
             testDir: options.testDir || join(process.cwd(), ".movehat", "local-node"),
             forceRestart: options.forceRestart ?? false,
@@ -30,7 +34,7 @@ export class LocalNodeManager {
      * @returns LocalNodeInfo with connection details
      */
     async start() {
-        if (this.process) {
+        if (this.spawned) {
             console.log("Local node already running");
             return this.getNodeInfo();
         }
@@ -39,14 +43,16 @@ export class LocalNodeManager {
         }
         this.starting = true;
         try {
-            console.log("\n🚀 Starting local Movement node...");
-            console.log(`   Test directory: ${this.options.testDir}`);
-            console.log(`   RPC port: ${this.options.apiPort}`);
-            console.log(`   Faucet port: ${this.options.faucetPort}`);
-            console.log(`   Ready port: ${this.options.readyPort}\n`);
+            logger.newline();
+            logger.step("Starting local Movement node...");
+            logger.plain(`   Test directory: ${this.options.testDir}`);
+            logger.plain(`   RPC port: ${this.options.apiPort}`);
+            logger.plain(`   Faucet port: ${this.options.faucetPort}`);
+            logger.plain(`   Ready port: ${this.options.readyPort}`);
+            logger.newline();
             // Clean state if force restart
             if (this.options.forceRestart && existsSync(this.options.testDir)) {
-                console.log("🧹 Cleaning previous node state...");
+                logger.step("Cleaning previous node state...");
                 rmSync(this.options.testDir, { recursive: true, force: true });
             }
             // Build command arguments
@@ -61,50 +67,53 @@ export class LocalNodeManager {
             if (this.options.forceRestart) {
                 args.push("--force-restart");
             }
-            // Start the node process
-            this.process = spawn("movement", args, {
+            // Start the node process via the injectable adapter.
+            this.killed = false;
+            this.spawned = this.adapter.spawn({
+                command: "movement",
+                args,
                 stdio: this.options.silent ? "ignore" : "pipe",
-                detached: false,
             });
             // Handle process output
-            if (!this.options.silent && this.process.stdout && this.process.stderr) {
-                this.process.stdout.on("data", (data) => {
+            if (!this.options.silent && this.spawned.stdout && this.spawned.stderr) {
+                this.spawned.stdout.on("data", (data) => {
                     const output = data.toString().trim();
                     if (output) {
                         console.log(`[Node] ${output}`);
                     }
                 });
-                this.process.stderr.on("data", (data) => {
+                this.spawned.stderr.on("data", (data) => {
                     const output = data.toString().trim();
                     if (output && !output.includes("WARN")) {
                         console.error(`[Node Error] ${output}`);
                     }
                 });
             }
-            // Handle process exit
-            this.process.on("exit", (code) => {
-                if (code !== 0 && code !== null) {
-                    console.error(`\n❌ Local node exited with code ${code}`);
+            // The adapter's `exited` promise settles on both natural exit and on
+            // spawn-time error (e.g. ENOENT). On error the code is `null` — we don't
+            // log a generic "spawn failed" message here because `waitForReady` will
+            // surface a detailed timeout-with-hints error if movement never starts.
+            void this.spawned.exited.then(({ code }) => {
+                if (code !== null && code !== 0) {
+                    logger.error(`Local node exited with code ${code}`);
                 }
-                this.process = null;
-            });
-            this.process.on("error", (error) => {
-                console.error(`\n❌ Failed to start local node: ${error.message}`);
-                this.process = null;
+                this.spawned = null;
             });
             // Wait for node to be ready
-            console.log("⏳ Waiting for node to be ready...");
+            logger.step("Waiting for node to be ready...");
             await this.waitForReady(60000); // 60 second timeout
-            console.log("✅ Local Movement node is ready!\n");
+            logger.success("Local Movement node is ready!");
+            logger.newline();
             this.starting = false;
             return this.getNodeInfo();
         }
         catch (error) {
             this.starting = false;
             // Cleanup on failure
-            if (this.process) {
-                this.process.kill();
-                this.process = null;
+            if (this.spawned) {
+                this.killed = true;
+                this.spawned.kill();
+                this.spawned = null;
             }
             throw error;
         }
@@ -113,36 +122,41 @@ export class LocalNodeManager {
      * Stop the local node
      */
     async stop() {
-        if (!this.process) {
+        if (!this.spawned) {
             return;
         }
-        console.log("\n🛑 Stopping local Movement node...");
-        return new Promise((resolve) => {
-            if (!this.process) {
-                resolve();
-                return;
+        logger.newline();
+        logger.step("Stopping local Movement node...");
+        const spawned = this.spawned;
+        // Mark killed synchronously so isRunning() reflects the intent right away,
+        // mirroring node's ChildProcess.killed semantics.
+        this.killed = true;
+        // Send SIGTERM for graceful shutdown
+        spawned.kill("SIGTERM");
+        // Force kill after 5 seconds if still running
+        const forceTimer = setTimeout(() => {
+            if (this.spawned === spawned) {
+                logger.warning("Force killing node...");
+                spawned.kill("SIGKILL");
             }
-            this.process.once("exit", () => {
-                console.log("✅ Local node stopped\n");
-                this.process = null;
-                resolve();
-            });
-            // Send SIGTERM for graceful shutdown
-            this.process.kill("SIGTERM");
-            // Force kill after 5 seconds if still running
-            setTimeout(() => {
-                if (this.process) {
-                    console.log("⚠️  Force killing node...");
-                    this.process.kill("SIGKILL");
-                }
-            }, 5000);
-        });
+        }, 5000);
+        try {
+            await spawned.exited;
+            logger.success("Local node stopped");
+            logger.newline();
+        }
+        finally {
+            clearTimeout(forceTimer);
+            if (this.spawned === spawned) {
+                this.spawned = null;
+            }
+        }
     }
     /**
      * Check if the node is running
      */
     isRunning() {
-        return this.process !== null && !this.process.killed;
+        return this.spawned !== null && !this.killed;
     }
     /**
      * Get node connection info
@@ -192,7 +206,7 @@ export class LocalNodeManager {
         const address = typeof account === 'string'
             ? account
             : account.accountAddress.toString();
-        // Use query parameters for Aptos/Movement faucet
+        // Use query parameters for the Movement faucet
         const faucetUrl = `http://127.0.0.1:${this.options.faucetPort}/mint?amount=${amount}&address=${address}`;
         try {
             const response = await fetch(faucetUrl, {
@@ -203,22 +217,25 @@ export class LocalNodeManager {
                 throw new Error(`Faucet request failed: ${errorText}`);
             }
             const result = await response.json();
-            console.log(`  ✓ Funded ${address} with ${amount} octas`);
+            logger.success(`Funded ${address} with ${amount} octas`, 2);
             return result;
         }
         catch (error) {
-            throw new Error(`Failed to fund account: ${error.message}`);
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to fund account: ${msg}`);
         }
     }
     /**
      * Fund multiple accounts in batch
      */
     async fundAccounts(accounts, amount = 100_000_000) {
-        console.log(`\n💰 Funding ${accounts.length} accounts from local faucet...`);
+        logger.newline();
+        logger.step(`Funding ${accounts.length} accounts from local faucet...`);
         for (const account of accounts) {
             await this.fundAccount(account, amount);
         }
-        console.log(`✓ All accounts funded successfully\n`);
+        logger.success("All accounts funded successfully");
+        logger.newline();
     }
     /**
      * Clean up node data directory
@@ -228,9 +245,9 @@ export class LocalNodeManager {
             throw new Error("Cannot clean while node is running. Stop the node first.");
         }
         if (existsSync(this.options.testDir)) {
-            console.log(`🧹 Cleaning node data at ${this.options.testDir}...`);
+            logger.step(`Cleaning node data at ${this.options.testDir}...`);
             rmSync(this.options.testDir, { recursive: true, force: true });
-            console.log("✓ Node data cleaned");
+            logger.success("Node data cleaned");
         }
     }
 }

package/dist/node/LocalNodeManager.js.map

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

package/dist/node/__tests__/LocalNodeManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LocalNodeManager.test.d.ts.map

package/dist/node/__tests__/LocalNodeManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalNodeManager.test.d.ts","sourceRoot":"","sources":["../../../src/node/__tests__/LocalNodeManager.test.ts"],"names":[],"mappings":""}

package/dist/node/__tests__/LocalNodeManager.test.js

@@ -0,0 +1,349 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { PassThrough } from "node:stream";
+import { mkdtempSync, rmSync, existsSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { LocalNodeManager } from "../LocalNodeManager.js";
+function buildFakeSpawned() {
+    const stdout = new PassThrough();
+    const stderr = new PassThrough();
+    const stdin = new PassThrough();
+    let exitResolve;
+    const exited = new Promise((resolve) => {
+        exitResolve = resolve;
+    });
+    let killed = false;
+    const proc = {
+        pid: 4242,
+        stdout,
+        stderr,
+        stdin,
+        kill: (_signal) => {
+            if (killed)
+                return false;
+            killed = true;
+            // Resolve `exited` shortly after kill so `stop()` doesn't hang.
+            setImmediate(() => exitResolve({ code: null, signal: _signal ?? "SIGTERM" }));
+            return true;
+        },
+        exited,
+        __exit: (code, signal) => exitResolve({ code, signal }),
+    };
+    return proc;
+}
+function buildFakeAdapter() {
+    const calls = [];
+    const spawned = [];
+    const adapter = {
+        run: vi.fn(),
+        spawn: (input) => {
+            calls.push(input);
+            const proc = buildFakeSpawned();
+            spawned.push(proc);
+            return proc;
+        },
+    };
+    return { adapter, calls, spawned };
+}
+function stubFetchOnce(response) {
+    const fn = vi.fn().mockResolvedValueOnce(response);
+    vi.stubGlobal("fetch", fn);
+    return fn;
+}
+function stubFetchAlwaysOk() {
+    const fn = vi.fn().mockResolvedValue({ ok: true, json: async () => ({}) });
+    vi.stubGlobal("fetch", fn);
+    return fn;
+}
+describe("LocalNodeManager — start / stop / lifecycle", () => {
+    let tmpDir;
+    let logSpy;
+    let errSpy;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "movehat-localnode-"));
+        // The logger prints to stdout/stderr; silence the noise for cleaner test output.
+        logSpy = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        errSpy = vi.spyOn(console, "error").mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+        if (existsSync(tmpDir)) {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it("constructs with sensible defaults from getNodeInfo", () => {
+        const { adapter } = buildFakeAdapter();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir });
+        const info = mgr.getNodeInfo();
+        expect(info.rpcUrl).toBe("http://127.0.0.1:8080");
+        expect(info.faucetUrl).toBe("http://127.0.0.1:8081");
+        expect(info.readyUrl).toBe("http://127.0.0.1:8070");
+        expect(info.testDir).toBe(tmpDir);
+    });
+    it("honors custom ports from constructor options", () => {
+        const { adapter } = buildFakeAdapter();
+        const mgr = new LocalNodeManager({
+            adapter,
+            testDir: tmpDir,
+            apiPort: 9000,
+            faucetPort: 9001,
+            readyPort: 9002,
+        });
+        const info = mgr.getNodeInfo();
+        expect(info.rpcUrl).toContain(":9000");
+        expect(info.faucetUrl).toContain(":9001");
+        expect(info.readyUrl).toContain(":9002");
+    });
+    it("isRunning reports false before start", () => {
+        const { adapter } = buildFakeAdapter();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir });
+        expect(mgr.isRunning()).toBe(false);
+    });
+    it("start spawns 'movement node run-localnet' with the expected args", async () => {
+        const { adapter, calls } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.command).toBe("movement");
+        const args = calls[0]?.args ?? [];
+        expect(args.slice(0, 2)).toEqual(["node", "run-localnet"]);
+        expect(args).toContain("--test-dir");
+        expect(args).toContain(tmpDir);
+        expect(args).toContain("--faucet-port");
+        expect(args).toContain("8081");
+        expect(args).toContain("--assume-yes");
+        expect(mgr.isRunning()).toBe(true);
+    });
+    it("start in silent mode does not wire stdout/stderr listeners", async () => {
+        const { adapter, spawned } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        // The PassThrough streams should have no `data` listeners attached
+        // when `silent: true` is set.
+        const proc = spawned[0];
+        expect(proc.stdout.listenerCount("data")).toBe(0);
+        expect(proc.stderr.listenerCount("data")).toBe(0);
+    });
+    it("start in non-silent mode wires stdout/stderr listeners that log events", async () => {
+        const { adapter, spawned } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: false });
+        await mgr.start();
+        const proc = spawned[0];
+        expect(proc.stdout.listenerCount("data")).toBeGreaterThan(0);
+        expect(proc.stderr.listenerCount("data")).toBeGreaterThan(0);
+        // Drive a line through stdout — the manager's listener forwards to console.log.
+        proc.stdout.emit("data", Buffer.from("local node ready\n"));
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining("local node ready"));
+        // stderr non-WARN line goes through console.error.
+        proc.stderr.emit("data", Buffer.from("real error\n"));
+        expect(errSpy).toHaveBeenCalledWith(expect.stringContaining("real error"));
+        // stderr WARN line should be filtered (no error log).
+        errSpy.mockClear();
+        proc.stderr.emit("data", Buffer.from("WARN something\n"));
+        expect(errSpy).not.toHaveBeenCalledWith(expect.stringContaining("WARN"));
+    });
+    it("force-restart cleans the test directory before spawn", async () => {
+        const { adapter } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const planted = join(tmpDir, "stale-file.txt");
+        // Create a stale file to prove the cleanup actually removes it.
+        mkdirSync(tmpDir, { recursive: true });
+        require("node:fs").writeFileSync(planted, "stale");
+        expect(existsSync(planted)).toBe(true);
+        const mgr = new LocalNodeManager({
+            adapter,
+            testDir: tmpDir,
+            forceRestart: true,
+            silent: true,
+        });
+        await mgr.start();
+        expect(existsSync(planted)).toBe(false);
+    });
+    it("force-restart appends --force-restart to the CLI args", async () => {
+        const { adapter, calls } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({
+            adapter,
+            testDir: tmpDir,
+            forceRestart: true,
+            silent: true,
+        });
+        await mgr.start();
+        expect(calls[0]?.args).toContain("--force-restart");
+    });
+    it("calling start twice returns the same node info (idempotent)", async () => {
+        const { adapter, calls } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        const info1 = await mgr.start();
+        const info2 = await mgr.start();
+        expect(info2).toEqual(info1);
+        expect(calls).toHaveLength(1);
+    });
+    it("stop signals SIGTERM and clears the spawned handle", async () => {
+        const { adapter, spawned } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        const killSpy = vi.spyOn(spawned[0], "kill");
+        await mgr.stop();
+        expect(killSpy).toHaveBeenCalledWith("SIGTERM");
+        expect(mgr.isRunning()).toBe(false);
+    });
+    it("stop is a no-op when no node is running", async () => {
+        const { adapter } = buildFakeAdapter();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir });
+        // Should not throw.
+        await mgr.stop();
+        expect(mgr.isRunning()).toBe(false);
+    });
+    it("clean refuses while the node is running", async () => {
+        const { adapter } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        await expect(mgr.clean()).rejects.toThrow(/Cannot clean while node is running/);
+    });
+    it("clean removes the test directory after stop", async () => {
+        const { adapter } = buildFakeAdapter();
+        stubFetchAlwaysOk();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        await mgr.stop();
+        expect(existsSync(tmpDir)).toBe(true);
+        await mgr.clean();
+        expect(existsSync(tmpDir)).toBe(false);
+    });
+    it("clean is a no-op when the test directory doesn't exist", async () => {
+        const { adapter } = buildFakeAdapter();
+        const missing = join(tmpDir, "never-created");
+        const mgr = new LocalNodeManager({ adapter, testDir: missing });
+        // Should not throw.
+        await mgr.clean();
+    });
+});
+describe("LocalNodeManager — start failure paths", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "movehat-localnode-"));
+        vi.spyOn(console, "log").mockImplementation(() => undefined);
+        vi.spyOn(console, "error").mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+        if (existsSync(tmpDir))
+            rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("waitForReady timeout surfaces a clear error AND cleans up the spawn", async () => {
+        const { adapter, spawned } = buildFakeAdapter();
+        // Always-failing fetch — node never becomes ready.
+        vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new Error("ECONNREFUSED")));
+        vi.useFakeTimers();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        // Attach the .catch handler synchronously so the eventual rejection
+        // never lands as an unhandled promise. vi.advanceTimersByTimeAsync
+        // drives the waitForReady loop forward; we then await the captured
+        // error and assert on it.
+        let captured;
+        const startPromise = mgr.start().catch((e) => {
+            captured = e;
+        });
+        // Drive the 60s timeout forward — each loop iteration does fetch +
+        // sleep(1000). Advance well past 60 000 ms.
+        await vi.advanceTimersByTimeAsync(61_000);
+        await startPromise;
+        expect(captured).toBeInstanceOf(Error);
+        expect(captured.message).toMatch(/did not become ready/);
+        // The spawn handle must have been killed in the catch arm.
+        expect(spawned[0]).toBeDefined();
+        expect(mgr.isRunning()).toBe(false);
+        vi.useRealTimers();
+    });
+});
+describe("LocalNodeManager — fundAccount", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "movehat-localnode-"));
+        vi.spyOn(console, "log").mockImplementation(() => undefined);
+        vi.spyOn(console, "error").mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+        if (existsSync(tmpDir))
+            rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("rejects when called before the node is running", async () => {
+        const { adapter } = buildFakeAdapter();
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir });
+        await expect(mgr.fundAccount("0xabc", 100)).rejects.toThrow(/Local node is not running/);
+    });
+    it("posts to the faucet endpoint and returns the parsed JSON on success", async () => {
+        const { adapter } = buildFakeAdapter();
+        // First fetch = ready check; subsequent = faucet mint.
+        const fetchFn = vi.fn();
+        fetchFn.mockResolvedValueOnce({ ok: true }); // waitForReady
+        fetchFn.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ txn_hashes: ["0xdeadbeef"] }),
+        }); // faucet
+        vi.stubGlobal("fetch", fetchFn);
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        const addr = "0x" + "1".repeat(64);
+        const result = await mgr.fundAccount(addr, 12345);
+        expect(result).toEqual({ txn_hashes: ["0xdeadbeef"] });
+        const faucetCall = fetchFn.mock.calls[1];
+        expect(faucetCall[0]).toContain("/mint?amount=12345&address=" + addr);
+        expect(faucetCall[1]?.method).toBe("POST");
+    });
+    it("rethrows a clear error when the faucet returns non-ok", async () => {
+        const { adapter } = buildFakeAdapter();
+        const fetchFn = vi.fn();
+        fetchFn.mockResolvedValueOnce({ ok: true }); // waitForReady
+        fetchFn.mockResolvedValueOnce({
+            ok: false,
+            text: async () => "out of funds",
+            json: async () => ({}),
+        });
+        vi.stubGlobal("fetch", fetchFn);
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        await expect(mgr.fundAccount("0xabc", 100)).rejects.toThrow(/Failed to fund account.*out of funds/);
+    });
+    it("fundAccount accepts an Account-like object by reading accountAddress.toString()", async () => {
+        const { adapter } = buildFakeAdapter();
+        const fetchFn = vi.fn();
+        fetchFn.mockResolvedValueOnce({ ok: true }); // waitForReady
+        fetchFn.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({}),
+        });
+        vi.stubGlobal("fetch", fetchFn);
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        const fakeAccount = {
+            accountAddress: { toString: () => "0xfeedbeef" },
+        }; // exercises the typeof-not-string branch
+        await mgr.fundAccount(fakeAccount, 100);
+        expect(fetchFn.mock.calls[1][0]).toContain("address=0xfeedbeef");
+    });
+    it("fundAccounts iterates and funds each account in turn", async () => {
+        const { adapter } = buildFakeAdapter();
+        const fetchFn = vi.fn();
+        fetchFn.mockResolvedValueOnce({ ok: true }); // waitForReady
+        fetchFn.mockResolvedValue({ ok: true, json: async () => ({}) });
+        vi.stubGlobal("fetch", fetchFn);
+        const mgr = new LocalNodeManager({ adapter, testDir: tmpDir, silent: true });
+        await mgr.start();
+        await mgr.fundAccounts(["0x1", "0x2", "0x3"], 100);
+        // 1 ready + 3 mint calls = 4 total.
+        expect(fetchFn.mock.calls.length).toBeGreaterThanOrEqual(4);
+    });
+});
+//# sourceMappingURL=LocalNodeManager.test.js.map