Nakamoto for App Developers
Here are some things currently in place:
The current 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
API status
Mainnet: https://api.hiro.so/extended/
Burn Block endpoint. This will allow you to get the hashes of fast Stacks blocks as they are added to the chain and see their associated burn blocks.
Pox endpoint. This allows you to get information about proof of transfer, including the currently deployed pox-4 contract. This will be helpful for anyone looking to incorporate stacking into their app.
Testnet: https://api.testnet.hiro.so/v2/pox
Mainnet: https://api.hiro.so/v2/pox
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.
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