Testnets
Join a Hedera Testnet
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 |
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
- GCP GCS and AWS S3 buckets:
hedera-testnet-streams-2023-01
Reset Dates:
2023
- January 26, 2023
- April 27, 2023
- July 27, 2023
- October 26, 2023
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 modified 2mo ago