ipor-fusion 4.0.0.dev255__tar.gz → 4.0.0.dev263__tar.gz

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/AGENTS.md

@@ -419,7 +419,9 @@ or examples.
   round re-resolves it. Labels only name calls in `result.calls` and failures.
   Integration tests and examples use it instead of a local node.
 - Amounts are raw on-chain integers; `types.py` `NewType`s (`Amount`, `Shares`,
-  `MarketId`, ...) name the unit, and nothing scales by decimals.
+  `MarketId`, ...) name the unit, and nothing scales by decimals except the exact
+  boundary converters `parse_amount` / `format_amount` (and the `*_shares` pair):
+  decimal text in, raw integer out, no float ever.
 - Three address roles are nominal: `PlasmaVaultAddress`, `FuseAddress` and
   `AccessManagerAddress` (NewTypes of `ChecksumAddress`). Their wrappers, getters and
   records return them, so a vault, a fuse and an access manager cannot be passed for

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev255
+Version: 4.0.0.dev263
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -170,7 +170,10 @@ Fuse, factory and manager addresses per chain are published in
 [ipor-abi](https://github.com/IPOR-Labs/ipor-abi) (`mainnet/mainnet-<chain>-fusion/addresses.json`).
 A fuse must also be registered on the vault; `vault.get_fuses().call(ctx)` lists the registered ones.
 
-Amounts are raw on-chain integers (`Amount`, `Shares` in `ipor_fusion.types`); the SDK never scales by decimals.
+Amounts are raw on-chain integers (`Amount`, `Shares` in `ipor_fusion.types`); the SDK scales by decimals
+only in explicit boundary converters.
+`parse_amount("1.5", Decimals(6))` and `format_amount(Amount(1_500_000), Decimals(6))` convert exactly at the
+boundary (no floats, no rounding; `parse_shares` / `format_shares` for shares at the share token's decimals).
 
 ### Read, send, or simulate
 

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/README.md

@@ -122,7 +122,10 @@ Fuse, factory and manager addresses per chain are published in
 [ipor-abi](https://github.com/IPOR-Labs/ipor-abi) (`mainnet/mainnet-<chain>-fusion/addresses.json`).
 A fuse must also be registered on the vault; `vault.get_fuses().call(ctx)` lists the registered ones.
 
-Amounts are raw on-chain integers (`Amount`, `Shares` in `ipor_fusion.types`); the SDK never scales by decimals.
+Amounts are raw on-chain integers (`Amount`, `Shares` in `ipor_fusion.types`); the SDK scales by decimals
+only in explicit boundary converters.
+`parse_amount("1.5", Decimals(6))` and `format_amount(Amount(1_500_000), Decimals(6))` convert exactly at the
+boundary (no floats, no rounding; `parse_shares` / `format_shares` for shares at the share token's decimals).
 
 ### Read, send, or simulate
 

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/pyproject.toml

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

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/skills/ipor-deploy-vault/SKILL.md

@@ -204,22 +204,32 @@ Notes on the walk:
 so you recognise and avoid it. Verify against `ipor-abi` before use; the
 registry is the source of truth and is regenerated on release.
 
-| Chain | Chain id | `IporFusionFactoryProxy` (use) | `IporFusionFactoryImpl` (reverts) | Verified |
-|---|---|---|---|---|
-| Ethereum | 1 | `0xcd05909C4A1F8E501e4ED554cEF4Ed5E48D9b852` | `0xf19C1E9f6616F6056AF1e322A86fDaAaAf0263f5` | implementation slot |
-| Unichain | 130 | `0xC9b4E839e86284C558791C13Bda97999fc49aF63` | `0xf5Bc40C192D51ED93ADD6557884766772FA72589` | implementation slot |
-| TAC | 239 | `0x26b5561E2E0e7d7977431E92740903Ef3cB7194b` | `0x7DDd0bBB59eFB4b7791cE5E1Cf1587F083aE4Ef5` | implementation slot |
-| Botanix | 3637 | `0x7c9857f22D0cc6523C8e88BFDCbf411AB8300fF5` | `0xddb0EFB2a7a5C02e01b5A1f85C0a1110d68EeC26` | registry only |
-| Base | 8453 | `0x1455717668fA96534f675856347A973fA907e922` | `0x610152A79BE7F2Aa3aA70520c9331c18fe8D33b7` | clone executed on a fork |
-| Plasma | 9745 | `0x70d41759FBF90fB63c88197217cB08F93a1c65CB` | `0x3A42bD6fEa94421025Ae2ed01CE6f137ac785abD` | implementation slot |
-| Arbitrum | 42161 | `0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5` | `0x87f94ac9aF79261F0BC73582114f805F55Cd0b25` | clone executed on a fork |
-| Avalanche | 43114 | `0xa00b6379833D77fA9C9497b32dae00dF39Ac751e` | `0x399596cFccFEbBb60f8652bece8586a6Bb4199ab` | implementation slot |
-| Ink | 57073 | `0xEC53f69Bd1D991a2F99e96DE66E81D0E42A61D8D` | `0xe7372BC46b79e0c87AfE5286c41c20687018E425` | implementation slot |
-| Katana | 747474 | `0xc29b8D591d6a3f109Ca7ba384F2e00162866D37B` | `0x4a4De6e86AD0d0546F55B595cA75f55803D940bA` | registry only |
-
-"Implementation slot" means the proxy's EIP-1967 implementation slot was read
-and matches the registry's `IporFusionFactoryImpl`; "registry only" means the
-pair was taken from `ipor-abi` without an on-chain read.
+| Chain | Chain id | `IporFusionFactoryProxy` (use) | `IporFusionFactoryImpl` (reverts) | Vault tooling | Verified |
+|---|---|---|---|---|---|
+| Ethereum | 1 | `0xcd05909C4A1F8E501e4ED554cEF4Ed5E48D9b852` | `0x14d120C365Debd920eaDf0a7AC31e659Bc58217b` | validated | implementation slot |
+| Flare | 14 | `0xE75F3565D67645775351A9886F2b598f07d1860B` | `0x6C1ff6eBf5e92Dbc5591E7cCF455829De9C46579` | factory only | implementation slot |
+| Unichain | 130 | `0xC9b4E839e86284C558791C13Bda97999fc49aF63` | `0x73c7CA802403BB21e9608C937c556C04d5eeBAD6` | validated | implementation slot |
+| Monad | 143 | `0x62DFfe8bCaaf7960f858a4f7dDC83cc98F04cEDC` | `0x1017f0032460B3c8FBB92Bfd350F708Ff6229137` | validated | implementation slot |
+| TAC | 239 | `0x26b5561E2E0e7d7977431E92740903Ef3cB7194b` | `0x7DDd0bBB59eFB4b7791cE5E1Cf1587F083aE4Ef5` | factory only | implementation slot |
+| HyperEVM | 999 | `0x6bBc827F34b4e862d15215ABd4AC0E3886181665` | `0x010430cbdE2Bb8ACC48D7aDfbEb99812E83f1156` | validated | implementation slot |
+| Botanix | 3637 | `0x7c9857f22D0cc6523C8e88BFDCbf411AB8300fF5` | `0xddb0EFB2a7a5C02e01b5A1f85C0a1110d68EeC26` | factory only | registry only |
+| Robinhood | 4663 | `0xDF7A590b60072476E355A8EfF33e4872440bDc7C` | `0x9d897beA78F8747d8f9C45d5734089ca7225AE90` | validated | implementation slot |
+| Base | 8453 | `0x1455717668fA96534f675856347A973fA907e922` | `0x378fEb2E96082FB965E2BB922AEE484d07c14014` | validated | implementation slot |
+| Plasma | 9745 | `0x70d41759FBF90fB63c88197217cB08F93a1c65CB` | `0x346DA190c60d6101B77DA613a252c7aE25A7a120` | validated | implementation slot |
+| Arbitrum | 42161 | `0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5` | `0x86C8Ea8800EB6bc8C846c3e0230178520a0ED721` | validated | implementation slot |
+| Avalanche | 43114 | `0xa00b6379833D77fA9C9497b32dae00dF39Ac751e` | `0x0f358Bb3d14AB911dBfAF4d9061097e7F5Cf123F` | validated | implementation slot |
+| Ink | 57073 | `0xEC53f69Bd1D991a2F99e96DE66E81D0E42A61D8D` | `0xEF774B9767cC9FC813A2b595BE870A13D5B367C0` | validated | implementation slot |
+| Katana | 747474 | `0xc29b8D591d6a3f109Ca7ba384F2e00162866D37B` | `0x4a4De6e86AD0d0546F55B595cA75f55803D940bA` | validated | implementation slot |
+
+A deployed factory is not the same as supported tooling. "Validated" chains are
+`SUPPORTED_CHAIN_IDS` (`ipor_fusion.chains`): `fusion vault info`/`validate`
+and `fetch_vault_data` run there. On a "factory only" chain `clone()` works,
+but the vault tooling raises `UnsupportedChainError` until the chain is
+validated. "Implementation slot" means the proxy's EIP-1967 implementation
+slot was read on chain and matches the registry's `IporFusionFactoryImpl`;
+"registry only" means the pair comes from `ipor-abi` without an on-chain read.
+The factory implementations are upgraded in place, so the implementation
+column changes with releases while the proxy stays.
 
 Fuse addresses are not in the SDK. Resolve them by registry name and chain
 in `ipor-abi` (`SupplyFuseAaveV3`, `BalanceFuseAaveV3`, ...), or with the

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/src/ipor_fusion/__init__.py

@@ -333,11 +333,15 @@ from ipor_fusion.types import (
     TokenId,
     TxHash,
     Verdict,
+    format_amount,
+    format_shares,
     parse_access_manager_address,
+    parse_amount,
     parse_fuse_address,
     parse_hex_address,
     parse_morpho_market_id,
     parse_plasma_vault_address,
+    parse_shares,
     parse_tx_hash,
 )
 from ipor_fusion.validation import (
@@ -617,6 +621,10 @@ __all__ = [
     "parse_plasma_vault_address",
     "parse_morpho_market_id",
     "parse_tx_hash",
+    "parse_amount",
+    "parse_shares",
+    "format_amount",
+    "format_shares",
     "Price",
     "Period",
     "MAX_UINT256",

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/src/ipor_fusion/core/fusion_factory.py

@@ -1,16 +1,16 @@
 """IporFusionFactoryProxy wrapper — deploys a full Fusion vault stack
 (plasmaVault + accessManager + 6 managers) in a single tx.
 
-Deployed signature on BASE (verified 2026-05-12 against impl bytecode):
+Deployed signature on BASE (verified against the impl bytecode on 2026-05-12,
+and on 2026-10-23 for the upgraded impl 0x378fEb2E96082FB965E2BB922AEE484d07c14014):
   clone(string assetName_, string assetSymbol_, address underlyingToken_,
         uint256 redemptionDelayInSeconds_, address owner_,
         uint256 daoFeePackageIndex_) → FusionInstance
 
-Note: the ipor-abi registry publishes a 5-arg shape (no daoFeePackageIndex);
-that's stale — the deployed factory impl at
-0x610152a79be7f2aa3aa70520c9331c18fe8d33b7 only exposes the 6-arg variant
-(selector 0x8697b10a). Always trust the impl bytecode over the registry
-when they disagree.
+Note: the ipor-abi registry has published a 5-arg shape (no
+daoFeePackageIndex); both the earlier impl 0x610152a79be7f2aa3aa70520c9331c18fe8d33b7
+and the current one expose only the 6-arg variant (selector 0x8697b10a). Always
+trust the impl bytecode over the registry when they disagree.
 
 `clone()` is a write — call `.send(ctx)` for a real tx, then decode the
 created addresses from its receipt with `factory.decode_clone_receipt(receipt)`.

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/src/ipor_fusion/guide/quickstart.md

@@ -119,22 +119,32 @@ Notes on the walk:
 so you recognise and avoid it. Verify against `ipor-abi` before use; the
 registry is the source of truth and is regenerated on release.
 
-| Chain | Chain id | `IporFusionFactoryProxy` (use) | `IporFusionFactoryImpl` (reverts) | Verified |
-|---|---|---|---|---|
-| Ethereum | 1 | `0xcd05909C4A1F8E501e4ED554cEF4Ed5E48D9b852` | `0xf19C1E9f6616F6056AF1e322A86fDaAaAf0263f5` | implementation slot |
-| Unichain | 130 | `0xC9b4E839e86284C558791C13Bda97999fc49aF63` | `0xf5Bc40C192D51ED93ADD6557884766772FA72589` | implementation slot |
-| TAC | 239 | `0x26b5561E2E0e7d7977431E92740903Ef3cB7194b` | `0x7DDd0bBB59eFB4b7791cE5E1Cf1587F083aE4Ef5` | implementation slot |
-| Botanix | 3637 | `0x7c9857f22D0cc6523C8e88BFDCbf411AB8300fF5` | `0xddb0EFB2a7a5C02e01b5A1f85C0a1110d68EeC26` | registry only |
-| Base | 8453 | `0x1455717668fA96534f675856347A973fA907e922` | `0x610152A79BE7F2Aa3aA70520c9331c18fe8D33b7` | clone executed on a fork |
-| Plasma | 9745 | `0x70d41759FBF90fB63c88197217cB08F93a1c65CB` | `0x3A42bD6fEa94421025Ae2ed01CE6f137ac785abD` | implementation slot |
-| Arbitrum | 42161 | `0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5` | `0x87f94ac9aF79261F0BC73582114f805F55Cd0b25` | clone executed on a fork |
-| Avalanche | 43114 | `0xa00b6379833D77fA9C9497b32dae00dF39Ac751e` | `0x399596cFccFEbBb60f8652bece8586a6Bb4199ab` | implementation slot |
-| Ink | 57073 | `0xEC53f69Bd1D991a2F99e96DE66E81D0E42A61D8D` | `0xe7372BC46b79e0c87AfE5286c41c20687018E425` | implementation slot |
-| Katana | 747474 | `0xc29b8D591d6a3f109Ca7ba384F2e00162866D37B` | `0x4a4De6e86AD0d0546F55B595cA75f55803D940bA` | registry only |
-
-"Implementation slot" means the proxy's EIP-1967 implementation slot was read
-and matches the registry's `IporFusionFactoryImpl`; "registry only" means the
-pair was taken from `ipor-abi` without an on-chain read.
+| Chain | Chain id | `IporFusionFactoryProxy` (use) | `IporFusionFactoryImpl` (reverts) | Vault tooling | Verified |
+|---|---|---|---|---|---|
+| Ethereum | 1 | `0xcd05909C4A1F8E501e4ED554cEF4Ed5E48D9b852` | `0x14d120C365Debd920eaDf0a7AC31e659Bc58217b` | validated | implementation slot |
+| Flare | 14 | `0xE75F3565D67645775351A9886F2b598f07d1860B` | `0x6C1ff6eBf5e92Dbc5591E7cCF455829De9C46579` | factory only | implementation slot |
+| Unichain | 130 | `0xC9b4E839e86284C558791C13Bda97999fc49aF63` | `0x73c7CA802403BB21e9608C937c556C04d5eeBAD6` | validated | implementation slot |
+| Monad | 143 | `0x62DFfe8bCaaf7960f858a4f7dDC83cc98F04cEDC` | `0x1017f0032460B3c8FBB92Bfd350F708Ff6229137` | validated | implementation slot |
+| TAC | 239 | `0x26b5561E2E0e7d7977431E92740903Ef3cB7194b` | `0x7DDd0bBB59eFB4b7791cE5E1Cf1587F083aE4Ef5` | factory only | implementation slot |
+| HyperEVM | 999 | `0x6bBc827F34b4e862d15215ABd4AC0E3886181665` | `0x010430cbdE2Bb8ACC48D7aDfbEb99812E83f1156` | validated | implementation slot |
+| Botanix | 3637 | `0x7c9857f22D0cc6523C8e88BFDCbf411AB8300fF5` | `0xddb0EFB2a7a5C02e01b5A1f85C0a1110d68EeC26` | factory only | registry only |
+| Robinhood | 4663 | `0xDF7A590b60072476E355A8EfF33e4872440bDc7C` | `0x9d897beA78F8747d8f9C45d5734089ca7225AE90` | validated | implementation slot |
+| Base | 8453 | `0x1455717668fA96534f675856347A973fA907e922` | `0x378fEb2E96082FB965E2BB922AEE484d07c14014` | validated | implementation slot |
+| Plasma | 9745 | `0x70d41759FBF90fB63c88197217cB08F93a1c65CB` | `0x346DA190c60d6101B77DA613a252c7aE25A7a120` | validated | implementation slot |
+| Arbitrum | 42161 | `0x134fCAce7a2C7Ef3dF2479B62f03ddabAEa922d5` | `0x86C8Ea8800EB6bc8C846c3e0230178520a0ED721` | validated | implementation slot |
+| Avalanche | 43114 | `0xa00b6379833D77fA9C9497b32dae00dF39Ac751e` | `0x0f358Bb3d14AB911dBfAF4d9061097e7F5Cf123F` | validated | implementation slot |
+| Ink | 57073 | `0xEC53f69Bd1D991a2F99e96DE66E81D0E42A61D8D` | `0xEF774B9767cC9FC813A2b595BE870A13D5B367C0` | validated | implementation slot |
+| Katana | 747474 | `0xc29b8D591d6a3f109Ca7ba384F2e00162866D37B` | `0x4a4De6e86AD0d0546F55B595cA75f55803D940bA` | validated | implementation slot |
+
+A deployed factory is not the same as supported tooling. "Validated" chains are
+`SUPPORTED_CHAIN_IDS` (`ipor_fusion.chains`): `fusion vault info`/`validate`
+and `fetch_vault_data` run there. On a "factory only" chain `clone()` works,
+but the vault tooling raises `UnsupportedChainError` until the chain is
+validated. "Implementation slot" means the proxy's EIP-1967 implementation
+slot was read on chain and matches the registry's `IporFusionFactoryImpl`;
+"registry only" means the pair comes from `ipor-abi` without an on-chain read.
+The factory implementations are upgraded in place, so the implementation
+column changes with releases while the proxy stays.
 
 Fuse addresses are not in the SDK. Resolve them by registry name and chain
 in `ipor-abi` (`SupplyFuseAaveV3`, `BalanceFuseAaveV3`, ...), or with the

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/src/ipor_fusion/types.py

@@ -1,3 +1,4 @@
+import re
 from dataclasses import dataclass
 from typing import ClassVar, Literal, NewType, TypeAlias
 
@@ -196,3 +197,81 @@ def parse_fuse_address(value: str | bytes) -> FuseAddress:
 def parse_access_manager_address(value: str | bytes) -> AccessManagerAddress:
     """An access manager's address, checksummed; see `parse_plasma_vault_address`."""
     return AccessManagerAddress(_checksum(value))
+
+
+# ASCII digits only: ``\d`` would also take other scripts' digits, which int() reads.
+_DECIMAL_TEXT = re.compile(r"([0-9]*)(?:\.([0-9]*))?")
+
+
+_UINT256_DIGITS = len(str(MAX_UINT256))
+
+
+def _check_decimals(decimals: Decimals) -> None:
+    if not 0 <= decimals <= 255:
+        raise ValueError(f"decimals must be 0..255 (ERC-20 uint8), got {decimals}")
+
+
+def _parse_units(text: str, decimals: Decimals, what: str) -> int:
+    if not isinstance(text, str):
+        raise TypeError(
+            f"{what} must be text, not {type(text).__name__}: floats lose precision"
+        )
+    _check_decimals(decimals)
+    match = _DECIMAL_TEXT.fullmatch(text.strip())
+    if match is None or not (match.group(1) or match.group(2)):
+        raise ValueError(f"not a decimal {what}: {text!r}")
+    whole, fraction = match.group(1).lstrip("0"), match.group(2) or ""
+    if len(fraction) > decimals:
+        raise ValueError(
+            f"{what} {text!r} has {len(fraction)} fractional digits,"
+            f" more than the {decimals} the token carries"
+        )
+    # Bounded before int(): a longer whole part overflows uint256 at any scale.
+    if len(whole) > _UINT256_DIGITS:
+        raise ValueError(f"{what} {text!r} exceeds uint256")
+    value = int(whole + fraction.ljust(decimals, "0") or "0")
+    if value > MAX_UINT256:
+        raise ValueError(f"{what} {text!r} exceeds uint256")
+    return value
+
+
+def _format_units(value: int, decimals: Decimals, what: str) -> str:
+    if not 0 <= value <= MAX_UINT256:
+        raise ValueError(f"{what} must be within uint256, got {value}")
+    _check_decimals(decimals)
+    whole, fraction = divmod(value, 10**decimals)
+    if fraction == 0:
+        return str(whole)
+    return f"{whole}.{str(fraction).zfill(decimals).rstrip('0')}"
+
+
+def parse_amount(text: str, decimals: Decimals) -> Amount:
+    """The raw `Amount` of ``text`` token units at ``decimals``, exactly:
+    ``parse_amount("1.5", Decimals(6))`` is ``Amount(1_500_000)``.
+
+    ``text`` is digits with at most one ``.`` (surrounding whitespace ignored);
+    no sign, exponent or separators. ``decimals`` is 0..255, an ERC-20 uint8.
+    Raises ``ValueError`` for anything else, for more fractional digits than
+    ``decimals`` (nothing is rounded) and for a value above uint256; ``TypeError`` for a non-string, so a float is never
+    accepted. Inverse of `format_amount`.
+    """
+    return Amount(_parse_units(text, decimals, "amount"))
+
+
+def parse_shares(text: str, decimals: Decimals) -> Shares:
+    """`parse_amount` for vault shares at the share token's ``decimals``
+    (`PlasmaVault.decimals`, not the asset's)."""
+    return Shares(_parse_units(text, decimals, "shares"))
+
+
+def format_amount(amount: Amount, decimals: Decimals) -> str:
+    """``amount`` in token units as exact decimal text, no trailing zeros:
+    ``format_amount(Amount(1_500_000), Decimals(6))`` is ``"1.5"``; a whole
+    number has no ``.``. Raises ``ValueError`` on an amount outside uint256 or
+    ``decimals`` outside 0..255. Inverse of `parse_amount`."""
+    return _format_units(amount, decimals, "amount")
+
+
+def format_shares(shares: Shares, decimals: Decimals) -> str:
+    """`format_amount` for vault shares."""
+    return _format_units(shares, decimals, "shares")

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/tests/test_guide.py

@@ -10,7 +10,14 @@ from _euler_v2 import BASE_FUSION_FACTORY
 from _guide import GUIDE_ADDRESSES
 from addresses import BASE_USDC
 
-from ipor_fusion import ERC20, AccessManager, Call, PlasmaVault
+from ipor_fusion import (
+    CHAIN_NAMES,
+    ERC20,
+    SUPPORTED_CHAIN_IDS,
+    AccessManager,
+    Call,
+    PlasmaVault,
+)
 from ipor_fusion.core import FusionFactory
 from ipor_fusion.fuses import AaveV3SupplyFuse
 from ipor_fusion.guide import (
@@ -21,6 +28,7 @@ from ipor_fusion.guide import (
     RESOURCES,
     guide_text,
 )
+from ipor_fusion.types import ChainId
 
 REPO_ROOT = Path(__file__).resolve().parents[1]
 SKILL_DIR = REPO_ROOT / "skills" / "ipor-deploy-vault"
@@ -49,6 +57,28 @@ PUBLIC_REPOS = {
 _URL = re.compile(r"https?://([A-Za-z0-9.-]+)(?::\d+)?(/[^\s)`>\"']*)?")
 _FRONTMATTER = re.compile(r"\A---\n(.*?)\n---\n", re.DOTALL)
 _PY_BLOCK = re.compile(r"```python\n(.*?)```", re.DOTALL)
+# Chains with an IporFusionFactoryProxy in ipor-abi (mainnet-<chain>-fusion).
+FACTORY_CHAINS = {
+    1,
+    14,
+    130,
+    143,
+    239,
+    999,
+    3637,
+    4663,
+    8453,
+    9745,
+    42161,
+    43114,
+    57073,
+    747474,
+}
+_FACTORY_ROW = re.compile(
+    r"^\| (\w+) \| (\d+) \| `(0x[0-9a-fA-F]{40})` \| `(0x[0-9a-fA-F]{40})` \| "
+    r"(validated|factory only) \| (implementation slot|registry only) \|$",
+    re.MULTILINE,
+)
 
 
 def _public_texts() -> dict[str, str]:
@@ -89,6 +119,23 @@ class TestResources:
         assert GUIDE_ADDRESSES["USDC"] == BASE_USDC
         assert {"SUPPLY_FUSE", "BALANCE_FUSE"} <= set(GUIDE_ADDRESSES)
 
+    def test_factory_table_tooling_column_is_the_supported_chain_set(self):
+        section = QUICKSTART.text.split("## Factory proxies per chain", 1)[1]
+        body = [
+            line
+            for line in section.splitlines()
+            if line.startswith("| ") and not line.startswith("| Chain |")
+        ]
+        rows = _FACTORY_ROW.findall("\n".join(body))
+        assert len(rows) == len(body), "every table row parses"
+        assert {int(row[1]) for row in rows} == FACTORY_CHAINS
+        ids = [int(row[1]) for row in rows]
+        assert ids == sorted(set(ids)), "one row per chain, by chain id"
+        for name, chain_id, *_ in rows:
+            assert CHAIN_NAMES[ChainId(int(chain_id))] == name.lower()
+        validated = {int(row[1]) for row in rows if row[4] == "validated"}
+        assert validated == set(SUPPORTED_CHAIN_IDS)
+
     def test_invariants_name_every_deploy_path_revert(self):
         text = INVARIANTS.text
         for selector, name in [

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/tests/test_public_api.py

@@ -367,7 +367,9 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "find_creation_block",
             "find_markets_missing_erc20_dependency",
             "find_orphan_fuse_markets",
+            "format_amount",
             "format_market_label",
+            "format_shares",
             "get_contract_name",
             "get_deployment_tx",
             "get_logs_adaptive",
@@ -377,10 +379,12 @@ _ALL_SNAPSHOT: dict[str, frozenset[str]] = {
             "morpho_blue_address",
             "package_version",
             "parse_access_manager_address",
+            "parse_amount",
             "parse_fuse_address",
             "parse_hex_address",
             "parse_morpho_market_id",
             "parse_plasma_vault_address",
+            "parse_shares",
             "parse_tx_hash",
             "price_oracle_middleware",
             "read_changelog",
@@ -1107,11 +1111,15 @@ _MODULE_PATH_SNAPSHOT: dict[str, frozenset[str]] = {
             "TxHash",
             "Verdict",
             "ZERO_ADDRESS",
+            "format_amount",
+            "format_shares",
             "parse_access_manager_address",
+            "parse_amount",
             "parse_fuse_address",
             "parse_hex_address",
             "parse_morpho_market_id",
             "parse_plasma_vault_address",
+            "parse_shares",
             "parse_tx_hash",
         }
     ),

{ipor_fusion-4.0.0.dev255 → ipor_fusion-4.0.0.dev263}/tests/test_types_and_events.py

@@ -6,7 +6,7 @@ from hexbytes import HexBytes
 from web3 import Web3
 
 from ipor_fusion.fuses.events import extract_events
-from ipor_fusion.types import Amount, Decimals, Price
+from ipor_fusion.types import MAX_UINT256, Amount, Decimals, Price, Shares
 
 ADDR = Web3.to_checksum_address("0x1111111111111111111111111111111111111111")
 
@@ -155,3 +155,119 @@ class TestRoleParsers:
         assert parser(bytes.fromhex(self.LOWER[2:])) == checksum
         with pytest.raises(ValueError):
             parser("0x1234")
+
+
+class TestAmountText:
+    @pytest.mark.parametrize(
+        ("text", "decimals", "raw"),
+        [
+            ("1.5", 6, 1_500_000),
+            ("0.000001", 6, 1),
+            ("1", 18, 10**18),
+            ("1.", 6, 1_000_000),
+            (".5", 6, 500_000),
+            (" 42 ", 0, 42),
+            ("0", 6, 0),
+            ("1.000000", 6, 1_000_000),
+            (str(MAX_UINT256), 0, MAX_UINT256),
+            (
+                "115792089237316195423570985008687907853269984665640564039457.584007913129639935",
+                18,
+                MAX_UINT256,
+            ),
+        ],
+    )
+    def test_parse_amount_is_exact(self, text, decimals, raw):
+        from ipor_fusion import parse_amount
+
+        assert parse_amount(text, Decimals(decimals)) == raw
+
+    @pytest.mark.parametrize(
+        "text",
+        [
+            "",
+            ".",
+            "-1",
+            "+1",
+            "1e6",
+            "1,000",
+            "1_000",
+            "1.5.0",
+            "0x10",
+            "1 0",
+            "nan",
+            "\u0663",
+            "\uff11.5",
+        ],
+    )
+    def test_parse_amount_rejects_anything_but_plain_decimal_text(self, text):
+        from ipor_fusion import parse_amount
+
+        with pytest.raises(ValueError, match="not a decimal amount"):
+            parse_amount(text, Decimals(6))
+
+    def test_parse_amount_never_rounds(self):
+        from ipor_fusion import parse_amount
+
+        with pytest.raises(ValueError, match="7 fractional digits"):
+            parse_amount("1.0000001", Decimals(6))
+
+    def test_parse_amount_rejects_uint256_overflow_and_floats(self):
+        from ipor_fusion import parse_amount
+
+        with pytest.raises(ValueError, match="exceeds uint256"):
+            parse_amount(str(MAX_UINT256 + 1), Decimals(0))
+        with pytest.raises(TypeError, match="floats lose precision"):
+            parse_amount(1.5, Decimals(6))
+        with pytest.raises(ValueError, match="decimals"):
+            parse_amount("1", Decimals(-1))
+        with pytest.raises(ValueError, match="0..255"):
+            parse_amount("1", Decimals(256))
+
+    def test_parse_amount_bounds_digits_before_converting(self):
+        from ipor_fusion import parse_amount
+
+        # Leading zeros are not significant, past Python's int() digit limit too.
+        assert parse_amount("0" * 5000 + "1", Decimals(0)) == 1
+        with pytest.raises(ValueError, match="exceeds uint256"):
+            parse_amount("1" * 5000, Decimals(0))
+        assert parse_amount("0." + "0" * 254 + "1", Decimals(255)) == 1
+
+    @pytest.mark.parametrize(
+        ("raw", "decimals", "text"),
+        [
+            (1_500_000, 6, "1.5"),
+            (1, 6, "0.000001"),
+            (10**18, 18, "1"),
+            (0, 6, "0"),
+            (42, 0, "42"),
+            (123_456_789, 4, "12345.6789"),
+            (
+                MAX_UINT256,
+                18,
+                "115792089237316195423570985008687907853269984665640564039457.584007913129639935",
+            ),
+        ],
+    )
+    def test_format_amount_round_trips(self, raw, decimals, text):
+        from ipor_fusion import format_amount, parse_amount
+
+        assert format_amount(Amount(raw), Decimals(decimals)) == text
+        assert parse_amount(text, Decimals(decimals)) == raw
+
+    @pytest.mark.parametrize("raw", [-1, MAX_UINT256 + 1])
+    def test_format_amount_rejects_values_outside_uint256(self, raw):
+        from ipor_fusion import format_amount, format_shares
+
+        with pytest.raises(ValueError, match="within uint256"):
+            format_amount(Amount(raw), Decimals(6))
+        with pytest.raises(ValueError, match="within uint256"):
+            format_shares(Shares(raw), Decimals(6))
+        with pytest.raises(ValueError, match="0..255"):
+            format_amount(Amount(1), Decimals(256))
+
+    def test_shares_pair_mirrors_amounts(self):
+        from ipor_fusion import format_shares, parse_shares
+
+        assert parse_shares("2.5", Decimals(8)) == Shares(250_000_000)
+        assert format_shares(Shares(250_000_000), Decimals(8)) == "2.5"