Module pow 

DarkFi PoW module

Structs

PoWModule

This struct represents the information required by the PoW algorithm

Constants

BLOCKCHAIN_TIMESTAMP_CHECK_WINDOW 🔒

How many most recent blocks to use to verify new blocks’ timestamp

BLOCK_FUTURE_TIME_LIMIT 🔒

Time limit in the future of what blocks can be

BUF_SIZE 🔒

Ring buffer length. Must be == DIFFICULTY_WINDOW + DIFFICULTY_LAG

CUT_BEGIN 🔒

Already known cutoff start index for this config

CUT_END 🔒

Already known cutoff end index for this config

DIFFICULTY_WINDOW 🔒

Amount of max items(blocks) to use for next difficulty calculation. Must be >= 2 and == BUF_SIZE - DIFFICULTY_LAG.

RANDOMX_KEY_CHANGE_DELAY

RandomX VM key change delay

RANDOMX_KEY_CHANGING_HEIGHT

RandomX VM key changing height

RETAINED 🔒

Max items to use for next difficulty calculation. Must be DIFFICULTY_WINDOW - 2 * DIFFICULTY_CUT

_DIFFICULTY_CUT 🔒

Used to calculate how many items to retain for next difficulty calculation. We are keeping the middle items, meaning cutting both from frond and back of the ring buffer, ending up with max DIFFICULTY_WINDOW - 2DIFFICULTY_CUT items. (2DIFFICULTY_CUT <= DIFFICULTY_WINDOW-2) must be true.

_DIFFICULTY_LAG 🔒

Amount of latest blocks to exlude from the calculation. Our ring buffer has length: DIFFICULTY_WINDOW + DIFFICULTY_LAG, but we only use DIFFICULTY_WINDOW items in calculations. Must be == BUF_SIZE - DIFFICULTY_WINDOW.

Functions

generate_mining_vms

Auxiliary function to generate mining VMs for provided RandomX key.

get_mining_flags

Auxiliary function to define RandomXFlags used in mining.

init_dataset 🔒

Auxiliary function to initialize a RandomXDataset using all available threads.

mine_block

Mine provided header, based on provided PoW module next mine target, using provided RandomX VMs setup.