0.5.1

Fast typed bindings from Solidity ABI artifacts.

Hardhat plugin · auto-generate on compile · ~30x faster than TypeChain

@0xdoublesharp/hardhat-abi-typegen

Hardhat plugin for abi-typegen. Generates typed bindings from Solidity ABI artifacts on every hardhat compile. Downloads the pre-built abi-typegen binary for your platform automatically.

Install

npm install -D @0xdoublesharp/hardhat-abi-typegen
yarn add -D @0xdoublesharp/hardhat-abi-typegen
pnpm add -D @0xdoublesharp/hardhat-abi-typegen

Setup

Hardhat 3

Add the plugin to plugins in hardhat.config.ts:

import { defineConfig } from "hardhat/config";
import abiTypegen from "@0xdoublesharp/hardhat-abi-typegen";

export default defineConfig({
  plugins: [abiTypegen],
  solidity: "0.8.34",
  typegen: {
    out: "src/generated", // output directory (default: "src/generated")
    target: "viem", // target name or comma-separated targets
    wrappers: true, // emit typed wrappers (default: true)
    contracts: ["Token"], // optional - limit to named contracts
    exclude: ["*Test", "*Mock"], // optional - exclude by glob pattern
  },
});

Hardhat 2

Hardhat 2 projects can keep the side-effect import:

import "@0xdoublesharp/hardhat-abi-typegen";

const config: HardhatUserConfig = {
  solidity: "0.8.34",
  typegen: {
    out: "src/generated", // output directory (default: "src/generated")
    target: "viem", // target name or comma-separated targets
    wrappers: true, // emit typed wrappers (default: true)
    contracts: ["Token"], // optional - limit to named contracts
    exclude: ["*Test", "*Mock"], // optional - exclude by glob pattern
  },
};

export default config;

The package uses conditional exports: ESM imports get the Hardhat 3 plugin object, and CommonJS/Hardhat 2 imports get the legacy task-hook plugin. The explicit fallback subpath @0xdoublesharp/hardhat-abi-typegen/hardhat2 is also available for Hardhat 2 projects that want to pin the legacy adapter.

Usage

Types are generated automatically after every compile:

npx hardhat compile
# → abi-typegen: generated 5 contract(s) → src/generated

Or generate directly:

npx abi-typegen generate --hardhat --target viem

Configuration

Targets

There are 28 CLI targets across 21 languages. Unity uses the csharp target with an adapter package.

JavaScript and TypeScript

Native languages

Game engines

See engine packages for setup and native bindings for supported features and platforms.

Shell and ABI formats

Zod, Solidity, and YAML describe or validate contracts; they do not submit transactions. See native bindings for SDK versions and configuration for target aliases.

COBOL

Target aliases: ethers6 → ethers, web3 → web3js, cs → csharp, kt → kotlin, sol → solidity, yml → yaml, c++ → cpp, fs/f# → fsharp, ml → ocaml, kdb/kdb+ → q

Multi-target examples — each target gets its own output subdirectory:

target: "viem,python,rust"; // comma-separated string
target: ["viem", "python", "rust"]; // array of strings

Notes

• When using target: "zod", install the latest zod package in the consuming project
• Use comma-separated multi-target generation instead of the removed all and all-ts aliases

See github.com/doublesharp/abi-typegen for full documentation.

Native contract bindings

Go, Swift, Kotlin, C#, F#, Java, and Dart wrappers use their runtime SDKs for contract calls and transactions. PHP includes ABI codecs, JSON-RPC reads, legacy transaction signing, receipt and log queries, and event/error decoding. It requires PHP 8.2+ with cURL, GMP, mbstring, and iconv. It does not generate EIP-1559 or deployment helpers. C/C++ bindings link abi-typegen-runtime and accept a caller-supplied transport/signing adapter. OCaml uses Zarith integers and the shared runtime with application-supplied transport. q/kdb+ generates event schemas, decoders, and log rows; it does not include an RPC client. OCaml and q also require compiled bridges linked to the shared runtime. --no-wrappers preserves primary ABI metadata, value types, and q table schemas. See the native binding guide for dependencies, ownership rules, supported features, and SDK limits.