moonwall 1.0.0-dev.0

package/dist/foundations/dev/helpers.js

@@ -0,0 +1,161 @@
+import { alith, createAndFinalizeBlock, customWeb3Request, generateKeyringPair, } from "../../util/index.js";
+import { Keyring } from "@polkadot/api";
+import chalk from "chalk";
+import { createLogger } from "../../util/index.js";
+import { setTimeout } from "node:timers/promises";
+import { getEnvironmentFromConfig, isEthereumDevConfig } from "../../services/config/index.js";
+import { extractError } from "../../api/testing/events.js";
+import { MoonwallContext } from "../../cli/lib/globalContext.js";
+import { vitestAutoUrl } from "../../cli/internal/providerFactories.js";
+const logger = createLogger({ name: "DevTest" });
+const debug = logger.debug.bind(logger);
+export async function getDevProviderPath() {
+    const env = getEnvironmentFromConfig();
+    return env.connections
+        ? env.connections[0].endpoints[0].replace("ws://", "http://")
+        : vitestAutoUrl();
+}
+function returnSigner(options) {
+    return options.signer && "privateKey" in options.signer && "type" in options.signer
+        ? generateKeyringPair(options.signer.type, options.signer.privateKey)
+        : options.signer;
+}
+function returnDefaultSigner() {
+    return isEthereumDevConfig()
+        ? alith
+        : new Keyring({ type: "sr25519" }).addFromUri("//Alice", {
+            name: "Alice default",
+        });
+}
+export async function createDevBlock(context, options, transactions) {
+    const containsViem = !!(context.isEthereumChain &&
+        context.viem() &&
+        (await MoonwallContext.getContext()).providers.find((prov) => prov.type === "viem"));
+    const api = context.polkadotJs();
+    const originalBlockNumber = (await api.rpc.chain.getHeader()).number.toBigInt();
+    const signer = options.signer ? returnSigner(options) : returnDefaultSigner();
+    const results = [];
+    const txs = !transactions ? [] : Array.isArray(transactions) ? transactions : [transactions];
+    for await (const call of txs) {
+        if (typeof call === "string") {
+            // Ethereum
+            results.push({
+                type: "eth",
+                hash: containsViem
+                    ? (await context.viem().request({
+                        method: "eth_sendRawTransaction",
+                        params: [call],
+                    })).result
+                    : (await customWeb3Request(context.web3(), "eth_sendRawTransaction", [call]))
+                        .result,
+            });
+        }
+        else if (call.isSigned) {
+            const tx = api.tx(call);
+            debug(`- Signed: ${tx.method.section}.${tx.method.method}(${tx.args
+                .map((d) => d.toHuman())
+                .join("; ")}) [ nonce: ${tx.nonce}]`);
+            results.push({
+                type: "sub",
+                hash: (await call.send()).toString(),
+            });
+        }
+        else {
+            const tx = api.tx(call);
+            debug(`- Unsigned: ${tx.method.section}.${tx.method.method}(${tx.args
+                .map((d) => d.toHuman())
+                .join("; ")}) [ nonce: ${tx.nonce}]`);
+            results.push({
+                type: "sub",
+                hash: (await call.signAndSend(signer)).toString(),
+            });
+        }
+    }
+    const { parentHash, finalize } = options;
+    const blockResult = await createAndFinalizeBlock(api, parentHash, finalize);
+    // No need to extract events if no transactions
+    if (results.length === 0) {
+        return {
+            block: blockResult,
+        };
+    }
+    const allRecords = (await (await api.at(blockResult.hash)).query.system.events());
+    const blockData = await api.rpc.chain.getBlock(blockResult.hash);
+    const getExtIndex = (records, result) => {
+        if (result.type === "eth") {
+            const res = records
+                .find(({ phase, event: { section, method, data } }) => phase.isApplyExtrinsic &&
+                section === "ethereum" &&
+                method === "Executed" &&
+                data[2].toString() === result.hash)
+                ?.phase?.asApplyExtrinsic?.toString();
+            return typeof res === "undefined" ? undefined : Number(res);
+        }
+        return blockData.block.extrinsics.findIndex((ext) => ext.hash.toHex() === result.hash);
+    };
+    const result = results.map((result) => {
+        const extrinsicIndex = getExtIndex(allRecords, result);
+        const extrinsicFound = typeof extrinsicIndex !== "undefined";
+        // We retrieve the events associated with the extrinsic
+        const events = allRecords.filter(({ phase }) => phase.isApplyExtrinsic && Number(phase.asApplyExtrinsic.toString()) === extrinsicIndex);
+        const failure = extractError(events);
+        return {
+            extrinsic: extrinsicFound ? blockData.block.extrinsics[extrinsicIndex] : null,
+            events,
+            error: failure &&
+                ((failure.isModule && api.registry.findMetaError(failure.asModule)) ||
+                    { name: failure.toString() }),
+            successful: extrinsicFound && !failure,
+            hash: result.hash,
+        };
+    });
+    if (results.find((res) => res.type === "eth")) {
+        // Wait until new block is actually created
+        // max wait 2s
+        for (let i = 0; i < 1000; i++) {
+            const currentBlock = (await api.rpc.chain.getHeader()).number.toBigInt();
+            await setTimeout(30);
+            if (currentBlock > originalBlockNumber) {
+                break;
+            }
+        }
+    }
+    const actualEvents = result.flatMap((resp) => resp.events);
+    if (options.expectEvents && options.expectEvents.length > 0) {
+        const match = options.expectEvents.every((eEvt) => {
+            const found = actualEvents
+                .map((aEvt) => eEvt.is(aEvt.event))
+                .reduce((acc, curr) => acc || curr, false);
+            if (!found) {
+                const message = `Event ${chalk.bgWhiteBright.blackBright(eEvt.meta.name)} not present in block`;
+                if (options.logger) {
+                    // Handle both pino Logger (has .error) and LogFn (callable)
+                    if ("error" in options.logger) {
+                        options.logger.error(message);
+                    }
+                    else {
+                        options.logger(message);
+                    }
+                }
+                else {
+                    console.error(message);
+                }
+            }
+            return found;
+        });
+        if (!match) {
+            throw new Error("Expected events not present in block");
+        }
+    }
+    if (!options.allowFailures) {
+        for (const event of actualEvents) {
+            if (api.events.system.ExtrinsicFailed.is(event.event)) {
+                throw new Error("ExtrinsicFailed event detected, enable 'allowFailures' if this is expected.");
+            }
+        }
+    }
+    return {
+        block: blockResult,
+        result: Array.isArray(transactions) ? result : result[0],
+    };
+}

