Announcement: As part of a simplification and improvement process of the Clarinet project, the commands
clarinet runare now deprecated and won't be available in Clarinet 2 that will be released in October 2023. The testing features are available now in the Clarinet SDK.
Clarinet consists of two main components:
- Clarity REPL (Read, Evaluate, Print, Loop)
- Testing harness.
When the above components are used together, you can rapidly develop and test a Clarity smart contract, by deploying the contract to a local
Clarinet supports different network types to cater to various development and testing needs. Here's a brief overview of each:
|Optimized for fast feedback loops, introspection, and portability. Can be run anywhere and generate reports about contract analysis, execution, costs, etc.
|Ideal for initial development and unit-testing.
|Local Stacks and Bitcoin nodes running on Docker for relatively fast feedback loops. Includes optional components like stacks-api, bitcoin-explorer, stacks-explorer, etc.
|Use for integration tests or to develop the front-end of your dApp locally
|A pre-production network that offers a realistic environment for testing.
|Ideal for final testing before deploying to Mainnet.
|The production network where real transactions occur.
|Use when you're ready to deploy your smart contract to production.
To better understand Clarinet and how to develop with Clarinet, Hiro has created an introductory video tutorial series from Hiro Engineer Ludo Galabru that will guide you through some of the basics of using Clarinet. The video series also shows you how to use Clarinet to develop, test, and deploy smart contracts.
To view these video tutorials, please see Hiro's Youtube channel.
For the latest information on Clarinet, refer to blog posts on Clarinet.
When developing smart contracts, you can also use the Clarity Visual Studio Code plugin.