Nakamoto & Primary Testnet

There are two main options when it comes to testnets. The one you work with will depend on your own testing needs and preferences.

Recent Testnet History (May 2024)

Over the past month+, the Bitcoin Testnet has slowly become unusable. Given the Primary Stacks Testnet leverages Bitcoin to provide a realistic environment, the Stacks testnet also became unusable. To overcome this, the core developers spun up the Nakamoto Testnet to unblock Signers and test ahead of Nakamoto Instantiation. In the background, they have also been working to bring the Primary Testnet back. To achieve this, they migrated the Primary Stacks testnet to the Bitcoin Regtest network. As of May 31st, the Primary Testnet is back and ready to use.

Primary and Nakamoto Testnets

There are some notable differences between Primary Testnet and Nakamoto Testnet, this table can guide you in selecting the one most aligned with your needs.

AttributesNakamoto TestnetPrimary Testnet

Stacking Cycle Length

3 days

1 week


Bleeding edge, more frequent upgrades with Release Candidates.

Stable release updates ONLY, the last step before Mainnet.

Usage Recommendations

  • Use this if you donโ€™t mind frequent resets and would like to test the latest features as theyโ€™re released

  • Use this if you prefer faster feedback loops to test various stacking-signer scenarios

  • Use this if you prefer more stable releases and donโ€™t want frequent resets and updates

  • Use this if you don't need to be among the first to test new features

  • Use this if you prefer longer Stacking cycles


Nakamoto Testnet will remain available until sBTC goes live on Mainnet

The Primary Testnet will exist and be maintained forever.

Important notes on the Primary Testnet:

  • Core devs are working on a BTC Regtest Explorer. In the meantime, Wallet, Explorer, and API links to BTC transactions will lead you nowhere. This is expected and will be addressed. All STX transactions are available to track on the Explorer.

  • You can start onboarding your Signer, deploy contracts and test your Apps. All functionality from the previous testnet is available.

  • Old testnet data is archived and will remain available until the end of June 2024

  • Faucet and tSTX:

    • The Faucet address and limits stay the same. Learn more about faucets: Testnet

    • If you need more tSTX than the current daily limit to onboard your Signer on Primary Testnet, please reach out to your main point of contact in the ecosystem.

Configuration Files for Signers

Last updated