package/dist/foundations/read-only/handler.d.ts

@@ -0,0 +1,3 @@
+import type { FoundationHandler } from "../../api/types/index.js";
+export declare const readOnlyHandler: FoundationHandler<"read_only">;
+//# sourceMappingURL=handler.d.ts.map

package/dist/foundations/read-only/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/foundations/read-only/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iCAAiC;AAGlE,eAAO,MAAM,eAAe,EAAE,iBAAiB,CAAC,WAAW,CA2C1D,CAAC"}

package/dist/foundations/read-only/handler.js

@@ -0,0 +1,32 @@
+import { MoonwallContext } from "../../cli/lib/globalContext.js";
+export const readOnlyHandler = ({ testCases, context, testCase, logger, }) => {
+    testCases({
+        context: {
+            ...context,
+            waitBlock: async (blocksToWaitFor = 1, chainName, mode = "quantity") => {
+                const ctx = await MoonwallContext.getContext();
+                const provider = chainName
+                    ? ctx.providers.find((prov) => prov.name === chainName && prov.type === "polkadotJs")
+                    : ctx.providers.find((prov) => prov.type === "polkadotJs");
+                if (!provider) {
+                    throw new Error("No PolkadotJs api found in provider config");
+                }
+                const api = provider.api;
+                const currentBlockNumber = (await api.rpc.chain.getBlock()).block.header.number.toNumber();
+                for (;;) {
+                    await new Promise((resolve) => setTimeout(resolve, 100));
+                    const newBlockNumber = (await api.rpc.chain.getBlock()).block.header.number.toNumber();
+                    if (mode === "quantity" && newBlockNumber >= currentBlockNumber + blocksToWaitFor) {
+                        break;
+                    }
+                    if (mode === "height" && newBlockNumber >= blocksToWaitFor) {
+                        break;
+                    }
+                }
+            },
+        },
+        it: testCase,
+        log: logger.info.bind(logger),
+        logger,
+    });
+};

package/dist/foundations/zombie/handler.d.ts

