rocketh 0.15.14 → 0.16.0

package/src/environment/providers/TransactionHashTracker.ts

@@ -1,22 +0,0 @@
-import {EIP1193GenericRequest, EIP1193ProviderWithoutEvents} from 'eip-1193';
-import {BaseProvider} from './BaseProvider.js';
-
-export class TransactionHashTrackerProvider extends BaseProvider implements EIP1193ProviderWithoutEvents {
-	public transactionHashes: `0x${string}`[] = [];
-
-	constructor(provider: EIP1193ProviderWithoutEvents) {
-		super(provider);
-	}
-
-	protected async _request<T = unknown, V extends EIP1193GenericRequest = EIP1193GenericRequest>(args: V): Promise<T> {
-		const response = await this.provider.request(args as any);
-		if (args.method === 'eth_sendRawTransaction' || args.method === 'eth_sendTransaction') {
-			this.transactionHashes.push(response as `0x${string}`);
-		}
-		return response as T;
-	}
-}
-
-export type TransactionHashTracker = EIP1193ProviderWithoutEvents & {
-	transactionHashes: `0x${string}`[];
-};

package/src/environment/utils/artifacts.ts

@@ -1,176 +0,0 @@
-import {Abi} from 'abitype';
-import {Artifact, DevDoc, UserDoc} from '../../types.js';
-import {FunctionFragment} from 'ethers';
-
-type CreateMutable<Type> = {
-	-readonly [Property in keyof Type]: Type[Property];
-};
-
-type ArrayElement<ArrayType extends readonly unknown[]> = ArrayType extends readonly (infer ElementType)[]
-	? ElementType
-	: never;
-
-// from https://gist.github.com/egardner/efd34f270cc33db67c0246e837689cb9
-function deepEqual(obj1: any, obj2: any): boolean {
-	// Private
-	function isObject(obj: any) {
-		if (typeof obj === 'object' && obj != null) {
-			return true;
-		} else {
-			return false;
-		}
-	}
-
-	if (obj1 === obj2) {
-		return true;
-	} else if (isObject(obj1) && isObject(obj2)) {
-		if (Object.keys(obj1).length !== Object.keys(obj2).length) {
-			return false;
-		}
-		for (var prop in obj1) {
-			if (!deepEqual(obj1[prop], obj2[prop])) {
-				return false;
-			}
-		}
-		return true;
-	}
-	return false;
-}
-
-function mergeDoc(values: any, mergedDevDocs: any, field: string) {
-	if (values[field]) {
-		const mergedEventDocs = (mergedDevDocs[field] = mergedDevDocs[field] || {});
-		for (const signature of Object.keys(values[field])) {
-			if (mergedEventDocs[signature] && !deepEqual(mergedEventDocs[signature], values[field][signature])) {
-				throw new Error(`Doc ${field} conflict: "${signature}" `);
-			}
-			mergedEventDocs[signature] = values[field][signature];
-		}
-	}
-}
-
-export function mergeABIs(list: {name: string; abi: Abi}[], options?: {doNotCheckForConflicts?: boolean}) {
-	const added: Map<string, ArrayElement<Abi>> = new Map();
-	const mergedABI: CreateMutable<Abi> = [];
-	const sigJSMap: Map<`0x${string}`, {index: number; routeName: string; functionName: string}> = new Map();
-	for (let i = 0; i < list.length; i++) {
-		const listElem = list[i];
-		for (const element of listElem.abi) {
-			if (element.type === 'function') {
-				// const selector = getFunctionSelector(element);
-				const selector = FunctionFragment.from(element).selector as `0x${string}`;
-				if (sigJSMap.has(selector)) {
-					if (!options?.doNotCheckForConflicts) {
-						const existing = sigJSMap.get(selector);
-						throw new Error(
-							`ABI conflict: ${existing!.routeName} has function "${existing!.functionName}" which conflict with ${
-								listElem.name
-							}'s "${element.name}" (selector: "${selector}")  `
-						);
-					} else {
-						continue;
-					}
-				}
-				sigJSMap.set(selector, {index: i, routeName: listElem.name, functionName: element.name});
-
-				const exists = added.has(element.name);
-				if (exists) {
-					// TODO check if same
-				} else {
-					added.set(element.name, element);
-					mergedABI.push(element);
-				}
-			} else if (element.type === 'constructor') {
-				// we skip it
-			} else if (element.type === 'error') {
-				const exists = added.has(element.name);
-				if (exists) {
-					// TODO check if same
-				} else {
-					added.set(element.name, element);
-					mergedABI.push(element);
-				}
-			} else if (element.type === 'event') {
-				const exists = added.has(element.name);
-				if (exists) {
-					// TODO check if same
-				} else {
-					added.set(element.name, element);
-					mergedABI.push(element);
-				}
-			} else if (element.type === 'fallback') {
-			} else if (element.type === 'receive') {
-			} else {
-				// if ('name' in element) {
-				// 	const exists = added.has(element.name);
-				// 	if (exists) {
-				// 		// TODO check if same
-				// 	} else {
-				// 		added.set(element.name, element);
-				// 		mergedABI.push(element);
-				// 	}
-				// }
-			}
-		}
-	}
-
-	return {
-		mergedABI,
-		added,
-		sigJSMap,
-	};
-}
-
-export function mergeArtifacts(
-	list: {name: string; artifact: Partial<Artifact<Abi>> & {abi: Abi}}[],
-	options?: {doNotCheckForConflicts?: boolean}
-) {
-	const {mergedABI, added, sigJSMap} = mergeABIs(
-		list.map((v) => ({name: v.name, abi: v.artifact.abi})),
-		options
-	);
-
-	const mergedDevDocs: CreateMutable<DevDoc> = {kind: 'dev', version: 1, methods: {}};
-	const mergedUserDocs: CreateMutable<UserDoc> = {kind: 'user', version: 1, methods: {}};
-
-	for (let i = 0; i < list.length; i++) {
-		const listElem = list[i];
-
-		const devdoc = listElem.artifact.devdoc;
-		if (devdoc) {
-			mergeDoc(devdoc, mergedDevDocs, 'events');
-			mergeDoc(devdoc, mergedDevDocs, 'errors');
-			mergeDoc(devdoc, mergedDevDocs, 'methods');
-			if (devdoc.author) {
-				if (mergedDevDocs.author && mergedDevDocs.author != devdoc.author) {
-					throw new Error(`DevDoc author conflict `);
-				}
-				mergedDevDocs.author = devdoc.author;
-				if (mergedDevDocs.title && mergedDevDocs.title != devdoc.title) {
-					throw new Error(`DevDoc title conflict `);
-				}
-				mergedDevDocs.title = devdoc.title;
-			}
-		}
-
-		const userdoc = listElem.artifact.userdoc;
-		if (userdoc) {
-			mergeDoc(userdoc, mergedUserDocs, 'events');
-			mergeDoc(userdoc, mergedUserDocs, 'errors');
-			mergeDoc(userdoc, mergedUserDocs, 'methods');
-			if (userdoc.notice) {
-				if (mergedUserDocs.notice && mergedUserDocs.notice != userdoc.notice) {
-					throw new Error(`UserDoc notice conflict `);
-				}
-				mergedUserDocs.notice = userdoc.notice;
-			}
-		}
-	}
-	return {
-		mergedABI,
-		added,
-		mergedDevDocs,
-		mergedUserDocs,
-		sigJSMap,
-	};
-}

