\n\n\n## Features ⚡\n\n- static typing - you will never call not existing method again\n- IDE support - works with any IDE supporting Typescript\n- extendible - work with many different APIs: `ethers.js`, `truffle`, `Web3.js 1.0`, `Web3.js 2.0` or you can create\n your own target\n- frictionless - works with simple, JSON ABI files as well as with Truffle style ABIs\n\n## Installation\n\n```bash\nnpm install --save-dev typechain\n```\n\nYou will also need to install a desired target for example `typechain-target-ethers`.\n[Learn more about targets](#targets-)\n\n## Packages 📦\n\n| Package | Version | Description | Examples |\n| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------- | -------------------------------- |\n| [`typechain`](/packages/core) | [](https://www.npmjs.com/package/typechain) | Core package | - |\n| [`@typechain/ethers-v4`](/packages/@typechain/ethers-v4) | [](https://www.npmjs.com/package/@typechain/ethers-v4) | Ethers ver 4 support | [example](./examples/ethers-v4) |\n| [`@typechain/truffle-v4`](/packages/@typechain/truffle-v4) | [](https://www.npmjs.com/package/@typechain/truffle-v4) | Truffle ver 4 support | [example](./examples/truffle-v4) |\n| [`@typechain/web3-v1`](/packages/@typechain/web3-v1) | [](https://www.npmjs.com/package/@typechain/web3-v1) | Web3 ver 1 support | [example](./examples/web3-v1) |\n| [`@typechain/web3-v2`](/packages/@typechain/web3-v2) | [](https://www.npmjs.com/package/@typechain/web3-v2) | Web3 ver 2 support | [example](./examples/web3-v2) |\n\n## Usage\n\n### CLI\n\n```\ntypechain --target=(ethers|truffle|web3-v1|web3-v2|path-to-custom-target) [glob]\n```\n\n- `glob` - pattern that will be used to find ABIs, remember about adding quotes: `typechain \"**/*.json\"`, examples:\n `./abis/**/*.abi`, `./abis/?(Oasis.abi|OasisHelper.abi)`\n- `--target` - ethers, truffle, web3-v1 or path to your custom target. typechain will try to load package named\n `typechain-target-${target}`, so make sure that desired package is installed.\n- `--outDir` - put all generated files to a specific dir\n\nTypeChain always will rewrite existing files. You should not commit them. Read more in FAQ section.\n\nExample:\n\n```\ntypechain --target ethers --outDir app/contracts './node_modules/neufund-contracts/build/contracts/*.json'\n```\n\n## Demo 🏎️\n\n\n\n[Example usage](https://github.com/Neufund/commit.neufund.org/pull/331/files)\n\n## Getting started 📚\n\n### Motivation\n\nInteracting with blockchain in Javascript is a pain. Web3 interface is sluggish and when using it with Typescript it\ngets even worse. Often, you can't be sure what given method call will actually do without looking at ABI file. TypeChain\nis here to solve these problems (as long as you use Typescript).\n\n### How does it work?\n\nTypeChain is code generator - provide ABI file and you will get Typescript class with flexible interface for interacting\nwith blockchain. Depending on the target parameter it can generate typings for truffle, web3 1.0.0 or ethers.\n\n### Step by step guide\n\nInstall typechain with `yarn add --dev typechain` and install desired target.\n\nRun `typechain --target=your_target` (you might need to make sure that it's available in your path if you installed it\nonly locally), it will automatically find all `.abi` files in your project and generate Typescript classes based on\nthem. You can specify your glob pattern: `typechain --target=your_target \"**/*.abi.json\"`. `node_modules` are always\nignored. We recommend git ignoring these generated files and making typechain part of your build process.\n\nThat's it! Now, just import contract bindings as any other file\n`import { MyAwesomeContract } from './contracts/MyAwesomeContract'` and start interacting with it. We use named exports\nbecause of [this](https://blog.neufund.org/why-we-have-banned-default-exports-and-you-should-do-the-same-d51fdc2cf2ad).\n\n## Targets 🎯\n\n### Ethers.js\n\nUse `ethers` target to generate wrappers for [ethers.js](https://github.com/ethers-io/ethers.js/) lib.\n\n### Truffle\n\nTruffle target is great when you use truffle contracts already. Check out\n[truffle-typechain-example](https://github.com/ethereum-ts/truffle-typechain-example) for more details. It require\ninstalling [typings](https://www.npmjs.com/package/truffle-typings) for truffle library itself.\n\nNow you can simply use your contracts as you did before and get full type safety, yay!\n\n### Web3-1.0.0\n\nGenerates typings for contracts compatible with latest stable Web3.js version. Typings for library itself are now part\nof `Web3 1.0.0` library so nothing additional is needed. For now it needs explicit cast as shown\n[here](https://github.com/krzkaczor/TypeChain/pull/88/files#diff-540a9b8840419be93ddb8d4b53325637R8), this will be fixed\nafter improving official typings.\n\n### Web3-2.0.0\n\nGenerates typings for contracts compatible with (unstable) Web3.js 2.x.x version. Typings for library itself are now\npart of `Web3 2.0.0` library so nothing additional is needed.\n[Usage example](https://github.com/ethereum-ts/TypeChain/blob/master/test/integration/targets/web3-v2/DumbContract.spec.web3.ts#L12).\n\n### Your own target\n\nThis might be useful when you're creating a library for users of your smartcontract and you don't want to lock yourself\ninto any API provided by Web3 access providing library. You can generate basically any code (even for different\nlanguages than TypeScript!) that based on smartcontract's ABI.\n\n## Migration guide\n\nFor users of 0.x.x versions: the only breaking change is extraction of targets for separate packages so now you need to\ninstall `typechain-target-${name}` for each target.\n\n## FAQ 🤔\n\n### Q: Should I commit generated files to my repository?\n\nA: _NO_ — we believe that no generated files should go to git repository. You should git ignore them and make\n`typechain` run automatically for example in post install hook in package.json:\n\n```\n\"postinstall\":\"typechain\"\n```\n\nWhen you update ABI, just regenerate files with TypeChain and Typescript compiler will find any breaking changes for\nyou.\n\n### Q: How do I customize generated code?\n\nA: You can create your own target and generate basically any code.\n\n### Q: Generated files won't match current codestyle of my project :(\n\nA: We will automatically format generated classes with `prettier` to match your coding preferences (just make sure to\nuse `.prettierrc` file).\n\nFurthermore, we will silent tslint for generated files with `/* tslint:disable */` comments.\n\n### Usage as API\n\nYou may want to use `ts-generator` api to kick off whole process by api:\n\n```typescript\nimport { tsGenerator } from 'ts-generator'\nimport { TypeChain } from 'typechain/dist/TypeChain'\n\nasync function main() {\n const cwd = process.cwd()\n\n await tsGenerator(\n { cwd },\n new TypeChain({\n cwd,\n rawConfig: {\n files: 'your-glob-here',\n outDir: 'optional out dir path',\n target: 'your-target',\n },\n }),\n )\n}\n\nmain().catch(console.error)\n```\n\n### Running tests\n\n```\nyarn # install all dependencies\nyarn test # runs tests + linting\nyarn test:fix # autofix any errors + run tests\n```\n\n### Debugging 🐞\n\n```sh\nDEBUG=typechain typechain\n```\n\n# Licence\n\nKrzysztof Kaczor (krzkaczor) MIT | [Github](https://github.com/krzkaczor) | [Twitter](https://twitter.com/krzkaczor)\n","license":"MIT","scripts":{"lint":"eslint --ext .ts src test","test":"mocha --config ../../.mocharc.js","clean":"rm -rf dist && rm -f tsconfig.build.tsbuildinfo","start":"ts-node -T ./src/index.ts","format":"prettier --config ../../.prettierrc --ignore-path ../../.prettierignore --check \"./**/*.ts\"","lint:fix":"yarn lint --fix","test:fix":"yarn lint:fix && yarn format:fix && yarn test && yarn typecheck","typecheck":"tsc --noEmit --incremental false --composite false","format:fix":"prettier --config ../../.prettierrc --ignore-path ../../.prettierignore --write \"./**/*.ts\"","post-build":"chmod +x ./dist/cli/cli.js && cp ../../README.md .","prepublishOnly":"yarn lint && yarn format && yarn test && yarn typecheck && (cd ../.. && yarn build)"},"_npmUser":{"name":"krzkaczor","email":"chris@kaczor.io"},"homepage":"https://github.com/ethereum-ts/Typechain#readme","keywords":["ethereum","TypeScript","bindings","smartcontract","blockchain"],"repository":{"url":"git+https://github.com/ethereum-ts/Typechain.git","type":"git"},"_npmVersion":"6.9.0","description":"🔌 TypeScript bindings for Ethereum smartcontracts","directories":{},"maintainers":[{"name":"krzkaczor","email":"krzkaczor@gmail.com"}],"_nodeVersion":"10.16.0","dependencies":{"debug":"^4.1.1","lodash":"^4.17.15","js-sha3":"^0.8.0","fs-extra":"^7.0.0","ts-generator":"^0.0.8","ts-essentials":"^6.0.3","command-line-args":"^4.0.7"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"chai":"^4.2.0","glob":"^7.1.2","mocha":"^6.2.2","sinon":"^8.0.1","eslint":"^6.8.0","ts-node":"^8.5.4","bluebird":"^3.5.1","coveralls":"^3.0.2","sinon-chai":"^3.3.0","typescript":"3.9.0-beta","@types/chai":"^4.2.7","@types/glob":"^5.0.35","@types/node":"^8.0.25","@types/debug":"^4.1.5","@types/mocha":"^5.2.7","bignumber.js":"^5.0.0","@types/lodash":"^4.14.139","@types/bluebird":"^3.5.18","@types/fs-extra":"^5.0.4","@types/prettier":"^1.13.2","chai-as-promised":"^7.1.1","@types/bignumber.js":"^5.0.0","eslint-plugin-sonarjs":"^0.5.0","@types/chai-as-promised":"^7.1.2","@types/command-line-args":"^4.0.2","eslint-config-typestrict":"^1.0.0","@typescript-eslint/parser":"^2.12.0","eslint-plugin-no-only-tests":"^2.4.0","@typescript-eslint/eslint-plugin":"^2.25.0"},"_npmOperationalInternal":{"tmp":"tmp/typechain_2.0.0-beta2_1587753670666_0.7825850421033897","host":"s3://npm-registry-packages"},"_id":"typechain@2.0.0-beta2","version":"2.0.0-beta2"}
![\"TypeChain\"](\"https://github.com/Neufund/TypeChain/blob/d82f3cc644a11e22ca8e42505c16f035e2f2555d/docs/images/typechain-logo.png?raw=true\"){kind=logo}
\n ![\"Build](\"https://circleci.com/gh/ethereum-ts/TypeChain/tree/master.svg?style=svg\")
\n ![\"Coverage\"](\"https://coveralls.io/repos/github/ethereum-ts/TypeChain/badge.svg?branch=master\"){kind=icon}
\n ![\"Downloads\"](\"https://img.shields.io/npm/dm/typechain.svg\")
\n ![\"Prettier\"](\"https://img.shields.io/badge/code_style-prettier-ff69b4.svg\"){kind=icon}
\n ![\"Software](\"https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square\"){kind=icon}
\n ![\"Neufund\"](\"https://github.com/Neufund/TypeChain/blob/6d358df7b2da6b62d56f9935f1666b17b93176f0/docs/images/neufund-logo.png?raw=true\"){kind=logo}
\n