ipor-fusion 4.1.0.dev14__tar.gz → 4.1.0.dev35__tar.gz

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/AGENTS.md

@@ -281,7 +281,8 @@ checkout's default profile), the pending reader included.
   `hypercore_event_decoding.py` (the ExternalState and HyperCore event specs, classes
   and decoders; internal modules, the ExternalState names are exported from
   `ipor_fusion.fuses`, the HyperCore ones from `ipor_fusion.hypercore`), `hypercore.py`
-  (the HyperCore fuses, market 55);
+  (the HyperCore fuses, market 55), `hypercore_pre_hooks.py` (the `PlasmaVault` call
+  that wires their pre-hooks);
   `base.py` re-exports the `core/fuse.py` base and validators,
   `FuseAction` and `ZERO_ADDRESS` (from `types`). A fuse is a value: equality and
   hash cover its class and every attribute it stores

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/MIGRATION_4.md

@@ -761,7 +761,7 @@ label values; they do not validate byte widths or address spelling.
 | `RoleId` | a `Roles` member (accepted as is), or `RoleId(n)`; `Roles.resolve(name)` returns one |
 | `Decimals`, `Period`, `Amount`, `Shares`, ... | `Decimals(8)`, `Period(0)`, `Amount(n)`, `Shares(n)` |
 | `Wad` | `Wad(6 * 10**17)` (60%): an 18-decimal fraction, `10**18` is 100% |
-| `ChecksumAddress` | `Web3.to_checksum_address(value)` |
+| `ChecksumAddress` | `Web3.to_checksum_address(value)`, or from 4.1 `parse_checksum_address(value)`, which also rejects a wrong EIP-55 checksum |
 | `HexAddress` | any `ChecksumAddress`, or `parse_hex_address(value)` (20 bytes or `0x`/`0X`-prefixed hex in any case → lowercase `0x` form) |
 | `MorphoBlueMarketId` | `parse_morpho_market_id(value)`: 32 bytes or hex in any spelling, always `0x` + 64 lowercase digits |
 | `TxHash` | `parse_tx_hash(value)` (32 bytes or `0x`/`0X`-prefixed hex in any case) |
@@ -775,6 +775,9 @@ The address and hash parsers (`parse_hex_address`, `parse_tx_hash`,
 `parse_plasma_vault_address`, `parse_fuse_address`, `parse_access_manager_address`)
 validate strictly: a string needs exactly one `0x`/`0X` prefix and the exact number of
 hex digits, with no surrounding whitespace; anything else raises `ValueError`.
