moonwall 1.0.0-dev.0

package/dist/contracts/contractInteraction.js

@@ -0,0 +1,170 @@
+import { ALITH_PRIVATE_KEY, PRECOMPILES, createEthersTransaction, createViemTransaction, deployViemContract, } from "../util/index.js";
+import chalk from "chalk";
+import { Interface, Wallet } from "ethers";
+import fs, { readFileSync } from "node:fs";
+import path from "node:path";
+import { decodeFunctionResult, encodeFunctionData, toHex } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { importJsonConfig } from "../services/config/index.js";
+function getCompiledPath(contractName) {
+    const config = importJsonConfig();
+    const contractsDir = config.environments.find((env) => env.name === process.env.MOON_TEST_ENV)?.contracts;
+    if (!contractsDir) {
+        throw new Error(`Contracts directory not found for environment config ${process.env.MOON_TEST_ENV}\n` +
+            `Please specify path to Foundry directory at:  ${chalk.bgWhiteBright.blackBright("moonwall.config.json > environments > contracts")}`);
+    }
+    const compiledJsonPath = recursiveSearch(contractsDir, `${contractName}.json`);
+    const solidityFilePath = recursiveSearch(contractsDir, `${contractName}.sol`);
+    if (!compiledJsonPath && !solidityFilePath) {
+        throw new Error(`Neither solidity contract ${contractName}.sol nor its compiled json exists in ${contractsDir}`);
+    }
+    if (!compiledJsonPath) {
+        throw new Error(`Compiled contract ${contractName}.json doesn't exist\n` +
+            `Please ${chalk.bgWhiteBright.blackBright("recompile contract")} ${contractName}.sol`);
+    }
+    return compiledJsonPath;
+}
+export function fetchCompiledContract(contractName) {
+    const compiledPath = getCompiledPath(contractName);
+    const json = readFileSync(compiledPath, "utf8");
+    const parsed = JSON.parse(json);
+    return {
+        abi: parsed.contract.abi,
+        bytecode: parsed.byteCode,
+        methods: parsed.contract.evm.methodIdentifiers,
+        deployedBytecode: `0x${parsed.contract.evm.deployedBytecode.object}`,
+    };
+}
+export function recursiveSearch(dir, filename) {
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+        const filepath = path.join(dir, file);
+        const stats = fs.statSync(filepath);
+        if (stats.isDirectory()) {
+            const searchResult = recursiveSearch(filepath, filename);
+            if (searchResult) {
+                return searchResult;
+            }
+        }
+        else if (stats.isFile() && file === filename) {
+            return filepath;
+        }
+    }
+    return null;
+}
+export async function interactWithPrecompileContract(context, callOptions) {
+    const { precompileName, ...rest } = callOptions;
+    const precompileInfo = PRECOMPILES[precompileName];
+    if (!precompileInfo) {
+        throw new Error(`No precompile found with the name: ${precompileName}`);
+    }
+    const [contractAddress, contractName] = Array.isArray(precompileInfo)
+        ? precompileInfo
+        : [precompileInfo, precompileName];
+    return await interactWithContract(context, {
+        ...rest,
+        contractName,
+        contractAddress: contractAddress,
+    });
+}
+export async function interactWithContract(context, callOptions) {
+    const { contractName, contractAddress, functionName, args = [], web3Library = "viem", gas = "estimate", value = 0n, privateKey = ALITH_PRIVATE_KEY, rawTxOnly = false, call = false, } = callOptions;
+    const { abi } = fetchCompiledContract(contractName);
+    const data = encodeFunctionData({
+        abi,
+        functionName,
+        args,
+    });
+    const account = privateKeyToAccount(privateKey);
+    const gasParam = gas === "estimate"
+        ? await context.viem().estimateGas({
+            account: account.address,
+            to: contractAddress,
+            value: 0n,
+            data,
+        })
+        : gas > 0n
+            ? gas
+            : 200000n;
+    if (!call && rawTxOnly) {
+        return web3Library === "viem"
+            ? createViemTransaction(context, {
+                to: contractAddress,
+                data,
+                gas: gasParam,
+                privateKey,
+                value,
+            })
+            : createEthersTransaction(context, {
+                to: contractAddress,
+                data,
+                gas: gasParam,
+                value: toHex(value),
+                privateKey,
+            });
+    }
+    if (call) {
+        if (web3Library === "viem") {
+            const result = await context.viem().call({
+                account: account.address,
+                to: contractAddress,
+                value: 0n,
+                data,
+                gas: gasParam,
+            });
+            if (!result.data) {
+                throw new Error("No data field returned from call");
+            }
+            return decodeFunctionResult({ abi, functionName, data: result.data });
+        }
+        const result = await context.ethers().call({
+            from: account.address,
+            to: contractAddress,
+            value: toHex(value),
+            data,
+            gasLimit: toHex(gasParam),
+        });
+        return new Interface(abi).decodeFunctionResult(functionName, result);
+    }
+    if (!rawTxOnly) {
+        if (web3Library === "viem") {
+            const hash = await context.viem().sendTransaction({
+                account: account,
+                to: contractAddress,
+                value,
+                data,
+                gas: gasParam,
+            });
+            return hash;
+        }
+        const signer = new Wallet(privateKey, context.ethers().provider);
+        const { hash } = await signer.sendTransaction({
+            from: account.address,
+            to: contractAddress,
+            value: toHex(value),
+            data,
+            gasLimit: toHex(gasParam),
+        });
+        return hash;
+    }
+    throw new Error("This should never happen, if it does there's a logic error in the code");
+}
+export async function deployCreateCompiledContract(context, contractName, options) {
+    const { abi, bytecode, methods } = fetchCompiledContract(contractName);
+    const { privateKey = ALITH_PRIVATE_KEY, args = [], ...rest } = options || {};
+    const blob = {
+        ...rest,
+        privateKey,
+        args,
+    };
+    const { contractAddress, logs, status, hash } = await deployViemContract(context, abi, bytecode, blob);
+    return {
+        contractAddress: contractAddress,
+        logs,
+        hash,
+        status,
+        abi,
+        bytecode,
+        methods,
+    };
+}

