ipor-fusion 4.0.0.dev327__tar.gz → 4.0.0.dev334__tar.gz

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/AGENTS.md

@@ -159,7 +159,8 @@ checkout's default profile), the pending reader included.
 - No AI attribution trailers or "generated with" lines in commits or PRs.
 - Branch and open a PR; `main` only moves through PRs and the release workflow.
 - Dependencies: `>=x,<next-major` ranges in `pyproject.toml`, resolved by
-  `uv.lock`; `pyright` is pinned exactly.
+  `uv.lock`; `pyright` is pinned exactly. `certifi` is the deliberate exception: it
+  is calendar-versioned, and its floor only forces a CA bundle with recent revocations.
 - English only, US spelling, in code, comments, docstrings and user-facing
   strings (`field_docs.py` ships as API documentation). Comments only for edge
   cases and non-obvious logic.
@@ -304,7 +305,8 @@ checkout's default profile), the pending reader included.
   `ccip/quote` (`quote_ccip_native_fee`: the exact native fee of a send, from a
   simulation with the payer's balance at zero);
   `ccip/events` decodes the executor/dispatcher/factory events by topic (one
-  registry, mirrored from the v3 source; the v2 pair emits a subset of it);
+  registry, mirrored from the released contracts; earlier deployments' events
+  are not decoded where their signatures differ);
   `ccip/chainlink` also wraps the 2.0 OffRamp, verifier resolver and committee verifier
   (`CcipOffRamp.execute` is the permissionless delivery) and `ccip/indexer` fetches a
   message's verifier result from Chainlink's public indexers and builds that

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/MIGRATION_4.md

@@ -346,12 +346,12 @@ could not hold. 4.0 exports them only from their subpackages.
   `CrosschainSimulator`. It also covers the crosschain ids (`AssetId`, `CommandId`,
   `MessageId`, `LayerZeroEid`, `CcipChainSelector`, ...), which still import from
   `ipor_fusion.types` too.
-- **HyperCore:** the 97 HyperCore names import from the new
+- **HyperCore:** the HyperCore names import from the new
   `ipor_fusion.hypercore`. That covers the fuses and `HyperCoreSubstrates`, the
   readers and `read_hypercore_*`, the event classes, specs and decoders, and the
   ids (`HyperCoreAsset`, `HyperCoreTokenIndex`, `MarginTableId`, `PayloadHash`,
   ...). It also covers the constants and helpers (`SPOT_DEX`, `USDC_TOKEN_INDEX`,
-  `USDC_SYSTEM_ADDRESS`, `system_address`, `precompile_index_of`, `SettlementMode`,
+  `USDC_SYSTEM_ADDRESS`, `system_address`, `precompile_index_of`,
   `TimeInForce`, `TransferDirection`, ...). `HYPEREVM_CHAIN_ID` stays a top-level
   chain constant. `ipor_fusion.fuses`
   and `ipor_fusion.readers` no longer list them; the ids still import from
@@ -540,11 +540,12 @@ on the spoke side.
   `observation()` raises `UnsupportedContractVersionError` this way), and it
   survives `Call.map()`.
 - **Removed.** `CrosschainDispatcher.pending_request_shares` (neither released
-  dispatcher has it). From the repository: `scripts/crosschain_readiness.py`, the
-  pytest `--run-readiness` option and `readiness` marker, and the examples
-  `crosschain_ccip_usdc_arbitrum_hyperevm.py` and
-  `composed_hypercore_flow_arbitrum_hyperevm.py`, which drove an earlier
-  deployment.
+  dispatcher has it). From the repository: `scripts/crosschain_readiness.py` and the
+  pytest `--run-readiness` option and `readiness` marker. The example
+  `crosschain_ccip_usdc_arbitrum_hyperevm.py` is rewritten for the released
+  contracts under the same name, and `composed_hypercore_flow_arbitrum_hyperevm.py`,
+  which drove an earlier deployment, is replaced by
+  `hypercore_vault_official_deployment_hyperevm.py`.
 - **Events and errors.** `CCIP_EVENTS` mirrors the released contracts:
   `ReturnFinalized` / `LateReturnFinalized` gain `debitedSD`, `SharesRequested`
   gains `feeShares`, and new events are registered. The crosschain error registry
