hardhat-deploy 2.0.0-next.45 → 2.0.0-next.47

package/README.md

@@ -17,627 +17,6 @@ But you can provide your own module for advanced use case.
 
 There are already a few like `@rocketh/proxy` to deploy proxy declaratively like in hardhat-deploy v1 or `@rocketh/diamond` to deploy diamond declaratively.
 
-## What is it for?
+## Documentation:
 
-This hardhat plugin adds a mechanism to deploy contracts to any network, keeping track of them and replicating the same environment for testing.
-
-It also adds a mechanism to associate names to addresses, so test and deployment scripts can be reconfigured by simply changing the address a name points to, allowing different configurations per network. This also results in much clearer tests and deployment scripts (no more accounts[0] in your code).
-
-This plugin contains a lot more features too, all geared toward a better developer experience :
-
-- chain configuration export (via @rocketh/export)
-  (listing deployed contracts' addresses and their abis (useful for web apps))
-- library linking at the time of deployment.
-- deterministic deployment across networks.
-- support for specific deploy script per network (L1 vs L2 for example)
-- deployment dependency system (allowing you to only deploy what is needed).
-- deployment retrying (by saving pending tx): so you can feel confident when making a deployment that you can always recover.
-- deployments as test fixture via hardhat helpers
-- contains helpers to read and execute transaction on deployed contract referring to them by name.
-- save metadata of deployed contract so they can always be fully verified, via sourcify or etherscan.
-- ability to submit contract source to etherscan and sourcify for verification at any time. (Because hardhat-deploy will save all the necessary info, it can be executed at any time.)
-- support hardhat's fork feature so deployment can be accessed even when run through fork.
-- declarative proxy deployment with ability to upgrade them transparently, only if code changes.
-- this include support for [openzeppelin](https://openzeppelin.com) transparent proxies
-- diamond deployment with facets, allowing you to focus on what the new version will be. It will generate the diamondCut necessary to reach the new state.
-- support HRC (Hot Contract Replacement) via special proxy mechanism and file watch setup
-
-## hardhat-deploy in a nutshell
-
-Before going into the details, here is a very simple summary of the basic feature of **hardhat-deploy**.
-
-**hardhat-deploy** allows you to write [`deploy scripts`](#deploy-scripts) in the `deploy` folder. Each of these files that look as follows will be executed in turn when you execute the following task: `hardhat --network <networkName> deploy`
-
-```js
-// we import what we need from the #rocketh alias, see below for setup
-import { deployScript, artifacts } from "#rocketh";
-
-export default deployScript(
-  // this allow us to define our deploy function which takes as first argument an environment object
-  // This contaisn the function provided by the modules imported in 'rocketh.ts'
-  // along with other built-in functions and the named accounts
-  async ({ deployViaProxy, namedAccounts }) => {
-    const { deployer, admin } = namedAccounts;
-
-    const prefix = "proxy:";
-    await deployViaProxy(
-      "GreetingsRegistry",
-      {
-        account: deployer,
-        artifact: artifacts.GreetingsRegistry,
-        args: [prefix],
-      },
-      {
-        owner: admin,
-        linkedData: {
-          prefix,
-          admin,
-        },
-      }
-    );
-  },
-  // execute takes as a second argument an options object where you can specify tags and dependencies
-  { tags: ["GreetingsRegistry", "GreetingsRegistry_deploy"] }
-);
-```
-
-Furthermore you can also ensure these scripts are executed in test too by calling `await loadAndExecuteDeployments({provider: provider,});` in your tests.
-
-Amd you can call these in hardhat test fixture to benefit from caching optimization.
-
-This is a huge benefit for testing since you are not required to replicate the deployment procedure in your tests. The tag feature (as seen in the script above) and [dependencies](#deploy-scripts-tags-and-dependencies) will also make your life easier when writing complex deployment procedures.
-
-You can even group deploy scripts in different sub-folders and ensure they are executed in their logical order.
-
-## Installation
-
-Here is the basic for getting started
-
-Note: hardhat-deploy is alpha, see @next to get alpha version, if you do not specify @nextyou'll get v1
-
-::: code-group
-
-```bash [npm]
-npm install -D hardhat-deploy@next rocketh @rocketh/deploy @rocketh/read-execute
-```
-
-```bash [pnpm]
-pnpm add -D hardhat-deploy@next rocketh @rocketh/deploy @rocketh/read-execute
-```
-
-:::
-
-
-Then you need to add it to the plugins list of hardhat in hardhat.config.ts:
-
-```ts
-import HardhatDeploy from 'hardhat-deploy';
-...
-const config: HardhatUserConfig = {
-	plugins: [..., HardhatDeploy],
-...
-```
-
-
-We also recommend you add these to provide more features
-
-::: code-group
-
-```bash [npm]
-npm install -D @rocketh/proxy @rocketh/diamond @rocketh/export @rocketh/verifier @rocketh/doc
-```
-
-```bash [pnpm]
-pnpm add -D @rocketh/proxy @rocketh/diamond @rocketh/export @rocketh/verifier @rocketh/doc
-```
-
-:::
-
-Note that extensions like `@rocketh/proxy` need to be passed into the rocketh setup function so they can be used.
-
-The best way to do that is actually use the `rocketh.ts/js` config file itself to do that in one place.
-We also recommend you setup an alias for it  so you can import with `import .. from "#rocketh"` it from anywhere:
-You can set it up by settings imports in `package.json`
-
-
-```json
-{
-...
-"imports": {
-		"#rocketh": "./rocketh.js",
-	},
-}
-```
-
-Alternatively if you use typescript, you can instead use `tsconfig.json`
-
-```json
-{
-	"compilerOptions": {
-	  ...
-		"paths": {
-			"#rocketh": ["./rocketh.ts"]
-		}
-	}
-}
-```
-
-Example of `rocketh.ts` file:
-
-```typescript
-// ------------------------------------------------------------------------------------------------
-// Typed Config
-// ------------------------------------------------------------------------------------------------
-import { UserConfig } from "rocketh";
-export const config = {
-  accounts: {
-    deployer: {
-      default: 0,
-    },
-  },
-} as const satisfies UserConfig;
-
-// ------------------------------------------------------------------------------------------------
-// Imports and Re-exports
-// ------------------------------------------------------------------------------------------------
-// We regroup all what is needed for the deploy scripts
-// so that they just need to import this file
-// we add here the extension we need, so that they are available in the deploy scripts
-// extensions are simply function that accept as their first argument the Environment
-// by passing them to the setup function (see below) you get to access them through the environment object with type-safety
-import * as deployExtensions from '@rocketh/deploy'; // this one provide a deploy function
-import * as readExecuteFunctions from '@rocketh/read-execute'; // this one provide read,execute functions
-const extensions = {...deployExtensions, ...readExecuteExtensions};
-// ------------------------------------------------------------------------------------------------
-// we re-export the artifacts, so they are easily available from the alias
-import * as artifacts from './generated/artifacts.js';
-export {artifacts};
-// ------------------------------------------------------------------------------------------------
-// we create the rocketh function we need by passing the extensions
-import {setup} from 'rocketh';
-const {deployScript, loadAndExecuteDeployments} = setup<typeof extensions, typeof config.accounts, typeof config.data>(
-	extensions,
-);
-// ------------------------------------------------------------------------------------------------
-// we do the same for hardhat-deploy
-import {setupHardhatDeploy} from 'hardhat-deploy/helpers';
-const {loadEnvironmentFromHardhat} = setupHardhatDeploy(extensions);
-// ------------------------------------------------------------------------------------------------
-// finally we export them
-export {loadAndExecuteDeployments, deployScript, loadEnvironmentFromHardhat};
-```
-
-You can them create a deploy script in the `deploy` folder like so:
-
-```typescript
-// we import what we need from the #rocketh alias, see ../rocketh.ts
-import { deployScript, artifacts } from "#rocketh";
-
-export default deployScript(
-  async ({ deploy, namedAccounts }) => {
-    const { deployer } = namedAccounts;
-
-    await deploy("GreetingsRegistry", {
-      account: deployer,
-      artifact: artifacts.GreetingsRegistry,
-      args: [""],
-    });
-  },
-  // finally you can pass tags and dependencies
-  { tags: ["GreetingsRegistry", "GreetingsRegistry_deploy"] }
-);
-```
-
-See a template that uses **hardhat-deploy** here: https://github.com/wighawag/template-ethereum-contracts
-
-## Migrating from hardhat-deploy v1
-
-in v1 you would create a deploy file like this:
-
-```typescript
-// deploy/00_deploy_my_contract.js
-// export a function that get passed the Hardhat runtime environment
-module.exports = async ({ getNamedAccounts, deployments }) => {
-  const { deploy } = deployments;
-  const { deployer } = await getNamedAccounts();
-  await deploy("MyContract", {
-    from: deployer,
-    args: ["Hello"],
-    log: true,
-  });
-};
-// add tags and dependencies
-module.exports.tags = ["MyContract"];
-```
-
-and you would have configuraiton in hardhat.config.ts
-
-```typescript
- namedAccounts: {
-    deployer: 0,
-    ...
-  },
-```
-
-in v2 you will do this instead:
-
-```typescript
-/// we import what we need from the #rocketh alias, see ../rocketh.ts
-import { deployScript, artifacts } from "#rocketh";
-
-export default deployScript(
-  async ({ deploy, namedAccounts }) => {
-    const { deployer } = namedAccounts;
-
-    await deploy("MyContract", {
-      account: deployer,
-      artifact: artifacts.MyContract,
-      args: ["Hello"],
-    });
-  },
-  // finally you can pass tags and dependencies
-  { tags: ["MyContract"] }
-);
-```
-
-and you would have a `rocketh.ts/js` file as described in the [Setup](#setup)
-
-### Migrating existing deployment to hardhat-deploy
-
-> Only needed for an existing project that already deployed contracts and has the deployment information available **(at minimum, address, abi, bytecode and metadata)**
->
-> If you come from hardhat-deploy v1, there is nothing you should need to do as hardhat-deploy v2 will read your deployment files as usual.
-
-You might want to switch your current deployment process to use **hardhat-deploy**. In that case you probably have some deployments saved elsewhere.
-
-In order to port them to **hardhat-deploy**, you'll need to create one `.json` file per contract in the `deployments/<network>` folder (configurable via [paths config](#extra-paths-config)).
-
-The network folder is simply the hardhat network name (as configured in hardhat.config.js).
-Such folder need to have a file named `.chain` containing both the chainId as decimal and the genesisHash.
-If coming from hardhat-deploy v1, it will also accept a `.chainId` file containing only the chainId but will convert it
-
-For example for a network named "sepolia" (for the corresponding network) the file `deployments/rinkeby/.chain` would be
-
-```
-{"chainId":"11155111","genesisHash":"0x25a5cc106eea7138acab33231d7160d69cb777ee0c2c553fcddf5138993e6dd9"}
-```
-
-Each contract file must follow this type (as defined in [types.ts](types.ts)) :
-
-```typescript
-export type Deployment<TAbi extends Abi> = {
-  readonly address: EIP1193Account;
-  readonly abi: Narrow<TAbi>;
-  readonly transaction?: {
-    readonly hash: EIP1193DATA;
-    readonly origin?: EIP1193Account;
-    readonly nonce?: EIP1193DATA;
-  };
-  readonly receipt?: {
-    confirmations: number;
-    blockHash: EIP1193DATA;
-    blockNumber: EIP1193QUANTITY;
-    transactionIndex: EIP1193QUANTITY;
-  };
-  readonly bytecode: EIP1193DATA;
-  readonly argsData: EIP1193DATA;
-  readonly metadata: string;
-  readonly numDeployments?: number;
-  readonly libraries?: Libraries;
-  readonly linkedData?: any; // TODO
-  readonly deployedBytecode?: EIP1193DATA;
-  readonly linkReferences?: any; // TODO
-  readonly deployedLinkReferences?: any; // TODO
-  readonly contractName?: string;
-  readonly sourceName?: string; // relative path
-  readonly devdoc?: DevDoc;
-  readonly evm?: {
-    readonly gasEstimates?: GasEstimates | null;
-  } & any;
-  readonly storageLayout?: StorageLayout;
-  readonly userdoc?: UserDoc;
-} & Record<string, unknown>;
-```
-
-As you can see, not all fields are mandatory. But having the other fields allow more feature. For example, metadata and args allow you to benefit from contract code verification.
-
-Here is an example:
-
-Let's say you have:
-
-- 2 Contract named Greeter and Registry deployed on rinkeby
-- 1 contract named Greeter on mainnet
-- 2 Contract named Greeter and Registry deployed on a network named rinkeby2
-
-You would get the following folder structure:
-
-```
-deployments/
-  mainnet/
-    .chain
-    Greeter.json
-  rinkeby/
-    .chain
-    Greeter.json
-    Registry.json
-  rinkeby2/
-    .chain
-    Greeter.json
-    Registry.json
-```
-
-The reason why **hardhat-deploy** save chainId and genesisHash in the `.chain` file is both for
-
-- safety: so that if you were to change the network name to point to a different chain, it would not attempt to read the wrong folder and assume that a contract has been deployed while it has not.
-- ability to know the chainId without requiring to be connected to a node (and so not dependent on hardhat.config.js settings). Useful for `export` task.
-
-## Hardhat Tasks Available/Updated
-
-hardhat deploy currently add one task to hardhat. But since hardhat-deploy is now just a tiny wrapper arround rocketh, you can use rocketh commands too
-
-### 1. hardhat deploy
-
-This plugin adds the _deploy_ task to Hardhat.
-
-This task will execute the scripts in the `deploy` folder and save the contract deployments to disk. These deployments are supposed to be saved for example in a git repository. This way they can be accessed later. But you are free to save them elsewhere and get them back via your mechanism of choice.
-
-With the deployment saved, it allows you to deploy a contract only if changes were made.
-
-Deploy scripts (also called Deploy functions) can also perform arbitrary logic.
-
-For further details on how to use it and write deploy script, see [section](#deploy-scripts) below.
-
-### 2. rocketh-verify
-
-This command is provided by the optional package `@rocketh/verify`
-
-This command will submit the contract source and other info of all deployed contracts to allow services like etherscan, blockscout or sourcify to verify and record the sources.
-
-To execute that command, you need to specify the network to run against :
-
-```bash
-pnpm rocketh-verify -n <network-name> <etherscan|sourcify|blockscout>
-```
-
-For etherscan verification, you just need the ETHERSCAN_API_KEY en variable to be set.
-you can use a .env or .env.local file for that as rocketh will load them automatically.
-
-### 3. rocketh-export
-
-This command is provided by the optional package `@rocketh/export`
-
-This command will export the contract deployed (saved in `deployments` folder) to a file with a simple format containing only contract addresses and abi, useful for web apps.
-
-One of the following options need to be set for this task to have any effects :
-
-```bash
-rocketh-export -n <network-name> --ts <path-to-contracts.ts>
-```
-
-## Environment object and extension
-
-Each deploy function is given a environment object as first argument.
-
-it contains at least the following fields :
-
-```typescript
-export interface Environment<
-  NamedAccounts extends UnresolvedUnknownNamedAccounts = UnresolvedUnknownNamedAccounts,
-  Deployments extends UnknownDeployments = UnknownDeployments
-> {
-  network: {
-    chain: Chain;
-    name: string;
-    tags: { [tag: string]: boolean };
-    provider: TransactionHashTracker;
-  };
-  namedAccounts: ResolvedNamedAccounts<NamedAccounts>;
-  namedSigners: ResolvedNamedSigners<ResolvedNamedAccounts<NamedAccounts>>;
-  unnamedAccounts: EIP1193Account[];
-  addressSigners: { [name: `0x${string}`]: Signer };
-  save<TAbi extends Abi = Abi>(
-    name: string,
-    deployment: Deployment<TAbi>,
-    options?: { doNotCountAsNewDeployment?: boolean }
-  ): Promise<Deployment<TAbi>>;
-  savePendingDeployment<TAbi extends Abi = Abi>(
-    pendingDeployment: PendingDeployment<TAbi>
-  ): Promise<Deployment<TAbi>>;
-  savePendingExecution(
-    pendingExecution: PendingExecution
-  ): Promise<EIP1193TransactionReceipt>;
-  get<TAbi extends Abi>(name: string): Deployment<TAbi>;
-  getOrNull<TAbi extends Abi>(name: string): Deployment<TAbi> | null;
-  fromAddressToNamedABI<TAbi extends Abi>(
-    address: Address
-  ): { mergedABI: TAbi; names: string[] };
-  fromAddressToNamedABIOrNull<TAbi extends Abi>(
-    address: Address
-  ): { mergedABI: TAbi; names: string[] } | null;
-  showMessage(message: string): void;
-  showProgress(message?: string): ProgressIndicator;
-  hasMigrationBeenDone(id: string): boolean;
-}
-```
-
-And it is expanded by each module you import like `@rocketh/deploy` which adds a deploy function
-
-## Configuration
-
-Configuration of network or other hardhat specific config is done via hardhat.config.ts
-
-Else rocketh.ts/js is where you can configure hardhat-deploy/rocketh specific configs.
-
-### **1. namedAccounts (ability to name addresses)**
-
-The rocketh.js file need to export a config object
-
-For example
-
-```js
-import {UserConfig} from 'rocketh';
-export const config = {
-	accounts: {
-		deployer: {
-			default: 0,
-      sepolia: 1
-		},
-		admin: {
-			default: 1,
-		},
-	},
-} as const satisfies UserConfig;
-
-import * as artifacts from './generated/artifacts.js';
-export {artifacts};
-```
-
-This config file import modules too so that deploy script can simply import rocketh.js to have access to artifacts and specifc environment functions
-
-The named account feature allow you to define accounts by name and have them configurable by network
-
-In the above file, the deployer is set to be the first account on all network, except for sepolia where it is the second
-
-### **4. deterministicDeployment (ability to specify a deployment factory)**
-
----
-
-The config also allow you to set an optional `deterministicDeployment` field.
-
-`deterministicDeployment` allows you to associate information that are used on each network for deterministic deployment. The information for each deterministic deployment consist out of a `factory`, a `deployer`, the required `funding` and a `signedTx` to deploy the factory. The default deterministic deployment used is the [Deterministic Deployment Proxy](https://github.com/Arachnid/deterministic-deployment-proxy). The factory expects a 32 bytes `salt` concatenated with the deployment data (see [EIP-1014](https://eips.ethereum.org/EIPS/eip-1014) for more information on these parameters).
-
-Using the `deterministicDeployment` it is possible to define a different setup for the deterministic deployment. One use case for this is the deterministic deployment on networks that required replay protection (such as Celo or Avalanche). The [Deterministic Deployment Proxy](https://github.com/Arachnid/deterministic-deployment-proxy) can only be deployed on networks that don't enforce replay protection, therefore on other networks an alternative library has to be used. An example for this would be the [Safe Singleton Factory](https://github.com/gnosis/safe-singleton-factory) that is an adjusted version of the [Deterministic Deployment Proxy](https://github.com/Arachnid/deterministic-deployment-proxy) that contains signed transactions that include replay protection.
-
-```js
-import {UserConfig} from 'rocketh';
-export const config = {
-	accounts: {
-		deployer: {
-			default: 0,
-      sepolia: 1
-		},
-		admin: {
-			default: 1,
-		},
-	},
-  networks: {
-    sepolia: {
-        factory: '0x4e59b44847b379578588920ca78fbf26c0b4956c',
-        deployer: '0x3fab184622dc19b6109349b94811493bf2a45362',
-        funding: '10000000000000000',
-        signedTx:
-          '0xf8a58085174876e800830186a08080b853604580600e600039806000f350fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe03601600081602082378035828234f58015156039578182fd5b8082525050506014600cf31ba02222222222222222222222222222222222222222222222222222222222222222a02222222222222222222222222222222222222222222222222222222222222222',
-      }
-  }
-} as const satisfies UserConfig;
-```
-
-## How to Deploy Contracts
-
----
-
-### The `deploy` Task
-
-`hardhat --network <networkName> deploy`
-
-This is a new task that the `hardhat-deploy` adds. As the name suggests it deploys contracts.
-To be exact it will look for files in the folder `deploy`
-
-It will scan for files in alphabetical order and execute them in turn.
-
-- it will `import` each of these files and execute the exported function
-
-To specify the network, you can use the builtin hardhat argument `--network <network name>`
-
-> :warning: Note that running `hardhat deploy` without specifying a network will use the default network. If the default network is hardhat (the default's default) then nothing will happen as a result as everything happens in memory, but this can be used to ensure the deployment is without issues.
-
----
-
-### Deploy Scripts
-
-The deploy scripts need to call the execute function exported by `rocketh`
-
-The execute expect as first argument a function
-
-For example this script will deploy the `GreetingsRegistry` contract
-
-```typescript
-import { deployScript, artifacts } from "#rocketh";
-export default deployScript(
-  async ({ deploy, namedAccounts }) => {
-    const { deployer } = namedAccounts;
-
-    await deploy("GreetingsRegistry", {
-      account: deployer,
-      artifact: artifacts.GreetingsRegistry,
-      args: [""],
-    });
-  },
-
-  { tags: ["GreetingsRegistry", "GreetingsRegistry_deploy"] }
-);
-```
-
-The tags is a list of string that when the _deploy_ task is executed with, the script will be executed (unless it skips). In other word if the deploy task is executed with a tag that does not belong to that script, that script will not be executed unless it is a dependency of a script that does get executed.
-
-The dependencies is a list of tag that will be executed if that script is executed. So if the script is executed, every script whose tag match any of the dependencies will be executed first.
-
-Finally the function can return true if it wishes to never be executed again. This can be useful to emulate migration scripts that are meant to be executed only once. Once such script return true (async), the `id` field is used to track execution and if that field is not present when the script return true, it will fails.
-
-In other words, if you want a particular deploy script to run only once, it needs to both return true (async) and have an `id` set.
-
-In any case, as a general advice every deploy function should be idempotent. This is so they can always recover from failure or pending transaction. This is what underpin most of hardhat-deploy philosophy.
-
-This is why the `deploy` function provided by `@rocketh/deploy` will by default only deploy if the contract code has changed, making it easier to write idempotent script.
-
-### Environment and function provided by rocketh modules
-
-By default rocketh environment only provide function to read and write deployments. It has no `deploy` function on its own.
-
-These are provided by external modules but few are already available like `@rocketh/deploy`, `@rocketh/proxy` and `@rocketh/diamond` each with its own specific use case.
-
-#### `@rocketh/deploy`
-
-#### `@rocketh/proxy`
-
-#### `@rocketh/diamond`
-
-## Handling contract using libraries
-
-In the deploy function, one of the `DeployOptions` field is the `libraries` field. It allows you to associate external contract as libraries at the time of deployment.
-
-First, you have deploy the library using the `deploy` function, then when we deploy a contract that needs the linked library, we can pass the deployed library name and address in as an argument to the `libraries` object.
-
-First step: deploy the library:
-
-```js
-const exampleLibrary = await deploy("ExampleLibary", {
-  artifact: artifacts.ExampleLibary,
-    from: <deployer>
-});
-
-```
-
-ExampleLibrary is now deployed to whatever network was chosen (`hardhat deploy --network <networkName>`)
-
-For example, if we are deploying on Sepolia, this library will get deployed on sepolia, and the `exampleLibrary` variable will be a deployment object that contains the abi as well as the deployed address for the contract.
-
-Now that the library is deployed, we can link it in our next deployed contract.
-
-```js
-const example = await deploy(
-  "Example",
-  {
-    account: deployer,
-    artifact: artifacts.Example,
-    args: ["example string argument for the 'Example' contract constructor"],
-  },
-  {
-    libraries: {
-      ExampleLibrary: exampleLibrary.address,
-    },
-  }
-);
-```
-
-This `libraries` object takes the name of the library, and its deployed address on the network. Multiple libraries can be passed into the `libraries` object.
+Please find the [documentation here](https://rocketh.dev/hardhat-deploy)

package/dist/esm/helpers.d.ts

@@ -1,4 +1,4 @@
-import { EdrNetworkUserConfig, NetworkUserConfig, SensitiveString } from 'hardhat/types/config';
+import { NetworkUserConfig, SensitiveString } from 'hardhat/types/config';
 import { HardhatRuntimeEnvironment } from 'hardhat/types/hre';
 import { NetworkConnection } from 'hardhat/types/network';
 import { Environment, UnresolvedUnknownNamedAccounts, UnresolvedNetworkSpecificData } from 'rocketh';
@@ -6,22 +6,29 @@ export declare function setupHardhatDeploy<Extensions extends Record<string, (en
     loadEnvironmentFromHardhat: (required: {
         hre: HardhatRuntimeEnvironment;
         connection?: NetworkConnection;
-    }, options?: {
-        useChainIdOfForkedNetwork?: boolean;
     }) => Promise<import("rocketh").EnhancedEnvironment<UnresolvedUnknownNamedAccounts, UnresolvedNetworkSpecificData, import("rocketh").UnknownDeployments, Extensions, Record<string, unknown>>>;
 };
+export declare function generateForkConfig(params: {
+    hre: HardhatRuntimeEnvironment;
+    connection?: NetworkConnection;
+}): Promise<{
+    provider: any;
+    environment: string | {
+        fork: string;
+    };
+    connection: NetworkConnection;
+    isFork: boolean;
+}>;
 export declare function loadEnvironmentFromHardhat<NamedAccounts extends UnresolvedUnknownNamedAccounts = UnresolvedUnknownNamedAccounts, Data extends UnresolvedNetworkSpecificData = UnresolvedNetworkSpecificData>(params: {
     hre: HardhatRuntimeEnvironment;
     connection?: NetworkConnection;
-}, options?: {
-    useChainIdOfForkedNetwork?: boolean;
 }): Promise<Environment<NamedAccounts, Data>>;
 export declare function getRPC(networkName: string): string | SensitiveString | undefined;
-export declare function getMnemonic(networkName?: string): string | SensitiveString;
-export declare function getAccounts(networkName?: string): {
+export declare function getMnemonic(networkName?: string, failsOnNoMnemonicSet?: boolean): string | SensitiveString;
+export declare function getAccounts(networkName?: string, failsOnNoMnemonicSet?: boolean): {
     mnemonic: string | SensitiveString;
 };
 export declare function addNetworksFromEnv(networks?: Record<string, NetworkUserConfig>): Record<string, NetworkUserConfig>;
-export declare function populateNetworksFromEnv(networks: Record<string, Omit<NetworkUserConfig, 'accounts' | 'url'> | EdrNetworkUserConfig>): Record<string, NetworkUserConfig>;
+export declare function addNetworksFromKnownList(networks?: Record<string, NetworkUserConfig>): Record<string, NetworkUserConfig>;
 export declare function addForkConfiguration(networks: Record<string, NetworkUserConfig>): Record<string, NetworkUserConfig>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,oBAAoB,EAEpB,iBAAiB,EACjB,eAAe,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,yBAAyB,EAAC,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,WAAW,EACX,8BAA8B,EAC9B,6BAA6B,EAG7B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,kBAAkB,CACjC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,EAAE,EAChF,aAAa,SAAS,8BAA8B,GAAG,8BAA8B,EACrF,IAAI,SAAS,6BAA6B,GAAG,6BAA6B,EACzE,UAAU,EAAE,UAAU;2CAEZ;QAAC,GAAG,EAAE,yBAAyB,CAAC;QAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;KAAC,YAChE;QACT,yBAAyB,CAAC,EAAE,OAAO,CAAC;KACpC;EASF;AAED,wBAAsB,0BAA0B,CAC/C,aAAa,SAAS,8BAA8B,GAAG,8BAA8B,EACrF,IAAI,SAAS,6BAA6B,GAAG,6BAA6B,EAE1E,MAAM,EAAE;IAAC,GAAG,EAAE,yBAAyB,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAAC,EACxE,OAAO,CAAC,EAAE;IACT,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACpC,GACC,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAuE3C;AAiBD,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAuBhF;AAED,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAc1E;AAED,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;CAAC,CAEtF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAuBlH;AAED,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,oBAAoB,CAAC,GAC1F,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAuBnC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAsDnH"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,iBAAiB,EACjB,eAAe,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,yBAAyB,EAAC,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,WAAW,EACX,8BAA8B,EAC9B,6BAA6B,EAI7B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,kBAAkB,CACjC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,EAAE,EAChF,aAAa,SAAS,8BAA8B,GAAG,8BAA8B,EACrF,IAAI,SAAS,6BAA6B,GAAG,6BAA6B,EACzE,UAAU,EAAE,UAAU;2CAEZ;QAAC,GAAG,EAAE,yBAAyB,CAAC;QAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;KAAC;EAY3E;AAED,wBAAsB,kBAAkB,CACvC,MAAM,EAAE;IAAC,GAAG,EAAE,yBAAyB,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAAC,GAItE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAC,CAsEhH;AAED,wBAAsB,0BAA0B,CAC/C,aAAa,SAAS,8BAA8B,GAAG,8BAA8B,EACrF,IAAI,SAAS,6BAA6B,GAAG,6BAA6B,EAE1E,MAAM,EAAE;IAAC,GAAG,EAAE,yBAAyB,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAAC,GAKtE,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAW3C;AAiBD,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAuBhF;AAED,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,CAmB1G;AAED,wBAAgB,WAAW,CAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,OAAO,GAC5B;IAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;CAAC,CAEtC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAuBlH;AAGD,wBAAgB,wBAAwB,CACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAsBnC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAoDnH"}

package/dist/esm/helpers.js

@@ -1,53 +1,60 @@
 import { configVariable } from 'hardhat/config';
-import { loadEnvironment, enhanceEnvIfNeeded, } from 'rocketh';
+import { loadEnvironment, enhanceEnvIfNeeded, chainByCanonicalName, } from 'rocketh';
 export function setupHardhatDeploy(extensions) {
-    async function loadEnvironmentFromHardhatWithExtensions(required, options) {
-        const env = await loadEnvironmentFromHardhat(required, options);
+    async function loadEnvironmentFromHardhatWithExtensions(required
+    // options?: {
+    // 	useChainIdOfForkedNetwork?: boolean;
+    // }
+    ) {
+        const env = await loadEnvironmentFromHardhat(required);
         return enhanceEnvIfNeeded(env, extensions);
     }
     return {
         loadEnvironmentFromHardhat: loadEnvironmentFromHardhatWithExtensions,
     };
 }
-export async function loadEnvironmentFromHardhat(params, options) {
-    const connection = params.connection || (await params.hre.network.connect());
+export async function generateForkConfig(params
+// options?: {
+// 	useChainIdOfForkedNetwork?: boolean;
+// }
+) {
+    const fork = process.env.HARDHAT_FORK;
+    const connection = params.connection || fork
+        ? await params.hre.network.connect({ network: 'fork' })
+        : await params.hre.network.connect();
     let provider = connection.provider;
-    let network = connection.networkName;
+    let environment = connection.networkName;
     let forkChainId;
-    const fork = process.env.HARDHAT_FORK;
     if (fork) {
-        if (options?.useChainIdOfForkedNetwork) {
-            const forkNetworkConfig = params.hre.config.networks[fork];
-            if (forkNetworkConfig.type === 'edr-simulated') {
-                forkChainId = forkNetworkConfig.chainId;
-            }
-            else if (forkNetworkConfig.chainId) {
-                forkChainId = forkNetworkConfig.chainId;
-            }
-            else {
-                if ('url' in forkNetworkConfig) {
-                    const url = await forkNetworkConfig.url.getUrl();
-                    const response = await fetch(url, {
-                        method: 'POST',
-                        headers: {
-                            'Content-Type': 'application/json',
-                        },
-                        body: JSON.stringify({
-                            jsonrpc: '2.0',
-                            id: 1,
-                            method: 'eth_chainId',
-                            params: [],
-                        }),
-                    });
-                    const json = (await response.json());
-                    forkChainId = Number(json.result);
-                }
-                else {
-                    throw new Error(`cannot fetch chainId`);
-                }
-            }
-        }
-        network = {
+        // if (options?.useChainIdOfForkedNetwork) {
+        // 	const forkNetworkConfig = params.hre.config.networks[fork];
+        // 	if (forkNetworkConfig.type === 'edr-simulated') {
+        // 		forkChainId = forkNetworkConfig.chainId;
+        // 	} else if (forkNetworkConfig.chainId) {
+        // 		forkChainId = forkNetworkConfig.chainId;
+        // 	} else {
+        // 		if ('url' in forkNetworkConfig) {
+        // 			const url = await forkNetworkConfig.url.getUrl();
+        // 			const response = await fetch(url, {
+        // 				method: 'POST',
+        // 				headers: {
+        // 					'Content-Type': 'application/json',
+        // 				},
+        // 				body: JSON.stringify({
+        // 					jsonrpc: '2.0',
+        // 					id: 1,
+        // 					method: 'eth_chainId',
+        // 					params: [],
+        // 				}),
+        // 			});
+        // 			const json = (await response.json()) as {result: string};
+        // 			forkChainId = Number(json.result);
+        // 		} else {
+        // 			throw new Error(`cannot fetch chainId`);
+        // 		}
+        // 	}
+        // }
+        environment = {
             fork,
         };
     }
@@ -71,13 +78,23 @@ export async function loadEnvironmentFromHardhat(params, options) {
             },
         });
     }
+    return { provider, environment, connection, isFork: !!fork };
+}
+export async function loadEnvironmentFromHardhat(params
+// TODO ?
+// options?: {
+// 	useChainIdOfForkedNetwork?: boolean;
+// }
+) {
+    const { connection, environment, provider, isFork } = await generateForkConfig(params);
     // console.log(`loading environments...`);
     return loadEnvironment({
         provider,
-        network,
+        environment,
         extra: {
             connection,
         },
+        saveDeployments: isFork ? false : undefined,
     });
 }
 function getVariable(prefix, name) {
@@ -116,7 +133,7 @@ export function getRPC(networkName) {
     }
     return uri;
 }
-export function getMnemonic(networkName) {
+export function getMnemonic(networkName, failsOnNoMnemonicSet) {
     if (networkName) {
         const mnemonic = getVariable('MNEMONIC_', networkName);
         if (mnemonic && mnemonic !== '') {
@@ -125,12 +142,15 @@ export function getMnemonic(networkName) {
     }
     const mnemonic = process.env.MNEMONIC;
     if (!mnemonic || mnemonic === '') {
+        if (failsOnNoMnemonicSet) {
+            throw new Error(`no mnemonic set for ${networkName} (via env variable 'MNEMONIC_${networkName}') or globally (via 'MNEMONIC_')`);
+        }
         return 'test test test test test test test test test test test junk';
     }
     return mnemonic;
 }
-export function getAccounts(networkName) {
-    return { mnemonic: getMnemonic(networkName) };
+export function getAccounts(networkName, failsOnNoMnemonicSet) {
+    return { mnemonic: getMnemonic(networkName, failsOnNoMnemonicSet) };
 }
 export function addNetworksFromEnv(networks) {
     const newNetworks = networks ? { ...networks } : {};
@@ -158,29 +178,28 @@ export function addNetworksFromEnv(networks) {
     }
     return newNetworks;
 }
-export function populateNetworksFromEnv(networks) {
-    const newNetworks = {};
-    for (const networkName of Object.keys(networks)) {
-        const network = networks[networkName];
-        if (network.type === 'edr-simulated') {
-            // we leave memory network alone
-            newNetworks[networkName] = network;
-        }
-        else {
-            const url = getRPC(networkName);
+const listOfNetworkNamesWithTestAccountAllowed = ['hardhat', 'localhost', 'memory', 'test'];
+export function addNetworksFromKnownList(networks) {
+    const newNetworks = networks ? { ...networks } : {};
+    const canonicalNames = Object.keys(chainByCanonicalName);
+    for (const canonicalName of canonicalNames) {
+        const chain = chainByCanonicalName[canonicalName];
+        const url = getRPC(canonicalName) || chain.rpcUrls.default.http[0];
+        if (!newNetworks[canonicalName]) {
             if (url) {
-                newNetworks[networkName] = {
-                    ...network,
+                newNetworks[canonicalName] = {
+                    type: 'http',
                     url,
-                    accounts: getAccounts(networkName),
+                    accounts: getAccounts(canonicalName, !listOfNetworkNamesWithTestAccountAllowed.includes(canonicalName)),
                 };
             }
             else {
-                if (!('url' in network) || !network.url) {
-                    console.error(`no url for network ${networkName}`);
-                }
+                console.error(`no url for chain ${canonicalName}`);
             }
         }
+        else {
+            // console.error(`duplicated chain ${canonicalName}`);
+        }
     }
     return newNetworks;
 }
@@ -211,15 +230,13 @@ export function addForkConfiguration(networks) {
             }
         }
     }
-    const existingHardhat = networks.hardhat && networks.hardhat.type === 'edr-simulated'
-        ? networks.hardhat
-        : { type: 'edr-simulated', chainType: 'l1' };
+    const existingForkConfiguration = networks.fork && networks.fork.type === 'edr-simulated' ? networks.fork : { type: 'edr-simulated', chainType: 'l1' };
     const newNetworks = {
-        ...populateNetworksFromEnv(networks),
-        hardhat: {
-            ...existingHardhat,
+        ...networks,
+        fork: {
+            ...existingForkConfiguration,
             ...{
-                accounts: hardhatAccounts || existingHardhat?.accounts,
+                accounts: hardhatAccounts || existingForkConfiguration?.accounts,
                 forking: forkURL
                     ? {
                         url: forkURL,

package/dist/esm/helpers.js.map

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

package/dist/esm/tasks/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/tasks/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAG1D,UAAU,kBAAkB;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,QAAA,MAAM,oBAAoB,EAAE,qBAAqB,CAAC,kBAAkB,CAwBnE,CAAC;AACF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/tasks/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAI1D,UAAU,kBAAkB;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,QAAA,MAAM,oBAAoB,EAAE,qBAAqB,CAAC,kBAAkB,CA0BnE,CAAC;AACF,eAAe,oBAAoB,CAAC"}

package/dist/esm/tasks/deploy.js

@@ -1,8 +1,9 @@
 import { loadAndExecuteDeployments } from 'rocketh';
+import { generateForkConfig } from '../helpers.js';
 const runScriptWithHardhat = async (args, hre) => {
     let saveDeployments = true;
     let skipPrompts = args.skipPrompts ? true : false;
-    const connection = await hre.network.connect();
+    const { connection, environment, isFork, provider } = await generateForkConfig({ hre });
     const isMemoryNetwork = connection.networkConfig.type == 'edr-simulated';
     if (isMemoryNetwork) {
         skipPrompts = true;
@@ -14,11 +15,11 @@ const runScriptWithHardhat = async (args, hre) => {
     const tags = args.tags && args.tags != '' ? args.tags : undefined;
     await loadAndExecuteDeployments({
         logLevel: 1,
-        provider: connection.provider, // TODO type
-        network: process.env.HARDHAT_FORK ? { fork: process.env.HARDHAT_FORK } : connection.networkName,
-        saveDeployments,
+        provider,
+        environment: environment,
+        saveDeployments: isFork ? false : saveDeployments,
         askBeforeProceeding: skipPrompts ? false : true,
-        tags,
+        tags: tags?.split(','),
         // reportGasUse: args.skipGasReport ? false : true,
         extra: { connection },
     });

package/dist/esm/tasks/deploy.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/tasks/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,yBAAyB,EAAC,MAAM,SAAS,CAAC;AAQlD,MAAM,oBAAoB,GAA8C,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC3F,IAAI,eAAe,GAAG,IAAI,CAAC;IAC3B,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,MAAM,eAAe,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,IAAI,eAAe,CAAC;IACzE,IAAI,eAAe,EAAE,CAAC;QACrB,WAAW,GAAG,IAAI,CAAC;QACnB,eAAe,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QAChC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,MAAM,yBAAyB,CAAC;QAC/B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,UAAU,CAAC,QAA0B,EAAE,YAAY;QAC7D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAC,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW;QAC7F,eAAe;QACf,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC/C,IAAI;QACJ,mDAAmD;QACnD,KAAK,EAAE,EAAC,UAAU,EAAC;KACnB,CAAC,CAAC;AACJ,CAAC,CAAC;AACF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/tasks/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,yBAAyB,EAAC,MAAM,SAAS,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAQjD,MAAM,oBAAoB,GAA8C,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC3F,IAAI,eAAe,GAAG,IAAI,CAAC;IAC3B,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAElD,MAAM,EAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAC,GAAG,MAAM,kBAAkB,CAAC,EAAC,GAAG,EAAC,CAAC,CAAC;IAEpF,MAAM,eAAe,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,IAAI,eAAe,CAAC;IACzE,IAAI,eAAe,EAAE,CAAC;QACrB,WAAW,GAAG,IAAI,CAAC;QACnB,eAAe,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QAChC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,MAAM,yBAAyB,CAAC;QAC/B,QAAQ,EAAE,CAAC;QACX,QAAQ;QACR,WAAW,EAAE,WAAW;QACxB,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;QACjD,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC/C,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;QACtB,mDAAmD;QACnD,KAAK,EAAE,EAAC,UAAU,EAAC;KACnB,CAAC,CAAC;AACJ,CAAC,CAAC;AACF,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat-deploy",
-  "version": "2.0.0-next.45",
+  "version": "2.0.0-next.47",
   "description": "deployment plugin for hardhat",
   "publishConfig": {
     "access": "public"
@@ -28,25 +28,25 @@
     "src"
   ],
   "devDependencies": {
-    "@changesets/cli": "^2.29.6",
-    "@types/node": "^24.3.0",
+    "@changesets/cli": "^2.29.7",
+    "@types/node": "^24.5.2",
     "as-soon": "^0.0.11",
-    "hardhat": "3.0.3",
+    "hardhat": "3.0.6",
     "rimraf": "^6.0.1",
-    "rocketh": "^0.14.4",
+    "rocketh": "0.15.0",
     "set-defaults": "^0.0.5",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "hardhat": "^3.0.0",
-    "rocketh": "^0.14.4"
+    "hardhat": "^3.0.6",
+    "rocketh": "^0.15.0"
   },
   "dependencies": {
-    "@nomicfoundation/hardhat-zod-utils": "3.0.0",
+    "@nomicfoundation/hardhat-zod-utils": "3.0.1",
     "@types/debug": "^4.1.12",
-    "debug": "^4.4.1",
+    "debug": "^4.4.3",
     "slash": "^5.1.0",
-    "zod": "^4.1.5"
+    "zod": "^4.1.9"
   },
   "scripts": {
     "build": "tsc --project tsconfig.json",

package/src/helpers.ts

@@ -14,6 +14,7 @@ import {
 	UnresolvedNetworkSpecificData,
 	loadEnvironment,
 	enhanceEnvIfNeeded,
+	chainByCanonicalName,
 } from 'rocketh';
 
 export function setupHardhatDeploy<
@@ -22,12 +23,12 @@ export function setupHardhatDeploy<
 	Data extends UnresolvedNetworkSpecificData = UnresolvedNetworkSpecificData
 >(extensions: Extensions) {
 	async function loadEnvironmentFromHardhatWithExtensions(
-		required: {hre: HardhatRuntimeEnvironment; connection?: NetworkConnection},
-		options?: {
-			useChainIdOfForkedNetwork?: boolean;
-		}
+		required: {hre: HardhatRuntimeEnvironment; connection?: NetworkConnection}
+		// options?: {
+		// 	useChainIdOfForkedNetwork?: boolean;
+		// }
 	) {
-		const env = await loadEnvironmentFromHardhat<NamedAccounts, Data>(required, options);
+		const env = await loadEnvironmentFromHardhat<NamedAccounts, Data>(required);
 		return enhanceEnvIfNeeded(env, extensions);
 	}
 
@@ -36,52 +37,55 @@ export function setupHardhatDeploy<
 	};
 }
 
-export async function loadEnvironmentFromHardhat<
-	NamedAccounts extends UnresolvedUnknownNamedAccounts = UnresolvedUnknownNamedAccounts,
-	Data extends UnresolvedNetworkSpecificData = UnresolvedNetworkSpecificData
->(
-	params: {hre: HardhatRuntimeEnvironment; connection?: NetworkConnection},
-	options?: {
-		useChainIdOfForkedNetwork?: boolean;
-	}
-): Promise<Environment<NamedAccounts, Data>> {
-	const connection = params.connection || (await params.hre.network.connect());
+export async function generateForkConfig(
+	params: {hre: HardhatRuntimeEnvironment; connection?: NetworkConnection}
+	// options?: {
+	// 	useChainIdOfForkedNetwork?: boolean;
+	// }
+): Promise<{provider: any; environment: string | {fork: string}; connection: NetworkConnection; isFork: boolean}> {
+	const fork = process.env.HARDHAT_FORK as string | undefined;
+
+	const connection =
+		params.connection || fork
+			? await params.hre.network.connect({network: 'fork'})
+			: await params.hre.network.connect();
+
 	let provider: any = connection.provider;
-	let network: string | {fork: string} = connection.networkName;
+	let environment: string | {fork: string} = connection.networkName;
 	let forkChainId: number | undefined;
-	const fork = process.env.HARDHAT_FORK as string | undefined;
+
 	if (fork) {
-		if (options?.useChainIdOfForkedNetwork) {
-			const forkNetworkConfig = params.hre.config.networks[fork];
+		// if (options?.useChainIdOfForkedNetwork) {
+		// 	const forkNetworkConfig = params.hre.config.networks[fork];
 
-			if (forkNetworkConfig.type === 'edr-simulated') {
-				forkChainId = forkNetworkConfig.chainId;
-			} else if (forkNetworkConfig.chainId) {
-				forkChainId = forkNetworkConfig.chainId;
-			} else {
-				if ('url' in forkNetworkConfig) {
-					const url = await forkNetworkConfig.url.getUrl();
-					const response = await fetch(url, {
-						method: 'POST',
-						headers: {
-							'Content-Type': 'application/json',
-						},
-						body: JSON.stringify({
-							jsonrpc: '2.0',
-							id: 1,
-							method: 'eth_chainId',
-							params: [],
-						}),
-					});
-					const json = (await response.json()) as {result: string};
-					forkChainId = Number(json.result);
-				} else {
-					throw new Error(`cannot fetch chainId`);
-				}
-			}
-		}
+		// 	if (forkNetworkConfig.type === 'edr-simulated') {
+		// 		forkChainId = forkNetworkConfig.chainId;
+		// 	} else if (forkNetworkConfig.chainId) {
+		// 		forkChainId = forkNetworkConfig.chainId;
+		// 	} else {
+		// 		if ('url' in forkNetworkConfig) {
+		// 			const url = await forkNetworkConfig.url.getUrl();
+		// 			const response = await fetch(url, {
+		// 				method: 'POST',
+		// 				headers: {
+		// 					'Content-Type': 'application/json',
+		// 				},
+		// 				body: JSON.stringify({
+		// 					jsonrpc: '2.0',
+		// 					id: 1,
+		// 					method: 'eth_chainId',
+		// 					params: [],
+		// 				}),
+		// 			});
+		// 			const json = (await response.json()) as {result: string};
+		// 			forkChainId = Number(json.result);
+		// 		} else {
+		// 			throw new Error(`cannot fetch chainId`);
+		// 		}
+		// 	}
+		// }
 
-		network = {
+		environment = {
 			fork,
 		};
 	}
@@ -107,13 +111,28 @@ export async function loadEnvironmentFromHardhat<
 		});
 	}
 
+	return {provider, environment, connection, isFork: !!fork};
+}
+
+export async function loadEnvironmentFromHardhat<
+	NamedAccounts extends UnresolvedUnknownNamedAccounts = UnresolvedUnknownNamedAccounts,
+	Data extends UnresolvedNetworkSpecificData = UnresolvedNetworkSpecificData
+>(
+	params: {hre: HardhatRuntimeEnvironment; connection?: NetworkConnection}
+	// TODO ?
+	// options?: {
+	// 	useChainIdOfForkedNetwork?: boolean;
+	// }
+): Promise<Environment<NamedAccounts, Data>> {
+	const {connection, environment, provider, isFork} = await generateForkConfig(params);
 	// console.log(`loading environments...`);
 	return loadEnvironment<NamedAccounts, Data>({
 		provider,
-		network,
+		environment,
 		extra: {
 			connection,
 		},
+		saveDeployments: isFork ? false : undefined,
 	});
 }
 
@@ -157,7 +176,7 @@ export function getRPC(networkName: string): string | SensitiveString | undefine
 	return uri;
 }
 
-export function getMnemonic(networkName?: string): string | SensitiveString {
+export function getMnemonic(networkName?: string, failsOnNoMnemonicSet?: boolean): string | SensitiveString {
 	if (networkName) {
 		const mnemonic = getVariable('MNEMONIC_', networkName);
 
@@ -168,13 +187,21 @@ export function getMnemonic(networkName?: string): string | SensitiveString {
 
 	const mnemonic = process.env.MNEMONIC;
 	if (!mnemonic || mnemonic === '') {
+		if (failsOnNoMnemonicSet) {
+			throw new Error(
+				`no mnemonic set for ${networkName} (via env variable 'MNEMONIC_${networkName}') or globally (via 'MNEMONIC_')`
+			);
+		}
 		return 'test test test test test test test test test test test junk';
 	}
 	return mnemonic;
 }
 
-export function getAccounts(networkName?: string): {mnemonic: string | SensitiveString} {
-	return {mnemonic: getMnemonic(networkName)};
+export function getAccounts(
+	networkName?: string,
+	failsOnNoMnemonicSet?: boolean
+): {mnemonic: string | SensitiveString} {
+	return {mnemonic: getMnemonic(networkName, failsOnNoMnemonicSet)};
 }
 
 export function addNetworksFromEnv(networks?: Record<string, NetworkUserConfig>): Record<string, NetworkUserConfig> {
@@ -202,28 +229,28 @@ export function addNetworksFromEnv(networks?: Record<string, NetworkUserConfig>)
 	return newNetworks;
 }
 
-export function populateNetworksFromEnv(
-	networks: Record<string, Omit<NetworkUserConfig, 'accounts' | 'url'> | EdrNetworkUserConfig>
+const listOfNetworkNamesWithTestAccountAllowed = ['hardhat', 'localhost', 'memory', 'test'];
+export function addNetworksFromKnownList(
+	networks?: Record<string, NetworkUserConfig>
 ): Record<string, NetworkUserConfig> {
-	const newNetworks: Record<string, NetworkUserConfig> = {};
-	for (const networkName of Object.keys(networks)) {
-		const network = networks[networkName];
-		if (network.type === 'edr-simulated') {
-			// we leave memory network alone
-			newNetworks[networkName] = network as EdrNetworkUserConfig;
-		} else {
-			const url = getRPC(networkName);
+	const newNetworks: Record<string, NetworkUserConfig> = networks ? {...networks} : {};
+	const canonicalNames = Object.keys(chainByCanonicalName);
+
+	for (const canonicalName of canonicalNames) {
+		const chain = chainByCanonicalName[canonicalName];
+		const url = getRPC(canonicalName) || chain.rpcUrls.default.http[0];
+		if (!newNetworks[canonicalName]) {
 			if (url) {
-				newNetworks[networkName] = {
-					...network,
+				newNetworks[canonicalName] = {
+					type: 'http',
 					url,
-					accounts: getAccounts(networkName),
+					accounts: getAccounts(canonicalName, !listOfNetworkNamesWithTestAccountAllowed.includes(canonicalName)),
 				};
 			} else {
-				if (!('url' in network) || !network.url) {
-					console.error(`no url for network ${networkName}`);
-				}
+				console.error(`no url for chain ${canonicalName}`);
 			}
+		} else {
+			// console.error(`duplicated chain ${canonicalName}`);
 		}
 	}
 	return newNetworks;
@@ -262,17 +289,15 @@ export function addForkConfiguration(networks: Record<string, NetworkUserConfig>
 		}
 	}
 
-	const existingHardhat: EdrNetworkUserConfig =
-		networks.hardhat && networks.hardhat.type === 'edr-simulated'
-			? networks.hardhat
-			: {type: 'edr-simulated', chainType: 'l1'};
+	const existingForkConfiguration: EdrNetworkUserConfig =
+		networks.fork && networks.fork.type === 'edr-simulated' ? networks.fork : {type: 'edr-simulated', chainType: 'l1'};
 
 	const newNetworks: Record<string, NetworkUserConfig> = {
-		...populateNetworksFromEnv(networks),
-		hardhat: {
-			...existingHardhat,
+		...networks,
+		fork: {
+			...existingForkConfiguration,
 			...{
-				accounts: hardhatAccounts || existingHardhat?.accounts,
+				accounts: hardhatAccounts || existingForkConfiguration?.accounts,
 				forking: forkURL
 					? {
 							url: forkURL,

package/src/tasks/deploy.ts

@@ -1,5 +1,6 @@
 import {NewTaskActionFunction} from 'hardhat/types/tasks';
 import {loadAndExecuteDeployments} from 'rocketh';
+import {generateForkConfig} from '../helpers.js';
 
 interface RunActionArguments {
 	saveDeployments: string;
@@ -10,7 +11,9 @@ interface RunActionArguments {
 const runScriptWithHardhat: NewTaskActionFunction<RunActionArguments> = async (args, hre) => {
 	let saveDeployments = true;
 	let skipPrompts = args.skipPrompts ? true : false;
-	const connection = await hre.network.connect();
+
+	const {connection, environment, isFork, provider} = await generateForkConfig({hre});
+
 	const isMemoryNetwork = connection.networkConfig.type == 'edr-simulated';
 	if (isMemoryNetwork) {
 		skipPrompts = true;
@@ -23,11 +26,11 @@ const runScriptWithHardhat: NewTaskActionFunction<RunActionArguments> = async (a
 
 	await loadAndExecuteDeployments({
 		logLevel: 1,
-		provider: connection.provider as unknown as any, // TODO type
-		network: process.env.HARDHAT_FORK ? {fork: process.env.HARDHAT_FORK} : connection.networkName,
-		saveDeployments,
+		provider,
+		environment: environment,
+		saveDeployments: isFork ? false : saveDeployments,
 		askBeforeProceeding: skipPrompts ? false : true,
-		tags,
+		tags: tags?.split(','),
 		// reportGasUse: args.skipGasReport ? false : true,
 		extra: {connection},
 	});