Skip to main content

Extend Clarinet

Extend Clarinet to integrate clarity contracts with your own tooling and workflow.

Topics covered in this guide:

Clarinet run

Namewallet accessdisk writedisk readDeploymentDescription
stacksjs-helper-generatornoyesnohttps://deno.land/x/clarinet@v0.29.0/ext/stacksjs-helper-generator.tsFacilitates contract integration by generating some typescript constants that can be used with stacks.js. Never hard code a stacks address again!

Extensions are run with the following syntax:

$ clarinet run --allow-write https://deno.land/x/clarinet@v0.29.0/ext/stacksjs-helper-generator.ts

Standalone plugin

An extension can be deployed as a standalone plugin on Deno, or can also just be a local file if it includes sensitive / private setup informations.

As illustrated in the example above, permissions (wallet / disk read / disk write) are declared using command flags. If at runtime, the Clarinet extension is trying to write to disk, read disk, or access wallets without permission, the script will end up failing.