package/dist/contracts/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchCompiledContract, recursiveSearch, interactWithPrecompileContract, interactWithContract, deployCreateCompiledContract, } from "./contractInteraction.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,EACpB,4BAA4B,GAC7B,iCAAiC"}

package/dist/contracts/index.js

@@ -0,0 +1 @@
+export { fetchCompiledContract, recursiveSearch, interactWithPrecompileContract, interactWithContract, deployCreateCompiledContract, } from "./contractInteraction.js";

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/foundations/chopsticks/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EAClB,iCAAiC;AAelC,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,CAAC,YAAY,CA4G7D,CAAC"}

package/dist/foundations/chopsticks/handler.js

@@ -0,0 +1,93 @@
+import { ALITH_PRIVATE_KEY, BALTATHAR_PRIVATE_KEY, CHARLETH_PRIVATE_KEY, DOROTHY_PRIVATE_KEY, jumpRoundsChopsticks, } from "../../util/index.js";
+import { Keyring } from "@polkadot/api";
+import { createChopsticksBlock, getWsUrlFromConfig, sendSetStorageRequest } from "./helpers.js";
+import { getEnvironmentFromConfig } from "../../services/config/index.js";
+import { MoonwallContext } from "../../cli/lib/globalContext.js";
+import { upgradeRuntimeChopsticks } from "../../cli/lib/upgradeProcedures.js";
+export const chopsticksHandler = ({ testCases, context, testCase, logger, }) => {
+    const accountTypeLookup = () => {
+        const metadata = ctx.polkadotJs().runtimeMetadata.asLatest;
+        const systemPalletIndex = metadata.pallets.findIndex((pallet) => pallet.name.toString() === "System");
+        const systemAccountStorageType = metadata.pallets[systemPalletIndex].storage
+            .unwrap()
+            .items.find((storage) => storage.name.toString() === "Account")?.type;
+        if (!systemAccountStorageType) {
+            throw new Error("System.Account storage not found");
+        }
+        return metadata.lookup.getTypeDef(systemAccountStorageType.asMap.key).type;
+    };
+    const newKeyring = () => {
+        const isEth = accountTypeLookup() === "AccountId20";
+        const keyring = new Keyring({
+            type: isEth ? "ethereum" : "sr25519",
+        });
+        return {
+            alice: keyring.addFromUri(isEth ? ALITH_PRIVATE_KEY : "//Alice", {
+                name: "Alice default",
+            }),
+            bob: keyring.addFromUri(isEth ? BALTATHAR_PRIVATE_KEY : "//Bob", {
+                name: "Bob default",
+            }),
+            charlie: keyring.addFromUri(isEth ? CHARLETH_PRIVATE_KEY : "//Charlie", {
+                name: "Charlie default",
+            }),
+            dave: keyring.addFromUri(isEth ? DOROTHY_PRIVATE_KEY : "//Dave", {
+                name: "Dave default",
+            }),
+        };
+    };
+    const ctx = {
+        ...context,
+        get isEthereumChain() {
+            return accountTypeLookup() === "AccountId20";
+        },
+        get isSubstrateChain() {
+            return accountTypeLookup() === "AccountId32";
+        },
+        get pjsApi() {
+            return context.polkadotJs();
+        },
+        get keyring() {
+            return newKeyring();
+        },
+        createBlock: async (options = {}) => {
+            // Get newBlockTimeout from foundation config if not provided in options
+            const env = getEnvironmentFromConfig();
+            const launchSpec = env.foundation.type === "chopsticks" ? env.foundation.launchSpec[0] : undefined;
+            const configTimeout = launchSpec?.newBlockTimeout;
+            return await createChopsticksBlock(context, {
+                ...options,
+                timeout: options.timeout ?? configTimeout,
+            });
+        },
+        setStorage: async (params) => await sendSetStorageRequest(params),
+        upgradeRuntime: async (providerName) => {
+            const path = (await MoonwallContext.getContext()).rtUpgradePath;
+            if (!path) {
+                throw new Error("No runtime upgrade path defined in config");
+            }
+            await upgradeRuntimeChopsticks(ctx, path, providerName);
+        },
+        jumpRounds: async (options) => {
+            const api = context.polkadotJs(options.providerName);
+            if (!containsPallet(api, "ParachainStaking")) {
+                throw new Error("ParachainStaking pallet is not enabled");
+            }
+            const wsUrl = await getWsUrlFromConfig(options.providerName);
+            const url = new URL(wsUrl);
+            const port = Number.parseInt(url.port, 10);
+            await jumpRoundsChopsticks(api, port, options.rounds);
+        },
+    };
+    testCases({
+        context: ctx,
+        it: testCase,
+        log: logger.info.bind(logger),
+        logger,
+    });
+};
+const containsPallet = (polkadotJsApi, palletName) => {
+    const metadata = polkadotJsApi.runtimeMetadata.asLatest;
+    const systemPalletIndex = metadata.pallets.findIndex((pallet) => pallet.name.toString() === palletName);
+    return systemPalletIndex !== -1;
+};

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

