When browsing any evm blockchain, it is often useful to be able to see the source code of a contract. This is especially true when trying to understand the behavior of a contract, or when trying to verify the behavior of a contract. You may be able to hack around and see it on etherscan but really you know your true home is your IDE (any IDE). This tool allows you to fetch the source code of a contract from the blockchain, and create you the full project files for you to view in YOUR IDE, support to deploy on a local node, compile if you choose to. This uses etherscan API to grab the verified sources of the contract. It will keep the same directory structure as how the contract was deployed, alongside all of the dependencies it uses, the project evmc fetches for you will be ready to go!
๐ Fetch the source code of a contract from the blockchain and use it in your favourite editor
๐ Support for hardhat project instantly creating you a hardhat project template with the compile, deploy scripts and local node running all ready to go.
๐ Ethereum Mainnet - eth
๐ Ethereum Ropsten - eth_ropsten
๐ Ethereum Rinkeby - eth_rinkeby
๐ Ethereum Goerli - eth_goerli
๐ Ethereum Kovan - eth_kovan
๐ Binance Smart Chain Mainnet - bsc
๐ Binance Smart Chain Testnet - bsc_testnet
๐ Polygon Mainnet - polygon
๐ Polygon Mumbai - mumbai
๐ Avalanche C-Chain - avalanche
๐ Avalanche Fuji - avalance_testnet
๐ Fantom - fantom
๐ Fantom Testnet - fantom_testnet
๐ Optimism - optimism
๐ Optimism Goerli - optimism_goerli
๐ Arbitrum - arbitrum
๐ Arbitrum Goerli - arbitrum_goerli
๐ Cronos - cronos
๐ Cronos Testnet - cronos_testnet
$ npm install evmcontracts -g
$ yarn global add evmcontracts
Once installed it will expose a command called evmc
which can be executed anywhere.
please note when executing these commands it will create a folder with the name of the contract in the current directory you are in, unless you use --output
To get just the contracts without any development tool:
$ evmc get <network> <contractAddress>
To get the contract and setup a hardhat development environment, with deploy scripts and compiling ready to go:
$ evmc get <network> <contractAddress> --hardhat
already supported by the foundry team already it seems.. nice work!
$ evmc get <network> <contractAddress> --output=PATH_DIRECTORY
The following features are coming soon:
๐ allow you to interact with the contract without downloading them on your machine
๐ ability to config your main network and development kit (to avoid repeating yourself)
๐ ability to fetch multiple contracts at once with a yaml file
๐ bring your own API key
I have generated API keys so its plug and play but these are rate limited at 5 requests per second, this should be plenty as long as the tool does not used by thousands of people, these are free API keys so nobody has motive of stealing them. Above we bring a way to bring your own API key in anyway so if this ever happens we can migrate and make it best practice.