Test Blobhash Opcode

Documentation for test cases from tests/cancun/eip4844_blobs/test_blobhash_opcode.py.

Generate fixtures for these test cases for Cancun with:

Cancun only:

fill -v tests/cancun/eip4844_blobs/test_blobhash_opcode.py --fork=Cancun --evm-bin=/path/to/evm-tool-dev-version

For all forks up to and including Cancun:

fill -v tests/cancun/eip4844_blobs/test_blobhash_opcode.py --until=Cancun --evm-bin=/path/to/evm-tool-dev-version

Tests BLOBHASH opcode in EIP-4844: Shard Blob Transactions

Test cases for the BLOBHASH opcode in EIP-4844: Shard Blob Transactions.

Adding a new test

Add a function that is named test_<test_name> and takes at least the following arguments:

• blockchain_test
• pre
• tx
• post

Additional custom pytest.fixture fixtures can be added and parametrized for new test cases.

There is no specific structure to follow within this test module.

test_blobhash_gas_cost(pre, template_tx, blocks, post, tx_type, blockchain_test)

Tests BLOBHASH opcode gas cost using a variety of indexes.

Asserts that the gas consumption of the BLOBHASH opcode is correct by ensuring it matches HASH_OPCODE_GAS = 3. Includes both valid and invalid random index sizes from the range [0, 2**256-1], for tx types 2 and 3.

Source code in tests/cancun/eip4844_blobs/test_blobhash_opcode.py

@pytest.mark.parametrize("tx_type", [0, 1, 2, 3])
def test_blobhash_gas_cost(
    pre,
    template_tx,
    blocks,
    post,
    tx_type,
    blockchain_test: BlockchainTestFiller,
):
    """
    Tests `BLOBHASH` opcode gas cost using a variety of indexes.

    Asserts that the gas consumption of the `BLOBHASH` opcode is correct by ensuring
    it matches `HASH_OPCODE_GAS = 3`. Includes both valid and invalid random
    index sizes from the range `[0, 2**256-1]`, for tx types 2 and 3.
    """
    gas_measures_code = [
        CodeGasMeasure(
            code=Op.BLOBHASH(i),
            overhead_cost=3,
            extra_stack_items=1,
        )
        for i in blobhash_index_values
    ]
    for i, gas_code in enumerate(gas_measures_code):
        address = to_address(0x100 + i * 0x100)
        pre[address] = Account(code=gas_code)
        blocks.append(
            Block(
                txs=[
                    template_tx.with_fields(
                        ty=tx_type,
                        nonce=i,
                        to=address,
                        gas_price=10 if tx_type < 2 else None,
                        access_list=[] if tx_type >= 2 else None,
                        max_priority_fee_per_gas=10 if tx_type >= 2 else None,
                        blob_versioned_hashes=random_blob_hashes[0:TARGET_BLOBS_PER_BLOCK]
                        if tx_type >= 3
                        else None,
                    )
                ]
            )
        )
        post[address] = Account(storage={0: BLOBHASH_GAS_COST})
    blockchain_test(
        pre=pre,
        blocks=blocks,
        post=post,
    )

test_blobhash_scenarios(pre, template_tx, blocks, post, scenario, blockchain_test)

Tests that the BLOBHASH opcode returns the correct versioned hash for various valid indexes.

Covers various scenarios with random blob_versioned_hash values within the valid range [0, 2**256-1].

Source code in tests/cancun/eip4844_blobs/test_blobhash_opcode.py

@pytest.mark.parametrize(
    "scenario",
    [
        "single_valid",
        "repeated_valid",
        "valid_invalid",
        "varied_valid",
    ],
)
def test_blobhash_scenarios(
    pre,
    template_tx,
    blocks,
    post,
    scenario: str,
    blockchain_test: BlockchainTestFiller,
):
    """
    Tests that the `BLOBHASH` opcode returns the correct versioned hash for
    various valid indexes.

    Covers various scenarios with random `blob_versioned_hash` values within
    the valid range `[0, 2**256-1]`.
    """
    TOTAL_BLOCKS = 5
    b_hashes_list = BlobhashScenario.create_blob_hashes_list(length=TOTAL_BLOCKS)
    blobhash_calls = BlobhashScenario.generate_blobhash_bytecode(scenario)
    for i in range(TOTAL_BLOCKS):
        address = to_address(0x100 + i * 0x100)
        pre[address] = Account(code=blobhash_calls)
        blocks.append(
            Block(
                txs=[
                    template_tx.with_fields(
                        ty=3,
                        nonce=i,
                        to=address,
                        access_list=[],
                        max_priority_fee_per_gas=10,
                        blob_versioned_hashes=b_hashes_list[i],
                    )
                ]
            )
        )
        post[address] = Account(
            storage={index: b_hashes_list[i][index] for index in range(MAX_BLOBS_PER_BLOCK)}
        )
    blockchain_test(
        pre=pre,
        blocks=blocks,
        post=post,
    )

