Nakamoto for App Developers

Here are some things currently in place:

Today’s testnet and mainnet (as of Bitcoin block 840,360) include the new contracts used for Signers and pox-4. This includes the new consensus rules which aren’t fully activated yet. Signers are now able to onboard and conduct distributed key generation and on-chain voting for the aggregate key, allowing them to test everything without the pressure of the network consensus requiring the real signing of blocks.

Fast blocks and Bitcoin finality will not be available until activation around August 28th. Until then, application developers can go about their development process as normal, but there are a few things to be aware of depending on the functionality your app has.

Getting Started with Nakamoto

You can jump into and begin using Nakamoto today, here are some links to help you get started.

New Docs

There have been several updates to Hiro's products including Clarinet, Stacks.js, and the API. You can view a summary of all the changes and links to relevant documentation on Hiro's Nakamoto Docs page.

API Endpoints

PoX-4 Contract

pox-4.clar is the new stacking contract for Nakamoto. If you are interested in experimenting with proof of transfer use cases including state changes, solo stacking, and pool stacking, all the functions you’ll need can be found at the deployed contract:

Signers Voting Contract

After a DKG (Distributed Key Generation) round, signer votes are submitted to this contract. For more on DKG, you can read the Stackers and Signing section of Nakamoto In-Depth.

https://explorer.hiro.so/txid/0x69af1dbed501acdbc0d1c79e1ecbc17e1904edacc15cf4b39d6783e720e21c00?chain=testnet

Block Explorer

The explorer will allow you to view fast blocks as they come in. Be sure to turn on “Live updates” to see them coming in in real time. https://explorer.hiro.so/?chain=testnet

Local Development Environment

Clarinet has been updated to work with Nakamoto using as of version 2.4. That means you can use Clarinet to build locally using Nakamoto rules in your local development environment and use Clarinet and deployment plans to deploy to Nakamoto Testnet.

Be sure to update Clarinet to the newest version.

Running a signer

If you are interested in running a signer, you can take a look at the How to Run a Signer doc which will get you up to speed on how to get the signer software set up using Nakamoto.

Office Hours

If you need support or just want to ask questions while experimenting with the Nakamoto Testnet, you can join the weekly office hours with the Stacks' Foundation's Developer Advocate, Kenny Rogers.

Last updated