@@ -0,0 +1,27 @@
+import type { ChopsticksBlockCreation, GenericContext } from "../../api/types/index.js";
+import type { WsProvider } from "@polkadot/api";
+import type { ApiTypes, AugmentedEvent } from "@polkadot/api/types";
+import type { EventRecord } from "@polkadot/types/interfaces";
+export declare function getWsFromConfig(providerName?: string, timeout?: number): Promise<WsProvider>;
+export declare function getWsUrlFromConfig(providerName?: string): Promise<string>;
+export declare function sendNewBlockAndCheck(context: GenericContext, expectedEvents: AugmentedEvent<ApiTypes>[]): Promise<{
+    match: boolean;
+    events: EventRecord[];
+}>;
+export declare function createChopsticksBlock(context: GenericContext, options?: ChopsticksBlockCreation): Promise<{
+    result: string;
+}>;
+export declare function sendSetHeadRequest(newHead: string, providerName?: string): Promise<string>;
+export declare function sendNewBlockRequest(params?: {
+    providerName?: string;
+    count?: number;
+    to?: number;
+    timeout?: number;
+}): Promise<string>;
+export declare function sendSetStorageRequest(params: {
+    providerName?: string;
+    module: string;
+    method: string;
+    methodParams: any[];
+}): Promise<void>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/foundations/chopsticks/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,iCAAiC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAK9D,wBAAsB,eAAe,CACnC,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAED,wBAAsB,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB/E;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,GACzC,OAAO,CAAC;IACT,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC,CAoBD;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,uBAAkD;;GA4C5D;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,mBAW9E;AAED,wBAAsB,mBAAmB,CAAC,MAAM,CAAC,EAAE;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,mBAiBA;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,GAAG,EAAE,CAAC;CACrB,iBASA"}

