ethers.js + abitype

Improves ethers.js with strict ABI typing

---

Makes ethers.js much better. Adds strict typing for Contract class based on ABI using the abitype library. For those who like this feature in viem, but not viem itself.

Installation

1npm i ethers-abitype

Usage

The library provides a special type for the Contract class and in your code you only need to override the type

Example without ABI typing (your regular ethers.js code):

1import { Contract } from "ethers";
2
3const address = "0x...";
4const abi = [
5  /*..*/
6];
7
8const contract = new Contract(address, abi);

Example code with ABI typing:

1import { Contract } from "ethers";
2+ import { TypedContract } from "ethers-abitype";
3
4const address = "0x...";
5const abi = [
6  /*..*/
7- ];
8+ ] as const;
9
10- const contract = new Contract(address, abi);
11+ const contract = new Contract(address, abi) as unknown as TypedContract<typeof abi>;

Congratulations, you now have a typed contract!

Alternatively, the library provides another approach. You can use a small wrapper function for creating an already typed contract:

1- import { Contract } from "ethers";
2+ import { typedContract } from "ethers-abitype";
3
4const address = "0x...";
5const abi = [
6  /*..*/
7- ];
8+ ] as const;
9
10- const contract = new Contract(address, abi);
11+ const contract = typedContract(address, abi);

Important! Your ABI must be declared using a const assertion. This means that you will not be able to store them in a JSON file, because TypeScript doesn't support importing JSON as const

You can also use Human-Readable ABI using parseAbi from abitype:

1import { typedContract } from "ethers-abitype";
2import { parseAbi } from "abitype";
3
4const address = "0x...";
5const abi = parseAbi([
6  "function symbol() external returns (string)",
7  "function decimals() external returns (uint256)",
8  /* ... */
9]);
10
11const contract = typedContract(address, abi);