Practical overview
When it fits
Use it when you want a repository scaffold for a TypeScript Hardhat project and are prepared to configure the relevant contracts, network settings, credentials and scripts.
Who it is for
- Developers starting or adapting a Solidity smart-contract project with Hardhat and TypeScript.
- Teams that want documented Hardhat and Foundry build and test workflows in one template.
- Developers adapting deployment, contract verification or interaction scripts to their own contracts and networks.
Documented uses
- Start a TypeScript Hardhat project for Solidity contract development.
- Build and test contracts using the included Hardhat and Foundry workflows.
- Adapt example scripts to deploy, verify or interact with contracts.
Requirements & limits
The repository is public and displays an MIT license.
- The README recommends Node.js 26.4.0 or later and uses pnpm for dependency installation.
- The included interaction script must be customized for the target contract.
- Deployment and verification involve network-specific configuration and credentials; automatic verification requires an API key.
- Mainnet forking requires access to an archive node and is disabled in the shown configuration.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the template dependencies
Set up the project dependencies using the README's documented Node.js, npm and pnpm sequence.
Before you start
- Node.js version 26.4.0 or later is recommended.
- npm is required to install pnpm.
Steps
Install pnpm globally with the command below.
npm install -g pnpmFrom the project, run
pnpm install.
Expected outcome
The project dependencies are installed for working with the template.
Guide limitations
- This covers dependency installation only; it does not configure a contract or run tests.
Run the included TypeScript or Solidity test workflow
Use the repository's documented commands to run its Hardhat TypeScript tests or Foundry Solidity tests.
Before you start
- The template repository and its dependencies must be available locally.
- Foundry is needed for the Solidity test workflow.
Steps
Run
pnpm test:hhfor TypeScript tests.Run
pnpm test:forgefor Solidity tests, or use the command below.make test-forge
Expected outcome
The selected test command starts the corresponding test workflow.
Guide limitations
- The README documents commands but does not specify test coverage or guarantee successful results for modified contracts.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- pcaversaccio/hardhat-project-template-ts · Official homepage title · retained in its source language

