Testnets

Join a Hedera Testnet

Overview

Hedera test networks provide developers access to a free testing environment for Hedera network services. Testnets simulate the exact development environment as you would expect for mainnet. This includes transaction fees, throttles, available services, etc. To create a Hedera Testnet or Previewnet account, you can visit the Hedera Developer Portal.

Once your application has been built and tested in this test environment, you can expect to migrate your decentralized application (dApp) to mainnet without any changes.

Test Networks
Description

Testnet

Testnet runs the same code as the Hedera Mainnet, designed to provide a pre-production environment for developers about to move to mainnet. You can find compatible SDKs here.

Previewnet

Code that is under development by the Hedera team and likely to be used in an upcoming release designed to give developers early exposure to features coming down the pipe. Updates to the network are made frequently. There is no guarantee an SDK will readily support the up-and-coming features.

Note: Updates to this network are triggered by a new release and are frequent. These updates will not be reflected on the status page.

Network Service
Availability

Cryptocurrency

Limited

Consensus Service

Limited

File Service

Limited

Smart Contract Service

Limited

Token Service

Limited

Test Network Resets

The mirror node and consensus node test network are scheduled to reset once a quarter. When a testnet reset occurs, all account, token, contract, topic, schedule, and file data are wiped.

Developers will no longer have access to the state data from test network consensus nodes. For example, you will not be able to perform transactions or queries on an account that existed before the reset.

The testnet mirror node will be available for developers to store any data before access is completely removed for two weeks after the date of the reset. You will be able to query old testnet information for the two-week period if it is available.

What you should do:

  • Take note of the upcoming reset dates.

  • Have the ability to recreate test data for your application to minimize interruptions.

  • After the reset, you will need to visit the Hedera Developer Portal to get your new testnet account ID.

    • The public and private key pair will remain the same after resets.

  • Subscribe to the Hedera status page to receive reset notifications.

  • Mirror Node operators can reference the instructions here to set up your mirror node

    • GCP GCS and AWS S3 buckets: hedera-testnet-streams-2023-01

If you have any questions or concerns, please connect with us via Discord.

Reset Dates:

2024

  • February 1, 2024 - Completed

  • April 25, 2024

  • July 25, 2024

  • Oct 31, 2024

2023

  • January 26, 2023 - Completed

  • April 27, 2023 - Skipped

  • July 27, 2023 - Completed

  • October 26, 2023 - Skipped

Test Network Throttles

Limited Support Transactions are currently throttled for testnets. You will receive a BUSY response if the number of transactions submitted to the network exceeds the threshold value.

Network Request Type
Throttle (tps)

Cryptocurrency Transactions

AccountCreateTransaction: 2 tps

AccountBalanceQuery: unlimited TransferTransaction (inc. tokens): 10,000 tps

Other: 10,000 tps

Consensus Transactions

TopicCreateTransaction: 5 tps

Other: 10,000 tps

Token Transactions

TokenMintTransaction:

  • 125 TPS for fungible mint

  • 50 TPS for NFT mint

TokenAssociateTransaction: 100 tps TransferTransaction (inc. tokens): 10,000 tps

Other: 3,000 tps

Schedule Transactions

ScheduleSignTransaction: 100 tps ScheduleCreateTransaction: 100 tps

File Transactions

10 tps

Smart Contract Transactions

ContractExecuteTransaction: 350 tps ContractCreateTransaction: 350 tps

Queries

ContractGetInfo: 700 tps ContractGetBytecode: 700 tps ContractCallLocal: 700 tps FileGetInfo: 700 tps FileGetContents: 700 tps Other: 10,000 tps

Receipts

unlimited (no throttle)

Last updated

#2591: #631 HashioDAO docs

Change request updated