package/src/environment/utils/chains.ts

@@ -1,192 +0,0 @@
-import * as chains from 'viem/chains';
-import {kebabCase} from 'change-case';
-import {
-	ChainConfig,
-	ChainInfo,
-	ChainUserConfig,
-	Create2DeterministicDeploymentInfo,
-	Create3DeterministicDeploymentInfo,
-	ResolvedUserConfig,
-} from '../../types.js';
-
-export type ChainType = 'zksync' | 'op-stack' | 'celo' | 'default';
-
-const chainTypesByNames: {[chainExportName: string]: ChainType} = {
-	base: 'op-stack',
-	baseGoerli: 'op-stack',
-	baseSepolia: 'op-stack',
-	optimism: 'op-stack',
-	optimismGoerli: 'op-stack',
-	optimismSepolia: 'op-stack',
-	pgn: 'op-stack',
-	pgnTestnet: 'op-stack',
-	zora: 'op-stack',
-	zoraSepolia: 'op-stack',
-	zoraTestnet: 'op-stack',
-	ancient8: 'op-stack',
-	ancient8Sepolia: 'op-stack',
-	celoAlfajores: 'celo',
-	celo: 'celo',
-	zkSync: 'zksync',
-	zkSyncTestnet: 'zksync',
-	zkSyncSepoliaTestnet: 'zksync',
-};
-
-export const chainTypes: {[chainId: string]: ChainType} = {};
-
-export const chainById: {[chainId: string]: ChainInfo} = {};
-export const allChains: {[chainExportName: string]: ChainInfo} = {...((chains as any).default || chains)};
-allChains['localhost'] = allChains['hardhat'];
-
-for (const key of Object.keys(allChains)) {
-	const chain = (allChains as any)[key] as ChainInfo;
-	const chainId = chain.id.toString();
-	const specificChainType = chainTypesByNames[key];
-	if (specificChainType) {
-		chainTypes[chainId] = specificChainType;
-	}
-	chainById[chainId] = {...chain, chainType: specificChainType};
-}
-
-export const chainByCanonicalName: {[canonicalName: string]: ChainInfo} = {};
-for (const key of Object.keys(chainById)) {
-	const chain = (chainById as any)[key] as ChainInfo;
-	const canonicalName = kebabCase(chain.name);
-	chainByCanonicalName[canonicalName] = chain;
-}
-
-export function getChainById(id: string | number): ChainInfo | undefined {
-	const chain = chainById['' + id];
-
-	return chain;
-}
-
-export function getChainByName(name: string): ChainInfo | undefined {
-	const chain = chainByCanonicalName[name];
-	return chain;
-}
-
-export function getChainConfig(id: number, config: ResolvedUserConfig): ChainConfig {
-	const defaultChainInfo = getChainById(id);
-	const canonicalName = defaultChainInfo ? kebabCase(defaultChainInfo.name) : undefined;
-	if (canonicalName) {
-		if (config.chains?.[id] && config.chains?.[canonicalName]) {
-			throw new Error(
-				`chain should be configured by chainId or name but not both, remove either ${id} or ${canonicalName}`
-			);
-		}
-	}
-
-	let chainConfig: ChainUserConfig | undefined = config.chains?.[id];
-	if (!chainConfig && canonicalName) {
-		chainConfig = config.chains?.[canonicalName];
-	}
-	if (!chainConfig) {
-		chainConfig = {info: defaultChainInfo};
-	}
-
-	let chainInfo = chainConfig?.info || defaultChainInfo;
-
-	let rpcUrl = process.env['ETH_NODE_URI_' + id];
-	if (canonicalName) {
-		const fromEnv = process.env['ETH_NODE_URI_' + canonicalName];
-		if (fromEnv) {
-			rpcUrl = fromEnv;
-		}
-	}
-
-	if (!rpcUrl) {
-		rpcUrl = chainConfig.rpcUrl;
-	}
-
-	if (!rpcUrl) {
-		rpcUrl = chainConfig.info?.rpcUrls.default.http[0];
-	}
-
-	if (!rpcUrl) {
-		if (id === 31337 || id === 1337) {
-			rpcUrl = 'http://127.0.0.1:8545';
-		}
-	}
-
-	if (!chainInfo) {
-		if (!rpcUrl) {
-			throw new Error(`no chain info found for chain with id ${id}`);
-		} else {
-			console.error(`chain with id ${id} has no public info`);
-		}
-
-		chainInfo = {
-			id,
-			name: 'unkwown',
-			nativeCurrency: {
-				name: 'Unknown Currency',
-				symbol: 'UNKNOWN',
-				decimals: 18,
-			},
-			rpcUrls: {
-				default: {
-					http: [rpcUrl],
-				},
-			},
-			chainType: 'default',
-		};
-	}
-
-	const create2Info = {
-		factory: '0x4e59b44847b379578588920ca78fbf26c0b4956c',
-		deployer: '0x3fab184622dc19b6109349b94811493bf2a45362',
-		funding: '10000000000000000',
-		signedTx:
-			'0xf8a58085174876e800830186a08080b853604580600e600039806000f350fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf31ba02222222222222222222222222222222222222222222222222222222222222222a02222222222222222222222222222222222222222222222222222222222222222',
-	} as const;
-	const create3Info = {
-		factory: '0x000000000004d4f168daE7DB3C610F408eE22F57',
-		salt: '0x5361109ca02853ca8e22046b7125306d9ec4ae4cdecc393c567b6be861df3db6',
-		bytecode:
-			'0x6080604052348015600f57600080fd5b506103ca8061001f6000396000f3fe6080604052600436106100295760003560e01c8063360d0fad1461002e5780639881d19514610077575b600080fd5b34801561003a57600080fd5b5061004e610049366004610228565b61008a565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b61004e61008536600461029c565b6100ee565b6040517fffffffffffffffffffffffffffffffffffffffff000000000000000000000000606084901b166020820152603481018290526000906054016040516020818303038152906040528051906020012091506100e78261014c565b9392505050565b6040517fffffffffffffffffffffffffffffffffffffffff0000000000000000000000003360601b166020820152603481018290526000906054016040516020818303038152906040528051906020012091506100e734848461015e565b600061015882306101ce565b92915050565b60006f67363d3d37363d34f03d5260086018f3600052816010806000f58061018e5763301164256000526004601cfd5b8060145261d69460005260016034536017601e20915060008085516020870188855af1823b026101c65763301164256000526004601cfd5b509392505050565b60006040518260005260ff600b53836020527f21c35dbe1b344a2488cf3321d6ce542f8e9f305544ff09e4993a62319a497c1f6040526055600b20601452806040525061d694600052600160345350506017601e20919050565b6000806040838503121561023b57600080fd5b823573ffffffffffffffffffffffffffffffffffffffff8116811461025f57600080fd5b946020939093013593505050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b600080604083850312156102af57600080fd5b823567ffffffffffffffff8111156102c657600080fd5b8301601f810185136102d757600080fd5b803567ffffffffffffffff8111156102f1576102f161026d565b6040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0603f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8501160116810181811067ffffffffffffffff8211171561035d5761035d61026d565b60405281815282820160200187101561037557600080fd5b816020840160208301376000602092820183015296940135945050505056fea264697066735822122059dcc5dc6453397d13ff28021e28472a80a45bbd97f3135f69bd2650773aeb0164736f6c634300081a0033',
-		proxyBytecode: '0x67363d3d37363d34f03d5260086018f3',
-	} as const;
-
-	const pollingInterval = chainConfig.pollingInterval || config.defaultPollingInterval;
-
-	let deterministicDeployment: {
-		create2: Create2DeterministicDeploymentInfo;
-		create3: Create3DeterministicDeploymentInfo;
-	} = {
-		create2: (() => {
-			const deterministicDeployment = chainConfig.deterministicDeployment;
-			if (!deterministicDeployment) {
-				return create2Info;
-			}
-
-			return 'create2' in deterministicDeployment && deterministicDeployment.create2
-				? deterministicDeployment.create2
-				: !('create2' in deterministicDeployment) && !('create3' in deterministicDeployment)
-				? (deterministicDeployment as Create2DeterministicDeploymentInfo)
-				: create2Info;
-		})(),
-		create3:
-			chainConfig.deterministicDeployment &&
-			'create3' in chainConfig.deterministicDeployment &&
-			chainConfig.deterministicDeployment.create3
-				? chainConfig.deterministicDeployment.create3
-				: create3Info,
-	};
-
-	const defaultTags: string[] = [];
-	if (chainInfo.testnet) {
-		defaultTags.push('testnet');
-	}
-
-	const properties = chainConfig.properties || config.defaultChainProperties || {};
-
-	return {
-		info: {...chainInfo},
-		deterministicDeployment,
-		pollingInterval,
-		properties,
-		rpcUrl: rpcUrl || chainInfo.rpcUrls.default.http[0],
-		tags: chainConfig.tags || [...defaultTags],
-	};
-}

