ipor-fusion 4.0.0.dev210__tar.gz → 4.0.0.dev215__tar.gz

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/AGENTS.md

@@ -186,10 +186,14 @@ the lifecycle matrix follows that.
   strings (`field_docs.py` ships as API documentation). Comments only for edge
   cases and non-obvious logic.
 - The public API is `ipor_fusion.__all__` (README, "Public API and stability").
-  Every public symbol is imported and listed there; a symbol of a public
-  subpackage (`core`, `config`, `fuses`, `readers`, `crosschain`,
-  `crosschain.fuses`, `crosschain.ccip`, `crosschain.stargate`) also goes in that
-  subpackage's `__all__`. `ipor_fusion.guide` keeps its own namespace. The
+  Every stable public symbol is imported and listed there; a symbol of a stable
+  subpackage (`core`, `config`, `fuses`, `readers`) also goes in that
+  subpackage's `__all__`. Preview features (`PREVIEW_FEATURES`) export only from
+  their own subpackages, never from the top level: crosschain from `crosschain`
+  (`crosschain.fuses`, `crosschain.ccip`, `crosschain.stargate`), HyperCore from
+  `hypercore` (which re-exports from `fuses/` and `readers/` modules; those
+  subpackages do not list them). Their exceptions stay in `errors` and the top
+  level. `ipor_fusion.guide` keeps its own namespace. The
   public modules (`about`, `cache`, `chains`, `dependency_graph`, `errors`, `explorer`,
   `field_docs`, `market_ids`, `market_info`, `morpho_api`, `substrates`, `types`,
   `validation`, `vault_data`, `vault_info`) stay importable for the names they

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/MIGRATION_4.md

@@ -23,12 +23,16 @@ the details, and each change is described once, in its section.
 Work through these in order; each is what breaks first at run time after the one
 before it is fixed.
 
