Skip to content

test_reserve_price_boundary()

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

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
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
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
@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],
) -> None:
    """
    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.
    """
    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