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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev260
+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

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

@@ -1,6 +1,6 @@
 [project]
 name = "ipor-fusion"
-version = "4.0.0.dev260"
+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.dev260 → 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.dev260 → 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.dev260 → 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.dev260 → 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 [