Vexta/test/functional/mining_randomx_gbt.py

#!/usr/bin/env python3
# Copyright (c) 2026 The Vexta Core developers
# Distributed under the MIT software license, see the accompanying
# file COPYING or http://www.opensource.org/licenses/mit-license.php.

"""Test activation-aware RandomX mining RPC handling."""

from test_framework.address import ADDRESS_BCRT1_UNSPENDABLE_DESCRIPTOR
from test_framework.blocktools import NORMAL_GBT_REQUEST_PARAMS
from test_framework.test_framework import DigiByteTestFramework
from test_framework.util import assert_equal, assert_raises_rpc_error


BLOCK_VERSION_ALGO = 15 << 8
BLOCK_VERSION_SHA256D = 2 << 8
BLOCK_VERSION_RANDOMX = 4 << 8


class RandomXGetBlockTemplateTest(DigiByteTestFramework):
    def set_test_params(self):
        self.num_nodes = 1
        self.setup_clean_chain = True
        self.supports_cli = False

    def run_test(self):
        node = self.nodes[0]

        self.log.info("RandomX GBT is rejected before activation")
        assert_raises_rpc_error(
            -8,
            "RandomX is not active yet",
            node.getblocktemplate,
            NORMAL_GBT_REQUEST_PARAMS,
            "randomx",
        )

        self.log.info("Default GBT remains SHA256D before activation")
        sha_template = node.getblocktemplate(NORMAL_GBT_REQUEST_PARAMS)
        assert_equal(sha_template["height"], 1)
        assert_equal(
            sha_template["version"] & BLOCK_VERSION_ALGO,
            BLOCK_VERSION_SHA256D,
        )

        self.log.info("Mining RPC reports only SHA256D before activation")
        mining_info = node.getmininginfo()
        assert_equal(mining_info["pow_algo_id"], 0)
        assert_equal(mining_info["pow_algo"], "sha256d")
        assert_equal(set(mining_info["difficulties"]), {"sha256d"})
        assert_equal(set(mining_info["networkhashesps"]), {"sha256d"})
        assert_equal(
            mining_info["difficulty"],
            mining_info["difficulties"]["sha256d"],
        )
        assert_equal(
            mining_info["networkhashps"],
            mining_info["networkhashesps"]["sha256d"],
        )

        self.log.info("getnetworkhashps accepts both known algorithms")
        assert_equal(node.getnetworkhashps(120, -1, "sha256d"), 0)
        assert_equal(node.getnetworkhashps(120, -1, "randomx"), 0)
        assert_raises_rpc_error(
            -8,
            "Unknown mining algorithm",
            node.getnetworkhashps,
            120,
            -1,
            "invalid",
        )

        self.log.info("Mining algorithm bits override -blockversion algo bits")
        block_version = 0x200000ff
        self.restart_node(0, extra_args=[f"-blockversion={block_version}"])
        node = self.nodes[0]

        sha_template = node.getblocktemplate(NORMAL_GBT_REQUEST_PARAMS)
        expected_sha_version = (
            (block_version & ~BLOCK_VERSION_ALGO) |
            BLOCK_VERSION_SHA256D
        )
        assert_equal(sha_template["version"], expected_sha_version)

        self.log.info("Activate RandomX at block 1 on regtest only")
        self.restart_node(0, extra_args=["-testactivationheight=randomx@1"])
        node = self.nodes[0]

        self.log.info("RandomX GBT is available exactly at activation height")
        randomx_template = node.getblocktemplate(
            NORMAL_GBT_REQUEST_PARAMS,
            "randomx",
        )
        assert_equal(randomx_template["height"], 1)
        assert_equal(
            randomx_template["version"] & BLOCK_VERSION_ALGO,
            BLOCK_VERSION_RANDOMX,
        )

        self.log.info("Default GBT remains SHA256D after RandomX activation")
        sha_template = node.getblocktemplate(NORMAL_GBT_REQUEST_PARAMS)
        assert_equal(sha_template["height"], 1)
        assert_equal(
            sha_template["version"] & BLOCK_VERSION_ALGO,
            BLOCK_VERSION_SHA256D,
        )

        self.log.info("Mining RPC exposes SHA256D and RandomX at activation")
        mining_info = node.getmininginfo()
        assert_equal(set(mining_info["difficulties"]), {"sha256d", "randomx"})
        assert_equal(
            set(mining_info["networkhashesps"]),
            {"sha256d", "randomx"},
        )
        assert mining_info["difficulties"]["sha256d"] > 0
        assert mining_info["difficulties"]["randomx"] > 0
        assert_equal(mining_info["networkhashesps"]["randomx"], 0)
        assert_equal(node.getnetworkhashps(120, -1, "randomx"), 0)

        self.log.info("Mine and accept a real RandomX block")
        randomx_blocks = self.generatetodescriptor(
            node,
            1,
            ADDRESS_BCRT1_UNSPENDABLE_DESCRIPTOR,
            1000000,
            "randomx",
            sync_fun=self.no_op,
        )
        assert_equal(len(randomx_blocks), 1)
        assert_equal(node.getblockcount(), 1)

        mined_block = node.getblock(randomx_blocks[0])
        assert_equal(
            mined_block["version"] & BLOCK_VERSION_ALGO,
            BLOCK_VERSION_RANDOMX,
        )
        assert_equal(mined_block["pow_algo_id"], 1)
        assert_equal(mined_block["pow_algo"], "randomx")
        assert mined_block["pow_hash"] is not None
        assert mined_block["pow_hash"] != mined_block["hash"]

        self.log.info("getblockheader exposes the same RandomX PoW metadata")
        mined_header = node.getblockheader(randomx_blocks[0])
        assert_equal(mined_header["pow_algo_id"], 1)
        assert_equal(mined_header["pow_algo"], "randomx")
        assert_equal(mined_header["pow_hash"], mined_block["pow_hash"])

        self.log.info("RandomX mining statistics remain separated from SHA256D")
        mining_info = node.getmininginfo()
        assert_equal(set(mining_info["difficulties"]), {"sha256d", "randomx"})
        assert_equal(
            set(mining_info["networkhashesps"]),
            {"sha256d", "randomx"},
        )

        self.log.info("Reindex and reload the RandomX block from disk")
        self.restart_node(
            0,
            extra_args=[
                "-testactivationheight=randomx@1",
                "-reindex",
            ],
        )
        node = self.nodes[0]

        assert_equal(node.getblockcount(), 1)
        reloaded_block = node.getblock(randomx_blocks[0])

        assert_equal(reloaded_block["hash"], randomx_blocks[0])
        assert_equal(reloaded_block["pow_algo_id"], 1)
        assert_equal(reloaded_block["pow_algo"], "randomx")
        assert_equal(reloaded_block["pow_hash"], mined_block["pow_hash"])


if __name__ == "__main__":
    RandomXGetBlockTemplateTest().main()