ccee103a0e
* IBD check uses minimumchain work instead of checkpoints. This introduces a 'minimum chain work' chainparam which is intended to be the known amount of work in the chain for the network at the time of software release. If you don't have this much work, you're not yet caught up. This is used instead of the count of blocks test from checkpoints. This criteria is trivial to keep updated as there is no element of subjectivity, trust, or position dependence to it. It is also a more reliable metric of sync status than a block count. * Remove GetTotalBlocksEstimate and checkpoint tests that test nothing. GetTotalBlocksEstimate is no longer used and it was the only thing the checkpoint tests were testing. Since checkpoints are on their way out it makes more sense to remove the test file than to cook up a new pointless test. # Conflicts: # src/Makefile.test.include # src/test/Checkpoints_tests.cpp * IsInitialBlockDownload no longer uses header-only timestamps. This avoids a corner case (mostly visible on testnet) where bogus headers can keep nodes in IsInitialBlockDownload. * Delay parallel block download until chain has sufficient work nMinimumChainWork is an anti-DoS threshold; wait until we have a proposed tip with more work than that before downloading blocks towards that tip. * Add timeout for headers sync At startup, we choose one peer to serve us the headers chain, until our best header is close to caught up. Disconnect this peer if more than 15 minutes + 1ms/expected_header passes and our best header is still more than 1 day away from current time. * Introduce assumevalid setting to skip presumed valid scripts. This disentangles the script validation skipping from checkpoints. A new option is introduced "assumevalid" which specifies a block whos ancestors we assume all have valid scriptsigs and so we do not check them when they are also burried under the best header by two weeks worth of work. Unlike checkpoints this has no influence on consensus unless you set it to a block with an invalid history. Because of this it can be easily be updated without risk of influencing the network consensus. This results in a massive IBD speedup. This approach was independently recommended by Peter Todd and Luke-Jr since POW based signature skipping (see PR#9180) does not have the verifiable properties of a specific hash and may create bad incentives. The downside is that, like checkpoints, the defaults bitrot and older releases will sync slower. On the plus side users can provide their own value here, and if they set it to something crazy all that will happen is more time will be spend validating signatures. Checkblocks and checklevel are also moved to the hidden debug options: Especially now that checkblocks has a low default there is little need to change these settings, and users frequently misunderstand them as influencing security or IBD speed. By hiding them we offset the space added by this new option. * Add consensusParams to FindNextBlocksToDownload * Adjust check in headers timeout logic to align with 144 blocks in Dash |
||
---|---|---|
.. | ||
data | ||
accounting_tests.cpp | ||
addrman_tests.cpp | ||
alert_tests.cpp | ||
allocator_tests.cpp | ||
arith_uint256_tests.cpp | ||
base32_tests.cpp | ||
base58_tests.cpp | ||
base64_tests.cpp | ||
bctest.py | ||
bip32_tests.cpp | ||
bip39_tests.cpp | ||
bitcoin-util-test.py | ||
bloom_tests.cpp | ||
bswap_tests.cpp | ||
buildenv.py.in | ||
cachemap_tests.cpp | ||
cachemultimap_tests.cpp | ||
checkblock_tests.cpp | ||
coins_tests.cpp | ||
compress_tests.cpp | ||
crypto_tests.cpp | ||
dbwrapper_tests.cpp | ||
DoS_tests.cpp | ||
getarg_tests.cpp | ||
governance_validators_tests.cpp | ||
hash_tests.cpp | ||
key_tests.cpp | ||
limitedmap_tests.cpp | ||
main_tests.cpp | ||
Makefile | ||
mempool_tests.cpp | ||
merkle_tests.cpp | ||
miner_tests.cpp | ||
multisig_tests.cpp | ||
net_tests.cpp | ||
netbase_tests.cpp | ||
pmt_tests.cpp | ||
policyestimator_tests.cpp | ||
pow_tests.cpp | ||
prevector_tests.cpp | ||
ratecheck_tests.cpp | ||
README.md | ||
reverselock_tests.cpp | ||
rpc_tests.cpp | ||
rpc_wallet_tests.cpp | ||
sanity_tests.cpp | ||
scheduler_tests.cpp | ||
script_P2PKH_tests.cpp | ||
script_P2SH_tests.cpp | ||
script_tests.cpp | ||
scriptnum10.h | ||
scriptnum_tests.cpp | ||
serialize_tests.cpp | ||
sighash_tests.cpp | ||
sigopcount_tests.cpp | ||
skiplist_tests.cpp | ||
streams_tests.cpp | ||
test_dash.cpp | ||
test_dash.h | ||
timedata_tests.cpp | ||
transaction_tests.cpp | ||
txvalidationcache_tests.cpp | ||
uint256_tests.cpp | ||
univalue_tests.cpp | ||
util_tests.cpp | ||
versionbits_tests.cpp |
Notes
The sources in this directory are unit test cases. Boost includes a unit testing framework, and since Dash Core already uses boost, it makes sense to simply use this framework rather than require developers to configure some other framework (we want as few impediments to creating unit tests as possible).
The build system is setup to compile an executable called "test_dash" that runs all of the unit tests. The main source file is called test_dash.cpp, which simply includes other files that contain the actual unit tests (outside of a couple required preprocessor directives). The pattern is to create one test file for each class or source file for which you want to create unit tests. The file naming convention is "<source_filename>_tests.cpp" and such files should wrap their tests in a test suite called "<source_filename>_tests". For an examples of this pattern, examine uint160_tests.cpp and uint256_tests.cpp.
Add the source files to /src/Makefile.test.include to add them to the build.
For further reading, I found the following website to be helpful in explaining how the boost unit test framework works: http://www.alittlemadness.com/2009/03/31/c-unit-testing-with-boosttest/.
test_dash has some built-in command-line arguments; for example, to run just the getarg_tests verbosely:
test_dash --log_level=all --run_test=getarg_tests
... or to run just the doubledash test:
test_dash --run_test=getarg_tests/doubledash
Run test_dash --help for the full list.