Testnet: Difference between revisions

From Bitcoin Wiki
Jump to navigation Jump to search
Dirtyfilthy (talk | contribs)
m →‎Genesis Block: change link from raw block to regular block
m remove broken or inactive links
 
(77 intermediate revisions by 40 users not shown)
Line 1: Line 1:
{{stub}}
The '''testnet''' is an alternative Bitcoin [[block chain]] to be used for testing. Testnet coins are separate and distinct from actual bitcoins, and are never supposed to have any value. This allows application developers or bitcoin testers to experiment, without having to use real bitcoins or worrying about breaking the main bitcoin chain.


The '''testnet''' is an alternative Bitcoin [[block chain]], to be used for testing. This allows application developers or bitcoin testers to experiment, without having to use real bitcoins or worrying about breaking the main bitcoin chain.
Run <code>bitcoin-qt</code> or <code>bitcoind</code> with the <code>-testnet</code> flag to use the testnet (or put <code>testnet=1</code> in the <code>bitcoin.conf</code> file).
 
There have been three generations of testnet. Testnet2 was just the first testnet reset with a different genesis block, because people were starting to trade testnet coins for real money. '''Testnet3''' is the current test network. It was introduced with the 0.7 release, introduced a third genesis block, a new rule to avoid the "difficulty was too high, is now too low, and transactions take too long to verify" problem, and contains blocks with edge-case transactions designed to test implementation compatibility. On 21 December 2015, SegNet was deployed to test the Wuille's Segregated Witness proposal.


==Differences==
==Differences==
* Instead of ports 8333 (listen) and 8332 (JSON-RPC), ports 18333 and 18332 are used.
* Default Bitcoin network protocol listen port is 18333 (instead of 8333)
* Bootstrapping IRC channel is #bitcoinTEST instead of #bitcoin (both on irc.lfnet.org). The built-in node list is disabled.
* Default RPC connection port is 18332 (instead of 8332)
* A different value of ADDRESSVERSION field ensures no testnet BitCoin addresses will work on the production network. (0x6F rather than 0x00)
* Bootstrapping uses different DNS seeds.
* The protocol message header bytes are shifted up (0xFABFB5DA instead of 0xF9BEB4D9)
* A different value of <code>ADDRESSVERSION</code> field ensures no testnet Bitcoin addresses will work on the production network. (<code>0x6F</code> rather than <code>0x00</code>)
* Minimum [[difficulty]] of 1.0 on testnet is equal to difficulty of 0.5 on mainnet. This means that the mainnet-equivalent of any testnet difficulty is half the testnet difficulty.
* The protocol message header bytes are <code>0x0B110907</code> (instead of <code>0xF9BEB4D9</code>)  
* Minimum [[difficulty]] of 1.0 on testnet is equal to difficulty of 0.5 on mainnet. This means that the mainnet-equivalent of any testnet difficulty is half the testnet difficulty. In addition, if no block has been found in 20 minutes, the difficulty automatically resets back to the minimum for a single block, after which it returns to its previous value.
* A new genesis block
* A new genesis block
* The <code>IsStandard()</code> check is disabled so that non-standard transactions can be experimented with.


==Genesis Block==
==Genesis Block==


