Smart Contracts
Learn how to collect all the contracts you care about so you can monitor, debug, and simulate transactions.
As a form of an opt-in Smart Contract registry, the all-in-one Tenderly development platform allows you to find any verified public contract and add it to your project. After adding a contract, you can start debugging transactions, doing simulations, or handling more advanced monitoring on the contracts that are important for your project.
To find and add a contract of interest, search for it by name or address. If you can't find the contract you need, it probably means it's not verified. You can still add it to your project to monitor it and verify it later on.
There are two options for adding contracts to your project from the Dashboard:
- Adding a publicly verified contract. No verification is required. Add a contract by entering its address and choosing the network to which it's deployed. Once added, the contract will show up in the refreshed list of contracts.
- Adding an unverified contract to observe in which transactions it's involved. However, these transactions won't be decoded to a human-readable format. Other meaningful information such as state changes, gas usage, and events will also remain in raw form.
It's possible to use some Tenderly features with unverified contracts, with limited functionality. For example, you can use the Simulator with raw data. To use the full power of various Tenderly features, it's required to verify the contracts.
To add a verified contract to your project, navigate to the Contracts tab in the left sidebar. Once you open the dedicated contract section, click the Add Contract button in the top right corner.
Adding a contract
This will open the Add Contract modal where you need to follow a few steps:
1. Enter the address of the contract you wish to add to Tenderly.
2. Choose the network to which the contract has been deployed and that Tenderly supports.
3. Skip the This contract is unverified box since you're adding a verified contract.
Adding a contract: enter the address and select the network
4. Hit the Add Contract button and the contract will be added to your project.
5. Find and click the added contract from the updated list to open the additional information about it.
Added contract in the dashboard
Follow the same first steps as when adding verified contracts:
1. Navigate to the Contracts page and click the Add contract button.
2. Fill in the address and select one of the 20+ networks supported by Tenderly.
3. Tick the This contract is unverified box.
Adding an unverified contract
If you're uncertain if a contract is verified when adding it, do the following:
- Check whether a contract is verified on Etherscan or BlockSbcout. Search for the contract by pasting its address in the search bar or entering its name in the Verified Contracts submenu. If the contract is verified, it will have a green checkmark and the "Contract Source Code Verified" label.
- Search for the contract on Tenderly. Type in the contract name or address in the Tenderly search bar. If the contract is unverified, it will be displayed only with an address, whereas a verified contract shows a name. Also, if you're uploading a new contract to Tenderly for the first time, it's likely to be unverified.
Last modified 1mo ago