@@ -0,0 +1,3 @@
+import type { FoundationHandler } from "../../api/types/index.js";
+export declare const zombieHandler: FoundationHandler<"zombie">;
+//# sourceMappingURL=handler.d.ts.map

package/dist/foundations/zombie/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/foundations/zombie/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,iCAAiC;AAOtF,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,QAAQ,CA8GrD,CAAC"}

package/dist/foundations/zombie/handler.js

@@ -0,0 +1,92 @@
+import { upgradeRuntime } from "../../cli/lib/upgradeProcedures.js";
+import { MoonwallContext } from "../../cli/lib/globalContext.js";
+import { alith } from "../../util/index.js";
+import { sendIpcMessage } from "./helpers.js";
+export const zombieHandler = ({ testCases, context, testCase, logger, }) => {
+    testCases({
+        context: {
+            ...context,
+            waitBlock: async (blocksToWaitFor = 1, chain = "parachain", mode = "quantity") => {
+                const ctx = await MoonwallContext.getContext();
+                const provider = ctx.providers.find((prov) => prov.name === chain);
+                if (!provider) {
+                    throw new Error(`Provider '${chain}' not found`);
+                }
+                const api = provider.api;
+                const currentBlockNumber = (await api.rpc.chain.getBlock()).block.header.number.toNumber();
+                for (;;) {
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                    const newBlockNumber = (await api.rpc.chain.getBlock()).block.header.number.toNumber();
+                    if (mode === "quantity" && newBlockNumber >= currentBlockNumber + blocksToWaitFor) {
+                        break;
+                    }
+                    if (mode === "height" && newBlockNumber >= blocksToWaitFor) {
+                        break;
+                    }
+                }
+            },
+            upgradeRuntime: async (options = {}) => {
+                const ctx = await MoonwallContext.getContext();
+                if (!ctx.rtUpgradePath) {
+                    throw new Error("Runtime upgrade path not defined in moonwall config");
+                }
+                const provider = ctx.providers.find((prov) => prov.name === "parachain");
+                if (!provider) {
+                    throw new Error(`Provider 'parachain' not found`);
+                }
+                const api = provider.api;
+                const params = {
+                    runtimeName: options.runtimeName || "moonbase",
+                    runtimeTag: options.runtimeTag || "local",
+                    localPath: options.localPath || ctx.rtUpgradePath,
+                    upgradeMethod: options.upgradeMethod || "Sudo",
+                    waitMigration: options.waitMigration || true,
+                    from: options.from || alith,
+                };
+                if (options.logger) {
+                    params.logger = options.logger;
+                }
+                await upgradeRuntime(api, params);
+            },
+            restartNode: async (nodeName) => {
+                await sendIpcMessage({
+                    text: `Restarting node ${nodeName}`,
+                    cmd: "restart",
+                    nodeName: nodeName,
+                });
+            },
+            pauseNode: async (nodeName) => {
+                await sendIpcMessage({
+                    text: `Pausing node ${nodeName}`,
+                    cmd: "pause",
+                    nodeName: nodeName,
+                });
+            },
+            resumeNode: async (nodeName) => {
+                await sendIpcMessage({
+                    text: `Resuming node ${nodeName}`,
+                    cmd: "resume",
+                    nodeName: nodeName,
+                });
+            },
+            killNode: async (nodeName) => {
+                await sendIpcMessage({
+                    text: `Killing node ${nodeName}`,
+                    cmd: "kill",
+                    nodeName: nodeName,
+                });
+            },
+            isUp: async (nodeName) => {
+                const response = await sendIpcMessage({
+                    text: `Checking if node ${nodeName} is up`,
+                    cmd: "isup",
+                    nodeName: nodeName,
+                });
+                return response.status === "success";
+            },
+        },
+        it: testCase,
+        log: logger.info.bind(logger),
+        logger,
+    });
+};

package/dist/foundations/zombie/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { LaunchConfig } from "@zombienet/orchestrator";
+export declare function checkZombieBins(config: LaunchConfig): Promise<void>;
+export declare function getZombieConfig(path: string): LaunchConfig;
+export type CmdCodes = "restart" | "pause" | "resume" | "kill" | "isup" | "init" | "networkmap";
+export type IPCRequestMessage = {
+    text: string;
+    cmd: CmdCodes;
+    nodeName?: string;
+};
+export type IPCResponseMessage = {
+    status: "success" | "failure";
+    result: boolean | object;
+    message: string;
+};
+export declare function sendIpcMessage(message: IPCRequestMessage): Promise<IPCResponseMessage>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/foundations/zombie/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/foundations/zombie/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAQ5D,wBAAsB,eAAe,CAAC,MAAM,EAAE,YAAY,iBA4CzD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAWb,YAAY,CAC1C;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqD5F"}

