- Get Started
- Stellar Attachment Convention
- Compliance Protocol
- Add Stellar To Your Exchange
- Hardware Requirements
- Issuing Assets
- Known Validators
- Build Stellar Apps
- Contribution Guide
The testnet is a small test Stellar network, run by the Stellar Development Foundation (SDF), which is open to developers.
SDF runs 3 Stellar Core validators on the testnet.
There is also a Horizon instance that can directly interact with the testnet.
Keep in mind that you can always run your own test network for use cases that don’t work well with SDF’s testnet.
The testnet has a capacity limit of 100 operations per ledger. When more than 100 operations are submitted to a given ledger, the network enters surge pricing mode, which uses market dynamics to decide which submissions are included. It works exactly the same way as surge pricing on the public network.
If you are having trouble submitting transactions to the testnet, you may need to offer a higher fee. You can also take the opportunity to develop a fee strategy, which may prove useful when you move your project into production.
In order to preserve a good experience for developers, the SDF testnet is periodically reset to the genesis (initial) ledger. Resets declutter the network, remove spam, minimize the time required to catch up to the latest ledger, and help maintain the system over time.
A reset clears all ledger entries (such as accounts, trustlines, offers, etc), transactions, and historical data from both Stellar Core and Horizon, which is why developers should not rely on the persistence of any accounts or on the state of any balances when using testnet.
After a reset, you will need to take a few steps to re-join and re-synch to the testnet. Those steps are outlined here, along with line-by-line instructions for people using core + horizon ubuntu packages. If you need help with other packages, check Stellar’s Stack Exchange for guidance.
SDF will try to make testnet resets as painless as possible, and will announce the exact date at least two weeks in advance on the Stellar Dashboard, and via several of Stellar’s online developer communities.
Starting in January 2019, the testnet will be reset once per quarter (every three months). The tentative dates:
The testnet will always restart on the announced reset date at 0900 UTC.
Since most applications rely on data being present to do anything useful, it is highly recommended that you have testing infrastructure that can repopulate testnet with useful data after a reset. Not only will this make testing more reliable, but it will also help you scale out your testing infrastructure to a private test network if you choose to do so.
For example, you may want to:
As a maintainer of an application, you will want to think about creating a data set that is representative enough to test your primary use cases, and allow for robust testing even when testnet is not available.
For additional questions we recommend heading over to Stellar’s Stack Exchange.