npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

Iโ€™ve always been into building performant and accessible sites, but lately Iโ€™ve been taking it extremely seriously. So much so that Iโ€™ve been building a tool to help me optimize and monitor the sites that I build to make sure that Iโ€™m making an attempt to offer the best experience to those who visit them. If youโ€™re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, ๐Ÿ‘‹, Iโ€™m Ryan Hefnerย  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If youโ€™re interested in other things Iโ€™m working on, follow me on Twitter or check out the open source projects Iโ€™ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soonโ€“ish.

Open Software & Tools

This site wouldnโ€™t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you ๐Ÿ™

ยฉ 2024 โ€“ย Pkg Stats / Ryan Hefner

@interlay/typechain

v2.0.1

Published

๐Ÿ”Œ TypeScript bindings for Ethereum smartcontracts

Downloads

2

Readme

Features โšก

  • static typing - you will never call not existing method again
  • IDE support - works with any IDE supporting Typescript
  • extendible - work with many different APIs: ethers.js v4, truffle v4 , truffle v5, Web3.js v1, Web3.js v2 or you can create your own target
  • frictionless - works with simple, JSON ABI files as well as with Truffle style ABIs

Installation

npm install --save-dev typechain

You will also need to install a desired target for example @typechain/ethers-v4. Learn more about targets

Packages ๐Ÿ“ฆ

| Package | Version | Description | Examples | | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | --------------------- | -------------------------------- | | typechain | npm | Core package | - | | @typechain/ethers-v5 | npm | Ethers ver 5 support | example | | @typechain/ethers-v4 | npm | Ethers ver 4 support | example | | @typechain/truffle-v5 | npm | Truffle ver 5 support | example | | @typechain/truffle-v4 | npm | Truffle ver 4 support | example | | @typechain/web3-v1 | npm | Web3 ver 1 support | example |

Usage

CLI

typechain --target=(ethers-v4|truffle-v4|truffle-v5|web3-v1|path-to-custom-target) [glob]
  • glob - pattern that will be used to find ABIs, remember about adding quotes: typechain "**/*.json", examples: ./abis/**/*.abi, ./abis/?(Oasis.abi|OasisHelper.abi).
  • --target - ethers-v4, truffle-v4, truffle-v5, web3-v1 or path to your custom target. Typechain will try to load package named. @typechain/${target}, so make sure that desired package is installed.
  • --outDir (optional) - put all generated files to a specific dir.

TypeChain always will rewrite existing files. You should not commit them. Read more in FAQ section.

Example:

typechain --target ethers-v4 --outDir app/contracts './node_modules/neufund-contracts/build/contracts/*.json'

Demo ๐ŸŽ๏ธ

Demo

Example usage

Getting started ๐Ÿ“š

Motivation

Interacting with blockchain in Javascript is a pain. Web3 interface is sluggish and when using it with Typescript it gets even worse. Often, you can't be sure what given method call will actually do without looking at ABI file. TypeChain is here to solve these problems (as long as you use Typescript).

How does it work?

TypeChain is code generator - provide ABI file and you will get Typescript class with flexible interface for interacting with blockchain. Depending on the target parameter it can generate typings for truffle, web3 1.0.0 or ethers.

Step by step guide

Install typechain with yarn add --dev typechain and install desired target.

Run typechain --target=your_target (you might need to make sure that it's available in your path if you installed it only locally), it will automatically find all .abi files in your project and generate Typescript classes based on them. You can specify your glob pattern: typechain --target=your_target "**/*.abi.json". node_modules are always ignored. We recommend git ignoring these generated files and making typechain part of your build process.

That's it! Now, you can simply import typings, check out our examples for more details.

Targets ๐ŸŽฏ

Ethers.js v4 / v5

Use ethers-v4 target to generate wrappers for ethers.js lib.

Truffle v4 / v5

Truffle target is great when you use truffle contracts already. Check out truffle-typechain-example for more details. It require installing typings for truffle library itself.

Now you can simply use your contracts as you did before and get full type safety, yay!

Web3 v1

Generates typings for contracts compatible with latest stable Web3.js version. Typings for library itself are now part of the Web3 1.0.0 library so nothing additional is needed. For now it needs explicit cast as shown here, this will be fixed after improving official typings.

NatSpec support

If you provide solidity artifacts rather than plain ABIs as an input, TypeChain can generate NatSpec comments directly to your typings which enables simple access to docs while coding.

Your own target

This might be useful when you're creating a library for users of your smartcontract and you don't want to lock yourself into any API provided by Web3 access providing library. You can generate basically any code (even for different languages than TypeScript!) that based on smartcontract's ABI.

FAQ ๐Ÿค”

Q: Should I commit generated files to my repository?

A: NO โ€” we believe that no generated files should go to git repository. You should git ignore them and make typechain run automatically for example in post install hook in package.json:

"postinstall":"typechain"

When you update ABI, just regenerate files with TypeChain and Typescript compiler will find any breaking changes for you.

Q: How do I customize generated code?

A: You can create your own target and generate basically any code.

Q: Generated files won't match current codestyle of my project :(

A: We will automatically format generated classes with prettier to match your coding preferences (just make sure to use .prettierrc file).

Furthermore, we will silent tslint for generated files with /* tslint:disable */ comments.

Usage as API

You may want to use ts-generator api to kick off whole process by api:

import { tsGenerator } from 'ts-generator'
import { TypeChain } from 'typechain/dist/TypeChain'

async function main() {
  const cwd = process.cwd()

  await tsGenerator(
    { cwd },
    new TypeChain({
      cwd,
      rawConfig: {
        files: 'your-glob-here',
        outDir: 'optional out dir path',
        target: 'your-target',
      },
    }),
  )
}

main().catch(console.error)

Running tests

yarn           # install all dependencies
yarn test      # runs tests + linting
yarn test:fix  # autofix any errors + run tests

Debugging ๐Ÿž

DEBUG=typechain typechain

Licence

Krzysztof Kaczor (krzkaczor) MIT | Github | Twitter