test_blobhash_invalid_blob_index(pre, template_tx, blocks, post, blockchain_test, scenario)

Tests that the BLOBHASH opcode returns a zeroed bytes32 value for invalid indexes.

Includes cases where the index is negative (index < 0) or exceeds the maximum number of blob_versioned_hash values stored: (index >= len(tx.message.blob_versioned_hashes)).

It confirms that the returned value is a zeroed `bytes32 for each case.

Source code in tests/cancun/eip4844_blobs/test_blobhash_opcode.py

@pytest.mark.parametrize(
    "scenario",
    [
        "invalid_calls",
    ],
)
def test_blobhash_invalid_blob_index(
    pre,
    template_tx,
    blocks,
    post,
    blockchain_test: BlockchainTestFiller,
    scenario,
):
    """
    Tests that the `BLOBHASH` opcode returns a zeroed `bytes32` value for invalid
    indexes.

    Includes cases where the index is negative (`index < 0`) or
    exceeds the maximum number of `blob_versioned_hash` values stored:
    (`index >= len(tx.message.blob_versioned_hashes)`).

    It confirms that the returned value is a zeroed `bytes32 for each case.
    """
    TOTAL_BLOCKS = 5
    blobhash_calls = BlobhashScenario.generate_blobhash_bytecode(scenario)
    for i in range(TOTAL_BLOCKS):
        address = to_address(0x100 + i * 0x100)
        pre[address] = Account(code=blobhash_calls)
        blob_per_block = (i % MAX_BLOBS_PER_BLOCK) + 1
        blobs = [random_blob_hashes[blob] for blob in range(blob_per_block)]
        blocks.append(
            Block(
                txs=[
                    template_tx.with_fields(
                        ty=3,
                        nonce=i,
                        to=address,
                        access_list=[],
                        max_priority_fee_per_gas=10,
                        blob_versioned_hashes=blobs,
                    )
                ]
            )
        )
        post[address] = Account(
            storage={
                index: (0 if index < 0 or index >= blob_per_block else blobs[index])
                for index in range(
                    -TOTAL_BLOCKS,
                    blob_per_block + (TOTAL_BLOCKS - (i % MAX_BLOBS_PER_BLOCK)),
                )
            }
        )
    blockchain_test(
        pre=pre,
        blocks=blocks,
        post=post,
    )

test_blobhash_multiple_txs_in_block(pre, blob_tx, post, blockchain_test)

Tests that the BLOBHASH opcode returns the appropriate values when there is more than 1 blob tx type within a block (for tx types 2 and 3).

Scenarios involve tx type 3 followed by tx type 2 running the same code within a block, including the opposite.

Source code in tests/cancun/eip4844_blobs/test_blobhash_opcode.py

def test_blobhash_multiple_txs_in_block(
    pre,
    blob_tx,
    post,
    blockchain_test: BlockchainTestFiller,
):
    """
    Tests that the `BLOBHASH` opcode returns the appropriate values when there
    is more than 1 blob tx type within a block (for tx types 2 and 3).

    Scenarios involve tx type 3 followed by tx type 2 running the same code
    within a block, including the opposite.
    """
    blobhash_bytecode = BlobhashScenario.generate_blobhash_bytecode("single_valid")
    pre = {
        **pre,
        **{
            to_address(address): Account(code=blobhash_bytecode)
            for address in range(0x100, 0x500, 0x100)
        },
    }
    blocks = [
        Block(
            txs=[
                blob_tx(address=to_address(0x100), type=3, nonce=0),
                blob_tx(address=to_address(0x100), type=2, nonce=1),
            ]
        ),
        Block(
            txs=[
                blob_tx(address=to_address(0x200), type=2, nonce=2),
                blob_tx(address=to_address(0x200), type=3, nonce=3),
            ]
        ),
        Block(
            txs=[
                blob_tx(address=to_address(0x300), type=2, nonce=4),
                blob_tx(address=to_address(0x400), type=3, nonce=5),
            ],
        ),
    ]
    post = {
        to_address(address): Account(
            storage={i: random_blob_hashes[i] for i in range(MAX_BLOBS_PER_BLOCK)}
        )
        if address in (0x200, 0x400)
        else Account(storage={i: 0 for i in range(MAX_BLOBS_PER_BLOCK)})
        for address in range(0x100, 0x500, 0x100)
    }
    blockchain_test(
        pre=pre,
        blocks=blocks,
        post=post,
    )