Skip to main content

Clarinet Integrate


The Clarinet Integrate feature enables you to easily integrate your existing smart contracts with the blockchain in a local testing environment, allowing you to validate and verify your smart contract on an actual blockchain. While unit testing (the process of testing your code to ensure it works correctly) is a valuable way to test your code before implementation, certain features cannot be verified during unit testing, such as how your smart contract interacts with proof of transfer or the Bitcoin chain. Clarinet Integrate provides these additional tests.

Topics covered in this guide:

Key concepts

Before using Clarinet Integrate, you should understand the following concepts described below.


Mainnet refers to a working, fully operational blockchain that has been deployed and is in production. This environment verifies and records transactions made to the blockchain.


Testnet refers to a test environment that you can use to validate and verify smart contracts and integrations between your contracts and the blockchain. Any work you perform in testnet is written to the blockchain and is not deployed into production.


Devnet refers to an environment where you perform development tasks, including creating smart contracts and other assets. Use this space during the development phase of your work whenever possible.

Working with clarinet integrate

Setting up and configuring your own devnet can be time-consuming. Clarinet Integrate speeds up the deployment process with an embedded orchestrator tool that enables you to run your own devnet network even when offline.


For a more detailed discussion on how to use Clarinet Integrate, please see the following resources: