Testnets
Join a Hedera Testnet
Overview
Hedera Testnets provide developers access to a free testing environment for Hedera network services. Testnets simulate the exact same 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 to mainnet without any changes.
Test Networks:
Name | Description |
Test Network | 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. |
Preview Test Network | 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 for two weeks after the date of the reset to store any data before access is completely removed. You will be able to query old testnet information for the two-week period if is it 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:
2023
January 26, 2023
April 27, 2023
July 27, 2023
October 26, 2023
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:
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