@@ -851,7 +852,7 @@ oracle-mapping readers, `read_external_state`, `VaultSimulator(vault=)`,
 `CrosschainSimulator`, crosschain discovery, the hub-manager inputs
 (`ExecutorInitParams.manager`, `create_executor(manager=)`, `executors_of(manager=)`),
 the async command helpers `Command.request_shares` / `redeem_from_request`,
-`pending_request_shares` and `WithdrawManager.update_plasma_vault_address` take a
+and `WithdrawManager.update_plasma_vault_address` take a
 `PlasmaVaultAddress`; `.address`, `FusionInstance.plasma_vault` and the executor's
 `manager()` return one. Crosschain deposit and redeem destinations stay
 `ChecksumAddress`: `Command.deposit` / `redeem`, `is_allowed_vault`,
@@ -928,8 +929,7 @@ and `pending_deployment_created_at()` return a `Timestamp`. Decimals are
 `shared_decimals` of `CcipCrosschainFactory.asset_config()`, `schedule_asset` and
 `execute_asset`. Token amounts are `Amount` (`EVMTokenAmount.amount`,
 `TokenTransferV1.amount`, `TaxiMessage.amount_sd`, `OutboundMessage.token_amount`,
-`StargateChain.to_local_decimals`), and `pending_request_shares()` returns
-`Shares`. Counters, sequences, epochs, versions, bps and gas limits stay `int`.
+`StargateChain.to_local_decimals`). Counters, sequences, epochs, versions, bps and gas limits stay `int`.
 Decoded event values
 (`ccip_events` → `CcipEvent.values`) stay a generic mapping: convert a value
 before passing it on.

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev327
+Version: 4.0.0.dev334
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -58,9 +58,10 @@ Maintained by <a href="https://ipor.io">IPOR Labs AG</a>.
 
 > **Preview, not production:** the crosschain market (54: Stargate and CCIP executors,
 > dispatchers, lanes, fuses) and the HyperCore market (55: fuses, readers, events) are
-> under active development. Their contracts are not production releases, the mainnet
-> deployments are a proof of concept and IPOR Labs canaries, and their interfaces may
-> change between minor versions. Route no production capital through them. Everything
+> under active development. The SDK follows their official deployment (the 2026-10-21
+> contracts release, listed in ipor-abi) and nothing earlier, and their interfaces may
+> change or be removed between minor versions, with no backward compatibility. Route
+> no production capital through them. Everything
 > else in the package is production. `server_info` and `fusion changelog` list the same
 > status (`PREVIEW_FEATURES`).
 
@@ -540,7 +541,7 @@ the pilot executors and factories). Pin an exact version if you depend on them.
 | `discover_deployment`, `open_lanes` | Read a vault's crosschain market from the hub alone (executors with transport, factory, fuses, attestation keys and spokes served; remote vaults per spoke) and open every lane; `LANES` maps a transport kind to its lane class |
 | `CrosschainSimulator` | Multi-chain `eth_simulateV1` relay: replays LayerZero and CCIP messages between pinned chains by impersonating the endpoint or router on delivery, no bridge needed |
 | `ccip_token_lane` | Whether a CCIP message lane exists from a chain and whether a token's pool serves it, read on Chainlink's Router, OnRamp, TokenAdminRegistry and pool |
