ipor-fusion 4.0.0.dev266__tar.gz → 4.0.0.dev272__tar.gz

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/MIGRATION_4.md

@@ -647,6 +647,7 @@ label values; they do not validate byte widths or address spelling.
 | `MarketId` | an `IporFusionMarkets` member, or `MarketId(n)` |
 | `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)` |
 | `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 |
@@ -686,6 +687,8 @@ converted amounts `Amount`. A custom `VaultState` annotates the same.
 `PlasmaVault.total_supply()`, `balance_of()` and `get_total_supply_cap()` return
 `Shares` (vault shares), and `transfer` / `approve` / `transfer_from` /
 `set_total_supply_cap` take `Shares`; `ERC20` keeps `Amount`.
+`PlasmaVault.setup_markets_limits` takes `Sequence[tuple[MarketId, Wad]]`: each
+limit is a share of total assets, not an asset amount (see Behavior changes).
 `Reconciliation` amounts (`balance_fuses_total`, `underlying_on_vault`,
 `rewards_manager_balance`, `erc20_direct_total`, `sum`, `on_chain_total_assets`, `delta`,
 `pending_withdrawals`, `implied_market_total`, `market_storage_divergence`) are
@@ -1001,6 +1004,17 @@ and `log_index` was passed through as given (a hex string from a raw log); the e
 These apply to every caller, type-checked or not. Changes described in full above
 are listed with a link.
 
+- **`PlasmaVault.setup_markets_limits` takes WAD shares and validates them.** The
+  contract (`AssetDistributionProtectionLib.MarketLimit.limitInPercentage`) reads each
+  limit as the most of the vault's total assets the market may hold, `10**18` being
+  100%; 3.x typed it as an `Amount` and documented it as an asset amount, so a limit
+  set "in asset units" (`1_000_000` for 1 USDC) became a near-zero share that blocks
+  the market once limits are activated. It now takes `Wad` and raises `ValueError`
+  before building the call for a limit outside `0..10**18`: a negative one is no
+  uint256, and above 100% the vault reverts `MarketLimitSetupInPercentageIsTooHigh`. Pass the share: `Wad(6 * 10**17)` for 60%. Check limits
+  set with 3.x with `PlasmaVault.get_market_limit(market).call(ctx)`, which
+  returns the `Wad` share.
+
 - **The CLI and the MCP tools take the same arguments.**
   - **MCP inputs:** the vault tools' `chain_id` and every `block_number` are
     optional and omitted means auto-detected / latest; `market_morpho_blue` and

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev266
+Version: 4.0.0.dev272
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -28,6 +28,7 @@ Classifier: Topic :: Office/Business :: Financial :: Investment
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.11
+Requires-Dist: certifi>=2026.10.19
 Requires-Dist: eth-abi<6,>=5.1.0
 Requires-Dist: eth-account<1,>=0.13
 Requires-Dist: eth-typing<7,>=6.0.0

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ipor-fusion"
-version = "4.0.0.dev266"
+version = "4.0.0.dev272"
 description = "The IPOR Fusion SDK for Python"
 authors = [
     { name = "Adam Mydlarz", email = "amydlarz@gmail.com" },
@@ -31,6 +31,7 @@ classifiers = [
     "Natural Language :: English",
 ]
 dependencies = [
+    "certifi>=2026.10.19",
     "eth-account>=0.13,<1",
     "eth-typing>=6.0.0,<7",
     "eth-abi>=5.1.0,<6",

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/src/ipor_fusion/__init__.py

@@ -334,6 +334,7 @@ from ipor_fusion.types import (
     TokenId,
     TxHash,
     Verdict,
+    Wad,
     format_amount,
     format_shares,
     parse_access_manager_address,
@@ -611,6 +612,7 @@ __all__ = [
     "Liquidity",
     "RoleId",
     "ChainId",
+    "Wad",
     "MorphoBlueMarketId",
     "ProposalHash",
     "TxHash",

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/src/ipor_fusion/core/plasma_vault.py

@@ -30,10 +30,13 @@ from ipor_fusion.types import (
     PlasmaVaultAddress,
     RoleId,
     Shares,
+    Wad,
 )
 
 T = TypeVar("T")
 
+WAD = Wad(10**18)
+
 _BALANCE_FUSE_ADDED_TOPIC = HexBytes(
     Web3.keccak(text="BalanceFuseAdded(uint256,address)")
 )
@@ -358,8 +361,24 @@ class PlasmaVault(ContractWrapper):
             bytes(selector),
         )
 
-    def setup_markets_limits(self, limits: list[tuple[MarketId, Amount]]) -> Call[None]:
-        """ATOMIST-only: set per-market cap in the underlying asset's smallest unit."""
+    def setup_markets_limits(
+        self, limits: Sequence[tuple[MarketId, Wad]]
+    ) -> Call[None]:
+        """Set each market's limit: the most of the vault's total assets the
+        market may hold, as a `Wad` share (``Wad(6 * 10**17)`` is 60%), enforced
+        once `activate_markets_limits` is on (AssetDistributionProtectionLib).
+
+        Raises ``ValueError`` for a limit outside ``0..10**18``: a negative one is
+        no uint256, and the vault reverts ``MarketLimitSetupInPercentageIsTooHigh``
+        above 100%.
+        """
+        for market, limit in limits:
+            if not 0 <= limit <= WAD:
+                raise ValueError(
+                    f"market {market} limit {limit}: expected a WAD share in"
+                    " 0..10**18; above 100% the vault reverts"
+                    " MarketLimitSetupInPercentageIsTooHigh"
+                )
         return self._write("setupMarketsLimits((uint256,uint256)[])", list(limits))
 
     def update_markets_balances(self, market_ids: list[MarketId]) -> Call[None]:
@@ -507,11 +526,12 @@ class PlasmaVault(ContractWrapper):
             "isMarketsLimitsActivated()", output_types=["bool"], decoder=bool
         )
 
-    def get_market_limit(self, market: MarketId) -> Call[int]:
-        """The most of the vault's total assets ``market`` may hold, as a WAD
-        share (``10**18`` is 100%), enforced only while limits are activated."""
+    def get_market_limit(self, market: MarketId) -> Call[Wad]:
+        """The most of the vault's total assets ``market`` may hold, as a `Wad`
+        share (``10**18`` is 100%), enforced only while limits are activated;
+        `setup_markets_limits` sets it."""
         return self._view(
-            "getMarketLimit(uint256)", market, output_types=["uint256"], decoder=int
+            "getMarketLimit(uint256)", market, output_types=["uint256"], decoder=Wad
         )
 
     def activate_markets_limits(self) -> Call[None]:

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/src/ipor_fusion/types.py

@@ -15,6 +15,8 @@ Tick = NewType("Tick", int)
 Liquidity = NewType("Liquidity", int)
 RoleId = NewType("RoleId", int)
 ChainId = NewType("ChainId", int)
+# An 18-decimal fixed-point fraction: 10**18 is 1, i.e. 100% (a market limit).
+Wad = NewType("Wad", int)
 # A Morpho Blue market id (bytes32) in its canonical spelling: "0x" and 64
 # lowercase hex digits, as the Morpho API reports it. Build one with
 # parse_morpho_market_id.

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/tests/test_public_api.py

@@ -73,6 +73,7 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "CacheField",
             "CacheKey",
             "Call",
+            "CallPermission",
             "ChainId",
             "ChainlinkDetailJson",
             "ChangelogEntry",
@@ -80,6 +81,7 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "CloneArgs",
             "CompoundV3Reader",
             "CompoundV3SupplyFuse",
+            "ContextManager",
             "ContractCache",
             "ContractNotFoundError",
             "CrosschainDiscoveryError",
@@ -170,7 +172,6 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "HyperCorePerpMarketJson",
             "HyperCoreSpotLegJson",
             "HyperCoreValuationError",
-            "ContextManager",
             "InFlightLimit",
             "IporFusionError",
             "IporFusionMarkets",
@@ -272,7 +273,6 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "RoleAccountJson",
             "RoleAccountsJson",
             "RoleId",
-            "CallPermission",
             "RoleStatus",
             "Roles",
             "SUPPORTED_CHAIN_IDS",
@@ -333,6 +333,7 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "Verdict",
             "VerifierResultUnavailable",
             "VestingData",
+            "Wad",
             "Web3Context",
             "WithdrawManager",
             "WithdrawManagerData",
@@ -1112,6 +1113,7 @@ _MODULE_PATH_SNAPSHOT: dict[str, frozenset[str]] = {
             "TransferId",
             "TxHash",
             "Verdict",
+            "Wad",
             "ZERO_ADDRESS",
             "format_amount",
             "format_shares",

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/tests/test_simulate_plasma_vault_setters_base.py

@@ -20,6 +20,7 @@ from __future__ import annotations
 
 import logging
 
+import pytest
 from eth_abi import decode as abi_decode
 from eth_utils import function_signature_to_4byte_selector
 from web3 import Web3
@@ -97,7 +98,8 @@ def test_grant_market_substrates_calldata_selector_and_roundtrip():
 
 
 def test_setup_markets_limits_calldata_selector_and_roundtrip():
-    pairs = [(1, 1_000_000_000_000), (2, 500_000_000_000)]
+    # MarketLimit(AAVE_V3_MARKET_ID, 6e17) // 60%, as in the contracts' PlasmaVaultBasic test.
+    pairs = [(1, 6 * 10**17), (2, 10**18), (3, 0)]
     calldata = _bare_vault().setup_markets_limits(pairs).calldata
     assert calldata[:4] == function_signature_to_4byte_selector(
         "setupMarketsLimits((uint256,uint256)[])"
@@ -106,6 +108,12 @@ def test_setup_markets_limits_calldata_selector_and_roundtrip():
     assert [(int(mkt), int(cap)) for mkt, cap in decoded] == pairs
 
 
+@pytest.mark.parametrize("limit", [10**18 + 1, -1])
+def test_setup_markets_limits_rejects_a_limit_outside_a_wad_share(limit):
+    with pytest.raises(ValueError, match="expected a WAD share in 0..10"):
+        _bare_vault().setup_markets_limits([(1, 10**17), (2, limit)])
+
+
 def test_configure_instant_withdrawal_fuses_calldata_selector_and_roundtrip():
     sub1 = b"\x11" * 32
     sub2 = b"\x22" * 32

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/tests/typed_client/consumer.py

@@ -56,6 +56,7 @@ from ipor_fusion import (
     TransactionError,
     VaultInfoJson,
     VaultSimulator,
+    Wad,
     Web3Context,
     build_meta_morpho_json,
     build_morpho_blue_market_json,
@@ -120,6 +121,10 @@ def access(ctx: Web3Context, am: AccessManager, account: ChecksumAddress) -> Non
     am.read_accounts_with_role(ctx, Roles.resolve("ATOMIST"))
 
 
+def market_limits(vault: PlasmaVault) -> None:
+    vault.setup_markets_limits([(IporFusionMarkets.AAVE_V3, Wad(6 * 10**17))])
+
+
 def governance(vault: PlasmaVault) -> None:
     vault.set_minimal_execution_delays_for_roles(
         [(Roles.ALPHA_ROLE, Period.HOUR), (RoleId(100), Period(0))]

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/tests/typed_client/rejected.py

@@ -14,6 +14,7 @@ from ipor_fusion import (
     ChainId,
     ExternalStateEvent,
     ExternalStateExecutor,
+    MarketId,
     MorphoBlueMarketJson,
     Multicall3,
     PlasmaVault,
@@ -74,6 +75,8 @@ def roles_do_not_mix(ctx: Web3Context, vault: PlasmaVaultAddress) -> None:
     pv = PlasmaVault(vault)
     pv.configure_instant_withdrawal_fuses([(pv.address, [])])  # pyright: ignore[reportArgumentType]
     HyperCorePendingReader(pv, pv.address)  # pyright: ignore[reportArgumentType]
+    # A market limit is a WAD share of total assets, not an asset amount.
+    pv.setup_markets_limits([(MarketId(1), Amount(10**6))])  # pyright: ignore[reportArgumentType]
 
 
 def selectors_are_not_chain_ids(factory: CcipCrosschainFactory) -> None:

{ipor_fusion-4.0.0.dev266 → ipor_fusion-4.0.0.dev272}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 5
+revision = 3
 requires-python = ">=3.11"
 resolution-markers = [
     "python_full_version >= '3.14' and sys_platform == 'win32'",
@@ -263,11 +263,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2026.5.20"
+version = "2026.10.19"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/f3/ce/ee2ecad540810a79593028e88299baeae54d346cc7a0d94b6199988b89b1/certifi-2026.5.20.tar.gz", hash = "sha256:69dea482ab64caa7b9f6aba1c6bf48bb6a5448d1c0f1b17ab42ad8c763a5344d", size = 135422, upload-time = "2026-05-20T11:46:50.073Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a6/bd/1436c50cc46699de0230fbaacc1d1de7bfec413176099949e9d5112e88f2/certifi-2026.10.19.tar.gz", hash = "sha256:035c1e85572b141bf1c3a3eff0e33a8eb74917522f2559075ff8d2fea780a1ae", size = 137598, upload-time = "2026-10-20T02:24:16.604Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/51/29046e48f693c54e5b7412216d447a1d8362c9653148d98c02cdf65fa733/certifi-2026.10.19-py3-none-any.whl", hash = "sha256:42d35340cc5b9ba78e818ddbff0c5b1c2b779de448a340fd1b989f5fa8670e1b", size = 136464, upload-time = "2026-10-20T02:24:15.072Z" },
 ]
 
 [[package]]
@@ -1111,6 +1111,7 @@ name = "ipor-fusion"
 version = "3.16.0"
 source = { editable = "." }
 dependencies = [
+    { name = "certifi" },
     { name = "eth-abi" },
     { name = "eth-account" },
     { name = "eth-typing" },
@@ -1145,6 +1146,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
+    { name = "certifi", specifier = ">=2026.10.19" },
     { name = "click", marker = "extra == 'cli'", specifier = ">=8.0,<9" },
     { name = "click", marker = "extra == 'mcp'", specifier = ">=8.0,<9" },
     { name = "eth-abi", specifier = ">=5.1.0,<6" },