Testnet uses a different genesis block to the main network. You can find it at http://blockexplorer.com/testnet/block/0000000224b1593e3ff16a0e3b61285bbc393a39f78c8aa48c456142671f7110
Testnet uses a different genesis block to the main network. You can find it [https://mempool.space/testnet/block/000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943 here].
The testnet was [https://github.com/gavinandresen/bitcoin-git/commit/feeb761ba07af74a7cd78b8c8f7c2a961fd9ea1c reset with a new genesis block] for the 0.7 Bitcoin release.
 
==Size==
Testnet receives less transactions than the main block chain and is typically much smaller in size. As of October 2024, the size of the data on disk was 92.26&nbsp;GB containing data for about 12 years worth of testnet activity.


==External links==
==External links==


* [http://www.bitcoin.org/smf/index.php?topic=363.0 Test Network forum topic]
* [https://bitcointalk.org/?topic=4483.0 Testnet in a box forum topic]
* [https://github.com/gavinandresen/bitcoin-git BitCoin testnet version at GitHub]
* [https://sourceforge.net/projects/bitcoin/files/Bitcoin/testnet-in-a-box/ Testnet-In-A-Box self-contained testnet]
* [https://freebitcoins.appspot.com/test/ Testnet Faucet]
* [https://github.com/freewil/bitcoin-testnet-box Forked/Updated testnet-box]
* [http://blockexplorer.com/testnet Testnet Block Explorer]
 
===Wallets===
 
Online testnet wallets to help you test your application.
 
* [https://CoPay.io/ CoPay.io] wallet supports TestNet accounts
 
===Faucets===
 
Once you're done with your test coins, it is a nice gesture to send them back to the faucets, so they become available to other developers.
* [https://cryptopump.info/ Cryptopump.info Testnet Faucet]
* [http://tbtc.bitaps.com bitaps.com Testnet Faucet + double spend test tool]
* [http://bitcoinfaucet.uo1.net/ UO1 Testnet Faucet]
* [https://play.google.com/store/apps/details?id=com.mycelium.testnetwallet Mycelium Testnet Wallet for Android with integrated Testnet "faucet" function (Local Trader)]
* [http://kuttler.eu/bitcoin/btc/faucet/ nkuttler's Bitcoin Testnet Faucet]
* [https://coinfaucet.eu/btc-testnet Coinfaucet testnet3 faucet]
* [https://testnet-faucet.com/btc-testnet/ Testnet-Faucet.com Bitcoin Testnet Faucet]
 
Offline (2023-07-27):
 
* [https://testnet-faucet.mempool.co mempool.co testnet3 Faucet]
 
Offline (2018-09-06):
 
* [http://tpfaucet.appspot.com/ TP's TestNet Faucet]
* [https://testnet.manu.backend.hamburg/faucet flyingkiwi's TestNet Faucet]
 
Offline (2016-08-07):
 
* [http://faucet.luis.im/ luis.im Mojocoin Testnet3 Faucet]
* [https://accounts.blockcypher.com/testnet-faucet BlockCypher Testnet Faucet], also provided as a [http://dev.blockcypher.com/#faucets Testnet faucet API] for test automation
 
===Block explorers===
* [https://mempool.space/testnet Bitcoin Testnet on mempool.space]
* [http://tbtc.bitaps.com/ Bitcoin Testnet Explorer on bitaps.com]
* [http://testnet.blockchain.info Blockchain.info Testnet Explorer]
* [https://live.blockcypher.com/btc-testnet/ BlockCypher Testnet Explorer]
[[Category:Technical]]
[[Category:Developer]]
 
{{Bitcoin Core documentation}}

Latest revision as of 17:53, 16 October 2024

The testnet is an alternative Bitcoin block chain to be used for testing. Testnet coins are separate and distinct from actual bitcoins, and are never supposed to have any value. This allows application developers or bitcoin testers to experiment, without having to use real bitcoins or worrying about breaking the main bitcoin chain.

Run bitcoin-qt or bitcoind with the -testnet flag to use the testnet (or put testnet=1 in the bitcoin.conf file).

There have been three generations of testnet. Testnet2 was just the first testnet reset with a different genesis block, because people were starting to trade testnet coins for real money. Testnet3 is the current test network. It was introduced with the 0.7 release, introduced a third genesis block, a new rule to avoid the "difficulty was too high, is now too low, and transactions take too long to verify" problem, and contains blocks with edge-case transactions designed to test implementation compatibility. On 21 December 2015, SegNet was deployed to test the Wuille's Segregated Witness proposal.

Differences

  • Default Bitcoin network protocol listen port is 18333 (instead of 8333)
  • Default RPC connection port is 18332 (instead of 8332)
  • Bootstrapping uses different DNS seeds.
  • A different value of ADDRESSVERSION field ensures no testnet Bitcoin addresses will work on the production network. (0x6F rather than 0x00)
  • The protocol message header bytes are 0x0B110907 (instead of 0xF9BEB4D9)
  • Minimum difficulty of 1.0 on testnet is equal to difficulty of 0.5 on mainnet. This means that the mainnet-equivalent of any testnet difficulty is half the testnet difficulty. In addition, if no block has been found in 20 minutes, the difficulty automatically resets back to the minimum for a single block, after which it returns to its previous value.
  • A new genesis block
  • The IsStandard() check is disabled so that non-standard transactions can be experimented with.

Genesis Block

Testnet uses a different genesis block to the main network. You can find it here. The testnet was reset with a new genesis block for the 0.7 Bitcoin release.

Size

Testnet receives less transactions than the main block chain and is typically much smaller in size. As of October 2024, the size of the data on disk was 92.26 GB containing data for about 12 years worth of testnet activity.

External links

Wallets

Online testnet wallets to help you test your application.

  • CoPay.io wallet supports TestNet accounts

Faucets

Once you're done with your test coins, it is a nice gesture to send them back to the faucets, so they become available to other developers.

Offline (2023-07-27):

Offline (2018-09-06):

Offline (2016-08-07):

Block explorers