package/src/executor/setup.test.ts

@@ -1,151 +0,0 @@
-import type {Environment} from '../types.js';
-import {setup} from './index.js';
-
-// Mock environment for testing
-const mockEnv = {} as Environment;
-
-// Example utility functions that take Environment as first parameter
-const utilityFunctions = {
-	deployContract:
-		(env: Environment) =>
-		async (contractName: string, args: any[] = []): Promise<string> => {
-			console.log(`Deploying ${contractName} with args:`, args);
-			return '0x1234567890123456789012345678901234567890';
-		},
-
-	verifyContract:
-		(env: Environment) =>
-		async (address: string): Promise<boolean> => {
-			console.log(`Verifying contract at ${address}`);
-			return true;
-		},
-
-	getBalance:
-		(env: Environment) =>
-		async (address: string): Promise<bigint> => {
-			console.log(`Getting balance for ${address}`);
-			return BigInt('1000000000000000000'); // 1 ETH
-		},
-
-	calculateGas:
-		(env: Environment) =>
-		(operation: string): number => {
-			console.log(`Calculating gas for ${operation}`);
-			return 21000;
-		},
-
-	isDeployed:
-		(env: Environment) =>
-		(contractName: string): boolean => {
-			console.log(`Checking if ${contractName} is deployed`);
-			return false;
-		},
-
-	test: (env: Environment) => true,
-};
-
-// Create the enhanced execute function using setup
-const {deployScript} = setup(utilityFunctions);
-
-// Test the enhanced execute function
-const testScript = deployScript(
-	async (env, args) => {
-		// Type test: env should have both original Environment properties AND curried functions
-
-		// Test curried functions (no need to pass env)
-		const address = await env.deployContract('MyToken', ['TokenName', 'TKN']);
-		const isVerified = await env.verifyContract(address);
-		const balance = await env.getBalance(address);
-		const gasEstimate = env.calculateGas('transfer');
-		const deployed = env.isDeployed('MyToken');
-
-		// Test that original environment properties are still accessible
-		// (These would normally be available on a real environment)
-		// console.log('Network name:', env.network?.name);
-		// console.log('Chain ID:', env.network?.chain?.id);
-
-		console.log('Test results:', {
-			address,
-			isVerified,
-			balance: balance.toString(),
-			gasEstimate,
-			deployed,
-		});
-
-		return true; // Return true to indicate successful completion
-	},
-	{
-		tags: ['test'],
-		dependencies: [],
-		id: 'test-setup-function',
-	}
-);
-
-// Type tests - these should compile without errors
-async function testTypes() {
-	// The script should be a valid DeployScriptModule
-	console.log('Script tags:', testScript.tags);
-	console.log('Script dependencies:', testScript.dependencies);
-	console.log('Script ID:', testScript.id);
-
-	// The script should be callable with an environment
-	try {
-		const result = await testScript(mockEnv, undefined);
-		console.log('Script execution result:', result);
-	} catch (error) {
-		console.log('Script execution test completed (expected with mock env)');
-	}
-}
-
-// Example of how this would be used in a real deployment script
-export const exampleUsage = () => {
-	// Define your utility functions
-	const myFunctions = {
-		deployERC20:
-			(env: Environment) =>
-			async (name: string, symbol: string): Promise<string> => {
-				// Implementation would use env.save, env.network.provider, etc.
-				return '0x...';
-			},
-
-		setupPermissions:
-			(env: Environment) =>
-			async (contractAddress: string, admin: string): Promise<void> => {
-				// Implementation would interact with contracts
-			},
-
-		verifyOnEtherscan:
-			(env: Environment) =>
-			async (address: string, constructorArgs: any[]): Promise<boolean> => {
-				// Implementation would call verification service
-				return true;
-			},
-	};
-
-	// Create the enhanced execute function
-	const {deployScript} = setup(myFunctions);
-
-	// Export your deployment script
-	return deployScript(
-		async (env, args) => {
-			// Now you can use the functions without passing env each time
-			const tokenAddress = await env.deployERC20('MyToken', 'MTK');
-			await env.setupPermissions(tokenAddress, env.namedAccounts.deployer);
-			await env.verifyOnEtherscan(tokenAddress, ['MyToken', 'MTK']);
-
-			// Original environment is still fully accessible
-			console.log(`Deployed on environment: ${env.name}`);
-			const deployment = env.get('MyToken');
-
-			return true;
-		},
-		{
-			tags: ['token', 'deploy'],
-			dependencies: ['setup'],
-			id: 'deploy-my-token',
-		}
-	);
-};
-
-// Export for potential use in actual tests
-export {testTypes, testScript, utilityFunctions};

