Nockchain Mining/PoW Source Trace

fakenet-miner-script

Defines the upstream fakenet miner command source: load .env, export MINING_PKH, mine against a local fakenet peer, and suppress default peers.

The script runs nockchain with --mine --fakenet --mining-pkh ${MINING_PKH}, dials /ip4/127.0.0.1/udp/3006/quic-v1, and uses --no-default-peers.

node-fakenet-script

Defines the local fakenet hub side that binds QUIC and public gRPC for local miner and wallet/API testing.

The node script binds public gRPC to 127.0.0.1:5555 and QUIC to /ip4/127.0.0.1/udp/3006/quic-v1 while running --fakenet.

mainnet-miner-script

Defines upstream operator command shape for non-fakenet mining and automatic CPU-thread selection.

The script exports MINING_PKH, computes logical CPU count, subtracts two threads with a minimum of one, and runs nockchain --mine --num-threads.

mining-cli-flags

Declares the operator-facing mining and fakenet PoW flags that receipts must capture before interpreting mining results.

Mining requires --mine with --mining-pkh or --mining-pkh-adv, supports --num-threads, and exposes fakenet-only PoW length and log difficulty overrides.

fakenet-constants-poke

Pokes fakenet blockchain constants into the kernel before fakenet operation and applies optional v1/bythos/ASERT/candidate interval overrides.

The fakenet boot path constructs fakenet_blockchain_constants from CLI PoW length/log difficulty, applies phase overrides, and sends PokeFakenetConstants.

fakenet-blockchain-constants

Defines relaxed fakenet mining constants derived from mainnet defaults for local testing.

Fakenet overrides update candidate interval, PoW length, genesis target by bex difficulty, first-month coinbase minimum, timelock minimum, base fee, and early phases.

mining-driver-bootstrap

Installs the mining driver with parsed public-key-hash target, mine flag, and thread count before libp2p and gRPC drivers.

The node translates --mining-pkh into share=1 PKH config, derives mine/threads, creates the mining driver, and adds it to the NockApp.

mining-wire-contract

Names the typed mining wire tags used for key setup, enablement, candidate work, and mined-block submission.

MiningWire maps SetPubKey to setpubkey, Enable to enable, Candidate to candidate, and Mined to mined under wire source miner version 1.

candidate-effect-handler

Receives kernel %mine effects, captures version/header/target/pow_len, starts mining threads, and cancels stale attempts when a new candidate arrives.

The driver accepts a %mine effect payload, stores block_header/version/target/pow_len, starts SerfThread miners, and cancels old attempts when the candidate changes.

mined-pow-poke

Constructs candidate proof pokes, sets mining keys, enables mining, creates random nonce cells, and submits mined PoW back to the main kernel.

The driver builds [version header nonce target pow_len], sends set-mining-key-advanced and enable-mining commands, then pokes MiningWire::Candidate on each mining attempt.

miner-kernel-pow-check

Runs the miner kernel proof attempt and emits either success with command %pow or retry with the digest.

The miner kernel builds prover input, calls prove-block-inner, checks proof hash against target, and returns %mine-result with success/failure.

pow-library

Defines the common PoW target check and proof-to-pow digest conversion used by the miner kernel.

check-target compares proof hash to target atom, and prove-block-inner dispatches proof versions 0/1/2 before converting proof to PoW.

candidate-block-state

Refreshes candidate block timestamp and transaction set when the candidate update interval is reached.

The miner library updates candidate block timestamp, logs the change, and adds transactions to the candidate block.

structured-miner-traces

Translates miner and heaviest-chain kernel spans into stdout-visible structured events used by monitoring and tests.

The traces driver records new_heaviest_chain and new_heaviest_miner with block height and digest fields.

libp2p-request-pow-separation

Separates network request/gossip EquiX anti-spam PoW from block-mining PoW so diagnostics do not conflate the two.

Libp2p request PoW uses sender/receiver/message preimages, verifies inbound request PoW, and authenticates gossip independently of miner candidate proof.