@0xdoublesharp/abi-typegen

Fast typed bindings from Solidity ABI artifacts.

22 targets · 16 languages · Foundry & Hardhat

@0xdoublesharp/abi-typegen

Pre-built binary for abi-typegen. Reads compiled Solidity artifacts and generates typed bindings. Generating files requires no native toolchain; compiling the generated output requires the target language and its SDK.

Install

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

The installer downloads the platform archive over HTTPS and checks its SHA-256 against checksums.json bundled in the npm package before extracting it. Missing hashes, mismatches, and incomplete archives fail installation. Downloads retry transient HTTP errors, including 504, up to three times with exponential backoff. Connection, transfer, and overall download deadlines prevent indefinite waits.

Hashes are pinned during npm publication after checking every GitHub release archive. This detects corruption and later archive replacement; it trusts the release and npm publishing process and is not independent build attestation.

Re-running postinstall verifies a fresh archive before replacing the binary. Installations need curl and tar. Linux archives currently target glibc.

See the installation guide for supported platforms and download troubleshooting.

Usage

# Single target
npx abi-typegen generate --target viem

# Hardhat artifact layout
npx abi-typegen generate --hardhat --target ethers

# Multi-target (each gets its own output subdirectory)
npx abi-typegen generate --target viem,python,rust

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

Commands

npx abi-typegen generate                 # write generated bindings
npx abi-typegen generate --check         # fail if output is stale (CI)
npx abi-typegen generate --clean         # remove stale generated files
npx abi-typegen diff                     # show what would change (dry run)
npx abi-typegen json --pretty            # dump parsed ABI as JSON
npx abi-typegen watch                    # watch artifacts and regenerate
npx abi-typegen init                     # add Foundry configuration
npx abi-typegen forge-install --shell zsh # print Forge shell integration
npx abi-typegen help generate            # show command help
npx abi-typegen --version                # print the installed version
npx abi-typegen fetch --name WETH \
  --network mainnet 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2          # fetch ABI from block explorer
npx abi-typegen fetch --name WETH \
  --file ./WETH.abi.json                 # import a local ABI file

Generation options

Fetch Networks

The fetch command supports 80+ networks via --network. Some examples:

Pass --url <URL> for any Etherscan-compatible explorer not in the list.

Hardhat Plugin

For automatic generation on compile, use @0xdoublesharp/hardhat-abi-typegen.

Configuration

Multi-target generation can also be configured in foundry.toml:

[abi-typegen]
target = ["viem", "python", "rust"]   # also accepts "viem,python,rust"

Notes

• When using --target zod, install the latest zod package in the consuming project
• Multi-target runs write each target to its own subdirectory under the output path

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.