# TronBox Documentation

> Official documentation for developing, testing, debugging, and deploying smart contracts with TronBox.

TronBox is a development framework for blockchains using the TRON Virtual Machine (TVM) and EVM-compatible networks. The current stable version is 4.9.0. The official source repository is [tronprotocol/tronbox](https://github.com/tronprotocol/tronbox).

## Getting Started

- [Introduction](https://tronbox.io/docs/): Learn what TronBox is and what it provides.
- [Quickstart](https://tronbox.io/docs/quickstart): Create, compile, deploy, test, and interact with a sample smart contract.
- [Installation](https://tronbox.io/docs/guides/installation): Install TronBox and its Node.js and Docker dependencies.
- [Create a project](https://tronbox.io/docs/guides/create-a-project): Initialize a project or start from a TronBox Box.

## Core Guides

- [Compile contracts](https://tronbox.io/docs/guides/compile-contracts): Compile Solidity contracts and manage build artifacts and dependencies.
- [Deploy contracts](https://tronbox.io/docs/guides/deploy-contracts): Deploy contracts with migrations and the Deployer API.
- [Interact with contracts](https://tronbox.io/docs/guides/interact-with-contracts): Call functions, send transactions, process results, and catch events.
- [Test contracts](https://tronbox.io/docs/guides/test-contracts): Run JavaScript smart contract tests with TronBox and TRE.
- [Write JavaScript tests](https://tronbox.io/docs/guides/write-javascript-tests): Use Mocha, Chai, accounts, hooks, and contract abstractions in tests.
- [Debug with TRE](https://tronbox.io/docs/guides/debugging-with-TRE): Debug Solidity contracts with console.log on the local runtime environment.

## Additional Guides

- [Work with npm](https://tronbox.io/docs/guides/work-with-npm): Install, import, and distribute Solidity packages.
- [Work with EVM-compatible chains](https://tronbox.io/docs/guides/work-with-evm): Compile, deploy, and test contracts on EVM-compatible networks.
- [Flatten contracts](https://tronbox.io/docs/guides/flattening-contracts): Combine a contract and its imports into one Solidity source file.
- [Create a TronBox Box](https://tronbox.io/docs/guides/create-a-box): Package a reusable TronBox project in a GitHub repository.

## Migration

- [Migration overview](https://tronbox.io/docs/migration/overview): Plan a migration from Truffle or Hardhat to TronBox.
- [TronBox vs Truffle](https://tronbox.io/docs/migration/tronbox-vs-truffle): Compare commands, configuration, interaction, testing, and deployment.
- [Migrate from Truffle](https://tronbox.io/docs/migration/migrating-from-truffle): Adapt an existing Truffle project to TronBox.
- [TronBox vs Hardhat](https://tronbox.io/docs/migration/tronbox-vs-hardhat): Compare commands, configuration, libraries, testing, and deployment.
- [Migrate from Hardhat](https://tronbox.io/docs/migration/migrating-from-hardhat): Adapt an existing Hardhat project to TronBox.

## Reference

- [Command-line options](https://tronbox.io/docs/reference/command-line-options): Reference TronBox commands, arguments, and options.
- [Configuration](https://tronbox.io/docs/reference/configuration): Configure networks, accounts, directories, compilers, and build output.
- [Contract abstractions](https://tronbox.io/docs/reference/contract-abstractions): Reference contract abstraction and instance APIs.

## Optional

- [OpenZeppelin upgrades](https://tronbox.io/docs/guides/using-upgrades-plugins): Use the deprecated OpenZeppelin Truffle Upgrades integration.
- [Connect with us](https://tronbox.io/docs/connect-with-us): Find community channels, support, and issue tracking.
- [Changelog](https://github.com/tronprotocol/tronbox/blob/master/CHANGELOG.md): Review TronBox releases and changes.