ipor-fusion 4.0.0.dev308__tar.gz → 4.0.0.dev311__tar.gz

{ipor_fusion-4.0.0.dev308 → ipor_fusion-4.0.0.dev311}/AGENTS.md

@@ -237,6 +237,11 @@ the lifecycle matrix follows that.
 
 - `chains.py` chain registry; `market_ids.py` `IporFusionMarkets`; `types.py`; `errors.py`
   defines every SDK exception class (`tests/test_error_hierarchy.py` pins it)
+- `fusion_errors.py` — `FUSION_ERROR_SIGNATURES`, every custom error of the
+  ipor-fusion contracts and their imports, registered by `errors.py` so reverts
+  decode by name; generated, never edited by hand: `uv run python
+  scripts/fusion_error_signatures.py ../ipor-fusion --source <commit>` (needs the
+  checkout's `npm ci`)
 - `about.py` — package version, repository URL, CHANGELOG parsing (`fusion changelog`,
   `server_info`); `field_docs.py` — `DOCS`, the JSON field descriptions shared by CLI
   output and MCP models

{ipor_fusion-4.0.0.dev308 → ipor_fusion-4.0.0.dev311}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev308
+Version: 4.0.0.dev311
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -369,10 +369,12 @@ A flash-loan fuse also needs `update_callback_handler(handler, sender, selector)
 
 The full clone → configure → deposit → execute sequence is exercised in [`tests/test_simulate_vault_from_scratch_base.py`](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/tests/test_simulate_vault_from_scratch_base.py).
 
-Custom errors of the crosschain contracts decode by name: importing
-`ipor_fusion.crosschain` registers their signatures (`CROSSCHAIN_ERROR_SIGNATURES`),
-so a simulated or sent call that reverts reads `NavSettledStale(8453)` in
-`SimulationResult.revert_reason` and `TransactionError` instead of a bare selector.
+Custom errors of the IPOR Fusion contracts and the libraries they import
+(OpenZeppelin included) decode by name, so a simulated or sent call that reverts
+reads `AccessManagedUnauthorized(0x...)`, `UnsupportedFuse()` or
+`NavSettledStale(8453)` in `SimulationResult.revert_reason` and `TransactionError`
+instead of a bare selector. Importing `ipor_fusion.crosschain` also registers
+`CROSSCHAIN_ERROR_SIGNATURES`.
 `register_custom_errors([...])` adds your own, and `SimulationResult.raise_for_failure()`
 raises `SimulationError` naming the first failed call.
 

{ipor_fusion-4.0.0.dev308 → ipor_fusion-4.0.0.dev311}/README.md

@@ -320,10 +320,12 @@ A flash-loan fuse also needs `update_callback_handler(handler, sender, selector)
 
 The full clone → configure → deposit → execute sequence is exercised in [`tests/test_simulate_vault_from_scratch_base.py`](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/tests/test_simulate_vault_from_scratch_base.py).
 
-Custom errors of the crosschain contracts decode by name: importing
-`ipor_fusion.crosschain` registers their signatures (`CROSSCHAIN_ERROR_SIGNATURES`),
-so a simulated or sent call that reverts reads `NavSettledStale(8453)` in
-`SimulationResult.revert_reason` and `TransactionError` instead of a bare selector.
+Custom errors of the IPOR Fusion contracts and the libraries they import
+(OpenZeppelin included) decode by name, so a simulated or sent call that reverts
+reads `AccessManagedUnauthorized(0x...)`, `UnsupportedFuse()` or
+`NavSettledStale(8453)` in `SimulationResult.revert_reason` and `TransactionError`
+instead of a bare selector. Importing `ipor_fusion.crosschain` also registers
+`CROSSCHAIN_ERROR_SIGNATURES`.
 `register_custom_errors([...])` adds your own, and `SimulationResult.raise_for_failure()`
 raises `SimulationError` naming the first failed call.
 

{ipor_fusion-4.0.0.dev308 → ipor_fusion-4.0.0.dev311}/pyproject.toml

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

ipor_fusion-4.0.0.dev311/scripts/fusion_error_signatures.py

@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""Regenerate ``src/ipor_fusion/fusion_errors.py`` from an ipor-fusion checkout.
+
+Collects every ``error`` declaration of the Solidity files reachable by import
+from ``contracts/`` (the contracts and the libraries they import, OpenZeppelin
+included, resolved through the checkout's ``foundry.toml`` remappings) and
+writes them as
+canonical ``Name(type,...)`` signatures: enums become ``uint8``, contract,
+interface and library types ``address``, ``uint``/``int`` their 256-bit form.
+Any other parameter type (a struct, a user-defined value type) stops the run,
+because its canonical form needs the compiler.
+
+    uv run python scripts/fusion_error_signatures.py ../ipor-fusion --source <commit>
+"""
+
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+import tomllib
+from pathlib import Path
+
+_OUTPUT = Path(__file__).resolve().parent.parent / "src/ipor_fusion/fusion_errors.py"
+_IMPORT = re.compile(r'^\s*import\s+(?:[^"\']*\s+from\s+)?["\']([^"\']+)["\']', re.M)
+_ERROR = re.compile(r"\berror\s+(\w+)\s*\(([^)]*)\)\s*;")
+_ENUM = re.compile(r"\benum\s+(\w+)")
+_CONTRACT = re.compile(r"\b(?:abstract\s+)?(?:contract|interface|library)\s+(\w+)")
+_ELEMENTARY = re.compile(
+    r"^(address|bool|string|bytes([1-9]|[12]\d|3[0-2])?|u?int(8|16|24|32|40|48|56|64"
+    r"|72|80|88|96|104|112|120|128|136|144|152|160|168|176|184|192|200|208|216|224"
+    r"|232|240|248|256)?)$"
+)
+_COMMENTS = re.compile(r"//[^\n]*|/\*.*?\*/", re.S)
+
+
+class _Resolver:
+    """Forge's import resolution: relative paths, then the longest matching
+    remapping, then the checkout root and each ``libs`` directory."""
+
+    def __init__(self, root: Path) -> None:
+        profile = tomllib.loads((root / "foundry.toml").read_text())["profile"]
+        default = profile["default"]
+        pairs = [entry.split("=", 1) for entry in default["remappings"]]
+        self._root = root
+        self._remappings = sorted(pairs, key=lambda pair: -len(pair[0]))
+        self._bases = [root, *(root / lib for lib in default["libs"])]
+
+    def __call__(self, spec: str, importer: Path) -> Path:
+        if spec.startswith("."):
+            return (importer.parent / spec).resolve()
+        for prefix, target in self._remappings:
+            if spec.startswith(prefix):
+                return (self._root / (target + spec.removeprefix(prefix))).resolve()
+        for base in self._bases:
+            if (base / spec).is_file():
+                return (base / spec).resolve()
+        return (self._root / spec).resolve()
+
+
+def _closure(root: Path) -> dict[Path, str]:
+    resolve = _Resolver(root)
+    pending = sorted((root / "contracts").rglob("*.sol"))
+    sources: dict[Path, str] = {}
+    while pending:
+        path = pending.pop()
+        if path in sources:
+            continue
+        if not path.is_file():
+            raise SystemExit(f"unresolved import: {path}")
+        text = _COMMENTS.sub("", path.read_text())
+        sources[path] = text
+        pending.extend(resolve(spec, path) for spec in _IMPORT.findall(text))
+    return sources
+
+
+def _canonical(param: str, enums: set[str], contracts: set[str], where: str) -> str:
+    kind = param.split()[0].split(".")[-1]
+    if kind in ("uint", "int"):
+        return f"{kind}256"
+    if _ELEMENTARY.fullmatch(kind):
+        return kind
+    if kind in enums:
+        return "uint8"
+    if kind in contracts:
+        return "address"
+    raise SystemExit(f"{where}: no canonical form for parameter type {kind!r}")
+
+
+def collect(root: Path) -> list[str]:
+    sources = _closure(root)
+    enums = {name for text in sources.values() for name in _ENUM.findall(text)}
+    contracts = {name for text in sources.values() for name in _CONTRACT.findall(text)}
+    signatures: set[str] = set()
+    for path, text in sources.items():
+        for name, params in _ERROR.findall(text):
+            types = [
+                _canonical(p.strip(), enums, contracts, f"{path}: {name}")
+                for p in params.split(",")
+                if p.strip()
+            ]
+            signatures.add(f"{name}({','.join(types)})")
+    return sorted(signatures)
+
+
+def render(signatures: list[str], source: str) -> str:
+    lines = "\n".join(f'    "{signature}",' for signature in signatures)
+    return f'''"""Custom errors of the IPOR Fusion contracts and the libraries they import
+(OpenZeppelin included), registered by :mod:`ipor_fusion.errors` so revert data
+decodes by name (``AccessManagedUnauthorized(0x...)``, ``UnsupportedFuse()``)
+instead of a bare selector.
+
+Generated by ``scripts/fusion_error_signatures.py`` from ipor-fusion {source};
+do not edit by hand.
+"""
+
+#: ``Name(type,...)`` signatures, sorted; the selector is the keccak of each.
+FUSION_ERROR_SIGNATURES: tuple[str, ...] = (
+{lines}
+)
+'''
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Regenerate fusion_errors.py.")
+    parser.add_argument("checkout", type=Path, help="ipor-fusion checkout")
+    parser.add_argument(
+        "--source", required=True, help="what the checkout is, e.g. a commit"
+    )
+    args = parser.parse_args()
+    signatures = collect(args.checkout.resolve())
+    _OUTPUT.write_text(render(signatures, args.source))
+    print(f"{len(signatures)} signatures -> {_OUTPUT}", file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()

{ipor_fusion-4.0.0.dev308 → ipor_fusion-4.0.0.dev311}/src/ipor_fusion/errors.py

@@ -10,6 +10,7 @@ from eth_utils import function_signature_to_4byte_selector
 from web3 import Web3
 from web3.types import TxParams, TxReceipt
 
+from ipor_fusion.fusion_errors import FUSION_ERROR_SIGNATURES
 from ipor_fusion.types import TxHash
 
 log = logging.getLogger(__name__)
@@ -50,6 +51,9 @@ def register_custom_errors(signatures: Iterable[str]) -> None:
         CUSTOM_ERRORS[function_signature_to_4byte_selector(canonical)] = (name, types)
 
 
+register_custom_errors(FUSION_ERROR_SIGNATURES)
+
+
 def decode_custom_error(selector: bytes, payload: bytes) -> str | None:
     """``Name(arg, arg)`` for a registered selector, ``None`` otherwise."""
     registered = CUSTOM_ERRORS.get(bytes(selector))