@nomicfoundation/hardhat-viem 3.0.2 → 3.0.4

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @nomicfoundation/hardhat-viem
 
+## 3.0.4
+
+### Patch Changes
+
+- bc193be: Use concrete value types for contract names in hardhat-viem and hardhat-ethers
+- 13918b4: Add support for custom chains not in viem's built-in chain list, thanks @daanporon! ([#7763](https://github.com/NomicFoundation/hardhat/issues/7763))
+
+## 3.0.3
+
+### Patch Changes
+
+- 6674b00: Bump `hardhat-utils` major
+
 ## 3.0.2
 
 ### Patch Changes

package/dist/src/internal/chains.d.ts

@@ -1,11 +1,32 @@
 import type { TestClientMode } from "../types.js";
+import type { ChainDescriptorConfig, ChainDescriptorsConfig } from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type { Chain as ViemChain } from "viem";
-export declare function getChain<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT): Promise<ViemChain>;
+export declare function getChain<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string): Promise<ViemChain>;
 export declare function getChainId(provider: EthereumProvider): Promise<number>;
 export declare function isDevelopmentNetwork(provider: EthereumProvider): Promise<boolean>;
 export declare function isHardhatNetwork(provider: EthereumProvider): Promise<boolean>;
 export declare function isAnvilNetwork(provider: EthereumProvider): Promise<boolean>;
 export declare function getMode(provider: EthereumProvider): Promise<TestClientMode>;
+/**
+ * Resolves a viem chain for a given chain id using the provided chain
+ * descriptors. If a matching descriptor is found, the chain is enriched with
+ * the descriptor's name and block explorer. Otherwise, falls back to a minimal
+ * chain using the network name.
+ */
+export declare function resolveChain(chainId: number, networkName: string, chainDescriptors: ChainDescriptorsConfig): ViemChain;
+/**
+ * Creates a viem chain with the minimum fields required to satisfy the
+ * {@link ViemChain} type.
+ */
+export declare function createMinimalChain(id: number, name: string): ViemChain;
+/**
+ * Returns the default block explorer for a chain descriptor, preferring
+ * Etherscan over Blockscout. Returns `undefined` if neither is configured.
+ */
+export declare function getDefaultBlockExplorer(chainDescriptor: ChainDescriptorConfig): {
+    name: string;
+    url: string;
+} | undefined;
 //# sourceMappingURL=chains.d.ts.map

package/dist/src/internal/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../src/internal/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAuB/C,wBAAsB,QAAQ,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAClE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,SAAS,CAAC,CAyCpB;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5E;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,CAUzB"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../src/internal/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAuB/C,wBAAsB,QAAQ,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAClE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAkCpB;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5E;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,CAUzB;AAmED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,sBAAsB,GACvC,SAAS,CAeX;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAStE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,qBAAqB,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAY3C"}

package/dist/src/internal/chains.js

@@ -12,7 +12,7 @@ const hardhatMetadataCache = new WeakMap();
 const isAnvilNetworkCache = new WeakMap();
 const HARDHAT_METADATA_METHOD = "hardhat_metadata";
 const ANVIL_NODE_INFO_METHOD = "anvil_nodeInfo";
-export async function getChain(provider, chainType) {
+export async function getChain(provider, chainType, chainDescriptors, networkName) {
     const cachedChain = chainCache.get(provider);
     if (cachedChain !== undefined) {
         return cachedChain;
@@ -33,11 +33,7 @@ export async function getChain(provider, chainType) {
             };
         }
         else if (chain === undefined) {
-            // If the chain couldn't be found and we can't detect the development
-            // network we throw an error.
-            throw new HardhatError(HardhatError.ERRORS.HARDHAT_VIEM.GENERAL.NETWORK_NOT_FOUND, {
-                chainId,
-            });
+            chain = resolveChain(chainId, networkName, chainDescriptors);
         }
         else {
             assertHardhatInvariant(false, "This should not happen, as we check in isDevelopmentNetwork that it's either hardhat or anvil");
@@ -143,4 +139,52 @@ function isHardhatMetadata(value) {
             (isObject(value.forkedNetwork) &&
                 typeof value.forkedNetwork.chainId === "number")));
 }
+/**
+ * Resolves a viem chain for a given chain id using the provided chain
+ * descriptors. If a matching descriptor is found, the chain is enriched with
+ * the descriptor's name and block explorer. Otherwise, falls back to a minimal
+ * chain using the network name.
+ */
+export function resolveChain(chainId, networkName, chainDescriptors) {
+    const chainDescriptor = chainDescriptors.get(BigInt(chainId));
+    if (chainDescriptor === undefined) {
+        return createMinimalChain(chainId, networkName);
+    }
+    const chain = createMinimalChain(chainId, chainDescriptor.name);
+    const blockExplorer = getDefaultBlockExplorer(chainDescriptor);
+    if (blockExplorer !== undefined) {
+        chain.blockExplorers = {
+            default: blockExplorer,
+        };
+    }
+    return chain;
+}
+/**
+ * Creates a viem chain with the minimum fields required to satisfy the
+ * {@link ViemChain} type.
+ */
+export function createMinimalChain(id, name) {
+    return {
+        id,
+        name,
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        rpcUrls: {
+            default: { http: [] },
+        },
+    };
+}
+/**
+ * Returns the default block explorer for a chain descriptor, preferring
+ * Etherscan over Blockscout. Returns `undefined` if neither is configured.
+ */
+export function getDefaultBlockExplorer(chainDescriptor) {
+    const { etherscan, blockscout } = chainDescriptor.blockExplorers;
+    if (etherscan !== undefined) {
+        return { name: etherscan.name ?? "Etherscan", url: etherscan.url };
+    }
+    if (blockscout !== undefined) {
+        return { name: blockscout.name ?? "Blockscout", url: blockscout.url };
+    }
+    return undefined;
+}
 //# sourceMappingURL=chains.js.map

package/dist/src/internal/chains.js.map

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

package/dist/src/internal/clients.d.ts

@@ -1,10 +1,11 @@
 import type { GetPublicClientReturnType, GetWalletClientReturnType, TestClient } from "../types.js";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type { Address as ViemAddress, PublicClientConfig as ViemPublicClientConfig, TestClientConfig as ViemTestClientConfig, WalletClientConfig as ViemWalletClientConfig } from "viem";
-export declare function getPublicClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, publicClientConfig?: Partial<ViemPublicClientConfig>): Promise<GetPublicClientReturnType<ChainTypeT>>;
-export declare function getWalletClients<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<Array<GetWalletClientReturnType<ChainTypeT>>>;
-export declare function getWalletClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, address: ViemAddress, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<GetWalletClientReturnType<ChainTypeT>>;
-export declare function getDefaultWalletClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<GetWalletClientReturnType<ChainTypeT>>;
-export declare function getTestClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, testClientConfig?: Partial<ViemTestClientConfig>): Promise<TestClient>;
+export declare function getPublicClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string, publicClientConfig?: Partial<ViemPublicClientConfig>): Promise<GetPublicClientReturnType<ChainTypeT>>;
+export declare function getWalletClients<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<Array<GetWalletClientReturnType<ChainTypeT>>>;
+export declare function getWalletClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string, address: ViemAddress, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<GetWalletClientReturnType<ChainTypeT>>;
+export declare function getDefaultWalletClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string, walletClientConfig?: Partial<ViemWalletClientConfig>): Promise<GetWalletClientReturnType<ChainTypeT>>;
+export declare function getTestClient<ChainTypeT extends ChainType | string>(provider: EthereumProvider, chainType: ChainTypeT, chainDescriptors: ChainDescriptorsConfig, networkName: string, testClientConfig?: Partial<ViemTestClientConfig>): Promise<TestClient>;
 //# sourceMappingURL=clients.d.ts.map

