ABIType logo

Version Downloads per month MIT License Best of JS
--- Strict TypeScript types for Ethereum ABIs. ABIType provides utilities and type definitions for ABI properties and values, covering the [Contract ABI Specification](https://docs.soliditylang.org/en/latest/abi-spec.html), as well as [EIP-712](https://eips.ethereum.org/EIPS/eip-712) Typed Data. ```ts import type { AbiParametersToPrimitiveTypes, ExtractAbiFunctions, ExtractAbiFunctionNames } from 'abitype' import { erc20Abi } from 'abitype/test' type FunctionNames = ExtractAbiFunctionNames // ^? type FunctionNames = "symbol" | "name" | "allowance" | "balanceOf" | "decimals" | "totalSupply" type TransferInputTypes = AbiParametersToPrimitiveTypes< // ^? type TransferInputTypes = readonly [`0x${string}`, bigint] ExtractAbiFunction['inputs'] > ``` Works great for adding blazing fast [autocomplete](https://twitter.com/awkweb/status/1555678944770367493) and type checking to functions, variables, or your own types. No need to generate types with third-party tools โ€“ just use your ABI and let TypeScript do the rest! ## TL;DR ABIType might be a good option for your project if: - You want to [typecheck](https://abitype.dev/api/types.html) your ABIs or EIP-712 Typed Data. - You want to add type inference and autocomplete to your library based on user-provided ABIs or EIP-712 Typed Data, like [wagmi](https://wagmi.sh) and [viem](https://viem.sh). - You need to [convert ABI types](https://abitype.dev/api/utilities.html#abiparameterstoprimitivetypes) (e.g. `'string'`) to TypeScript types (e.g. `string`) or other type transformations. - You need to validate ABIs at [runtime](https://abitype.dev/api/zod.html) (e.g. after fetching from external resource). - You donโ€™t want to set up a build process to generate types (e.g. TypeChain). ## Install ```bash pnpm add abitype ``` ```bash npm i abitype ``` ```bash yarn add abitype ``` ## Documentation For full documentation, visit [abitype.dev](https://abitype.dev). ## Community If you have questions or need help, reach out to the community at the [ABIType GitHub Discussions](https://github.com/wagmi-dev/abitype/discussions). ## Sponsor If you find ABIType useful, please consider supporting development on [GitHub Sponsors](https://github.com/sponsors/wagmi-dev?metadata_campaign=abitype_readme) or sending crypto to `wagmi-dev.eth`. Thank you ๐Ÿ™ ## Contributing If you're interested in contributing to ABIType, please read our [contributing docs](https://github.com/wagmi-dev/abitype/blob/main/.github/CONTRIBUTING.md) **before submitting a pull request**.