Skip to main content

thirdweb Contracts

npm versionBuild StatusJoin our Discord!

Collection of smart contracts deployable via the thirdweb SDK, dashboard and CLI


npm i @thirdweb-dev/contracts

Deployed addresses


Dev - (Mumbai only)

Running Tests

  1. yarn: install contracts dependencies
  2. forge install: install tests dependencies
  3. forge test: run the tests

This repository is a hybrid hardhat and forge project.

First install the relevant dependencies of the project:


forge install

To compile contracts, run:

forge build

Or, if you prefer hardhat, you can run:

npx hardhat compile

To run tests:

forge test

To export the ABIs of the contracts in the /contracts directory, run:

npx hardhat export-abi

To run any scripts in the /scripts directory, run:

npx hardhat run scripts/{path to the script}


The thirdweb registry (TWRegistry) and factory (TWFactory) have been deployed on the following chains:

TWRegistry is deployed to a common address on all mentioned networks. TWFactory is deployed to a common address on all mentioned networks except Fantom mainnet.

Bug reports

Found a security issue with our smart contracts? Send bug reports to and we'll continue communicating with you from there. We're actively developing a bug bounty program; bug report payouts happen on a case by case basis, for now.


If you have any feedback, please reach out to us at



Apache 2.0