-| `decode_hypercore_event`, `hypercore_events` | The HyperCore fuse, pending-library, settlement and reporter events, decoded by topic with their raw log identity under the same input contract as `decode_external_state_event`; a malformed listed log raises `HyperCoreEventDecodeError` |
+| `decode_hypercore_event`, `hypercore_events` | The HyperCore fuse events and the pending library's `HyperCoreActionEnqueued` / `HyperCoreActionSettled`, decoded by topic with their raw log identity under the same input contract as `decode_external_state_event`; a malformed listed log raises `HyperCoreEventDecodeError` |
 | Crosschain fuses (market 54): `StargateCrosschainSupplyFuse`, `StargateCrosschainCommandFuse`, `CcipCrosschainSupplyFuse`, `CcipCrosschainCommandFuse`, `CrosschainClaimFuse`; transport-agnostic bases `CrosschainSupplyFuse` / `CrosschainCommandFuse` with `StargateSendParams` / `CcipSendParams`, plus `Command`, `CrosschainSubstrateLib`, `OptionsBuilder` | `ipor_fusion.crosschain` |
 | HyperCore fuses (market 55): `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` | `ipor_fusion.hypercore`, with `HyperCoreReader`, `read_hypercore_vault_state` and the event decoders |
 

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/README.md

@@ -9,9 +9,10 @@ Maintained by <a href="https://ipor.io">IPOR Labs AG</a>.
 
 > **Preview, not production:** the crosschain market (54: Stargate and CCIP executors,
 > dispatchers, lanes, fuses) and the HyperCore market (55: fuses, readers, events) are
-> under active development. Their contracts are not production releases, the mainnet
-> deployments are a proof of concept and IPOR Labs canaries, and their interfaces may
-> change between minor versions. Route no production capital through them. Everything
+> under active development. The SDK follows their official deployment (the 2026-10-21
+> contracts release, listed in ipor-abi) and nothing earlier, and their interfaces may
+> change or be removed between minor versions, with no backward compatibility. Route
+> no production capital through them. Everything
 > else in the package is production. `server_info` and `fusion changelog` list the same
 > status (`PREVIEW_FEATURES`).
 
@@ -491,7 +492,7 @@ the pilot executors and factories). Pin an exact version if you depend on them.
 | `discover_deployment`, `open_lanes` | Read a vault's crosschain market from the hub alone (executors with transport, factory, fuses, attestation keys and spokes served; remote vaults per spoke) and open every lane; `LANES` maps a transport kind to its lane class |
 | `CrosschainSimulator` | Multi-chain `eth_simulateV1` relay: replays LayerZero and CCIP messages between pinned chains by impersonating the endpoint or router on delivery, no bridge needed |
 | `ccip_token_lane` | Whether a CCIP message lane exists from a chain and whether a token's pool serves it, read on Chainlink's Router, OnRamp, TokenAdminRegistry and pool |