package/dist/foundations/chopsticks/helpers.js

@@ -0,0 +1,133 @@
+import chalk from "chalk";
+import { setTimeout } from "node:timers/promises";
+import { MoonwallContext } from "../../cli/lib/globalContext.js";
+export async function getWsFromConfig(providerName, timeout) {
+    if (providerName) {
+        const provider = (await MoonwallContext.getContext()).environment.providers.find(({ name }) => name === providerName);
+        if (typeof provider === "undefined") {
+            throw new Error(`Cannot find provider ${chalk.bgWhiteBright.blackBright(providerName)}`);
+        }
+        if (!provider.ws) {
+            throw new Error("Provider does not have an attached ws() property ");
+        }
+        return provider.ws(timeout);
+    }
+    const provider = (await MoonwallContext.getContext()).environment.providers.find(({ type }) => type === "polkadotJs");
+    if (typeof provider === "undefined") {
+        throw new Error(`Cannot find providers of type ${chalk.bgWhiteBright.blackBright("polkadotJs")}`);
+    }
+    if (!provider.ws) {
+        throw new Error("Provider does not have an attached ws() property ");
+    }
+    return provider.ws(timeout);
+}
+export async function getWsUrlFromConfig(providerName) {
+    // Import the environment config directly which has the connections property
+    const { getEnvironmentFromConfig } = await import("../../cli/lib/configReader.js");
+    const env = getEnvironmentFromConfig();
+    if (providerName) {
+        const connection = env.connections?.find(({ name }) => name === providerName);
+        if (connection?.endpoints && connection.endpoints.length > 0) {
+            return connection.endpoints[0];
+        }
+    }
+    // Default to first polkadotJs connection
+    const connection = env.connections?.find(({ type }) => type === "polkadotJs");
+    if (!connection || !connection.endpoints || connection.endpoints.length === 0) {
+        throw new Error("No WebSocket endpoint found in configuration");
+    }
+    return connection.endpoints[0];
+}
+export async function sendNewBlockAndCheck(context, expectedEvents) {
+    const newBlock = await sendNewBlockRequest();
+    const api = context.polkadotJs();
+    const apiAt = await api.at(newBlock);
+    const actualEvents = (await apiAt.query.system.events());
+    const match = expectedEvents.every((eEvt) => {
+        return actualEvents
+            .map((aEvt) => {
+            if (api.events.system.ExtrinsicSuccess.is(aEvt.event) &&
+                aEvt.event.data.dispatchInfo?.class?.toString() !== "Normal") {
+                return false;
+            }
+            return eEvt.is(aEvt.event);
+        })
+            .reduce((acc, curr) => acc || curr, false);
+    });
+    return { match, events: actualEvents };
+}
+export async function createChopsticksBlock(context, options = { allowFailures: false }) {
+    const result = await sendNewBlockRequest(options);
+    const apiAt = await context.polkadotJs(options.providerName).at(result);
+    const actualEvents = await apiAt.query.system.events();
+    if (options?.expectEvents) {
+        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 && options.allowFailures === true) {
+        // Skip ExtrinsicFailure Asserts
+    }
+    else {
+        for (const event of actualEvents) {
+            if (context.polkadotJs().events.system.ExtrinsicFailed.is(event.event)) {
+                throw new Error(`ExtrinsicFailed event detected, enable 'allowFailures' if this is expected.`);
+            }
+        }
+    }
+    return { result };
+}
+export async function sendSetHeadRequest(newHead, providerName) {
+    const ws = providerName ? await getWsFromConfig(providerName) : await getWsFromConfig();
+    let result = "";
+    await ws.isReady;
+    result = await ws.send("dev_setHead", [newHead]);
+    await ws.disconnect();
+    return result;
+}
+export async function sendNewBlockRequest(params) {
+    const ws = params
+        ? await getWsFromConfig(params.providerName, params.timeout)
+        : await getWsFromConfig();
+    let result = "";
+    while (!ws.isConnected) {
+        await setTimeout(100);
+    }
+    if (params?.count || params?.to) {
+        result = await ws.send("dev_newBlock", [{ count: params.count, to: params.to }]);
+    }
+    else {
+        result = await ws.send("dev_newBlock", [{ count: 1 }]);
+    }
+    await ws.disconnect();
+    return result;
+}
+export async function sendSetStorageRequest(params) {
+    const ws = params ? await getWsFromConfig(params.providerName) : await getWsFromConfig();
+    while (!ws.isConnected) {
+        await setTimeout(100);
+    }
+    await ws.send("dev_setStorage", [{ [params.module]: { [params.method]: params.methodParams } }]);
+    await ws.disconnect();
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/foundations/dev/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,iBAAiB,EAGlB,iCAAiC;AAsBlC,eAAO,MAAM,UAAU,EAAE,iBAAiB,CAAC,KAAK,CA0K/C,CAAC"}

package/dist/foundations/dev/handler.js

@@ -0,0 +1,136 @@
+import { ALITH_PRIVATE_KEY, BALTATHAR_PRIVATE_KEY, CHARLETH_PRIVATE_KEY, DOROTHY_PRIVATE_KEY, alith, createEthersTransaction, createViemTransaction, jumpBlocksDev, jumpRoundsDev, } from "../../util/index.js";
+import { Keyring } from "@polkadot/api";
+import { createDevBlock } from "./helpers.js";
+import { getEnvironmentFromConfig, isEthereumDevConfig } from "../../services/config/index.js";
+import { deployCreateCompiledContract, interactWithContract, interactWithPrecompileContract, } from "../../contracts/index.js";
+export const devHandler = ({ testCases, context, testCase, logger }) => {
+    const env = getEnvironmentFromConfig();
+    const ethCompatible = isEthereumDevConfig();
+    const accountTypeLookup = () => {
+        const metadata = ctx.polkadotJs().runtimeMetadata.asLatest;
+        const systemPalletIndex = metadata.pallets.findIndex((pallet) => pallet.name.toString() === "System");
+        const systemAccountStorage = metadata.pallets[systemPalletIndex].storage
+            .unwrap()
+            .items.find((storage) => storage.name.toString() === "Account");
+        if (!systemAccountStorage) {
+            throw new Error("Account storage not found");
+        }
+        const systemAccountStorageType = systemAccountStorage.type;
+        return metadata.lookup.getTypeDef(systemAccountStorageType.asMap.key).type;
+    };
+    const newKeyring = () => {
+        const isEth = accountTypeLookup() === "AccountId20";
+        const keyring = new Keyring({
+            type: isEth ? "ethereum" : "sr25519",
+        });
+        return {
+            alice: keyring.addFromUri(isEth ? ALITH_PRIVATE_KEY : "//Alice", {
+                name: "Alice default",
+            }),
+            bob: keyring.addFromUri(isEth ? BALTATHAR_PRIVATE_KEY : "//Bob", {
+                name: "Bob default",
+            }),
+            charlie: keyring.addFromUri(isEth ? CHARLETH_PRIVATE_KEY : "//Charlie", {
+                name: "Charlie default",
+            }),
+            dave: keyring.addFromUri(isEth ? DOROTHY_PRIVATE_KEY : "//Dave", {
+                name: "Dave default",
+            }),
+        };
+    };
+    const containsPallet = (palletName) => {
+        const metadata = context.polkadotJs().runtimeMetadata.asLatest;
+        const systemPalletIndex = metadata.pallets.findIndex((pallet) => pallet.name.toString() === palletName);
+        return systemPalletIndex !== -1;
+    };
+    const ctx = {
+        ...context,
+        get isEthereumChain() {
+            return accountTypeLookup() === "AccountId20";
+        },
+        get isSubstrateChain() {
+            return accountTypeLookup() === "AccountId32";
+        },
+        get pjsApi() {
+            return context.polkadotJs();
+        },
+        get isParachainStaking() {
+            return containsPallet("ParachainStaking");
+        },
+        get keyring() {
+            return newKeyring();
+        },
+        createBlock: async (transactions, options) => {
+            const defaults = {
+                signer: env.defaultSigner || alith,
+                allowFailures: env.defaultAllowFailures === undefined ? true : env.defaultAllowFailures,
+                finalize: env.defaultFinalization === undefined ? true : env.defaultFinalization,
+            };
+            return await createDevBlock(context, { ...defaults, ...options }, transactions);
+        },
+        createTxn: !ethCompatible
+            ? undefined
+            : (options) => {
+                const { libraryType = "viem", ...txnOptions } = options;
+                return libraryType === "viem"
+                    ? createViemTransaction(ctx, txnOptions)
+                    : createEthersTransaction(ctx, txnOptions);
+            },
+        readPrecompile: !ethCompatible
+            ? undefined
+            : async (options) => {
+                const response = await interactWithPrecompileContract(ctx, {
+                    call: true,
+                    ...options,
+                });
+                return response;
+            },
+        writePrecompile: !ethCompatible
+            ? undefined
+            : async (options) => {
+                const response = await interactWithPrecompileContract(ctx, {
+                    call: false,
+                    ...options,
+                });
+                return response;
+            },
+        readContract: !ethCompatible
+            ? undefined
+            : async (options) => {
+                const response = await interactWithContract(ctx, {
+                    call: true,
+                    ...options,
+                });
+                return response;
+            },
+        writeContract: !ethCompatible
+            ? undefined
+            : async (options) => {
+                const response = await interactWithContract(ctx, {
+                    call: false,
+                    ...options,
+                });
+                return response;
+            },
+        deployContract: !ethCompatible
+            ? undefined
+            : async (contractName, options) => {
+                return await deployCreateCompiledContract(ctx, contractName, options);
+            },
+        jumpBlocks: async (blocks) => {
+            await jumpBlocksDev(context.polkadotJs(), blocks);
+        },
+        jumpRounds: async (rounds) => {
+            if (!ctx.isParachainStaking) {
+                throw new Error("ParachainStaking pallet is not enabled");
+            }
+            await jumpRoundsDev(context.polkadotJs(), rounds);
+        },
+    };
+    testCases({
+        context: ctx,
+        it: testCase,
+        log: logger.info.bind(logger),
+        logger,
+    });
+};

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

@@ -0,0 +1,27 @@
+import type { BlockCreation, ExtrinsicCreation, GenericContext } from "../../api/types/index.js";
+import type { ApiTypes, SubmittableExtrinsic } from "@polkadot/api/types";
+export declare function getDevProviderPath(): Promise<string>;
+export type CreatedBlockResult = {
+    block: {
+        duration: number;
+        hash: string;
+    };
+    result: ExtrinsicCreation | ExtrinsicCreation[] | null;
+};
+export type CallType<TApi extends ApiTypes> = SubmittableExtrinsic<TApi> | Promise<SubmittableExtrinsic<TApi>> | `0x${string}` | Promise<string>;
+export declare function createDevBlock<ApiType extends ApiTypes, Calls extends CallType<ApiType> | Array<CallType<ApiType>>>(context: GenericContext, options: BlockCreation, transactions?: Calls): Promise<{
+    block: {
+        duration: number;
+        hash: string;
+        proofSize?: number;
+    };
+    result?: undefined;
+} | {
+    block: {
+        duration: number;
+        hash: string;
+        proofSize?: number;
+    };
+    result: any;
+}>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/foundations/dev/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,iBAAiB,EACjB,cAAc,EACf,iCAAiC;AAQlC,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAa1E,wBAAsB,kBAAkB,oBAKvC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,QAAQ,IACtC,oBAAoB,CAAC,IAAI,CAAC,GAC1B,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,GACnC,KAAK,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,CAAC;AAgBpB,wBAAsB,cAAc,CAClC,OAAO,SAAS,QAAQ,EACxB,KAAK,SAAS,QAAQ,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAC1D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,KAAK;;;;;;;;;;;;;;GAqKtE"}