package/src/internal/logging.ts

@@ -1,80 +0,0 @@
-import {logs} from 'named-logs';
-
-import {hookup, factory as Logging} from 'named-logs-console';
-// import ora from 'ora-cjs';
-hookup();
-
-export function setLogLevel(level: number) {
-	Logging.level = level;
-	if (Logging.level > 0) {
-		Logging.enable();
-	} else {
-		Logging.disable();
-	}
-}
-
-export const logger = logs('rocketh');
-
-export type ProgressIndicator = {
-	start(msg?: string): ProgressIndicator;
-	stop(): ProgressIndicator;
-	succeed(msg?: string): ProgressIndicator;
-	fail(msg?: string): ProgressIndicator;
-};
-const loggerProgressIndicator: ProgressIndicator = {
-	start(msg?: string) {
-		if (msg) {
-			console.log(msg);
-		}
-		return this;
-	},
-	stop() {
-		return this;
-	},
-	succeed(msg?: string) {
-		if (msg) {
-			console.log(msg);
-		}
-		return this;
-	},
-	fail(msg?: string) {
-		if (msg) {
-			console.error(msg);
-		}
-		return this;
-	},
-};
-const voidProgressIndicator: ProgressIndicator = {
-	start() {
-		return this;
-	},
-	stop() {
-		return this;
-	},
-	succeed() {
-		return this;
-	},
-	fail() {
-		return this;
-	},
-};
-// export function spin(message: string): PartialOra {
-// 	return Logging.level > 0 ? ora(message).start() : voidProgressIndicator;
-// }
-
-// let lastSpin = ora('rocketh');
-let lastSpin = loggerProgressIndicator;
-export function spin(message?: string): ProgressIndicator {
-	if (Logging.level > 0) {
-		lastSpin = lastSpin.start(message);
-		return lastSpin;
-	} else {
-		return voidProgressIndicator;
-	}
-}
-
-export function log(message: string) {
-	if (Logging.level > 0) {
-		console.log(message);
-	}
-}

package/src/internal/types.ts

@@ -1,5 +0,0 @@
-export type InternalEnvironment = {
-	exportDeploymentsAsTypes(): Promise<void>;
-	recoverTransactionsIfAny(): Promise<void>;
-	recordMigration(id: string): void;
-};