Truffle Flattener: Prepare Solidity source for verification

Understand the project

Practical overview

Use it as a preprocessing step when a Truffle or Buidler workflow needs contract source and dependencies combined for verification or debugging.

Developers working with Solidity contracts in Truffle or Buidler projects.
Developers preparing contract source for Etherscan verification or Remix debugging.

Before you choose

The repository is public and identifies the software as MIT-licensed. The documented interface is a command-line utility installed with npm.

Aliased Solidity imports are not supported.
Hardhat projects can use the npx hardhat flatten command identified in the README.
The utility prepares source files; verification on Etherscan and debugging in Remix are separate downstream tasks.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Create a flattened source file from Solidity files in a Truffle or Buidler project.

Install the utility globally with the command below.
Documented command
```
npm install truffle-flattener -g
```
From the project, run truffle-flattener with the Solidity file or files to process.

The utility merges the selected Solidity files and their dependencies in the required order for use in a verification or debugging workflow.

Evidence and transparency

Source record details

Source availability: Active
Sources checked: 14 October 2026
Original website title: NomicFoundation/truffle-flattener · Official homepage title · retained in its source language