Need a crash course on Bitcoin layers?
→ READ OUR FREE GUIDE
Need a crash course on Bitcoin layers?
→ READ OUR FREE GUIDE
Need a crash course on Bitcoin layers?
→ READ OUR FREE GUIDE
Need a crash course on Bitcoin layers?
→ READ OUR FREE GUIDE
Need a crash course on Bitcoin layers?
→ READ OUR FREE GUIDE

Expanded sBTC Testing Support Is Live in Clarinet and the Hiro Platform

Now you can access test sBTC across all of your testing environments in Clarinet and the Hiro Platform, so you can more easily and safely integrate sBTC into your development workflow.

Type
Product update
Topic(s)
Product
Stacks
Hiro
Published
February 28, 2025
Author(s)
Sr. Software Engineer
New Testing Capabilities for sBTC
Contents

Earlier this week, 2,000 BTC was bridged into sBTC on Stacks, maxing out the new cap increase in just 24 hours. Liquidity is flowing in, and there’s never been a better time to start building with sBTC.

The good news for you is that building with sBTC just got a whole lot easier.

Mock sBTC Is Now Available in Test Environments

Integrating sBTC into your application is straightforward: it’s a SIP-010 token and follows fungible token standards on Stacks. But for applications that rely on sBTC for their functionality, testing with sBTC was a hassle.

In particular, if you wanted to test the sBTC integration of your app, you had to sub in a dummy SIP-10 token on your various test environments, including simnet, devnet, and testnet. Then when you were ready to deploy on mainnet, you had to swap the code for your dummy token for real sBTC.

And changing your code before deploying to production goes against every lesson you’ve learned about development.

With our latest releases in Clarinet and the Hiro Platform, testing your sBTC integration is now much simpler. Starting today, you can specify the <code-rich-text>sbtc-deposit<code-rich-text> smart contract in your Clarinet project requirements, which enables your test wallets in simnet and devnet to come preloaded with sBTC in the same way that they do with STX today.

This lets you instantly test sBTC transfers in simnet and devnet, speeding up your feedback loop and removing the need to add extra code to simulate sBTC on your own.

We’ve also deployed our own sBTC contract on testnet, so that builders don’t have to deploy their own for testing purposes. And more importantly, this is the contract linked to Hiro’s new sBTC faucet (more on that below).

In addition, Clarinet will automatically remap the sBTC address in your code as you move from one environment to another. No more tweaking your testnet code before deploying to production on mainnet.

With this feature, you can consistently interact with a singular sBTC token across all of your development environments, streamlining your development and reducing the risk of any errors in how your app interacts with sBTC. Learn more about how to interact with sBTC in Clarinet in our documentation.

New sBTC Testnet Faucet

A screenshot of the new sBTC faucet

Alongside with this expanded sBTC support, we’ve also launched a new testnet faucet page in the Hiro Platform that will send you testnet STX and testnet sBTC, streamlining your testing process.

If you’re experimenting with code on testnet and need quick access to sBTC, now that mock sBTC is just one click away.

With this expanded sBTC support, we hope you can more rapidly integrate sBTC into your workflow and ship more confidently. If there is any specific sBTC support you need, or if you have feedback to share, please reach out to us in #clarinet or #hiro-platform under the Hiro Developer Tools channels on the Stacks Discord.

Product updates & dev resources straight to your inbox
Your Email is in an invalid format
Checkbox is required.
Thanks for
subscribing.
Oops! Something went wrong while submitting the form.
Copy link
Mailbox
Hiro news & product updates straight to your inbox
Only relevant communications. We promise we won’t spam.

Related stories