+From 4.1 on, the checksumming ones (`parse_checksum_address` and the three role
+parsers) also reject a mixed-case address whose EIP-55 checksum is wrong; an
+all-lowercase or all-uppercase address carries no checksum and still parses.
 Normalize user input first (see [Start here](#start-here)).
 `parse_morpho_market_id` still accepts hex without `0x`.
 

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.1.0.dev14
+Version: 4.1.0.dev35
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -543,7 +543,7 @@ the pilot executors and factories). Pin an exact version if you depend on them.
 | `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 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 |
+| HyperCore fuses (market 55): `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` | `ipor_fusion.hypercore`, with `HyperCoreReader`, `read_hypercore_vault_state`, the event decoders and `HyperCorePreHookWiring` (the capital-flow and pending-action pre-hooks on their selectors, `HYPERCORE_CAPITAL_FLOW_SELECTORS` / `HYPERCORE_PENDING_ACTION_SELECTORS`) |
 
 The crosschain API supports only the contracts of the 2026-10-21 release; earlier
 deployments are unreadable (`MIGRATION_4.md`). `open_lane` and `discover_deployment`

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/README.md

@@ -494,7 +494,7 @@ the pilot executors and factories). Pin an exact version if you depend on them.
 | `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 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 |
+| HyperCore fuses (market 55): `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` | `ipor_fusion.hypercore`, with `HyperCoreReader`, `read_hypercore_vault_state`, the event decoders and `HyperCorePreHookWiring` (the capital-flow and pending-action pre-hooks on their selectors, `HYPERCORE_CAPITAL_FLOW_SELECTORS` / `HYPERCORE_PENDING_ACTION_SELECTORS`) |
 
 The crosschain API supports only the contracts of the 2026-10-21 release; earlier
 deployments are unreadable (`MIGRATION_4.md`). `open_lane` and `discover_deployment`

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/advanced_euler_v2_credit_market_base.py

@@ -62,6 +62,7 @@ from ipor_fusion import (
     VaultSimulator,
     Web3Context,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.fuses import (
@@ -87,7 +88,7 @@ BASE_CHAIN_ID = ChainId(8453)
 EULER_MARKET = IporFusionMarkets.EULER_V2
 
 # IporFusionFactoryProxy on Base. Its clone(...) takes the six args in clone_args().
-BASE_FUSION_FACTORY = Web3.to_checksum_address(
+BASE_FUSION_FACTORY = parse_checksum_address(
     "0x1455717668fA96534f675856347A973fA907e922"
 )
 
@@ -116,20 +117,18 @@ EULER_BALANCE_FUSE = parse_fuse_address("0xF8A6AA09bB55f2319113b0DA88883F392e66A
 # so they are not in the ipor-abi registry -- they are a live cbETH/WETH pair
 # whose LTV allows the borrow below. The RPC-gated test asserts each eVault's
 # IEVault.asset() equals the expected underlying, which is their provenance check.
-EVAULT_CBETH = Web3.to_checksum_address("0x358f25F82644eaBb441d0df4AF8746614fb9ea49")
-EVAULT_WETH = Web3.to_checksum_address("0x859160DB5841E5cfB8D3f144C6b3381A85A4b410")
+EVAULT_CBETH = parse_checksum_address("0x358f25F82644eaBb441d0df4AF8746614fb9ea49")
+EVAULT_WETH = parse_checksum_address("0x859160DB5841E5cfB8D3f144C6b3381A85A4b410")
 
 # Underlying assets of those eVaults (registry names "cbETH" / "wETH").
-BASE_CBETH = Web3.to_checksum_address("0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22")
-BASE_WETH = Web3.to_checksum_address("0x4200000000000000000000000000000000000006")
+BASE_CBETH = parse_checksum_address("0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22")
+BASE_WETH = parse_checksum_address("0x4200000000000000000000000000000000000006")
 
 # A Base address holding ample cbETH, used to fund the vault's collateral via an
 # impersonated transfer inside the simulation. This is the Morpho Blue core
 # contract (registry name "Morpho") -- a large, unrelated holder, so funding does
 # not perturb the Euler markets the strategy uses.
-BASE_CBETH_WHALE = Web3.to_checksum_address(
-    "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
-)
+BASE_CBETH_WHALE = parse_checksum_address("0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb")
 
 # ── Simulation parameters (safe to adjust) ───────────────────────────────────
 #
@@ -152,10 +151,10 @@ BASE_CBETH_WHALE = Web3.to_checksum_address(
 # focuses on the credit lifecycle rather than the deposit -> shares path.)
 
 # Governance/atomist. Any address; here it happens to be a random EOA.
-OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
 
 # The alpha operator. Anvil account #0, a well-known test address.
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
 
 # One owner address controls 256 Euler sub-accounts; the vault's EVC account for
 # this position is `plasma_vault XOR SUB_ACCOUNT`. Using a non-zero sub-account

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/advanced_euler_v2_looping_arbitrum.py

@@ -47,6 +47,7 @@ from ipor_fusion import (
     VaultSimulator,
     Web3Context,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.fuses import (
@@ -76,7 +77,7 @@ EULER_MARKET = IporFusionMarkets.EULER_V2
 SWAPPER_MARKET = IporFusionMarkets.UNIVERSAL_TOKEN_SWAPPER_V2
 MORPHO_FLASH_MARKET = IporFusionMarkets.MORPHO_FLASH_LOAN
 
-ARBITRUM_FUSION_FACTORY = Web3.to_checksum_address(
+ARBITRUM_FUSION_FACTORY = parse_checksum_address(
     "0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5"
 )
 EULER_SUPPLY_FUSE = parse_fuse_address("0x920f6c81666877490A8D6dcFEFd85d151Ef04B7d")
@@ -96,34 +97,34 @@ UNIVERSAL_SWAPPER_FUSE_V2 = parse_fuse_address(
 UNIVERSAL_SWAPPER_BALANCE_FUSE_V2 = parse_fuse_address(
     "0x69199E8360b3Baa536Cda2bd71dFFb30F79fBeF7"
 )
-MORPHO_CALLBACK_HANDLER = Web3.to_checksum_address(
+MORPHO_CALLBACK_HANDLER = parse_checksum_address(
     "0x62E0A527fa7990183C4225f4565B2BfC925CD46e"
 )
-MORPHO = Web3.to_checksum_address("0x6c247b1F6182318877311737BaC0844bAa518F5e")
+MORPHO = parse_checksum_address("0x6c247b1F6182318877311737BaC0844bAa518F5e")
 
 # Euler eVaults come from Euler's official Arbitrum Cluster deployment manifest.
 # The RPC-gated test also checks each eVault's ``asset()`` at PINNED_BLOCK.
-EVAULT_USDC = Web3.to_checksum_address("0x0a1eCC5Fe8C9be3C809844fcBe615B46A869b899")
-EVAULT_WBTC = Web3.to_checksum_address("0x889E1c458B2469b70aCcdfb5B59726dC1668896C")
+EVAULT_USDC = parse_checksum_address("0x0a1eCC5Fe8C9be3C809844fcBe615B46A869b899")
+EVAULT_WBTC = parse_checksum_address("0x889E1c458B2469b70aCcdfb5B59726dC1668896C")
 
-ARBITRUM_USDC = Web3.to_checksum_address("0xaf88d065e77c8cC2239327C5EDb3A432268e5831")
-ARBITRUM_WBTC = Web3.to_checksum_address("0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f")
+ARBITRUM_USDC = parse_checksum_address("0xaf88d065e77c8cC2239327C5EDb3A432268e5831")
+ARBITRUM_WBTC = parse_checksum_address("0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f")
 
 # Official Uniswap Universal Router deployment on Arbitrum. The 500-fee pool is
 # verified on-chain in the RPC-gated test and is the deepest USDC/WBTC V3 pool at
 # the pinned block.
-UNISWAP_UNIVERSAL_ROUTER = Web3.to_checksum_address(
+UNISWAP_UNIVERSAL_ROUTER = parse_checksum_address(
     "0x5E325eDA8064b456f4781070C0738d849c824258"
 )
 UNISWAP_POOL_FEE = 500
-UNISWAP_USDC_WBTC_POOL = Web3.to_checksum_address(
+UNISWAP_USDC_WBTC_POOL = parse_checksum_address(
     "0x0e4831319a50228b9e450861297ab92dee15b44f"
 )
 
 # ── Simulation parameters (safe to adjust) ───────────────────────────────────
 
-OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
 SUB_ACCOUNT = 0x01
 
 INITIAL_WBTC = Amount(10_000_000)  # 0.10 WBTC, the unlevered equity

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/crosschain_ccip_usdc_arbitrum_hyperevm.py

@@ -113,6 +113,7 @@ from ipor_fusion import (
     Web3Context,
     erc20_balance_slot,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.crosschain import (
@@ -151,10 +152,10 @@ ARBITRUM_CHAIN_ID = ChainId(42161)
 HYPEREVM_CHAIN_ID = ChainId(999)
 ARBITRUM_CCIP_SELECTOR = CcipChainSelector(4949039107694359620)
 HYPEREVM_CCIP_SELECTOR = CcipChainSelector(2442541497099098535)
-ARBITRUM_CCIP_ROUTER = Web3.to_checksum_address(
+ARBITRUM_CCIP_ROUTER = parse_checksum_address(
     "0x141fa059441E0ca23ce184B6A78bafD2A517DdE8"
 )
-HYPEREVM_CCIP_ROUTER = Web3.to_checksum_address(
+HYPEREVM_CCIP_ROUTER = parse_checksum_address(
     "0x13b3332b66389B1467CA6eBd6fa79775CCeF65ec"
 )
 
@@ -162,17 +163,17 @@ HYPEREVM_CCIP_ROUTER = Web3.to_checksum_address(
 # (developers.circle.com -> stablecoins -> USDC contract addresses). The USDC
 # CCIP lane between them is a CCTP burn-and-mint lane, so the asset arrives as
 # the same native token on the other side.
-ARBITRUM_USDC = Web3.to_checksum_address("0xaf88d065e77c8cC2239327C5EDb3A432268e5831")
-HYPEREVM_USDC = Web3.to_checksum_address("0xb88339CB7199b77E23DB6E890353E22632Ba630f")
+ARBITRUM_USDC = parse_checksum_address("0xaf88d065e77c8cC2239327C5EDb3A432268e5831")
+HYPEREVM_USDC = parse_checksum_address("0xb88339CB7199b77E23DB6E890353E22632Ba630f")
 USDC_DECIMALS = Decimals(6)
 
 # Chainlink USDC/USD feed proxies (data.chain.link -> feeds -> arbitrum ->
 # mainnet -> usdc-usd, and hyperliquid -> hyperliquid -> usdc-usd; the standard
 # feeds, not SVR). Each vault's price manager prices USDC from its chain's feed.
-ARBITRUM_USDC_USD_FEED = Web3.to_checksum_address(
+ARBITRUM_USDC_USD_FEED = parse_checksum_address(
     "0x50834F3163758fcC1Df9973b6e91f0F0F0434aD3"
 )
-HYPEREVM_USDC_USD_FEED = Web3.to_checksum_address(
+HYPEREVM_USDC_USD_FEED = parse_checksum_address(
     "0xA0Adc43ce7AfE3EE7d7eac3C994E178D0620223B"
 )
 
@@ -180,10 +181,10 @@ HYPEREVM_USDC_USD_FEED = Web3.to_checksum_address(
 # mainnet/mainnet-arbitrum-fusion/addresses.json and
 # mainnet/mainnet-hyperevm-fusion/addresses.json. Their clone(...) creates the
 # hub and the spoke vault.
-ARBITRUM_FUSION_FACTORY = Web3.to_checksum_address(
+ARBITRUM_FUSION_FACTORY = parse_checksum_address(
     "0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5"
 )
-HYPEREVM_FUSION_FACTORY = Web3.to_checksum_address(
+HYPEREVM_FUSION_FACTORY = parse_checksum_address(
     "0x6bBc827F34b4e862d15215ABd4AC0E3886181665"
 )
 
@@ -195,7 +196,7 @@ HYPEREVM_FUSION_FACTORY = Web3.to_checksum_address(
 RELEASE_COMMIT = "10f0f8e4031980b6f130d4f6460c6f8edfbcab32"
 # CcipCrosschainFactory: creates executors on the hub and dispatchers on the
 # spoke, and carries the factory-to-factory deployment ticket.
-CCIP_FACTORY = Web3.to_checksum_address("0xAd84580810A4e498F5F13Ad8506F73782FB472FA")
+CCIP_FACTORY = parse_checksum_address("0xAd84580810A4e498F5F13Ad8506F73782FB472FA")
 # CcipCrosschainSupplyFuse, CcipCrosschainCommandFuse, CrosschainClaimFuse and
 # CrosschainBalanceFuse, all bound to the CROSSCHAIN market (54).
 CCIP_SUPPLY_FUSE = parse_fuse_address("0x00a20FD711083CcE9C9c4292762aFf79f78C48eb")
@@ -207,13 +208,13 @@ CROSSCHAIN_BALANCE_FUSE = parse_fuse_address(
 # CrosschainNavValidationPreHook: closes the vault's share-price-sensitive entry
 # points while any of its executors fails its NAV check (a stale attestation,
 # a blocked chain, a stale transfer).
-CROSSCHAIN_NAV_PRE_HOOK = Web3.to_checksum_address(
+CROSSCHAIN_NAV_PRE_HOOK = parse_checksum_address(
     "0xA17c7A5Ed994aA5FE99C22B37DeCBCbfb32FaFe3"
 )
 # The libraries the executor and the dispatcher link (source path, name,
 # address), in the order Foundry's ``--libraries`` takes them.
 RELEASE_LIBRARIES: tuple[tuple[str, str, ChecksumAddress], ...] = tuple(
-    (source, name, Web3.to_checksum_address(address))
+    (source, name, parse_checksum_address(address))
     for source, name, address in (
         (
             "contracts/crosschain/ccip/lib/CcipRouteLib.sol",
@@ -277,7 +278,7 @@ DISPATCHER_CREATION_CODE_HASH = bytes.fromhex(
 # The factory's owner on both chains, read from CcipCrosschainFactory.owner()
 # (a Safe multisig). Only it configures the factory and allows executor
 # creators; the example checks the read against this constant.
-FACTORY_OWNER = Web3.to_checksum_address("0xA74376157E78053275fdae4A6849B5C16F41A0B9")
+FACTORY_OWNER = parse_checksum_address("0xA74376157E78053275fdae4A6849B5C16F41A0B9")
 
 # ``IporFusionMarkets.CROSSCHAIN``: the market the crosschain fuses are bound to.
 CROSSCHAIN_MARKET = IporFusionMarkets.CROSSCHAIN
@@ -303,17 +304,13 @@ CROSSCHAIN_MARKET = IporFusionMarkets.CROSSCHAIN
 #   RESCUE_GUARDIAN -- can veto the executor's timelocked rescue actions,
 #                  nothing else; the executor refuses it equal to the rescue
 #                  admin (VAULT_OWNER).
-VAULT_OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+VAULT_OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
 # Anvil accounts #0 to #4, well-known test addresses.
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
-DEPOSITOR = Web3.to_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
-BALANCE_PROPOSER = Web3.to_checksum_address(
-    "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC"
-)
-BALANCE_APPROVER = Web3.to_checksum_address(
-    "0x90F79bf6EB2c4f870365E785982E1f101E93b906"
-)
-RESCUE_GUARDIAN = Web3.to_checksum_address("0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+DEPOSITOR = parse_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
+BALANCE_PROPOSER = parse_checksum_address("0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC")
+BALANCE_APPROVER = parse_checksum_address("0x90F79bf6EB2c4f870365E785982E1f101E93b906")
+RESCUE_GUARDIAN = parse_checksum_address("0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65")
 
 # ── Adjustable simulation parameters ─────────────────────────────────────────
 # Pinned after the released contracts were deployed, at the same timestamp on

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/external_state_margin_leg_base.py

@@ -99,6 +99,7 @@ from ipor_fusion import (
     WithdrawManager,
     WithdrawRequestInfo,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.fuses import ExternalStateOperationFuse
@@ -116,7 +117,7 @@ BASE_CHAIN_ID = ChainId(8453)
 
 # IporFusionFactoryProxy on Base. Its clone(...) takes the six arguments
 # assembled in clone_args() below.
-BASE_FUSION_FACTORY = Web3.to_checksum_address(
+BASE_FUSION_FACTORY = parse_checksum_address(
     "0x1455717668fA96534f675856347A973fA907e922"
 )
 
@@ -125,7 +126,7 @@ BASE_FUSION_FACTORY = Web3.to_checksum_address(
 # asset parked at the venue -- perp venues margin in USDC, and a venue that
 # credits by sender needs the executor itself to send it, so a second asset plus
 # a swap would only add a market this example does not need.
-BASE_USDC = Web3.to_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
+BASE_USDC = parse_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
 
 # External-state market (IporFusionMarkets.EXTERNAL_STATE).
 EXTERNAL_STATE_MARKET = IporFusionMarkets.EXTERNAL_STATE
@@ -172,17 +173,17 @@ BASE_EXTERNAL_STATE_BALANCE_FUSE = parse_fuse_address(
 #                 two addresses driven by one process buy nothing.
 
 # Governance/atomist. Any address; here it happens to be a random EOA.
-OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
 
 # The alpha operator. Anvil account #0, a well-known test address.
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
 
 # The depositor -- the end user putting funds in. Anvil account #1.
-DEPOSITOR = Web3.to_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
+DEPOSITOR = parse_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
 
 # The two custodians. Anvil accounts #2 and #3.
-CUSTODIAN_A = Web3.to_checksum_address("0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC")
-CUSTODIAN_B = Web3.to_checksum_address("0x90F79bf6EB2c4f870365E785982E1f101E93b906")
+CUSTODIAN_A = parse_checksum_address("0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC")
+CUSTODIAN_B = parse_checksum_address("0x90F79bf6EB2c4f870365E785982E1f101E93b906")
 
 # SIMULATION ONLY (placeholder addresses). Two distinct things, easy to conflate.
 #
@@ -204,10 +205,10 @@ CUSTODIAN_B = Web3.to_checksum_address("0x90F79bf6EB2c4f870365E785982E1f101E93b9
 # not reach. Pasting that address here would give it borrowed provenance: on Base
 # it is an unrelated account, and a reader who copied it would send funds
 # nowhere.
-VENUE_DEPOSIT_ADDRESS = Web3.to_checksum_address(
+VENUE_DEPOSIT_ADDRESS = parse_checksum_address(
     "0x000000000000000000000000000000000000BEEF"
 )
-VENUE_BALANCE_ACCOUNT = Web3.to_checksum_address(
+VENUE_BALANCE_ACCOUNT = parse_checksum_address(
     "0x000000000000000000000000000000000000CAFE"
 )
 
@@ -215,7 +216,7 @@ VENUE_BALANCE_ACCOUNT = Web3.to_checksum_address(
 # impersonated transfer inside the simulation. Morpho Blue's core contract
 # (~150M USDC) -- a protocol this example never touches, so funding cannot
 # perturb the flow under test.
-BASE_USDC_WHALE = Web3.to_checksum_address("0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb")
+BASE_USDC_WHALE = parse_checksum_address("0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb")
 
 # Pinned Base block, after both external-state fuses were deployed. Pinning makes
 # the simulation deterministic and immune to mainnet state drift. It requires an

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/hypercore_vault_official_deployment_hyperevm.py

@@ -96,6 +96,7 @@ from ipor_fusion import (
     decode_substrate,
     erc20_balance_slot,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.hypercore import (
@@ -110,6 +111,7 @@ from ipor_fusion.hypercore import (
     HyperCorePendingReader,
     HyperCorePendingState,
     HyperCorePerpAssetInfo,
+    HyperCorePreHookWiring,
     HyperCoreReader,
     HyperCoreSendFuse,
     HyperCoreSubstrates,
@@ -138,7 +140,7 @@ log = logging.getLogger("hypercore_vault_official_deployment_hyperevm")
 HYPEREVM_CHAIN_ID = ChainId(999)
 
 # IporFusionFactoryProxy (implementation IporFusionFactoryImpl, factory version 10).
-FUSION_FACTORY = Web3.to_checksum_address("0x6bBc827F34b4e862d15215ABd4AC0E3886181665")
+FUSION_FACTORY = parse_checksum_address("0x6bBc827F34b4e862d15215ABd4AC0E3886181665")
 
 # BurnRequestFeeFuseV2: the fuse every factory clone starts with.
 FACTORY_FEE_FUSE = parse_fuse_address("0xD62f398d36aeDE3992521EA9Fc501dEB418a50b4")
@@ -154,28 +156,28 @@ ORDER_FUSE = parse_fuse_address("0x96f97c088E9610A036a2738B004DF04Ee9Cf17a2")
 # HyperCoreBalanceFuse: values the vault's Core account for market 55.
 BALANCE_FUSE = parse_fuse_address("0xbEd25202529DCD2a05f7D8944B10779b6dbc6Fa6")
 # HyperCoreCapitalFlowPreHook and HyperCorePendingActionPreHook.
-CAPITAL_FLOW_PRE_HOOK = Web3.to_checksum_address(
+CAPITAL_FLOW_PRE_HOOK = parse_checksum_address(
     "0xbA999E8b50bDC2672CcE13A1F896aaD7Dc5BE547"
 )
-PENDING_ACTION_PRE_HOOK = Web3.to_checksum_address(
+PENDING_ACTION_PRE_HOOK = parse_checksum_address(
     "0xd240690cf7C41dDD75863c4b4a9358ea62B20c85"
 )
 # HyperCorePendingReader: the stateless helper the vault delegatecalls to report
 # its pending-action record. The SDK's default for chain 999 is this address.
-PENDING_READER = Web3.to_checksum_address("0x1EFFb12434f5fb59a636C54D8CBaC93b13DF1A9E")
+PENDING_READER = parse_checksum_address("0x1EFFb12434f5fb59a636C54D8CBaC93b13DF1A9E")
 
 # IporFusionPriceFeedUSD: a constant 1 USD price (8 decimals). The global price
 # oracle middleware on HyperEVM has no USDC source, so the vault's own price
 # manager must name one. A constant peg keeps this example's NAV arithmetic
 # exact; a production vault picks its USDC feed in its oracle review (a market
 # USDC/USD feed prices a depeg, a constant does not).
-USD_PRICE_FEED = Web3.to_checksum_address("0x15794119c5D99Ed7997D1CE80DE8599e188547c5")
+USD_PRICE_FEED = parse_checksum_address("0x15794119c5D99Ed7997D1CE80DE8599e188547c5")
 
 # Native Circle USDC on HyperEVM (6 decimals). Core token 0 is USDC; its
 # ``tokenInfo(0).evmContract`` is Circle's CoreDepositWallet, whose ``token()`` is
 # this ERC-20, so the SpotToken grant names this address, not the wallet
 # (contracts/fuses/hypercore/README.md in ipor-fusion).
-HYPEREVM_USDC = Web3.to_checksum_address("0xb88339CB7199b77E23DB6E890353E22632Ba630f")
+HYPEREVM_USDC = parse_checksum_address("0xb88339CB7199b77E23DB6E890353E22632Ba630f")
 
 # xyz is HIP-3 perp dex 1, and xyz:NVDA is its market 2: action asset
 # 100_000 + 1 * 10_000 + 2 in orders and grants, read index 10_002 for the
@@ -195,9 +197,9 @@ XYZ_NVDA_SZ_DECIMALS = 3
 # refresh balances, and DEPOSITOR is an end user. OWNER and ALPHA must never
 # share an address in production: a compromised alpha key would become
 # governance, and on a HyperCore vault governance can re-wire the pre-hooks.
-OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
-DEPOSITOR = Web3.to_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
+OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+DEPOSITOR = parse_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
 
 # Pinned HyperEVM block, after the official HyperCore contracts and the factory
 # upgrade. If your provider cannot serve state at this height, BUMP IT to a
@@ -234,22 +236,10 @@ MAX_ORDER_NOTIONAL_USD6 = 15_000_000
 SEND_CAP_WEI = 10_000_000_000  # 100 USDC
 NAV_JUMP_FLOOR_USD6 = 1_000_000  # 1 USD; the runbook sizes it per vault TVL
 
-# The six share-priced entry points and the two operator entry points of a
-# Plasma Vault: the HyperCore pre-hooks are wired per selector.
-CAPITAL_FLOW_SELECTORS = tuple(
-    function_signature_to_4byte_selector(signature)
-    for signature in (
-        "deposit(uint256,address)",
-        "depositWithPermit(uint256,address,uint256,uint8,bytes32,bytes32)",
-        "mint(uint256,address)",
-        "withdraw(uint256,address,address)",
-        "redeem(uint256,address,address)",
-        "redeemFromRequest(uint256,address,address)",
-    )
-)
-PENDING_ACTION_SELECTORS = tuple(
-    function_signature_to_4byte_selector(signature)
-    for signature in ("execute((address,bytes)[])", "updateMarketsBalances(uint256[])")
+# This deployment's two pre-hooks.
+PRE_HOOKS = HyperCorePreHookWiring(
+    capital_flow_hook=CAPITAL_FLOW_PRE_HOOK,
+    pending_action_hook=PENDING_ACTION_PRE_HOOK,
 )
 
 
@@ -340,18 +330,6 @@ def market_substrates(vault: PlasmaVaultAddress) -> list[bytes]:
     ]
 
 
-def pre_hook_wiring() -> tuple[list[bytes], list[ChecksumAddress], list[list[bytes]]]:
-    """``setPreHookImplementations`` arguments: the capital-flow hook on the six
-    share-priced selectors, the pending-action hook on ``execute`` and
-    ``updateMarketsBalances``; neither hook takes substrates. A selector appears
-    once: a duplicate in one call silently keeps the last value."""
-    selectors = [*CAPITAL_FLOW_SELECTORS, *PENDING_ACTION_SELECTORS]
-    implementations = [CAPITAL_FLOW_PRE_HOOK] * len(CAPITAL_FLOW_SELECTORS) + [
-        PENDING_ACTION_PRE_HOOK
-    ] * len(PENDING_ACTION_SELECTORS)
-    return selectors, implementations, [[] for _ in selectors]
-
-
 def core_to_evm_amount(spot_total_wei: int) -> int:
     """Core wei to bridge back: spot minus the fee reserve, rounded down to a
     multiple of 100 Core wei so the EVM amount is exact."""
@@ -675,9 +653,8 @@ def run_simulation(
 
     # 3. The pre-hooks. The deposit fuse and opening orders revert unless all
     #    six share-priced selectors carry the capital-flow hook.
-    selectors, implementations, hook_substrates = pre_hook_wiring()
     sim.add_call(
-        vault.set_pre_hook_implementations(selectors, implementations, hook_substrates),
+        PRE_HOOKS.set_pre_hook_implementations(vault),
         from_=OWNER,
         label="set pre-hooks",
         gas=CALL_GAS,
@@ -686,8 +663,10 @@ def run_simulation(
 
     # The post-deployment checklist, read back from the wired vault.
     wired_hooks = [
-        (selector, sim.observe(vault.get_pre_hook_implementation(selector)))
-        for selector in selectors
+        (selector, expected, sim.observe(vault.get_pre_hook_implementation(selector)))
+        for selector, expected in zip(
+            PRE_HOOKS.selectors, PRE_HOOKS.implementations, strict=True
+        )
     ]
     vault_refresh_role = sim.observe(
         access_manager.has_role(Roles.UPDATE_MARKETS_BALANCES_ROLE, vault_address)
@@ -719,12 +698,7 @@ def run_simulation(
     result = sim.run()
     _assert_all_success(result)
 
-    for selector, implementation in wired_hooks:
-        expected = (
-            CAPITAL_FLOW_PRE_HOOK
-            if selector in CAPITAL_FLOW_SELECTORS
-            else PENDING_ACTION_PRE_HOOK
-        )
+    for selector, expected, implementation in wired_hooks:
         _check(
             implementation.value == expected,
             f"selector 0x{selector.hex()} runs {implementation.value}, not {expected}",

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/examples/simple_aave_v3_supply_base.py

@@ -51,6 +51,7 @@ from ipor_fusion import (
     VaultSimulator,
     Web3Context,
     is_simulate_v1_supported,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.fuses import AaveV3SupplyFuse
@@ -68,13 +69,13 @@ BASE_CHAIN_ID = ChainId(8453)
 
 # IporFusionFactoryProxy on Base. Its clone(...) takes the six arguments
 # assembled in clone_args() below.
-BASE_FUSION_FACTORY = Web3.to_checksum_address(
+BASE_FUSION_FACTORY = parse_checksum_address(
     "0x1455717668fA96534f675856347A973fA907e922"
 )
 
 # Native (Circle-issued) USDC on Base, 6 decimals. Not the bridged USDbC, a
 # distinct ERC-20 with its own Aave market and price feed.
-BASE_USDC = Web3.to_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
+BASE_USDC = parse_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
 
 # Aave V3 market (IporFusionMarkets.AAVE_V3).
 AAVE_MARKET = IporFusionMarkets.AAVE_V3
@@ -112,21 +113,21 @@ BASE_AAVE_V3_BALANCE_FUSE = parse_fuse_address(
 #   DEPOSITOR-- an end user; only ever holds and deposits funds.
 
 # Governance/atomist. Any address; here it happens to be a random EOA.
-OWNER = Web3.to_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
+OWNER = parse_checksum_address("0x533ac556E288625B267bD71B7928E0a8B46DcE82")
 
 # The alpha operator. Anvil account #0, a well-known test address.
-ALPHA = Web3.to_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
+ALPHA = parse_checksum_address("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")
 
 # The depositor -- the end user putting funds in. Never drives execute() and
 # never holds a governance role. Anvil account #1, the natural sibling to the
 # alpha's Anvil account #0.
-DEPOSITOR = Web3.to_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
+DEPOSITOR = parse_checksum_address("0x70997970C51812dc3A010C7d01b50e0d17dc79C8")
 
 # A Base address holding ample USDC, used to fund the depositor via an
 # impersonated transfer inside the simulation. This is the Morpho Blue core
 # contract (~150M USDC) -- deliberately a different protocol from Aave, so
 # funding does not perturb the market the strategy supplies into.
-BASE_USDC_WHALE = Web3.to_checksum_address("0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb")
+BASE_USDC_WHALE = parse_checksum_address("0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb")
 
 # Pinned Base block. Pinning makes the simulation deterministic and immune to
 # mainnet state drift. It requires an archive node that can serve state at this

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/pyproject.toml

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

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/skills/ipor-deploy-vault/SKILL.md

@@ -127,6 +127,7 @@ from ipor_fusion import (
     PlasmaVault,
     Roles,
     Web3Context,
+    parse_checksum_address,
     parse_fuse_address,
 )
 from ipor_fusion.fuses import AaveV3SupplyFuse
@@ -138,8 +139,8 @@ owner = Account.from_key(OWNER_PRIVATE_KEY).address  # owns, configures and oper
 ctx = Web3Context(w3, chain_id=ChainId(8453), signer=owner, private_key=OWNER_PRIVATE_KEY)
 
 # Generic addresses are ChecksumAddress; fuse addresses carry their role (FuseAddress).
-FACTORY_PROXY = Web3.to_checksum_address("0x1455717668fA96534f675856347A973fA907e922")  # IporFusionFactoryProxy, Base
-USDC = Web3.to_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
+FACTORY_PROXY = parse_checksum_address("0x1455717668fA96534f675856347A973fA907e922")  # IporFusionFactoryProxy, Base
+USDC = parse_checksum_address("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
 SUPPLY_FUSE = parse_fuse_address("0x26fD6EF391E98C78CfCA27e00c3d15be4D941625")  # SupplyFuseAaveV3, Base
 BALANCE_FUSE = parse_fuse_address("0xf53f3EaFfDf67539256365cA7299540A98b60BA9")  # BalanceFuseAaveV3, Base
 

{ipor_fusion-4.1.0.dev14 → ipor_fusion-4.1.0.dev35}/src/ipor_fusion/__init__.py

@@ -387,6 +387,7 @@ from ipor_fusion.types import (
     format_shares,
     parse_access_manager_address,
     parse_amount,
+    parse_checksum_address,
     parse_fuse_address,
     parse_hex_address,
     parse_morpho_market_id,
@@ -709,6 +710,7 @@ __all__ = [
     "FuseAddress",
     "AccessManagerAddress",
     "parse_access_manager_address",
+    "parse_checksum_address",
     "parse_fuse_address",
     "parse_hex_address",
     "parse_plasma_vault_address",