-1. **Removed and renamed imports fail first, at import.** The crosschain encoders
-   left `ipor_fusion.fuses.crosschain` for `ipor_fusion.crosschain.fuses` (no shim);
-   the event decoder modules `ipor_fusion.fuses.external_state_events` and
-   `ipor_fusion.fuses.hypercore_events` are renamed `external_state_event_decoding`
-   and `hypercore_event_decoding` (import their names from `ipor_fusion` or
-   `ipor_fusion.fuses`); `IporFusionMarkets.RWA`, `MORPHO_BLUE_ADDRESS`, the 3.x cache
+1. **Removed and renamed imports fail first, at import.** The preview features
+   left the top level: crosschain names import from `ipor_fusion.crosschain`,
+   HyperCore names from the new `ipor_fusion.hypercore` (see
+   [Preview features leave the top level](#preview-features-leave-the-top-level));
+   the crosschain encoders left `ipor_fusion.fuses.crosschain` for
+   `ipor_fusion.crosschain.fuses` (no shim); the event decoder modules
+   `ipor_fusion.fuses.external_state_events` and `ipor_fusion.fuses.hypercore_events`
+   are renamed `external_state_event_decoding` and `hypercore_event_decoding` (import
+   the external-state names from `ipor_fusion` or `ipor_fusion.fuses`, the HyperCore
+   ones from `ipor_fusion.hypercore`); `IporFusionMarkets.RWA`, `MORPHO_BLUE_ADDRESS`, the 3.x cache
    functions, `read_erc20_holdings`, `ExternalStateExecutor.mark_nav` and `NavMark`
    are gone. See [Moved, removed and reshaped](#moved-removed-and-reshaped).
 2. **Wrappers are built from an address; execution takes the context.**
@@ -309,14 +313,14 @@ vocabulary `Severity`, `Verdict` and `Check`. Also new: `InFlightLimit` (see
 **Crosschain fuse encoders moved.** The crosschain market encoders moved from
 `ipor_fusion.fuses.crosschain` into the crosschain package, and
 `ipor_fusion.fuses` no longer re-exports them. There is no shim: the old paths
-raise `ImportError`. The top-level names (`from ipor_fusion import ...`) are
-unchanged.
+raise `ImportError`. They are not top-level names either (see the next
+paragraph).
 
 | 3.x import | 4.0 import |
 |---|---|
 | `ipor_fusion.fuses.crosschain` | `ipor_fusion.crosschain.fuses` (or `ipor_fusion.crosschain`) |
 | `ipor_fusion.fuses.crosschain.base`, `.ccip`, `.stargate` | `ipor_fusion.crosschain.fuses` (its submodules `base`, `ccip` and `stargate` exist but are internal) |
-| `from ipor_fusion.fuses import CcipCrosschainSupplyFuse` (and the other crosschain encoders, `SendParams`, `CrosschainSubstrate*`, `crosschain_market_id`) | `from ipor_fusion.crosschain import ...` or `from ipor_fusion import ...` |
+| `from ipor_fusion.fuses import CcipCrosschainSupplyFuse` (and the other crosschain encoders, `SendParams`, `CrosschainSubstrate*`, `crosschain_market_id`) | `from ipor_fusion.crosschain import ...` |
 
 `ipor_fusion.crosschain` now exports the whole crosschain surface: besides the
 codecs and wrappers, the encoders, `CrosschainLane`, `CcipLane`, `StargateLane`,
@@ -325,6 +329,41 @@ the transports and chains, `discover_deployment`, `open_lane(s)`, `LANES` and
 `ipor_fusion.crosschain.ccip` and `.stargate` keep exporting only their codecs
 and wrappers.
 
+#### Preview features leave the top level
+
+Crosschain and HyperCore are preview features (`PREVIEW_FEATURES`): their names
+may change in a minor release, which the top level's major-only removal promise
+could not hold. 4.0 exports them only from their subpackages.
+
+- **Crosschain:** the 124 crosschain names import from `ipor_fusion.crosschain`,
+  or from `crosschain.ccip` / `crosschain.stargate` / `crosschain.fuses` as before.
+  That covers lanes, discovery, transports, encoders, wrappers, codecs and
+  `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
+  `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`,
+  `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
+  `ipor_fusion.types`.
+- **Unchanged:** the exception classes (`HyperCoreEventDecodeError`,
+  `HyperCoreValuationError`, `CrosschainDiscoveryError`,
+  `VerifierResultUnavailable`, ...) stay top-level names of `ipor_fusion.errors`. The `vault info` document's HyperCore TypedDicts
+  (`HyperCoreJson`, ...) stay with the document.
+- **Error registration:** `import ipor_fusion` no longer loads the crosschain
+  package. Import `ipor_fusion.crosschain` to register the crosschain contracts'
+  custom errors for decoding by name.
+
+```python
+from ipor_fusion.crosschain import CcipLane, discover_deployment, open_lanes
+from ipor_fusion.hypercore import HyperCoreDepositFuse, read_hypercore_vault_state
+```
+
 **Fuse base.** `Fuse`, `StakeFuse` and the shared validators and substrate packers
 moved to `ipor_fusion.core.fuse`. Import `Fuse` and `StakeFuse` from `ipor_fusion`
 or `ipor_fusion.fuses`. `ipor_fusion.fuses.base` still re-exports them in 4.0, but
@@ -343,7 +382,8 @@ The internal `ipor_fusion.fuses.base` still re-exports them. The CLI's internal
 from `ipor_fusion.fuses`, hid its submodule of the same name (`import
 ipor_fusion.fuses.hypercore_events as m` bound the function); the external-state
 module was renamed to match. Import the decoders with `from ipor_fusion import
-external_state_events, hypercore_events`; the modules are internal.
+external_state_events` and `from ipor_fusion.hypercore import hypercore_events`;
+the modules are internal.
 
 **Removed.**
 

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev210
+Version: 4.0.0.dev215
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -388,8 +388,7 @@ renaming a name in it, or changing a signature incompatibly, waits for a major
 release; adding one does not.
 
 - **Public subpackages** declare their own `__all__`, each a subset of the top
-  level: `ipor_fusion.core`, `config`, `fuses`, `readers`, `crosschain`,
-  `crosschain.fuses`, `crosschain.ccip` and `crosschain.stargate`. `ipor_fusion.guide`
+  level: `ipor_fusion.core`, `config`, `fuses` and `readers`. `ipor_fusion.guide`
   (the packaged docs) keeps its names in its own namespace.
 - **Public modules** stay importable for the top-level names they define:
   `about`, `cache`, `chains`, `dependency_graph`, `errors`, `explorer`, `field_docs`,
@@ -404,8 +403,12 @@ release; adding one does not.
   the subpackage or `ipor_fusion`), underscore names, and names in no `__all__`.
   They change without notice; the CLI and the MCP server are stable as commands
   and tools, not as Python modules.
-- **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`: crosschain,
-  HyperCore) are exported like the rest but may change in a minor release.
+- **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`) export only
+  from their own subpackages, `ipor_fusion.crosschain` (with `crosschain.fuses`,
+  `crosschain.ccip` and `crosschain.stargate`) and `ipor_fusion.hypercore`, never
+  from the top level, and may change in a minor release. Their exception classes
+  stay in `ipor_fusion.errors`, and the `vault info` document's HyperCore blocks
+  (`HyperCoreJson`, ...) stay with the document.
 - **Third-party types** are not re-exported: import `ChecksumAddress` and
   `HexAddress` from `eth_typing`, and `BlockIdentifier`, `Timestamp` and `TxParams`
   from `web3.types`. The SDK's own types (`ChainId`, `Amount`, `PlasmaVaultAddress`,
@@ -448,14 +451,6 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 | `ExternalStateExecutor` | NAV propose/confirm for off-vault capital (market 50); the executor's thresholds (`staleness_max`, `big_change_bps`, `dust_threshold`, `min_update_interval`), the live aggregate (`get_balance_fuse_snapshot`) and the pre-hook's staleness clock (`get_oldest_update_timestamp`) |
 | `read_external_state`, `ExternalStateVaultState` | The market's vault-scoped state from the vault's ERC-7201 storage at one block: executor, the balance fuse's cached total, the custodian timestamp it last checked and the pause flag the pre-hook enforces (no getter exposes them) |
 | `decode_external_state_event`, `EXTERNAL_STATE_TOPICS` | The ExternalState events the vault emits (big change, cache updates, unpause, rescue, executor creation and deployment, operation enter/exit), decoded by topic with their raw log identity; a malformed listed log raises |
-| `decode_hypercore_event`, `hypercore_events` | **Preview.** The HyperCore fuse, pending-library, settlement and reporter events, decoded by topic with their raw log identity under the same input contract; a malformed listed log raises `HyperCoreEventDecodeError` |
-| `StargateCrosschainExecutor`, `CcipCrosschainExecutor` | **Preview.** Crosschain executor reads and attestation (`propose_balance`, `approve_balance`) |
-| `StargateCrosschainDispatcher`, `CcipCrosschainDispatcher` | Remote dispatcher state (`observation`, tracked idle, command lane) |
-| `StargateCrosschainFactory`, `CcipCrosschainFactory` | Executor creation and route/asset configuration reads |
-| `CrosschainLane`, `open_lane` | One executor/dispatcher pair driven transport-agnostically: supply, recall, command, claim, buckets, attestation (`attestation`, `needs_attestation`, `staleness_max`); `enforces_min_received` identifies real supply floors (CCIP requires zero); `open_lane` detects the transport and finds the fuses |
-| `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 |
 | `erc20_balance_slot`, `VaultSimulator.with_erc20_balance` | Fund any address with any ERC-20 in a simulation by a storage override (slot found by probing), no holder to impersonate |
 | `ERC20` | Token reads and approvals |
 
@@ -475,8 +470,24 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 | Merkl | `MerklClaimWrapperFuse` |
 | Universal | `UniversalTokenSwapperFuse` |
 | Off-vault capital | `AsyncActionFuse` (market 40), `ExternalStateOperationFuse` (market 50) |
-| Crosschain (preview) | `StargateCrosschainSupplyFuse`, `StargateCrosschainCommandFuse`, `CcipCrosschainSupplyFuse`, `CcipCrosschainCommandFuse`, `CrosschainClaimFuse` (market 54); transport-agnostic bases `CrosschainSupplyFuse` / `CrosschainCommandFuse` with `StargateSendParams` / `CcipSendParams`, plus `Command`, `CrosschainSubstrateLib`, `OptionsBuilder` |
-| HyperCore (Hyperliquid, market 55, preview) | `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` |
+
+### Preview features (`ipor_fusion.crosschain`, `ipor_fusion.hypercore`)
+
+Not production (see the note at the top) and outside the stable top level:
+import these from their subpackage, and expect changes in a minor release.
+
+| Name | Purpose |
+|------|---------|
+| `StargateCrosschainExecutor`, `CcipCrosschainExecutor` | Crosschain executor reads and attestation (`propose_balance`, `approve_balance`) |
+| `StargateCrosschainDispatcher`, `CcipCrosschainDispatcher` | Remote dispatcher state (`observation`, tracked idle, command lane) |
+| `StargateCrosschainFactory`, `CcipCrosschainFactory` | Executor creation and route/asset configuration reads |
+| `CrosschainLane`, `open_lane` | One executor/dispatcher pair driven transport-agnostically: supply, recall, command, claim, buckets, attestation (`attestation`, `needs_attestation`, `staleness_max`); `enforces_min_received` identifies real supply floors (CCIP requires zero); `open_lane` detects the transport and finds the fuses |
+| `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` |
+| 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 |
 
 The mainnet crosschain POC vault uses a keccak-derived market ID, not 54. Use
 `crosschain_market_id("IPOR_FUSION_CROSSCHAIN_USDC_POC_V1")` for that deployment;

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/README.md

@@ -340,8 +340,7 @@ renaming a name in it, or changing a signature incompatibly, waits for a major
 release; adding one does not.
 
 - **Public subpackages** declare their own `__all__`, each a subset of the top
-  level: `ipor_fusion.core`, `config`, `fuses`, `readers`, `crosschain`,
-  `crosschain.fuses`, `crosschain.ccip` and `crosschain.stargate`. `ipor_fusion.guide`
+  level: `ipor_fusion.core`, `config`, `fuses` and `readers`. `ipor_fusion.guide`
   (the packaged docs) keeps its names in its own namespace.
 - **Public modules** stay importable for the top-level names they define:
   `about`, `cache`, `chains`, `dependency_graph`, `errors`, `explorer`, `field_docs`,
@@ -356,8 +355,12 @@ release; adding one does not.
   the subpackage or `ipor_fusion`), underscore names, and names in no `__all__`.
   They change without notice; the CLI and the MCP server are stable as commands
   and tools, not as Python modules.
-- **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`: crosschain,
-  HyperCore) are exported like the rest but may change in a minor release.
+- **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`) export only
+  from their own subpackages, `ipor_fusion.crosschain` (with `crosschain.fuses`,
+  `crosschain.ccip` and `crosschain.stargate`) and `ipor_fusion.hypercore`, never
+  from the top level, and may change in a minor release. Their exception classes
+  stay in `ipor_fusion.errors`, and the `vault info` document's HyperCore blocks
+  (`HyperCoreJson`, ...) stay with the document.
 - **Third-party types** are not re-exported: import `ChecksumAddress` and
   `HexAddress` from `eth_typing`, and `BlockIdentifier`, `Timestamp` and `TxParams`
   from `web3.types`. The SDK's own types (`ChainId`, `Amount`, `PlasmaVaultAddress`,
@@ -400,14 +403,6 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 | `ExternalStateExecutor` | NAV propose/confirm for off-vault capital (market 50); the executor's thresholds (`staleness_max`, `big_change_bps`, `dust_threshold`, `min_update_interval`), the live aggregate (`get_balance_fuse_snapshot`) and the pre-hook's staleness clock (`get_oldest_update_timestamp`) |
 | `read_external_state`, `ExternalStateVaultState` | The market's vault-scoped state from the vault's ERC-7201 storage at one block: executor, the balance fuse's cached total, the custodian timestamp it last checked and the pause flag the pre-hook enforces (no getter exposes them) |
 | `decode_external_state_event`, `EXTERNAL_STATE_TOPICS` | The ExternalState events the vault emits (big change, cache updates, unpause, rescue, executor creation and deployment, operation enter/exit), decoded by topic with their raw log identity; a malformed listed log raises |
-| `decode_hypercore_event`, `hypercore_events` | **Preview.** The HyperCore fuse, pending-library, settlement and reporter events, decoded by topic with their raw log identity under the same input contract; a malformed listed log raises `HyperCoreEventDecodeError` |
-| `StargateCrosschainExecutor`, `CcipCrosschainExecutor` | **Preview.** Crosschain executor reads and attestation (`propose_balance`, `approve_balance`) |
-| `StargateCrosschainDispatcher`, `CcipCrosschainDispatcher` | Remote dispatcher state (`observation`, tracked idle, command lane) |
-| `StargateCrosschainFactory`, `CcipCrosschainFactory` | Executor creation and route/asset configuration reads |
-| `CrosschainLane`, `open_lane` | One executor/dispatcher pair driven transport-agnostically: supply, recall, command, claim, buckets, attestation (`attestation`, `needs_attestation`, `staleness_max`); `enforces_min_received` identifies real supply floors (CCIP requires zero); `open_lane` detects the transport and finds the fuses |
-| `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 |
 | `erc20_balance_slot`, `VaultSimulator.with_erc20_balance` | Fund any address with any ERC-20 in a simulation by a storage override (slot found by probing), no holder to impersonate |
 | `ERC20` | Token reads and approvals |
 
@@ -427,8 +422,24 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 | Merkl | `MerklClaimWrapperFuse` |
 | Universal | `UniversalTokenSwapperFuse` |
 | Off-vault capital | `AsyncActionFuse` (market 40), `ExternalStateOperationFuse` (market 50) |
-| Crosschain (preview) | `StargateCrosschainSupplyFuse`, `StargateCrosschainCommandFuse`, `CcipCrosschainSupplyFuse`, `CcipCrosschainCommandFuse`, `CrosschainClaimFuse` (market 54); transport-agnostic bases `CrosschainSupplyFuse` / `CrosschainCommandFuse` with `StargateSendParams` / `CcipSendParams`, plus `Command`, `CrosschainSubstrateLib`, `OptionsBuilder` |
-| HyperCore (Hyperliquid, market 55, preview) | `HyperCoreDepositFuse`, `HyperCoreMarginFuse`, `HyperCoreSendFuse`, `HyperCoreOrderFuse`, `HyperCoreCancelFuse`, `HyperCoreBuilderFeeFuse`, `HyperCoreSubstrates` |
+
+### Preview features (`ipor_fusion.crosschain`, `ipor_fusion.hypercore`)
+
+Not production (see the note at the top) and outside the stable top level:
+import these from their subpackage, and expect changes in a minor release.
+
+| Name | Purpose |
+|------|---------|
+| `StargateCrosschainExecutor`, `CcipCrosschainExecutor` | Crosschain executor reads and attestation (`propose_balance`, `approve_balance`) |
+| `StargateCrosschainDispatcher`, `CcipCrosschainDispatcher` | Remote dispatcher state (`observation`, tracked idle, command lane) |
+| `StargateCrosschainFactory`, `CcipCrosschainFactory` | Executor creation and route/asset configuration reads |
+| `CrosschainLane`, `open_lane` | One executor/dispatcher pair driven transport-agnostically: supply, recall, command, claim, buckets, attestation (`attestation`, `needs_attestation`, `staleness_max`); `enforces_min_received` identifies real supply floors (CCIP requires zero); `open_lane` detects the transport and finds the fuses |
+| `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` |
+| 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 |
 
 The mainnet crosschain POC vault uses a keccak-derived market ID, not 54. Use
 `crosschain_market_id("IPOR_FUSION_CROSSCHAIN_USDC_POC_V1")` for that deployment;

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/examples/composed_hypercore_flow_arbitrum_hyperevm.py

@@ -73,43 +73,45 @@ from web3.types import BlockIdentifier, RPCEndpoint, Timestamp
 
 from ipor_fusion import (
     ERC20,
-    SPOT_DEX,
-    USDC_SYSTEM_ADDRESS,
-    USDC_TOKEN_INDEX,
     AccountOverride,
-    CcipChain,
-    CcipChainSelector,
-    CcipCrosschainExecutor,
-    CcipTransport,
-    Command,
-    CrosschainLane,
-    CrosschainSimulator,
     FuseAction,
-    HyperCoreReader,
-    LaneObservation,
     PlasmaVault,
     SimulationResult,
     SubstrateInfo,
-    TimeInForce,
     VaultSimulator,
     Web3Context,
-    ccip_events,
     decode_custom_error,
     decode_substrate,
     erc20_balance_slot,
-    open_lane,
     parse_fuse_address,
     parse_plasma_vault_address,
-    precompile_index_of,
-    quote_ccip_native_fee,
-    read_hypercore_evm_exit_ceiling,
-    read_hypercore_vault_state,
     register_custom_errors,
 )
-from ipor_fusion.fuses import (
+from ipor_fusion.crosschain import (
+    CcipChain,
+    CcipChainSelector,
+    CcipCrosschainExecutor,
+    CcipTransport,
+    Command,
+    CrosschainLane,
+    CrosschainSimulator,
+    LaneObservation,
+    ccip_events,
+    open_lane,
+    quote_ccip_native_fee,
+)
+from ipor_fusion.hypercore import (
+    SPOT_DEX,
+    USDC_SYSTEM_ADDRESS,
+    USDC_TOKEN_INDEX,
     HyperCoreDepositFuse,
     HyperCoreOrderFuse,
+    HyperCoreReader,
     HyperCoreSendFuse,
+    TimeInForce,
+    precompile_index_of,
+    read_hypercore_evm_exit_ceiling,
+    read_hypercore_vault_state,
 )
 from ipor_fusion.market_ids import IporFusionMarkets
 from ipor_fusion.types import (

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/examples/crosschain_ccip_usdc_arbitrum_hyperevm.py

@@ -45,7 +45,7 @@ executors submit into HyperEVM's 3 M-gas small blocks. Every lifecycle message
 here carries the factory route's 2 M and is executed automatically, but the
 one-time dispatcher deployment ticket carries 6 M and has to be executed by
 anyone through the permissionless ``OffRamp.execute``
-(``ipor_fusion.manual_execution``). The deployment below already has its
+(``ipor_fusion.crosschain.manual_execution``). The deployment below already has its
 dispatcher; the relay delivers every message directly.
 
 Run it (the shell snippets assume a POSIX shell -- bash or zsh):
@@ -70,6 +70,15 @@ from web3.types import Timestamp
 
 from ipor_fusion import (
     ERC20,
+    PlasmaVault,
+    SimulationResult,
+    VaultSimulator,
+    Web3Context,
+    erc20_balance_slot,
+    is_simulate_v1_supported,
+    parse_plasma_vault_address,
+)
+from ipor_fusion.crosschain import (
     CcipChain,
     CcipChainSelector,
     CcipTransport,
@@ -77,14 +86,7 @@ from ipor_fusion import (
     CrosschainLane,
     CrosschainSimulator,
     LaneObservation,
-    PlasmaVault,
-    SimulationResult,
-    VaultSimulator,
-    Web3Context,
-    erc20_balance_slot,
-    is_simulate_v1_supported,
     open_lane,
-    parse_plasma_vault_address,
 )
 from ipor_fusion.market_ids import IporFusionMarkets
 from ipor_fusion.types import Amount, ChainId, Decimals, Period, Shares

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/pyproject.toml

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

{ipor_fusion-4.0.0.dev210 → ipor_fusion-4.0.0.dev215}/scripts/crosschain_readiness.py

@@ -41,8 +41,13 @@ from eth_utils import function_signature_to_4byte_selector, keccak
 from web3 import Web3
 from web3.types import BlockData, LogReceipt, RPCEndpoint
 
-from ipor_fusion import ERC20, Call, Web3Context, ccip_token_lane
-from ipor_fusion.crosschain import CcipCrosschainFactory, CcipOffRamp, CcipRouter
+from ipor_fusion import ERC20, Call, Web3Context
+from ipor_fusion.crosschain import (
+    CcipCrosschainFactory,
+    CcipOffRamp,
+    CcipRouter,
+    ccip_token_lane,
+)
 from ipor_fusion.types import AssetId, CcipChainSelector, ChainId
 
 T = TypeVar("T")