Skip to content

test_reserve_price_boundary()

Documentation for tests/osaka/eip7918_blob_reserve_price/test_blob_base_fee.py::test_reserve_price_boundary@0f7c73a7.

Generate fixtures for these test cases for Osaka with:

fill -v tests/osaka/eip7918_blob_reserve_price/test_blob_base_fee.py::test_reserve_price_boundary --fork Osaka

Tests the reserve price boundary mechanism. Note the default block base fee per gas is 7 (delta is 0). With a non zero delta the block base fee per gas is set to (boundary * blob base fee) + delta.

Example scenarios from parametrization, assume parent_excess_blobs = 3: delta=-2: blob_base_fee=1, boundary=8, block_base_fee_per_gas=8+(-2)=6, 6 < 8, reserve inactive, effective_fee=1 delta=0: blob_base_fee=1, boundary=8, block_base_fee_per_gas=7, 7 < 8, reserve inactive, effective_fee=1 delta=100: blob_base_fee=1, boundary=8, block_base_fee_per_gas=8+100=108, 108 > 8, reserve active, effective_fee=max(108/8, 1)=13

All values give a blob base_ fee of 1 because we need a much higher excess blob gas to increase the blob fee. This only increases to 2 at 20 excess blobs.

Source code in tests/osaka/eip7918_blob_reserve_price/test_blob_base_fee.py 
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
@pytest.mark.parametrize_by_fork(
    "parent_excess_blobs",
    # Keep max assuming this will be greater than 20 in the future, to test a blob fee of > 1 :)
    lambda fork: [0, 3, fork.target_blobs_per_block(), fork.max_blobs_per_block()],
)
@pytest.mark.parametrize("block_base_fee_per_gas_delta", [-2, -1, 0, 1, 10, 100])
def test_reserve_price_boundary(
    blockchain_test: BlockchainTestFiller,
    env: Environment,
    pre: Alloc,
    block: Block,
    post: Dict[Address, Account],
):
    """
    Tests the reserve price boundary mechanism. Note the default block base fee per gas is 7 (delta is 0).
    With a non zero delta the block base fee per gas is set to (boundary * blob base fee) + delta.

    Example scenarios from parametrization, assume parent_excess_blobs = 3:
        delta=-2: blob_base_fee=1, boundary=8, block_base_fee_per_gas=8+(-2)=6, 6 < 8, reserve inactive, effective_fee=1
        delta=0: blob_base_fee=1, boundary=8, block_base_fee_per_gas=7, 7 < 8, reserve inactive, effective_fee=1
        delta=100: blob_base_fee=1, boundary=8, block_base_fee_per_gas=8+100=108, 108 > 8, reserve active, effective_fee=max(108/8, 1)=13

    All values give a blob base_ fee of 1 because we need a much higher excess blob gas
    to increase the blob fee. This only increases to 2 at 20 excess blobs.
    """  # noqa: E501
    blockchain_test(
        genesis_environment=env,
        pre=pre,
        blocks=[block],
        post=post,
    )

Parametrized Test Cases

The interactive table below is also available as a standalone page.

Test ID (Abbreviated) parent_excess_blobs block_base_fee_per_gas_delta
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_-2 0 -2
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_-1 0 -1
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_0 0 0
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_1 0 1
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_10 0 10
...fork_Osaka-parent_excess_blobs_0-blockchain_test-block_base_fee_per_gas_delta_100 0 100
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_-2 3 -2
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_-1 3 -1
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_0 3 0
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_1 3 1
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_10 3 10
...fork_Osaka-parent_excess_blobs_3-blockchain_test-block_base_fee_per_gas_delta_100 3 100
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_-2 6 -2
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_-1 6 -1
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_0 6 0
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_1 6 1
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_10 6 10
...fork_Osaka-parent_excess_blobs_6-blockchain_test-block_base_fee_per_gas_delta_100 6 100
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_-2 9 -2
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_-1 9 -1
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_0 9 0
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_1 9 1
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_10 9 10
...fork_Osaka-parent_excess_blobs_9-blockchain_test-block_base_fee_per_gas_delta_100 9 100