What is Tenderly CLI?
Tenderly CLI is a suite of development tools that allows you to debug, monitor, and track the execution of your smart contracts. Whether you’re deploying to mainnet, testnets, or local development networks, Tenderly CLI provides the essential tooling to streamline your smart contract workflow.Contract Monitoring
Actively monitor your deployed contracts on any supported network with real-time transaction tracking
Smart Debugging
Debug transactions with detailed execution traces and state changes
Contract Verification
Verify your contracts directly from your development environment
Multi-Framework Support
Works with Hardhat, Truffle, Foundry, and other popular frameworks
Key Features
Contract Management
Push your smart contracts to the Tenderly Dashboard where they’re actively monitored. Get insights into every transaction, including:- Transaction traces and call stacks
- State changes and event logs
- Gas usage analytics
- Error detection and debugging information
Multiple Authentication Methods
Tenderly CLI supports flexible authentication:- Email/Password: Traditional authentication flow
- Access Key: Generate an access key from your Tenderly Dashboard for CI/CD pipelines
Project Configuration
The CLI uses a simple YAML configuration file (tenderly.yaml) to manage your project settings. You can push contracts to multiple projects and networks with a single configuration.
Global Flags
Every command supports these global flags for customization:| Flag | Default | Description |
|---|---|---|
--debug | false | Enable debug level logging for troubleshooting |
--output | text | Set output mode: text or json |
--global-config | config | Specify global configuration file name |
--project-config | tenderly | Specify project configuration file name |
--project-dir | ./ | Set the project directory path |
Use Cases
- Development
- Production
- CI/CD
During development, use Tenderly CLI to:
- Verify contracts as you deploy them
- Monitor test deployments on testnets
- Debug failed transactions with detailed traces
- Track contract interactions and state changes
Supported Networks
Tenderly CLI supports all major Ethereum networks and EVM-compatible chains, including:- Ethereum Mainnet and all major testnets
- Layer 2 solutions (Arbitrum, Optimism, Base, etc.)
- Polygon, BSC, Avalanche, and more
- Custom and local networks (via DevNets)
For smart contract verification with Foundry or Hardhat, refer to the Foundry verification guide and Hardhat verification guide.
What’s Next?
Ready to get started? Follow our installation guide to set up the Tenderly CLI on your system, then check out the quickstart guide to push your first contract to Tenderly.Installation
Install the CLI on macOS, Linux, or Windows
Quickstart
Get started in 5 minutes with our quickstart guide
Get Help
Need assistance? We’re here to help:- Email us at [email protected]
- Check the command-line help with
tenderly --help - Use the
--debugflag for detailed error information - Report bugs on the GitHub repository