package/dist/src/internal/clients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../../src/internal/clients.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EACV,OAAO,IAAI,WAAW,EACtB,kBAAkB,IAAI,sBAAsB,EAC5C,gBAAgB,IAAI,oBAAoB,EACxC,kBAAkB,IAAI,sBAAsB,EAC7C,MAAM,MAAM,CAAC;AAcd,wBAAsB,eAAe,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACzE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAoBhD;AAED,wBAAsB,gBAAgB,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAC1E,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAC,CA0BvD;AAED,wBAAsB,eAAe,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACzE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,WAAW,EACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAqBhD;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,SAAS,SAAS,GAAG,MAAM,EAErC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAoBhD;AAED,wBAAsB,aAAa,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACvE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,OAAO,CAAC,UAAU,CAAC,CAcrB"}
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../../src/internal/clients.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EACV,OAAO,IAAI,WAAW,EACtB,kBAAkB,IAAI,sBAAsB,EAC5C,gBAAgB,IAAI,oBAAoB,EACxC,kBAAkB,IAAI,sBAAsB,EAC7C,MAAM,MAAM,CAAC;AAcd,wBAAsB,eAAe,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACzE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAqBhD;AAED,wBAAsB,gBAAgB,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAC1E,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAC,CA2BvD;AAED,wBAAsB,eAAe,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACzE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAsBhD;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,SAAS,SAAS,GAAG,MAAM,EAErC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACnD,OAAO,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAuBhD;AAED,wBAAsB,aAAa,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EACvE,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/src/internal/clients.js

