Module miner

Internal mining in Zebra.

TODO

• pause mining if we have no peers, like zcashd does, and add a developer config that mines regardless of how many peers we have. https://github.com/zcash/zcash/blob/6fdd9f1b81d3b228326c9826fa10696fc516444b/src/miner.cpp#L865-L880
• move common code into zebra-chain or zebra-node-services and remove the RPC dependency.

Constants

• BLOCK_MINING_WAIT_TIME
  How long we wait after mining a block, before expecting a new template.
• BLOCK_TEMPLATE_REFRESH_LIMIT
  A rate-limit for block template refreshes.
• BLOCK_TEMPLATE_WAIT_TIME
  The amount of time we wait between block template retries.

Functions

• generate_block_templates
  Generates block templates using rpc, and sends them to mining threads using template_sender.
• init
  Initialize the miner based on its config.
• mine_a_block
  Mines one or more blocks based on template. Calculates equihash solutions, checks difficulty, and returns as soon as it has at least one block. Uses a different nonce range for each solver_id.
• run_mining_solver
  Runs a single mining thread that gets blocks from the template_receiver, calculates equihash solutions with nonces based on solver_id, and submits valid blocks to Zebra’s block validator.
• spawn_init
  Initialize the miner based on its config, and spawn a task for it.