package/dist/foundations/zombie/helpers.js

@@ -0,0 +1,97 @@
+import chalk from "chalk";
+import fs from "node:fs";
+import invariant from "tiny-invariant";
+import { checkAccess, checkExists } from "../../cli/internal/fileCheckers.js";
+import { setTimeout as timer } from "node:timers/promises";
+import net from "node:net";
+export async function checkZombieBins(config) {
+    const relayBinPath = config.relaychain.default_command;
+    if (!relayBinPath) {
+        throw new Error("No relayBinPath '[relaychain.default_command]' specified in zombie config");
+    }
+    await checkExists(relayBinPath);
+    checkAccess(relayBinPath);
+    if (config.parachains) {
+        const promises = config.parachains.map(async (para) => {
+            if (para.collator) {
+                if (!para.collator.command) {
+                    throw new Error("No command found for collator, please check your zombienet config file for collator command");
+                }
+                await checkExists(para.collator.command);
+                checkAccess(para.collator.command);
+            }
+            if (para.collators) {
+                for (const coll of para.collators) {
+                    if (!coll.command) {
+                        throw new Error("No command found for collators, please check your zombienet config file for collators command");
+                    }
+                    await checkExists(coll.command);
+                    checkAccess(coll.command);
+                }
+                // para.collators.forEach((coll) => {
+                //   if (!coll.command) {
+                //     throw new Error(
+                //       "No command found for collators, please check your zombienet config file for para collators command"
+                //     );
+                //   }
+                //   checkExists(coll.command);
+                //   checkAccess(coll.command);
+                // });
+            }
+        });
+        await Promise.all(promises);
+    }
+}
+export function getZombieConfig(path) {
+    const fsResult = fs.existsSync(path);
+    if (!fsResult) {
+        throw new Error(`No ZombieConfig file found at location: ${path} \n Are you sure your ${chalk.bgWhiteBright.blackBright("moonwall.config.json")} file has the correct "configPath" in zombieSpec?`);
+    }
+    const buffer = fs.readFileSync(path, "utf-8");
+    return JSON.parse(buffer);
+}
+export async function sendIpcMessage(message) {
+    return new Promise(async (resolve, reject) => {
+        let response;
+        const ipcPath = process.env.MOON_IPC_SOCKET;
+        invariant(ipcPath, "No IPC path found. This is a bug, please report it.");
+        const client = net.createConnection({ path: ipcPath }, () => {
+            console.log("📨 Successfully connected to IPC server");
+        });
+        client.on("error", (err) => {
+            console.error("📨 IPC client connection error:", err);
+        });
+        // Listener to return control flow after server responds
+        client.on("data", async (data) => {
+            response = JSON.parse(data.toString());
+            if (response.status === "success") {
+                client.end();
+                for (let i = 0;; i++) {
+                    if (client.closed) {
+                        break;
+                    }
+                    if (i > 100) {
+                        reject(new Error("Closing IPC connection failed"));
+                    }
+                    await timer(200);
+                }
+                resolve(response);
+            }
+            if (response.status === "failure") {
+                reject(new Error(JSON.stringify(response)));
+            }
+        });
+        for (let i = 0;; i++) {
+            if (!client.connecting) {
+                break;
+            }
+            if (i > 100) {
+                reject(new Error(`Connection to ${ipcPath} failed`));
+            }
+            await timer(200);
+        }
+        await new Promise((resolve) => {
+            client.write(JSON.stringify(message), () => resolve("Sent!"));
+        });
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Moonwall - Blockchain Testing Framework
+ *
+ * Public API exports for test consumers
+ */
+export * from "./api/types/index.js";
+export { afterAll, afterEach, beforeAll, beforeEach, expect } from "vitest";
+export * from "./util/index.js";
+export { describeSuite } from "./cli/lib/runnerContext.js";
+export { getEnvironmentFromConfig, importAsyncConfig, importConfig, isEthereumDevConfig, isEthereumZombieConfig, } from "./cli/lib/configReader.js";
+export { MoonwallContext, contextCreator } from "./cli/lib/globalContext.js";
+export { customDevRpcRequest } from "./cli/lib/rpcFunctions.js";
+export { fetchCompiledContract, deployCreateCompiledContract, interactWithContract, interactWithPrecompileContract, } from "./cli/lib/contractFunctions.js";
+export { whiteListedTrack, notePreimage, instantFastTrack, execCouncilProposal, execTechnicalCommitteeProposal, execOpenTechCommitteeProposal, proposeReferendaAndDeposit, dispatchAsGeneralAdmin, } from "./cli/lib/governanceProcedures.js";
+export { ApiPromise } from "@polkadot/api";
+export { default as Web3 } from "web3";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,qCAAqC;AAKrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAM5E,gCAAgC;AAMhC,OAAO,EAAE,aAAa,EAAE,mCAAmC;AAG3D,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,GACvB,kCAAkC;AAMnC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,mCAAmC;AAK7E,OAAO,EAAE,mBAAmB,EAAE,kCAAkC;AAKhE,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,GAC/B,uCAAuC;AAKxC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,GACvB,0CAA0C;AAK3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * Moonwall - Blockchain Testing Framework
+ *
+ * Public API exports for test consumers
+ */
+// =============================================================================
+// Type Definitions
+// =============================================================================
+export * from "./api/types/index.js";
+// =============================================================================
+// Vitest Re-exports
+// =============================================================================
+export { afterAll, afterEach, beforeAll, beforeEach, expect } from "vitest";
+// =============================================================================
+// Testing Utilities
+// =============================================================================
+// Block creation, event filtering, contract helpers, etc.
+export * from "./util/index.js";
+// =============================================================================
+// Test Runner
+// =============================================================================
+// describeSuite - Primary test suite creation function
+export { describeSuite } from "./cli/lib/runnerContext.js";
+// Configuration loading
+export { getEnvironmentFromConfig, importAsyncConfig, importConfig, isEthereumDevConfig, isEthereumZombieConfig, } from "./cli/lib/configReader.js";
+// =============================================================================
+// Context (Advanced Use)
+// =============================================================================
+// For advanced users who need direct access to the Moonwall context
+export { MoonwallContext, contextCreator } from "./cli/lib/globalContext.js";
+// =============================================================================
+// RPC Utilities
+// =============================================================================
+export { customDevRpcRequest } from "./cli/lib/rpcFunctions.js";
+// =============================================================================
+// Contract Utilities
+// =============================================================================
+export { fetchCompiledContract, deployCreateCompiledContract, interactWithContract, interactWithPrecompileContract, } from "./cli/lib/contractFunctions.js";
+// =============================================================================
+// Governance Utilities
+// =============================================================================
+export { whiteListedTrack, notePreimage, instantFastTrack, execCouncilProposal, execTechnicalCommitteeProposal, execOpenTechCommitteeProposal, proposeReferendaAndDeposit, dispatchAsGeneralAdmin, } from "./cli/lib/governanceProcedures.js";
+// =============================================================================
+// Re-exports from Dependencies (for convenience)
+// =============================================================================
+export { ApiPromise } from "@polkadot/api";
+export { default as Web3 } from "web3";

package/dist/internal/common.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeUrlToHttps(url: string): string;
+export declare function directRpcRequest(endpoint: string, method: string, params?: any[], timeoutMs?: number): Promise<any>;
+//# sourceMappingURL=common.d.ts.map

package/dist/internal/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/internal/common.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,GAAG,EAAO,EAClB,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CA6Cd"}

package/dist/internal/common.js

@@ -0,0 +1,41 @@
+export function normalizeUrlToHttps(url) {
+    return url.replace(/^ws(s)?:/, "http$1:");
+}
+export async function directRpcRequest(endpoint, method, params = [], timeoutMs = 10000 // Default 10 second timeout
+) {
+    const data = {
+        jsonrpc: "2.0",
+        id: 1,
+        method,
+        params,
+    };
+    if (endpoint.startsWith("ws")) {
+        console.log("you've passed a websocket to fetch, is this intended?");
+    }
+    // Create an AbortController for timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(endpoint, {
+            method: "POST",
+            body: JSON.stringify(data),
+            headers: { "Content-Type": "application/json" },
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        const responseData = (await response.json());
+        if (responseData.error) {
+            throw new Error(responseData.error.message);
+        }
+        return responseData.result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error.name === "AbortError") {
+            throw new Error(`RPC request to ${endpoint} timed out after ${timeoutMs}ms (method: ${method})`, { cause: error });
+        }
+        throw new Error(`RPC request to ${endpoint} failed (method: ${method}): ${error.message}`, {
+            cause: error,
+        });
+    }
+}

package/dist/internal/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./common.js";
+export { createLogger, getLogger, clearLoggers, setLoggerEnabled, setupLogger, type Logger, type LoggerOptions, } from "./logger.js";
+export * from "./logging.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,KAAK,MAAM,EACX,KAAK,aAAa,GACnB,oBAAoB;AACrB,6BAA6B"}