-| `decode_hypercore_event`, `hypercore_events` | The HyperCore fuse, pending-library, settlement and reporter events, decoded by topic with their raw log identity under the same input contract as `decode_external_state_event`; a malformed listed log raises `HyperCoreEventDecodeError` |
+| `decode_hypercore_event`, `hypercore_events` | The HyperCore fuse events and the pending library's `HyperCoreActionEnqueued` / `HyperCoreActionSettled`, decoded by topic with their raw log identity under the same input contract as `decode_external_state_event`; a malformed listed log raises `HyperCoreEventDecodeError` |
 | Crosschain fuses (market 54): `StargateCrosschainSupplyFuse`, `StargateCrosschainCommandFuse`, `CcipCrosschainSupplyFuse`, `CcipCrosschainCommandFuse`, `CrosschainClaimFuse`; transport-agnostic bases `CrosschainSupplyFuse` / `CrosschainCommandFuse` with `StargateSendParams` / `CcipSendParams`, plus `Command`, `CrosschainSubstrateLib`, `OptionsBuilder` | `ipor_fusion.crosschain` |
 | HyperCore fuses (market 55): `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` | `ipor_fusion.hypercore`, with `HyperCoreReader`, `read_hypercore_vault_state` and the event decoders |
 

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ipor-fusion"
-version = "4.0.0.dev327"
+version = "4.0.0.dev334"
 description = "The IPOR Fusion SDK for Python"
 authors = [
     { name = "Adam Mydlarz", email = "amydlarz@gmail.com" },

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/about.py

@@ -23,9 +23,9 @@ class PreviewFeature:
 
 # Stated once here and surfaced by `server_info`, `fusion changelog`, the
 # README and the module docstrings, so no reader can miss it: the contracts
-# behind these are under active development, their mainnet deployments are
-# a proof of concept and IPOR Labs canaries, and their interfaces may change
-# between minor versions. Nothing under these names should route production
+# behind these are under active development, the SDK follows only their
+# official deployment, and their interfaces may change or be removed between
+# minor versions. Nothing under these names should route production
 # capital. Every other feature of the package is production.
 PREVIEW_FEATURES: tuple[PreviewFeature, ...] = (
     PreviewFeature(
@@ -40,9 +40,8 @@ PREVIEW_FEATURES: tuple[PreviewFeature, ...] = (
 )
 PREVIEW_STATEMENT = (
     "Preview, not production: the contracts are under active development, the "
-    "mainnet deployments are a proof of concept and IPOR Labs canaries, and "
-    "interfaces may change or be removed between minor versions, with no "
-    "backward compatibility."
+    "SDK follows only their official deployment, and interfaces may change or "
+    "be removed between minor versions, with no backward compatibility."
 )
 
 _DISTRIBUTION = "ipor-fusion"

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/core/contract.py

@@ -19,6 +19,12 @@ T_co = TypeVar("T_co", covariant=True)
 U = TypeVar("U")
 
 
+class _AbiDecodeFailure(DecodingError):
+    """The cause `Call.decode` chains a ``decode_error`` translation from, so an
+    optional batch read can tell an undecodable answer (``None``) apart from any
+    other error a decoder raises."""
+
+
 # No ``slots=True``: on early 3.11 and 3.12 patch releases (3.11.1, 3.12.0 and
 # 3.12.1 checked) ``Call[int](...)`` on a slotted frozen generic dataclass
 # raises ``TypeError`` when typing sets ``__orig_class__`` on the instance.
@@ -122,7 +128,9 @@ class Call(Generic[T_co]):
         except DecodingError as exc:
             if self.decode_error is None:
                 raise
-            raise self.decode_error(exc) from exc
+            marker = _AbiDecodeFailure(str(exc))
+            marker.__cause__ = exc
+            raise self.decode_error(exc) from marker
         single: object = values[0] if len(values) == 1 else values
         if self.decoder is not None:
             return self.decoder(single)

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/core/multicall.py

@@ -9,7 +9,7 @@ from web3 import Web3
 from web3.exceptions import ContractLogicError
 
 from ipor_fusion.core.context import Web3Context
-from ipor_fusion.core.contract import Call, ContractWrapper
+from ipor_fusion.core.contract import Call, ContractWrapper, _AbiDecodeFailure
 from ipor_fusion.errors import EmptyCallResultError
 
 T = TypeVar("T")
@@ -226,6 +226,13 @@ class Multicall3Batch:
             settle(result)
 
 
+def _translated_decode_failure(exc: Exception) -> bool:
+    """Whether ``exc`` is a `Call.decode_error` translation of an undecodable
+    answer: it names the failure for required reads, while an optional read of
+    the same answer is ``None``."""
+    return isinstance(exc.__cause__, _AbiDecodeFailure)
+
+
 def _try_decode(call: Call[T], ok: bool, data: bytes) -> T | None:
     if not ok or not data:
         return None
@@ -233,6 +240,10 @@ def _try_decode(call: Call[T], ok: bool, data: bytes) -> T | None:
         return call.decode(data)
     except DecodingError:
         return None
+    except Exception as exc:
+        if _translated_decode_failure(exc):
+            return None
+        raise
 
 
 def _try_call(call: Call[T], ctx: Web3Context) -> T | None:
@@ -240,3 +251,7 @@ def _try_call(call: Call[T], ctx: Web3Context) -> T | None:
         return call.call(ctx)
     except _CALL_FAILURES:
         return None
+    except Exception as exc:
+        if _translated_decode_failure(exc):
+            return None
+        raise

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/crosschain/__init__.py

@@ -7,7 +7,7 @@ transport and lane. This namespace exports all of it; the transport
 subpackages export only their codecs and wrappers, because the encoders import
 those and a package's ``__init__`` runs before any of its modules.
 
-Status: preview, not production. The contracts behind it are under active development, the mainnet deployments are a proof of concept and IPOR Labs canaries, and interfaces may change between minor versions; see ``ipor_fusion.about.PREVIEW_FEATURES``.
+Status: preview, not production. The contracts behind it are under active development, the SDK follows only their official deployment, and interfaces may change or be removed between minor versions, with no backward compatibility; see ``ipor_fusion.about.PREVIEW_FEATURES``.
 """
 
 from ipor_fusion.crosschain.ccip.chainlink import (

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/hypercore/__init__.py

@@ -1,8 +1,10 @@
 """HyperCore (Hyperliquid) vaults, market 55: preview.
 
 The fuses, readers, events and identifiers of the HyperCore market. A
-preview feature (`ipor_fusion.PREVIEW_FEATURES`): its names may change in a
-minor release, which is why they live here rather than in `ipor_fusion`.
+preview feature (`ipor_fusion.PREVIEW_FEATURES`) that follows only the
+official deployment: its names may change or be removed in a minor release,
+with no backward compatibility, which is why they live here rather than in
+`ipor_fusion`.
 """
 
 from ipor_fusion.fuses.hypercore import (

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/mcp/models.py

@@ -1175,9 +1175,8 @@ class PreviewFeatureModel(_Base):
     status: Literal["preview"] = Field(
         default="preview",
         description="Always 'preview': not production. The contracts are under "
-        "active development, the mainnet deployments are a proof of concept "
-        "and IPOR Labs canaries, and interfaces may change or be removed "
-        "between minor versions, with no backward compatibility. Route no "
+        "active development, the SDK follows only their official deployment, "
+        "and interfaces may change or be removed between minor versions, with no backward compatibility. Route no "
         "production capital through these features.",
     )
 

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/src/ipor_fusion/preflight.py

@@ -141,8 +141,9 @@ def _market_id_call(fuse: FuseAddress) -> Call[MarketId]:
 
 
 def _pinned(ctx: Web3Context) -> tuple[Web3Context, int]:
-    default = ctx.default_block
-    block = default if isinstance(default, int) else ctx.web3.eth.block_number
+    """``ctx`` pinned to the number of the block it names (a number, hash or tag
+    such as ``finalized``), resolved once."""
+    block = int(ctx.web3.eth.get_block(ctx.default_block)["number"])
     return ctx.at_block(block), block
 
 
@@ -321,7 +322,8 @@ def preflight_execute(
     simulate: bool = True,
 ) -> ExecutePreflight:
     """Check ``actions`` as ``sender``'s `PlasmaVault.execute` on the state of one
-    base block (``ctx.default_block`` when it is a number, else the latest).
+    base block: the one ``ctx.default_block`` names (a number, hash or tag),
+    resolved once.
 
     The static checks take a few Multicall3 batches (one per dependency-graph
     level), the ``canCall`` read, the balance-fuse storage reads and, for a

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/tests/test_multicall.py

@@ -370,3 +370,85 @@ class TestBatch:
             batch.run()
         assert [to for to, _ in seen] == [MULTICALL3_ADDRESS, TOKEN_B]
         assert {block for _, block in seen} == {TestPinnedContext.BLOCK}
+
+
+class TestNamedDecodeErrors:
+    """A Call whose decode_error names an undecodable answer (an earlier
+    dispatcher's six-word observation): required reads raise the named error,
+    optional reads are None, with Multicall3 and without it."""
+
+    DISPATCHER = Web3.to_checksum_address("0x" + "cc" * 20)
+    SIX_WORDS = encode(["uint256"] * 6, [1, 2, 3, 4, 5, 6])
+
+    def _observation(self) -> Call[object]:
+        from ipor_fusion.crosschain import CcipCrosschainDispatcher
+
+        return CcipCrosschainDispatcher(self.DISPATCHER).observation()
+
+    def _answer(self, _to: str, _data: bytes) -> bytes:
+        return self.SIX_WORDS
+
+    def _contexts(self) -> list[MagicMock]:
+        return [
+            _ctx(self._answer),
+            TestWithoutMulticall3._ctx_without_multicall(self._answer),
+        ]
+
+    def test_required_reads_raise_the_named_error(self):
+        from ipor_fusion.errors import UnsupportedContractVersionError
+
+        for ctx in self._contexts():
+            with pytest.raises(
+                UnsupportedContractVersionError, match="released 8-field"
+            ):
+                self._observation().call(ctx)
+            with pytest.raises(UnsupportedContractVersionError):
+                Multicall3(ctx).aggregate([self._observation()])
+            batch = Multicall3(ctx).batch()
+            batch.add(self._observation())
+            with pytest.raises(UnsupportedContractVersionError):
+                batch.run()
+
+    def test_optional_reads_are_none(self):
+        for ctx in self._contexts():
+            assert Multicall3(ctx).try_aggregate([self._observation()]) == [None]
+            batch = Multicall3(ctx).batch()
+            read = batch.try_add(self._observation())
+            mapped = batch.try_add(self._observation().map(lambda o: o))
+            batch.run()
+            assert (read.value, mapped.value) == (None, None)
+
+    def test_other_decoder_errors_still_propagate_from_optional_reads(self):
+        from eth_abi.exceptions import DecodingError
+
+        def buggy(_value: object) -> object:
+            raise ValueError("decoder bug") from DecodingError("inner")
+
+        def translate(exc: Exception) -> Exception:
+            return RuntimeError(f"named: {exc}")
+
+        valid = encode(["uint256"], [7])
+        decoded_badly = Call(
+            to=self.DISPATCHER,
+            data=SELECTOR,
+            output_types=["uint256"],
+            decoder=buggy,
+            decode_error=translate,
+        )
+        mapped_badly = Call(
+            to=self.DISPATCHER,
+            data=SELECTOR,
+            output_types=["uint256"],
+            decode_error=translate,
+        ).map(buggy)
+        for ctx in [
+            _ctx(lambda _to, _data: valid),
+            TestWithoutMulticall3._ctx_without_multicall(lambda _to, _data: valid),
+        ]:
+            for call in (decoded_badly, mapped_badly):
+                with pytest.raises(ValueError, match="decoder bug"):
+                    Multicall3(ctx).try_aggregate([call])
+                batch = Multicall3(ctx).batch()
+                batch.try_add(call)
+                with pytest.raises(ValueError, match="decoder bug"):
+                    batch.run()

{ipor_fusion-4.0.0.dev327 → ipor_fusion-4.0.0.dev334}/tests/test_preflight.py

@@ -85,7 +85,7 @@ def _ctx(
     ctx.chain_id = 8453
     ctx.at_block.return_value = ctx
     ctx.call.side_effect = multicall_aware(handler)
-    ctx.web3.eth.get_block.return_value = {"timestamp": NOW}
+    ctx.web3.eth.get_block.return_value = {"number": BLOCK, "timestamp": NOW}
     return ctx
 
 
@@ -231,6 +231,22 @@ class _FakeSimulator:
         return self.outcome
 
 
+@pytest.mark.parametrize("named", ["finalized", "safe", "0x" + "ab" * 32, "latest"])
+def test_the_block_the_context_names_is_resolved_and_pinned(monkeypatch, named):
+    monkeypatch.setattr(preflight_module, "is_simulate_v1_supported", lambda w3: True)
+    monkeypatch.setattr(preflight_module, "VaultSimulator", _FakeSimulator)
+    ctx = _ctx()
+    ctx.default_block = named
+
+    result = preflight_execute(ctx, VAULT, [_supply()], sender=SENDER)
+
+    ctx.web3.eth.get_block.assert_called_once_with(named)
+    ctx.at_block.assert_called_once_with(BLOCK)
+    # _FakeSimulator asserts it was built with block=BLOCK: the simulation
+    # runs on top of the resolved block, not the latest.
+    assert result.block_number == BLOCK
+
+
 def test_the_simulation_reports_total_assets_and_a_revert(monkeypatch):
     monkeypatch.setattr(preflight_module, "is_simulate_v1_supported", lambda w3: True)
     monkeypatch.setattr(preflight_module, "VaultSimulator", _FakeSimulator)