Bitcoin Core 28.99.0
P2P Digital Currency
random.cpp
Go to the documentation of this file.
1// Copyright (c) 2023 The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#include <test/util/random.h>
6
7#include <logging.h>
8#include <random.h>
9#include <uint256.h>
10#include <util/check.h>
11
12#include <cstdlib>
13#include <iostream>
14
15std::atomic<bool> g_seeded_g_prng_zero{false};
16
17extern void MakeRandDeterministicDANGEROUS(const uint256& seed) noexcept;
18
20{
21 constexpr auto RANDOM_CTX_SEED{"RANDOM_CTX_SEED"};
22
23 // Do this once, on the first call, regardless of seedtype, because once
24 // MakeRandDeterministicDANGEROUS is called, the output of GetRandHash is
25 // no longer truly random. It should be enough to get the seed once for the
26 // process.
27 static const uint256 ctx_seed = []() {
28 // If RANDOM_CTX_SEED is set, use that as seed.
29 if (const char* num{std::getenv(RANDOM_CTX_SEED)}) {
30 if (auto num_parsed{uint256::FromUserHex(num)}) {
31 return *num_parsed;
32 } else {
33 std::cerr << RANDOM_CTX_SEED << " must consist of up to " << uint256::size() * 2 << " hex digits (\"0x\" prefix allowed), it was set to: '" << num << "'.\n";
34 std::abort();
35 }
36 }
37 // Otherwise use a (truly) random value.
38 return GetRandHash();
39 }();
40
42 if constexpr (G_FUZZING) {
43 Assert(g_seeded_g_prng_zero); // Only SeedRandomStateForTest(SeedRand::ZEROS) is allowed in fuzz tests
44 }
45 const uint256& seed{seedtype == SeedRand::FIXED_SEED ? ctx_seed : uint256::ZERO};
46 LogInfo("Setting random seed for current tests to %s=%s\n", RANDOM_CTX_SEED, seed.GetHex());
48}
constexpr bool G_FUZZING
Definition: check.h:16
#define Assert(val)
Identity function.
Definition: check.h:85
static constexpr unsigned int size()
Definition: uint256.h:110
256-bit opaque blob.
Definition: uint256.h:190
static std::optional< uint256 > FromUserHex(std::string_view str)
Definition: uint256.h:193
static const uint256 ZERO
Definition: uint256.h:198
#define LogInfo(...)
Definition: logging.h:261
void MakeRandDeterministicDANGEROUS(const uint256 &seed) noexcept
Internal function to set g_determinstic_rng.
Definition: random.cpp:670
uint256 GetRandHash() noexcept
Generate a random uint256.
Definition: random.h:454
std::atomic< bool > g_seeded_g_prng_zero
Definition: random.cpp:15
void SeedRandomStateForTest(SeedRand seedtype)
Seed the global RNG state for testing and log the seed value.
Definition: random.cpp:19
SeedRand
Definition: random.h:15
@ ZEROS
Seed with a compile time constant of zeros.
@ FIXED_SEED
Seed with a fixed value that never changes over the lifetime of this process.