package/dist/internal/index.js

@@ -0,0 +1,3 @@
+export * from "./common.js";
+export { createLogger, getLogger, clearLoggers, setLoggerEnabled, setupLogger, } from "./logger.js";
+export * from "./logging.js";

package/dist/internal/logger.d.ts

@@ -0,0 +1,24 @@
+import pino from "pino";
+import type { Logger } from "pino";
+export interface LoggerOptions {
+    name: string;
+    level?: string;
+    enabled?: boolean;
+}
+export declare function createLogger(options: LoggerOptions): Logger;
+export declare function getLogger(name: string): Logger | undefined;
+export declare function clearLoggers(): void;
+export declare function setLoggerEnabled(pattern: string, enabled: boolean): void;
+/**
+ * Callable logger type - a function that logs at info level with access to the underlying pino Logger
+ */
+export interface CallableLogger {
+    (message: string): void;
+    /** Log at info level (alias for calling the logger directly) */
+    info: (message: string) => void;
+    /** The underlying pino Logger for advanced usage */
+    pino: pino.Logger;
+}
+export declare function setupLogger(name: string): CallableLogger;
+export type { Logger } from "pino";
+//# sourceMappingURL=logger.d.ts.map

package/dist/internal/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/internal/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAuBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqB3D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQxE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;CACnB;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAexD;AAGD,YAAY,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC"}

