# ethers-types

> [![npm package][npm-img]][npm-url] [![Build Status][build-img]][build-url] [![Downloads][downloads-img]][downloads-url] [![Issues][issues-img]][issues-url] [![Commitizen Friendly][commitizen-img]][commitizen-url] [![Semantic Release][semantic-release-img]

Latest version **3.18.1** (published 2025-01-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install ethers-types
pnpm add ethers-types
yarn add ethers-types
bun add ethers-types
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 3.18.1 |
| Published | 2025-01-09 |
| First published | 2023-06-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 9.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Romain |
| Maintainers | rubilmax |
| Keywords | ethereum, smart-contracts, ethers, types, typescript, erc20, evm |

## Links

- npm: https://www.npmjs.com/package/ethers-types
- Repository: https://github.com/rubilmax/ethers-types
- Homepage: https://github.com/rubilmax/ethers-types#readme
- Issues: https://github.com/rubilmax/ethers-types/issues
- npm.io page: https://npm.io/package/ethers-types

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 3.18.1 (latest) — 2025-01-09
- 3.18.0 — 2025-01-09
- 3.17.3 — 2024-11-21
- 3.17.2 — 2024-08-05
- 3.17.1 — 2024-07-01
- 3.17.0 — 2024-06-24
- 3.16.0 — 2024-05-22
- 3.15.1 — 2024-05-20
- 3.15.0 — 2024-05-16
- 3.14.0 — 2024-04-18
- 3.13.0 — 2024-04-17
- 3.12.0 — 2024-04-15
- 3.11.0 — 2024-04-03
- 3.10.0 — 2024-04-03
- 3.9.0 — 2024-03-18
- … 20 more at https://npm.io/package/ethers-types/versions

## README

# ethers-types

[![npm package][npm-img]][npm-url]
[![Build Status][build-img]][build-url]
[![Downloads][downloads-img]][downloads-url]
[![Issues][issues-img]][issues-url]
[![Commitizen Friendly][commitizen-img]][commitizen-url]
[![Semantic Release][semantic-release-img]][semantic-release-url]

> 🛟 Making web3 more predictable & safer, 1 type at a time!

## Install

```bash
npm install ethers-types
```

```bash
yarn add ethers-types
```

---

## Getting Started

Import your favorite protocol's contract types directly into your TypeScript code:

```typescript
import { getDefaultProvider } from "ethers";
import { MorphoAaveV3__factory } from "ethers-types/factories/protocols/morpho/aave-v3/MorphoAaveV3__factory";
import { ERC20__factory } from "ethers-types/factories/token/ERC20/ERC20__factory";

const provider = getDefaultProvider();

const dai = ERC20__factory.connect("0x6B175474E89094C44Da98b954EedeAC495271d0F", provider);
const ma3Eth = MorphoAaveV3__factory.connect("0x33333aea097c193e66081E930c33020272b33333", provider);
```

You can even use [ethers-multicall-provider](https://github.com/Rubilmax/ethers-multicall-provider) to batch your RPC calls and load responses faster!

```typescript
import { getDefaultProvider } from "ethers";
import { MorphoAaveV3__factory } from "ethers-types/factories/protocols/morpho/aave-v3/MorphoAaveV3__factory";
import { ERC20__factory } from "ethers-types/factories/token/ERC20/ERC20__factory";

const provider = MulticallWrapper.wrap(getDefaultProvider());

const dai = ERC20__factory.connect("0x6B175474E89094C44Da98b954EedeAC495271d0F", provider);

dai.symbol().then(console.log);
dai.decimals().then(console.log);
```

[build-img]: https://github.com/Rubilmax/ethers-types/actions/workflows/release.yml/badge.svg
[build-url]: https://github.com/Rubilmax/ethers-types/actions/workflows/release.yml
[downloads-img]: https://img.shields.io/npm/dt/ethers-types
[downloads-url]: https://www.npmtrends.com/ethers-types
[npm-img]: https://img.shields.io/npm/v/ethers-types
[npm-url]: https://www.npmjs.com/package/ethers-types
[issues-img]: https://img.shields.io/github/issues/Rubilmax/ethers-types
[issues-url]: https://github.com/Rubilmax/ethers-types/issues
[semantic-release-img]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
[semantic-release-url]: https://github.com/semantic-release/semantic-release
[commitizen-img]: https://img.shields.io/badge/commitizen-friendly-brightgreen.svg
[commitizen-url]: http://commitizen.github.io/cz-cli/

---
_Source: https://npm.io/package/ethers-types · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._