@@ -3,8 +3,9 @@ import { createPublicClient, createWalletClient, createTestClient, custom as cus
 import { publicActionsL2, walletActionsL2 } from "viem/op-stack";
 import { getAccounts } from "./accounts.js";
 import { getChain, getMode, isDevelopmentNetwork } from "./chains.js";
-export async function getPublicClient(provider, chainType, publicClientConfig) {
-    const chain = publicClientConfig?.chain ?? (await getChain(provider, chainType));
+export async function getPublicClient(provider, chainType, chainDescriptors, networkName, publicClientConfig) {
+    const chain = publicClientConfig?.chain ??
+        (await getChain(provider, chainType, chainDescriptors, networkName));
     const { defaultClientParams, defaultTransportParams } = await getDefaultParams(provider);
     let publicClient = createPublicClient({
         chain,
@@ -19,8 +20,9 @@ export async function getPublicClient(provider, chainType, publicClientConfig) {
     We need to assert the type because TS gets confused with the conditional type */
     return publicClient;
 }
-export async function getWalletClients(provider, chainType, walletClientConfig) {
-    const chain = walletClientConfig?.chain ?? (await getChain(provider, chainType));
+export async function getWalletClients(provider, chainType, chainDescriptors, networkName, walletClientConfig) {
+    const chain = walletClientConfig?.chain ??
+        (await getChain(provider, chainType, chainDescriptors, networkName));
     const accounts = await getAccounts(provider);
     const { defaultClientParams, defaultTransportParams } = await getDefaultParams(provider);
     let walletClients = accounts.map((account) => createWalletClient({
@@ -37,8 +39,9 @@ export async function getWalletClients(provider, chainType, walletClientConfig)
     We need to assert the type because TS gets confused with the conditional type */
     return walletClients;
 }
-export async function getWalletClient(provider, chainType, address, walletClientConfig) {
-    const chain = walletClientConfig?.chain ?? (await getChain(provider, chainType));
+export async function getWalletClient(provider, chainType, chainDescriptors, networkName, address, walletClientConfig) {
+    const chain = walletClientConfig?.chain ??
+        (await getChain(provider, chainType, chainDescriptors, networkName));
     const { defaultClientParams, defaultTransportParams } = await getDefaultParams(provider);
     let walletClient = createWalletClient({
         chain,
@@ -54,18 +57,20 @@ export async function getWalletClient(provider, chainType, address, walletClient
     We need to assert the type because TS gets confused with the conditional type */
     return walletClient;
 }
-export async function getDefaultWalletClient(provider, chainType, walletClientConfig) {
-    const chain = walletClientConfig?.chain ?? (await getChain(provider, chainType));
+export async function getDefaultWalletClient(provider, chainType, chainDescriptors, networkName, walletClientConfig) {
+    const chain = walletClientConfig?.chain ??
+        (await getChain(provider, chainType, chainDescriptors, networkName));
     const [defaultAccount] = await getAccounts(provider);
     if (defaultAccount === undefined) {
         throw new HardhatError(HardhatError.ERRORS.HARDHAT_VIEM.GENERAL.DEFAULT_WALLET_CLIENT_NOT_FOUND, {
             chainId: chain.id,
         });
     }
-    return getWalletClient(provider, chainType, defaultAccount, walletClientConfig);
+    return getWalletClient(provider, chainType, chainDescriptors, networkName, defaultAccount, walletClientConfig);
 }
-export async function getTestClient(provider, chainType, testClientConfig) {
-    const chain = testClientConfig?.chain ?? (await getChain(provider, chainType));
+export async function getTestClient(provider, chainType, chainDescriptors, networkName, testClientConfig) {
+    const chain = testClientConfig?.chain ??
+        (await getChain(provider, chainType, chainDescriptors, networkName));
     const mode = await getMode(provider);
     const testClient = createTestClient({
         chain,

package/dist/src/internal/clients.js.map

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

package/dist/src/internal/contracts.d.ts

@@ -1,11 +1,12 @@
 import type { ContractReturnType, DeployContractConfig, GetContractAtConfig, GetTransactionReturnType, SendDeploymentTransactionConfig } from "../types.js";
-import type { ArtifactManager } from "hardhat/types/artifacts";
+import type { ArtifactManager, StringWithArtifactContractNamesAutocompletion } from "hardhat/types/artifacts";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type { Address as ViemAddress } from "viem";
-export declare function deployContract<ContractName extends string>(provider: EthereumProvider, artifactManager: ArtifactManager, contractName: ContractName, constructorArgs?: readonly unknown[], deployContractConfig?: DeployContractConfig): Promise<ContractReturnType<ContractName>>;
-export declare function sendDeploymentTransaction<ContractName extends string>(provider: EthereumProvider, artifactManager: ArtifactManager, contractName: ContractName, constructorArgs?: readonly unknown[], sendDeploymentTransactionConfig?: SendDeploymentTransactionConfig): Promise<{
+export declare function deployContract<ContractName extends StringWithArtifactContractNamesAutocompletion>(provider: EthereumProvider, artifactManager: ArtifactManager, chainDescriptors: ChainDescriptorsConfig, networkName: string, contractName: ContractName, constructorArgs?: readonly unknown[], deployContractConfig?: DeployContractConfig): Promise<ContractReturnType<ContractName>>;
+export declare function sendDeploymentTransaction<ContractName extends StringWithArtifactContractNamesAutocompletion>(provider: EthereumProvider, artifactManager: ArtifactManager, chainDescriptors: ChainDescriptorsConfig, networkName: string, contractName: ContractName, constructorArgs?: readonly unknown[], sendDeploymentTransactionConfig?: SendDeploymentTransactionConfig): Promise<{
     contract: ContractReturnType<ContractName>;
     deploymentTransaction: GetTransactionReturnType;
 }>;
-export declare function getContractAt<ContractName extends string>(provider: EthereumProvider, artifactManager: ArtifactManager, contractName: ContractName, address: ViemAddress, getContractAtConfig?: GetContractAtConfig): Promise<ContractReturnType<ContractName>>;
+export declare function getContractAt<ContractName extends StringWithArtifactContractNamesAutocompletion>(provider: EthereumProvider, artifactManager: ArtifactManager, chainDescriptors: ChainDescriptorsConfig, networkName: string, contractName: ContractName, address: ViemAddress, getContractAtConfig?: GetContractAtConfig): Promise<ContractReturnType<ContractName>>;
 //# sourceMappingURL=contracts.d.ts.map

package/dist/src/internal/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/internal/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EAGxB,+BAA+B,EAEhC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAkB,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAUnE,wBAAsB,cAAc,CAAC,YAAY,SAAS,MAAM,EAC9D,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,SAAS,OAAO,EAAO,EACxC,oBAAoB,GAAE,oBAAyB,GAC9C,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAiF3C;AAED,wBAAsB,yBAAyB,CAAC,YAAY,SAAS,MAAM,EACzE,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,SAAS,OAAO,EAAO,EACxC,+BAA+B,GAAE,+BAAoC,GACpE,OAAO,CAAC;IACT,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC3C,qBAAqB,EAAE,wBAAwB,CAAC;CACjD,CAAC,CAoDD;AAED,wBAAsB,aAAa,CAAC,YAAY,SAAS,MAAM,EAC7D,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,WAAW,EACpB,mBAAmB,GAAE,mBAAwB,GAC5C,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAe3C"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/internal/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EAGxB,+BAA+B,EAEhC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,eAAe,EACf,6CAA6C,EAC9C,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAkB,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAUnE,wBAAsB,cAAc,CAClC,YAAY,SAAS,6CAA6C,EAElE,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,SAAS,OAAO,EAAO,EACxC,oBAAoB,GAAE,oBAAyB,GAC9C,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAmF3C;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,SAAS,6CAA6C,EAElE,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,SAAS,OAAO,EAAO,EACxC,+BAA+B,GAAE,+BAAoC,GACpE,OAAO,CAAC;IACT,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC3C,qBAAqB,EAAE,wBAAwB,CAAC;CACjD,CAAC,CAsDD;AAED,wBAAsB,aAAa,CACjC,YAAY,SAAS,6CAA6C,EAElE,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,WAAW,EACpB,mBAAmB,GAAE,mBAAwB,GAC5C,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAgB3C"}

package/dist/src/internal/contracts.js

@@ -4,7 +4,7 @@ import { resolveLinkedBytecode } from "@nomicfoundation/hardhat-utils/bytecode";
 import { ensureError } from "@nomicfoundation/hardhat-utils/error";
 import { getContractAddress, getContract } from "viem";
 import { getDefaultWalletClient, getPublicClient } from "./clients.js";
-export async function deployContract(provider, artifactManager, contractName, constructorArgs = [], deployContractConfig = {}) {
+export async function deployContract(provider, artifactManager, chainDescriptors, networkName, contractName, constructorArgs = [], deployContractConfig = {}) {
     const { client, confirmations = 1, libraries = {}, ...deployContractParameters } = deployContractConfig;
     if (confirmations < 0) {
         throw new HardhatError(HardhatError.ERRORS.HARDHAT_VIEM.GENERAL.INVALID_CONFIRMATIONS, {
@@ -17,13 +17,15 @@ export async function deployContract(provider, artifactManager, contractName, co
         });
     }
     const [publicClient, walletClient, { abi, bytecode }] = await Promise.all([
-        client?.public ?? getPublicClient(provider, "l1"),
-        client?.wallet ?? getDefaultWalletClient(provider, "l1"),
+        client?.public ??
+            getPublicClient(provider, "l1", chainDescriptors, networkName),
+        client?.wallet ??
+            getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
         getContractAbiAndBytecode(artifactManager, contractName, libraries),
     ]);
     let deploymentTxHash;
     // If gasPrice is defined, then maxFeePerGas and maxPriorityFeePerGas
-    // must be undefined because it's a legaxy tx.
+    // must be undefined because it's a legacy tx.
     if (deployContractParameters.gasPrice !== undefined) {
         deploymentTxHash = await walletClient.deployContract({
             abi,
@@ -59,16 +61,18 @@ export async function deployContract(provider, artifactManager, contractName, co
     const contract = createContractInstance(contractName, publicClient, walletClient, abi, contractAddress);
     return contract;
 }
-export async function sendDeploymentTransaction(provider, artifactManager, contractName, constructorArgs = [], sendDeploymentTransactionConfig = {}) {
+export async function sendDeploymentTransaction(provider, artifactManager, chainDescriptors, networkName, contractName, constructorArgs = [], sendDeploymentTransactionConfig = {}) {
     const { client, libraries = {}, ...deployContractParameters } = sendDeploymentTransactionConfig;
     const [publicClient, walletClient, { abi, bytecode }] = await Promise.all([
-        client?.public ?? getPublicClient(provider, "l1"),
-        client?.wallet ?? getDefaultWalletClient(provider, "l1"),
+        client?.public ??
+            getPublicClient(provider, "l1", chainDescriptors, networkName),
+        client?.wallet ??
+            getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
         getContractAbiAndBytecode(artifactManager, contractName, libraries),
     ]);
     let deploymentTxHash;
     // If gasPrice is defined, then maxFeePerGas and maxPriorityFeePerGas
-    // must be undefined because it's a legaxy tx.
+    // must be undefined because it's a legacy tx.
     if (deployContractParameters.gasPrice !== undefined) {
         deploymentTxHash = await walletClient.deployContract({
             abi,
@@ -98,11 +102,12 @@ export async function sendDeploymentTransaction(provider, artifactManager, contr
     const contract = createContractInstance(contractName, publicClient, walletClient, abi, contractAddress);
     return { contract, deploymentTransaction: deploymentTx };
 }
-export async function getContractAt(provider, artifactManager, contractName, address, getContractAtConfig = {}) {
+export async function getContractAt(provider, artifactManager, chainDescriptors, networkName, contractName, address, getContractAtConfig = {}) {
     const [publicClient, walletClient, artifact] = await Promise.all([
-        getContractAtConfig.client?.public ?? getPublicClient(provider, "l1"),
+        getContractAtConfig.client?.public ??
+            getPublicClient(provider, "l1", chainDescriptors, networkName),
         getContractAtConfig.client?.wallet ??
-            getDefaultWalletClient(provider, "l1"),
+            getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
         artifactManager.readArtifact(contractName),
     ]);
     return createContractInstance(contractName, publicClient, walletClient, artifact.abi, address);

package/dist/src/internal/contracts.js.map

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

package/dist/src/internal/hook-handlers/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/internal/hook-handlers/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;8BAK5C,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAAvD,wBAqBE"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/internal/hook-handlers/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;8BAK5C,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAAvD,wBAuBE"}

package/dist/src/internal/hook-handlers/network.js

@@ -3,7 +3,7 @@ export default async () => {
     const handlers = {
         async newConnection(context, next) {
             const connection = await next(context);
-            connection.viem = initializeViem(connection.chainType, connection.provider, context.artifacts);
+            connection.viem = initializeViem(connection.chainType, connection.provider, context.artifacts, context.config.chainDescriptors, connection.networkName);
             return connection;
         },
     };

package/dist/src/internal/hook-handlers/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../../src/internal/hook-handlers/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,eAAe,KAAK,IAAoC,EAAE;IACxD,MAAM,QAAQ,GAA0B;QACtC,KAAK,CAAC,aAAa,CACjB,OAAoB,EACpB,IAE2C;YAE3C,MAAM,UAAU,GAAkC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtE,UAAU,CAAC,IAAI,GAAG,cAAc,CAC9B,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,QAAQ,EACnB,OAAO,CAAC,SAAS,CAClB,CAAC;YAEF,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../../src/internal/hook-handlers/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,eAAe,KAAK,IAAoC,EAAE;IACxD,MAAM,QAAQ,GAA0B;QACtC,KAAK,CAAC,aAAa,CACjB,OAAoB,EACpB,IAE2C;YAE3C,MAAM,UAAU,GAAkC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtE,UAAU,CAAC,IAAI,GAAG,cAAc,CAC9B,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,QAAQ,EACnB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAC/B,UAAU,CAAC,WAAW,CACvB,CAAC;YAEF,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/src/internal/initialization.d.ts

@@ -1,6 +1,7 @@
 import type { HardhatViemHelpers } from "../types.js";
 import type { ArtifactManager } from "hardhat/types/artifacts";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
-export declare function initializeViem<ChainTypeT extends ChainType | string>(chainType: ChainTypeT, provider: EthereumProvider, artifactManager: ArtifactManager): HardhatViemHelpers<ChainTypeT>;
+export declare function initializeViem<ChainTypeT extends ChainType | string>(chainType: ChainTypeT, provider: EthereumProvider, artifactManager: ArtifactManager, chainDescriptors: ChainDescriptorsConfig, networkName: string): HardhatViemHelpers<ChainTypeT>;
 //# sourceMappingURL=initialization.d.ts.map

package/dist/src/internal/initialization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../../src/internal/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAchE,wBAAgB,cAAc,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAClE,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,GAC/B,kBAAkB,CAAC,UAAU,CAAC,CA6ChC"}
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../../src/internal/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAchE,wBAAgB,cAAc,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,EAClE,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,sBAAsB,EACxC,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAAC,UAAU,CAAC,CA4EhC"}

package/dist/src/internal/initialization.js

@@ -1,14 +1,14 @@
 import { getPublicClient, getWalletClients, getWalletClient, getTestClient, } from "./clients.js";
 import { deployContract, getContractAt, sendDeploymentTransaction, } from "./contracts.js";
-export function initializeViem(chainType, provider, artifactManager) {
+export function initializeViem(chainType, provider, artifactManager, chainDescriptors, networkName) {
     return {
-        getPublicClient: (publicClientConfig) => getPublicClient(provider, chainType, publicClientConfig),
-        getWalletClients: (walletClientConfig) => getWalletClients(provider, chainType, walletClientConfig),
-        getWalletClient: (address, walletClientConfig) => getWalletClient(provider, chainType, address, walletClientConfig),
-        getTestClient: (testClientConfig) => getTestClient(provider, chainType, testClientConfig),
-        deployContract: (contractName, constructorArgs, deployContractConfig) => deployContract(provider, artifactManager, contractName, constructorArgs, deployContractConfig),
-        sendDeploymentTransaction: (contractName, constructorArgs, sendDeploymentTransactionConfig) => sendDeploymentTransaction(provider, artifactManager, contractName, constructorArgs, sendDeploymentTransactionConfig),
-        getContractAt: (contractName, address, getContractAtConfig) => getContractAt(provider, artifactManager, contractName, address, getContractAtConfig),
+        getPublicClient: (publicClientConfig) => getPublicClient(provider, chainType, chainDescriptors, networkName, publicClientConfig),
+        getWalletClients: (walletClientConfig) => getWalletClients(provider, chainType, chainDescriptors, networkName, walletClientConfig),
+        getWalletClient: (address, walletClientConfig) => getWalletClient(provider, chainType, chainDescriptors, networkName, address, walletClientConfig),
+        getTestClient: (testClientConfig) => getTestClient(provider, chainType, chainDescriptors, networkName, testClientConfig),
+        deployContract: (contractName, constructorArgs, deployContractConfig) => deployContract(provider, artifactManager, chainDescriptors, networkName, contractName, constructorArgs, deployContractConfig),
+        sendDeploymentTransaction: (contractName, constructorArgs, sendDeploymentTransactionConfig) => sendDeploymentTransaction(provider, artifactManager, chainDescriptors, networkName, contractName, constructorArgs, sendDeploymentTransactionConfig),
+        getContractAt: (contractName, address, getContractAtConfig) => getContractAt(provider, artifactManager, chainDescriptors, networkName, contractName, address, getContractAtConfig),
     };
 }
 //# sourceMappingURL=initialization.js.map

package/dist/src/internal/initialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"initialization.js","sourceRoot":"","sources":["../../../src/internal/initialization.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,cAAc,CAC5B,SAAqB,EACrB,QAA0B,EAC1B,eAAgC;IAEhC,OAAO;QACL,eAAe,EAAE,CAAC,kBAAkB,EAAE,EAAE,CACtC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,kBAAkB,CAAC;QAE1D,gBAAgB,EAAE,CAAC,kBAAkB,EAAE,EAAE,CACvC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,kBAAkB,CAAC;QAE3D,eAAe,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAC/C,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC;QAEnE,aAAa,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAClC,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC;QAEtD,cAAc,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,EAAE,CACtE,cAAc,CACZ,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,EACf,oBAAoB,CACrB;QAEH,yBAAyB,EAAE,CACzB,YAAY,EACZ,eAAe,EACf,+BAA+B,EAC/B,EAAE,CACF,yBAAyB,CACvB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,EACf,+BAA+B,CAChC;QAEH,aAAa,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,CAC5D,aAAa,CACX,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,OAAO,EACP,mBAAmB,CACpB;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"initialization.js","sourceRoot":"","sources":["../../../src/internal/initialization.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,cAAc,CAC5B,SAAqB,EACrB,QAA0B,EAC1B,eAAgC,EAChC,gBAAwC,EACxC,WAAmB;IAEnB,OAAO;QACL,eAAe,EAAE,CAAC,kBAAkB,EAAE,EAAE,CACtC,eAAe,CACb,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,kBAAkB,CACnB;QAEH,gBAAgB,EAAE,CAAC,kBAAkB,EAAE,EAAE,CACvC,gBAAgB,CACd,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,kBAAkB,CACnB;QAEH,eAAe,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAC/C,eAAe,CACb,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,kBAAkB,CACnB;QAEH,aAAa,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAClC,aAAa,CACX,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,gBAAgB,CACjB;QAEH,cAAc,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,EAAE,CACtE,cAAc,CACZ,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,CACrB;QAEH,yBAAyB,EAAE,CACzB,YAAY,EACZ,eAAe,EACf,+BAA+B,EAC/B,EAAE,CACF,yBAAyB,CACvB,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,+BAA+B,CAChC;QAEH,aAAa,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,CAC5D,aAAa,CACX,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,OAAO,EACP,mBAAmB,CACpB;KACJ,CAAC;AACJ,CAAC"}

package/dist/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactMap } from "hardhat/types/artifacts";
+import type { ArtifactMap, StringWithArtifactContractNamesAutocompletion } from "hardhat/types/artifacts";
 import type { ChainType, DefaultChainType } from "hardhat/types/network";
 import type { Abi as ViemAbi, Account as ViemAccount, Address as ViemAddress, Chain as ViemChain, Client as ViemClient, ContractConstructorArgs as ViemContractConstructorArgs, createTestClient as ViemCreateTestClient, GetContractReturnType as ViemGetContractReturnType, GetTransactionReturnType as ViemGetTransactionReturnType, PublicClient as ViemPublicClient, PublicClientConfig as ViemPublicClientConfig, RpcSchema as ViemRpcSchema, TestClient as ViemTestClient, TestClientConfig as ViemTestClientConfig, Transport as ViemTransport, WalletClient as ViemWalletClient, WalletClientConfig as ViemWalletClientConfig, PublicActions as ViemPublicActions, WalletActions as ViemWalletActions } from "viem";
 import type { PublicActionsL2 as ViemOpStackPublicActionsL2, WalletActionsL2 as ViemOpStackWalletActionsL2 } from "viem/op-stack";
@@ -47,27 +47,33 @@ export interface HardhatViemHelpers<ChainTypeT extends ChainType | string = Defa
      * returns the viem's contract instance.
      *
      * @param contractName The name of the contract to deploy. This is required
-     * to return the correct contract type.
+     * to return the correct contract type. TypeScript's language server
+     * autocompletes the names of the contracts that have already been built. If
+     * your contract name isn't in the list, you can still use it, and/or run
+     * `hardhat build` to get it in the list.
      * @param constructorArgs The arguments to pass to the contract's constructor.
      * @param deployContractConfig A configuration object. See
      * {@link DeployContractConfig} for more details.
      * @returns The deployed contract instance.
      */
-    deployContract: <ContractName extends string>(contractName: ContractName, constructorArgs?: ConstructorArgs<ContractName>, deployContractConfig?: DeployContractConfig) => Promise<ContractReturnType<ContractName>>;
+    deployContract: <ContractName extends StringWithArtifactContractNamesAutocompletion>(contractName: ContractName, constructorArgs?: ConstructorArgs<ContractName>, deployContractConfig?: DeployContractConfig) => Promise<ContractReturnType<ContractName>>;
     /**
      * Sends a deployment transaction for the specified contract and returns the
      * contract instance along with the deployment transaction.
      * The function does not wait for the transaction to be mined.
      *
      * @param contractName The name of the contract to deploy. This is required
-     * to return the correct contract type.
+     * to return the correct contract type. TypeScript's language server
+     * autocompletes the names of the contracts that have already been built. If
+     * your contract name isn't in the list, you can still use it, and/or run
+     * `hardhat build` to get it in the list.
      * @param constructorArgs The arguments to pass to the contract's constructor.
      * @param sendDeploymentTransactionConfig A configuration object. See
      * {@link SendDeploymentTransactionConfig} for more details.
      * @returns An object containing the deployed contract instance and the
      * deployment transaction.
      */
-    sendDeploymentTransaction: <ContractName extends string>(contractName: ContractName, constructorArgs?: ConstructorArgs<ContractName>, sendDeploymentTransactionConfig?: SendDeploymentTransactionConfig) => Promise<{
+    sendDeploymentTransaction: <ContractName extends StringWithArtifactContractNamesAutocompletion>(contractName: ContractName, constructorArgs?: ConstructorArgs<ContractName>, sendDeploymentTransactionConfig?: SendDeploymentTransactionConfig) => Promise<{
         contract: ContractReturnType<ContractName>;
         deploymentTransaction: GetTransactionReturnType;
     }>;
@@ -76,13 +82,16 @@ export interface HardhatViemHelpers<ChainTypeT extends ChainType | string = Defa
      * address.
      *
      * @param contractName The name of the contract to get an instance of. This
-     * is required to return the correct contract type.
+     * is required to return the correct contract type. TypeScript's language
+     * server autocompletes the names of the contracts that have already been
+     * built. If your contract name isn't in the list, you can still use it,
+     * and/or run `hardhat build` to get it in the list.
      * @param address The address of the contract.
      * @param getContractAtConfig A configuration object. See
      * {@link GetContractAtConfig} for more details.
      * @returns The contract instance.
      */
-    getContractAt: <ContractName extends string>(contractName: ContractName, address: ViemAddress, getContractAtConfig?: GetContractAtConfig) => Promise<ContractReturnType<ContractName>>;
+    getContractAt: <ContractName extends StringWithArtifactContractNamesAutocompletion>(contractName: ContractName, address: ViemAddress, getContractAtConfig?: GetContractAtConfig) => Promise<ContractReturnType<ContractName>>;
 }
 export type GetPublicClientReturnType<ChainTypeT extends ChainType | string> = ChainTypeT extends "op" ? OpPublicClient : PublicClient;
 export type GetWalletClientReturnType<ChainTypeT extends ChainType | string> = ChainTypeT extends "op" ? OpWalletClient : WalletClient;

package/dist/src/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nomicfoundation/hardhat-viem",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "Hardhat plugin for viem",
   "homepage": "https://github.com/nomicfoundation/hardhat/tree/v-next/v-next/hardhat-viem",
   "repository": {
@@ -41,14 +41,15 @@
     "tsx": "^4.19.3",
     "typescript": "~5.8.0",
     "viem": "^2.43.0",
-    "@nomicfoundation/hardhat-test-utils": "^2.0.1"
+    "hardhat": "^3.1.11",
+    "@nomicfoundation/hardhat-test-utils": "^2.0.2"
   },
   "dependencies": {
-    "@nomicfoundation/hardhat-errors": "^3.0.0",
-    "@nomicfoundation/hardhat-utils": "^3.0.6"
+    "@nomicfoundation/hardhat-errors": "^3.0.7",
+    "@nomicfoundation/hardhat-utils": "^4.0.0"
   },
   "peerDependencies": {
-    "hardhat": "^3.0.0",
+    "hardhat": "^3.1.11",
     "viem": "^2.43.0"
   },
   "scripts": {

package/src/internal/chains.ts

@@ -1,4 +1,8 @@
 import type { TestClientMode } from "../types.js";
+import type {
+  ChainDescriptorConfig,
+  ChainDescriptorsConfig,
+} from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type { Chain as ViemChain } from "viem";
@@ -27,6 +31,8 @@ const ANVIL_NODE_INFO_METHOD = "anvil_nodeInfo";
 export async function getChain<ChainTypeT extends ChainType | string>(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
 ): Promise<ViemChain> {
   const cachedChain = chainCache.get(provider);
   if (cachedChain !== undefined) {
@@ -49,14 +55,7 @@ export async function getChain<ChainTypeT extends ChainType | string>(
         id: chainId,
       };
     } else if (chain === undefined) {
-      // If the chain couldn't be found and we can't detect the development
-      // network we throw an error.
-      throw new HardhatError(
-        HardhatError.ERRORS.HARDHAT_VIEM.GENERAL.NETWORK_NOT_FOUND,
-        {
-          chainId,
-        },
-      );
+      chain = resolveChain(chainId, networkName, chainDescriptors);
     } else {
       assertHardhatInvariant(
         false,
@@ -214,3 +213,65 @@ function isHardhatMetadata(value: unknown): value is HardhatMetadata {
         typeof value.forkedNetwork.chainId === "number"))
   );
 }
+
+/**
+ * Resolves a viem chain for a given chain id using the provided chain
+ * descriptors. If a matching descriptor is found, the chain is enriched with
+ * the descriptor's name and block explorer. Otherwise, falls back to a minimal
+ * chain using the network name.
+ */
+export function resolveChain(
+  chainId: number,
+  networkName: string,
+  chainDescriptors: ChainDescriptorsConfig,
+): ViemChain {
+  const chainDescriptor = chainDescriptors.get(BigInt(chainId));
+  if (chainDescriptor === undefined) {
+    return createMinimalChain(chainId, networkName);
+  }
+
+  const chain = createMinimalChain(chainId, chainDescriptor.name);
+  const blockExplorer = getDefaultBlockExplorer(chainDescriptor);
+  if (blockExplorer !== undefined) {
+    chain.blockExplorers = {
+      default: blockExplorer,
+    };
+  }
+
+  return chain;
+}
+
+/**
+ * Creates a viem chain with the minimum fields required to satisfy the
+ * {@link ViemChain} type.
+ */
+export function createMinimalChain(id: number, name: string): ViemChain {
+  return {
+    id,
+    name,
+    nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+    rpcUrls: {
+      default: { http: [] },
+    },
+  };
+}
+
+/**
+ * Returns the default block explorer for a chain descriptor, preferring
+ * Etherscan over Blockscout. Returns `undefined` if neither is configured.
+ */
+export function getDefaultBlockExplorer(
+  chainDescriptor: ChainDescriptorConfig,
+): { name: string; url: string } | undefined {
+  const { etherscan, blockscout } = chainDescriptor.blockExplorers;
+
+  if (etherscan !== undefined) {
+    return { name: etherscan.name ?? "Etherscan", url: etherscan.url };
+  }
+
+  if (blockscout !== undefined) {
+    return { name: blockscout.name ?? "Blockscout", url: blockscout.url };
+  }
+
+  return undefined;
+}

package/src/internal/clients.ts

@@ -3,6 +3,7 @@ import type {
   GetWalletClientReturnType,
   TestClient,
 } from "../types.js";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type {
@@ -27,10 +28,13 @@ import { getChain, getMode, isDevelopmentNetwork } from "./chains.js";
 export async function getPublicClient<ChainTypeT extends ChainType | string>(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   publicClientConfig?: Partial<ViemPublicClientConfig>,
 ): Promise<GetPublicClientReturnType<ChainTypeT>> {
   const chain =
-    publicClientConfig?.chain ?? (await getChain(provider, chainType));
+    publicClientConfig?.chain ??
+    (await getChain(provider, chainType, chainDescriptors, networkName));
   const { defaultClientParams, defaultTransportParams } =
     await getDefaultParams(provider);
 
@@ -53,10 +57,13 @@ export async function getPublicClient<ChainTypeT extends ChainType | string>(
 export async function getWalletClients<ChainTypeT extends ChainType | string>(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   walletClientConfig?: Partial<ViemWalletClientConfig>,
 ): Promise<Array<GetWalletClientReturnType<ChainTypeT>>> {
   const chain =
-    walletClientConfig?.chain ?? (await getChain(provider, chainType));
+    walletClientConfig?.chain ??
+    (await getChain(provider, chainType, chainDescriptors, networkName));
   const accounts = await getAccounts(provider);
   const { defaultClientParams, defaultTransportParams } =
     await getDefaultParams(provider);
@@ -85,11 +92,14 @@ export async function getWalletClients<ChainTypeT extends ChainType | string>(
 export async function getWalletClient<ChainTypeT extends ChainType | string>(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   address: ViemAddress,
   walletClientConfig?: Partial<ViemWalletClientConfig>,
 ): Promise<GetWalletClientReturnType<ChainTypeT>> {
   const chain =
-    walletClientConfig?.chain ?? (await getChain(provider, chainType));
+    walletClientConfig?.chain ??
+    (await getChain(provider, chainType, chainDescriptors, networkName));
   const { defaultClientParams, defaultTransportParams } =
     await getDefaultParams(provider);
 
@@ -115,10 +125,13 @@ export async function getDefaultWalletClient<
 >(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   walletClientConfig?: Partial<ViemWalletClientConfig>,
 ): Promise<GetWalletClientReturnType<ChainTypeT>> {
   const chain =
-    walletClientConfig?.chain ?? (await getChain(provider, chainType));
+    walletClientConfig?.chain ??
+    (await getChain(provider, chainType, chainDescriptors, networkName));
   const [defaultAccount] = await getAccounts(provider);
 
   if (defaultAccount === undefined) {
@@ -133,6 +146,8 @@ export async function getDefaultWalletClient<
   return getWalletClient(
     provider,
     chainType,
+    chainDescriptors,
+    networkName,
     defaultAccount,
     walletClientConfig,
   );
@@ -141,10 +156,13 @@ export async function getDefaultWalletClient<
 export async function getTestClient<ChainTypeT extends ChainType | string>(
   provider: EthereumProvider,
   chainType: ChainTypeT,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   testClientConfig?: Partial<ViemTestClientConfig>,
 ): Promise<TestClient> {
   const chain =
-    testClientConfig?.chain ?? (await getChain(provider, chainType));
+    testClientConfig?.chain ??
+    (await getChain(provider, chainType, chainDescriptors, networkName));
   const mode = await getMode(provider);
 
   const testClient = createTestClient({

package/src/internal/contracts.ts

@@ -9,7 +9,11 @@ import type {
   WalletClient,
 } from "../types.js";
 import type { PrefixedHexString } from "@nomicfoundation/hardhat-utils/hex";
-import type { ArtifactManager } from "hardhat/types/artifacts";
+import type {
+  ArtifactManager,
+  StringWithArtifactContractNamesAutocompletion,
+} from "hardhat/types/artifacts";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { EthereumProvider } from "hardhat/types/providers";
 import type { Abi as ViemAbi, Address as ViemAddress } from "viem";
 
@@ -21,9 +25,13 @@ import { getContractAddress, getContract } from "viem";
 
 import { getDefaultWalletClient, getPublicClient } from "./clients.js";
 
-export async function deployContract<ContractName extends string>(
+export async function deployContract<
+  ContractName extends StringWithArtifactContractNamesAutocompletion,
+>(
   provider: EthereumProvider,
   artifactManager: ArtifactManager,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   contractName: ContractName,
   constructorArgs: readonly unknown[] = [],
   deployContractConfig: DeployContractConfig = {},
@@ -54,14 +62,16 @@ export async function deployContract<ContractName extends string>(
   }
 
   const [publicClient, walletClient, { abi, bytecode }] = await Promise.all([
-    client?.public ?? getPublicClient(provider, "l1"),
-    client?.wallet ?? getDefaultWalletClient(provider, "l1"),
+    client?.public ??
+      getPublicClient(provider, "l1", chainDescriptors, networkName),
+    client?.wallet ??
+      getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
     getContractAbiAndBytecode(artifactManager, contractName, libraries),
   ]);
 
   let deploymentTxHash: PrefixedHexString;
   // If gasPrice is defined, then maxFeePerGas and maxPriorityFeePerGas
-  // must be undefined because it's a legaxy tx.
+  // must be undefined because it's a legacy tx.
   if (deployContractParameters.gasPrice !== undefined) {
     deploymentTxHash = await walletClient.deployContract({
       abi,
@@ -110,9 +120,13 @@ export async function deployContract<ContractName extends string>(
   return contract;
 }
 
-export async function sendDeploymentTransaction<ContractName extends string>(
+export async function sendDeploymentTransaction<
+  ContractName extends StringWithArtifactContractNamesAutocompletion,
+>(
   provider: EthereumProvider,
   artifactManager: ArtifactManager,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   contractName: ContractName,
   constructorArgs: readonly unknown[] = [],
   sendDeploymentTransactionConfig: SendDeploymentTransactionConfig = {},
@@ -126,14 +140,16 @@ export async function sendDeploymentTransaction<ContractName extends string>(
     ...deployContractParameters
   } = sendDeploymentTransactionConfig;
   const [publicClient, walletClient, { abi, bytecode }] = await Promise.all([
-    client?.public ?? getPublicClient(provider, "l1"),
-    client?.wallet ?? getDefaultWalletClient(provider, "l1"),
+    client?.public ??
+      getPublicClient(provider, "l1", chainDescriptors, networkName),
+    client?.wallet ??
+      getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
     getContractAbiAndBytecode(artifactManager, contractName, libraries),
   ]);
 
   let deploymentTxHash: PrefixedHexString;
   // If gasPrice is defined, then maxFeePerGas and maxPriorityFeePerGas
-  // must be undefined because it's a legaxy tx.
+  // must be undefined because it's a legacy tx.
   if (deployContractParameters.gasPrice !== undefined) {
     deploymentTxHash = await walletClient.deployContract({
       abi,
@@ -173,17 +189,22 @@ export async function sendDeploymentTransaction<ContractName extends string>(
   return { contract, deploymentTransaction: deploymentTx };
 }
 
-export async function getContractAt<ContractName extends string>(
+export async function getContractAt<
+  ContractName extends StringWithArtifactContractNamesAutocompletion,
+>(
   provider: EthereumProvider,
   artifactManager: ArtifactManager,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
   contractName: ContractName,
   address: ViemAddress,
   getContractAtConfig: GetContractAtConfig = {},
 ): Promise<ContractReturnType<ContractName>> {
   const [publicClient, walletClient, artifact] = await Promise.all([
-    getContractAtConfig.client?.public ?? getPublicClient(provider, "l1"),
+    getContractAtConfig.client?.public ??
+      getPublicClient(provider, "l1", chainDescriptors, networkName),
     getContractAtConfig.client?.wallet ??
-      getDefaultWalletClient(provider, "l1"),
+      getDefaultWalletClient(provider, "l1", chainDescriptors, networkName),
     artifactManager.readArtifact(contractName),
   ]);
 
@@ -196,7 +217,9 @@ export async function getContractAt<ContractName extends string>(
   );
 }
 
-function createContractInstance<ContractName extends string>(
+function createContractInstance<
+  ContractName extends StringWithArtifactContractNamesAutocompletion,
+>(
   _contractName: ContractName,
   publicClient: PublicClient,
   walletClient: WalletClient,

package/src/internal/hook-handlers/network.ts

@@ -17,6 +17,8 @@ export default async (): Promise<Partial<NetworkHooks>> => {
         connection.chainType,
         connection.provider,
         context.artifacts,
+        context.config.chainDescriptors,
+        connection.networkName,
       );
 
       return connection;

package/src/internal/initialization.ts

@@ -1,5 +1,6 @@
 import type { HardhatViemHelpers } from "../types.js";
 import type { ArtifactManager } from "hardhat/types/artifacts";
+import type { ChainDescriptorsConfig } from "hardhat/types/config";
 import type { ChainType } from "hardhat/types/network";
 import type { EthereumProvider } from "hardhat/types/providers";
 
@@ -19,24 +20,53 @@ export function initializeViem<ChainTypeT extends ChainType | string>(
   chainType: ChainTypeT,
   provider: EthereumProvider,
   artifactManager: ArtifactManager,
+  chainDescriptors: ChainDescriptorsConfig,
+  networkName: string,
 ): HardhatViemHelpers<ChainTypeT> {
   return {
     getPublicClient: (publicClientConfig) =>
-      getPublicClient(provider, chainType, publicClientConfig),
+      getPublicClient(
+        provider,
+        chainType,
+        chainDescriptors,
+        networkName,
+        publicClientConfig,
+      ),
 
     getWalletClients: (walletClientConfig) =>
-      getWalletClients(provider, chainType, walletClientConfig),
+      getWalletClients(
+        provider,
+        chainType,
+        chainDescriptors,
+        networkName,
+        walletClientConfig,
+      ),
 
     getWalletClient: (address, walletClientConfig) =>
-      getWalletClient(provider, chainType, address, walletClientConfig),
+      getWalletClient(
+        provider,
+        chainType,
+        chainDescriptors,
+        networkName,
+        address,
+        walletClientConfig,
+      ),
 
     getTestClient: (testClientConfig) =>
-      getTestClient(provider, chainType, testClientConfig),
+      getTestClient(
+        provider,
+        chainType,
+        chainDescriptors,
+        networkName,
+        testClientConfig,
+      ),
 
     deployContract: (contractName, constructorArgs, deployContractConfig) =>
       deployContract(
         provider,
         artifactManager,
+        chainDescriptors,
+        networkName,
         contractName,
         constructorArgs,
         deployContractConfig,
@@ -50,6 +80,8 @@ export function initializeViem<ChainTypeT extends ChainType | string>(
       sendDeploymentTransaction(
         provider,
         artifactManager,
+        chainDescriptors,
+        networkName,
         contractName,
         constructorArgs,
         sendDeploymentTransactionConfig,
@@ -59,6 +91,8 @@ export function initializeViem<ChainTypeT extends ChainType | string>(
       getContractAt(
         provider,
         artifactManager,
+        chainDescriptors,
+        networkName,
         contractName,
         address,
         getContractAtConfig,

package/src/types.ts

@@ -1,4 +1,7 @@
-import type { ArtifactMap } from "hardhat/types/artifacts";
+import type {
+  ArtifactMap,
+  StringWithArtifactContractNamesAutocompletion,
+} from "hardhat/types/artifacts";
 import type { ChainType, DefaultChainType } from "hardhat/types/network";
 import type {
   Abi as ViemAbi,
@@ -82,13 +85,18 @@ export interface HardhatViemHelpers<
    * returns the viem's contract instance.
    *
    * @param contractName The name of the contract to deploy. This is required
-   * to return the correct contract type.
+   * to return the correct contract type. TypeScript's language server
+   * autocompletes the names of the contracts that have already been built. If
+   * your contract name isn't in the list, you can still use it, and/or run
+   * `hardhat build` to get it in the list.
    * @param constructorArgs The arguments to pass to the contract's constructor.
    * @param deployContractConfig A configuration object. See
    * {@link DeployContractConfig} for more details.
    * @returns The deployed contract instance.
    */
-  deployContract: <ContractName extends string>(
+  deployContract: <
+    ContractName extends StringWithArtifactContractNamesAutocompletion,
+  >(
     contractName: ContractName,
     constructorArgs?: ConstructorArgs<ContractName>,
     deployContractConfig?: DeployContractConfig,
@@ -99,14 +107,19 @@ export interface HardhatViemHelpers<
    * The function does not wait for the transaction to be mined.
    *
    * @param contractName The name of the contract to deploy. This is required
-   * to return the correct contract type.
+   * to return the correct contract type. TypeScript's language server
+   * autocompletes the names of the contracts that have already been built. If
+   * your contract name isn't in the list, you can still use it, and/or run
+   * `hardhat build` to get it in the list.
    * @param constructorArgs The arguments to pass to the contract's constructor.
    * @param sendDeploymentTransactionConfig A configuration object. See
    * {@link SendDeploymentTransactionConfig} for more details.
    * @returns An object containing the deployed contract instance and the
    * deployment transaction.
    */
-  sendDeploymentTransaction: <ContractName extends string>(
+  sendDeploymentTransaction: <
+    ContractName extends StringWithArtifactContractNamesAutocompletion,
+  >(
     contractName: ContractName,
     constructorArgs?: ConstructorArgs<ContractName>,
     sendDeploymentTransactionConfig?: SendDeploymentTransactionConfig,
@@ -119,13 +132,18 @@ export interface HardhatViemHelpers<
    * address.
    *
    * @param contractName The name of the contract to get an instance of. This
-   * is required to return the correct contract type.
+   * is required to return the correct contract type. TypeScript's language
+   * server autocompletes the names of the contracts that have already been
+   * built. If your contract name isn't in the list, you can still use it,
+   * and/or run `hardhat build` to get it in the list.
    * @param address The address of the contract.
    * @param getContractAtConfig A configuration object. See
    * {@link GetContractAtConfig} for more details.
    * @returns The contract instance.
    */
-  getContractAt: <ContractName extends string>(
+  getContractAt: <
+    ContractName extends StringWithArtifactContractNamesAutocompletion,
+  >(
     contractName: ContractName,
     address: ViemAddress,
     getContractAtConfig?: GetContractAtConfig,