package/dist/internal/logger.js

@@ -0,0 +1,66 @@
+import pino from "pino";
+import pinoPretty from "pino-pretty";
+const logLevel = process.env.LOG_LEVEL || "info";
+// Create pretty stream for all contexts
+const prettyStream = pinoPretty({
+    colorize: true,
+    translateTime: "HH:MM:ss.l",
+    ignore: "pid,hostname",
+    sync: true, // Important for worker threads
+});
+const pinoOptions = {
+    level: logLevel,
+    formatters: {
+        level: (label) => {
+            return { level: label };
+        },
+    },
+};
+const loggers = new Map();
+export function createLogger(options) {
+    const { name, level = logLevel, enabled = true } = options;
+    const existingLogger = loggers.get(name);
+    if (existingLogger) {
+        return existingLogger;
+    }
+    const loggerConfig = {
+        name,
+        level,
+        enabled,
+        formatters: pinoOptions.formatters,
+    };
+    // Create logger with pretty stream
+    const logger = pino(loggerConfig, prettyStream);
+    loggers.set(name, logger);
+    return logger;
+}
+export function getLogger(name) {
+    return loggers.get(name);
+}
+export function clearLoggers() {
+    loggers.clear();
+}
+// Helper function to enable/disable specific loggers
+export function setLoggerEnabled(pattern, enabled) {
+    const regex = new RegExp(pattern.replace(/\*/g, ".*"));
+    loggers.forEach((logger, name) => {
+        if (regex.test(name)) {
+            logger.level = enabled ? logLevel : "silent";
+        }
+    });
+}
+// Compatibility layer for the existing setupLogger function
+// Returns a callable function that logs at info level
+export function setupLogger(name) {
+    const logger = createLogger({
+        name: `test:${name}`,
+        enabled: process.argv.includes("--printlogs"),
+    });
+    // Create a callable function that wraps logger.info
+    const logFn = (message) => logger.info(message);
+    const callableLogger = logFn;
+    // Attach .info as alias and the underlying pino logger
+    callableLogger.info = logFn;
+    callableLogger.pino = logger;
+    return callableLogger;
+}