mm-web3 0.5.6__tar.gz → 0.6.0__tar.gz

{mm_web3-0.5.6 → mm_web3-0.6.0}/.claude/settings.local.json

@@ -4,7 +4,8 @@
       "Bash(just lint)",
       "mcp__ide__getDiagnostics",
       "Bash(tree:*)",
-      "WebFetch(domain:docs.astral.sh)"
+      "WebFetch(domain:docs.astral.sh)",
+      "Bash(just test:*)"
     ],
     "deny": [],
     "ask": []

mm_web3-0.6.0/CLAUDE.md

@@ -0,0 +1,25 @@
+# AI Agent Start Guide
+
+## Critical: Language
+RESPOND IN ENGLISH. Always. No exceptions.
+User's language does NOT determine your response language.
+Only switch if user EXPLICITLY requests it (e.g., "respond in {language}").
+Language switching applies ONLY to chat. All code, comments, commit messages, and files must ALWAYS be in English — no exceptions.
+
+
+## Mandatory Rules (external)
+These files are REQUIRED. Read them fully and follow all rules.
+- `~/.claude/shared-rules/general.md`
+- `~/.claude/shared-rules/python.md`
+
+## Project Reading (context)
+These files are REQUIRED for project understanding.
+- `README.md` - Project overview and API
+
+## Preflight (mandatory)
+Before your first response:
+1. Read all files listed above.
+2. Do not answer until all are read.
+3. In your first reply, list every file you have read from this document.
+
+Failure to follow this protocol is considered an error.

mm_web3-0.6.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: mm-web3
+Version: 0.6.0
+Requires-Python: >=3.14
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: mm-http~=0.3.0
+Requires-Dist: mm-print~=0.3.0
+Requires-Dist: mm-std~=0.7.0

{mm_web3-0.5.6 → mm_web3-0.6.0}/README.md

@@ -170,46 +170,6 @@ max_attempts = 3
 backoff_seconds = 1.0
 ```
 
-## Development
-
-### Setup
-
-```bash
-# Clone and setup
-git clone <repository-url>
-cd mm-cryptocurrency
-uv sync
-
-# Run tests
-just test
-
-# Format code
-just format
-
-# Run linting
-just lint
-
-# Run security audit
-just audit
-```
-
-### Requirements
-
-- **Python 3.13+**
-- **uv** for package management
-- Dependencies: `mm-http`, `mm-print`, `mm-result`
-
-### Testing
-
-The library includes comprehensive tests covering:
-- Network definitions and utilities
-- Proxy fetching and validation
-- Configuration loading and validation
-- Retry logic and error handling
-- Utility functions
-
-Run tests with: `just test` or `uv run pytest`
-
 ## API Reference
 
 ### Core Classes

{mm_web3-0.5.6 → mm_web3-0.6.0}/justfile

@@ -16,8 +16,8 @@ test:
 
 lint *args: format pre-commit
     uv run ruff check {{args}} src tests
-    uv run ty check
     uv run mypy src
+    uv run ty check src
 
 audit:
     uv export --no-dev --all-extras --format requirements-txt --no-emit-project > requirements.txt

{mm_web3-0.5.6 → mm_web3-0.6.0}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "mm-web3"
-version = "0.5.6"
+version = "0.6.0"
 description = ""
-requires-python = ">=3.13"
+requires-python = ">=3.14"
 dependencies = [
-    "mm-std~=0.6.0",
-    "mm-http~=0.2.4",
-    "mm-print~=0.2.2",
+    "mm-std~=0.7.0",
+    "mm-http~=0.3.0",
+    "mm-print~=0.3.0",
     "loguru>=0.7.3",
 ]
 
@@ -16,7 +16,7 @@ build-backend = "hatchling.build"
 
 [dependency-groups]
 dev = [
-    "bandit~=1.9.2",
+    "bandit~=1.9.3",
     "mypy~=1.19.1",
     "pip-audit~=2.10.0",
     "pre-commit~=4.5.1",
@@ -24,21 +24,21 @@ dev = [
     "pytest-asyncio~=1.3.0",
     "pytest-xdist~=3.8.0",
     "pytest-httpserver~=1.1.3",
-    "ruff~=0.14.11",
+    "ruff~=0.14.14",
     "python-dotenv~=1.2.1",
     "eth-account~=0.13.7",
-    "ty~=0.0.11",
+    "ty~=0.0.14",
 ]
 
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 warn_no_return = false
 strict = true
 exclude = ["^tests/", "^tmp/"]
 
 [tool.ruff]
 line-length = 130
-target-version = "py313"
+target-version = "py314"
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [

{mm_web3-0.5.6 → mm_web3-0.6.0}/src/mm_web3/calcs.py

@@ -120,6 +120,8 @@ def calc_expression_with_vars(
                 term_value = int(term)
             elif suffix is not None:
                 term_value = convert_value_with_units(term, unit_decimals)
+            elif term.startswith("random(") and term.endswith(")"):
+                term_value = _parse_random_function(term, unit_decimals)
             elif variables:
                 # Check if term ends with any variable name
                 matched_var = None
@@ -132,21 +134,19 @@ def calc_expression_with_vars(
                     multiplier_part = term.removesuffix(matched_var)
                     multiplier = Decimal(multiplier_part) if multiplier_part else Decimal(1)
                     term_value = int(multiplier * variables[matched_var])
-                # Check for random function
-                elif term.startswith("random(") and term.endswith(")"):
-                    term_value = _parse_random_function(term, unit_decimals)
                 else:
+                    # Re-raise as ValueError for consistent error type from function
                     raise ValueError(f"unrecognized term: {term}")  # noqa: TRY301
-            elif term.startswith("random(") and term.endswith(")"):
-                term_value = _parse_random_function(term, unit_decimals)
             else:
+                # Re-raise as ValueError for consistent error type from function
                 raise ValueError(f"unrecognized term: {term}")  # noqa: TRY301
 
             if operator == "+":
                 result += term_value
-            if operator == "-":
+            elif operator == "-":
                 result -= term_value
 
+        # Return inside try is intentional - exception handling wraps entire calculation
         return result  # noqa: TRY300
     except Exception as e:
         raise ValueError(e) from e

{mm_web3-0.5.6 → mm_web3-0.6.0}/src/mm_web3/config.py

@@ -4,7 +4,7 @@ from pathlib import Path
 from typing import Any, NoReturn, Self, TypeVar
 from zipfile import ZipFile
 
-import mm_print
+from mm_print import print_json, print_plain
 from mm_result import Result
 from pydantic import BaseModel, ConfigDict, ValidationError
 
@@ -31,11 +31,11 @@ class Web3CliConfig(BaseModel):
         if count:
             for k in count:
                 data[k] = len(data[k])
-        mm_print.json(data)
+        print_json(data)
         sys.exit(0)
 
     @classmethod
-    def read_toml_config_or_exit(cls, config_path: Path, zip_password: str = "") -> Self:  # nosec
+    def read_toml_config_or_exit(cls, config_path: Path, zip_password: str = "") -> Self:  # nosec: empty default is for optional password, not hardcoded secret
         """Read TOML config file, exit on error.
 
         Args:
@@ -51,7 +51,7 @@ class Web3CliConfig(BaseModel):
         cls._print_error_and_exit(res)
 
     @classmethod
-    async def read_toml_config_or_exit_async(cls, config_path: Path, zip_password: str = "") -> Self:  # nosec
+    async def read_toml_config_or_exit_async(cls, config_path: Path, zip_password: str = "") -> Self:  # nosec: empty default is for optional password, not hardcoded secret
         """Read TOML config file with async validation, exit on error.
 
         Args:
@@ -67,7 +67,7 @@ class Web3CliConfig(BaseModel):
         cls._print_error_and_exit(res)
 
     @classmethod
-    def _load_toml_data(cls, config_path: Path, zip_password: str = "") -> dict[str, Any]:  # nosec
+    def _load_toml_data(cls, config_path: Path, zip_password: str = "") -> dict[str, Any]:  # nosec: empty default is for optional password, not hardcoded secret
         """Load TOML data from file or ZIP archive.
 
         Args:
@@ -84,7 +84,7 @@ class Web3CliConfig(BaseModel):
             return tomllib.load(f)
 
     @classmethod
-    def read_toml_config(cls, config_path: Path, zip_password: str = "") -> Result[Self]:  # nosec
+    def read_toml_config(cls, config_path: Path, zip_password: str = "") -> Result[Self]:  # nosec: empty default is for optional password, not hardcoded secret
         """Read and validate TOML config file.
 
         Args:
@@ -98,12 +98,12 @@ class Web3CliConfig(BaseModel):
             data = cls._load_toml_data(config_path, zip_password)
             return Result.ok(cls(**data))
         except ValidationError as e:
-            return Result.err(("validator_error", e), extra={"errors": e.errors()})
+            return Result.err(("validator_error", e), context={"errors": e.errors()})
         except Exception as e:
             return Result.err(e)
 
     @classmethod
-    async def read_toml_config_async(cls, config_path: Path, zip_password: str = "") -> Result[Self]:  # nosec
+    async def read_toml_config_async(cls, config_path: Path, zip_password: str = "") -> Result[Self]:  # nosec: empty default is for optional password, not hardcoded secret
         """Read and validate TOML config file with async validators.
 
         Use this method when your config has async model validators that
@@ -121,7 +121,7 @@ class Web3CliConfig(BaseModel):
             model = await cls.model_validate(data)  # type: ignore[misc]
             return Result.ok(model)
         except ValidationError as e:
-            return Result.err(("validator_error", e), extra={"errors": e.errors()})
+            return Result.err(("validator_error", e), context={"errors": e.errors()})
         except Exception as e:
             return Result.err(e)
 
@@ -132,14 +132,14 @@ class Web3CliConfig(BaseModel):
         Args:
             res: Failed Result containing error information
         """
-        if res.error == "validator_error" and res.extra:
-            mm_print.plain("config validation errors")
-            for e in res.extra["errors"]:
+        if res.error == "validator_error" and res.context:
+            print_plain("config validation errors")
+            for e in res.context["errors"]:
                 loc = e["loc"]
                 field = ".".join(str(lo) for lo in loc) if len(loc) > 0 else ""
-                mm_print.plain(f"{field} {e['msg']}")
+                print_plain(f"{field} {e['msg']}")
         else:
-            mm_print.plain(f"can't parse config file: {res.error} {res.extra}")
+            print_plain(f"can't parse config file: {res.error} {res.context}")
         sys.exit(1)
 
 
@@ -156,5 +156,7 @@ def read_text_from_zip_archive(zip_archive_path: Path, filename: str | None = No
     """
     with ZipFile(zip_archive_path) as zipfile:
         if filename is None:
+            if not zipfile.filelist:
+                raise ValueError(f"ZIP archive is empty: {zip_archive_path}")
             filename = zipfile.filelist[0].filename
         return zipfile.read(filename, pwd=password.encode() if password else None).decode()

{mm_web3-0.5.6 → mm_web3-0.6.0}/src/mm_web3/log.py

@@ -5,6 +5,13 @@ from loguru import logger
 
 
 def init_loguru(debug: bool, debug_file: Path | None, info_file: Path | None) -> None:
+    """Initialize loguru logger with console and optional file outputs.
+
+    Args:
+        debug: If True, set DEBUG level with timestamps; otherwise INFO level with plain format
+        debug_file: Optional file path for DEBUG level logs with timestamps
+        info_file: Optional file path for INFO level logs with plain format
+    """
     if debug:
         level = "DEBUG"
         format_ = "<green>{time:YYYY-MM-DD HH:mm:ss}</green> <level>{level}</level> {message}"

{mm_web3-0.5.6 → mm_web3-0.6.0}/src/mm_web3/proxy.py

@@ -65,7 +65,7 @@ def is_valid_proxy_url(proxy_url: str) -> bool:
     Check if the given URL is a valid proxy URL.
 
     A valid proxy URL must have:
-      - A scheme in {"http", "https", "socks4", "socks5", "zsocks5h"}.
+      - A scheme in {"http", "https", "socks4", "socks5", "socks5h"}.
       - A non-empty hostname.
       - A specified port.
       - No extra path components (the path must be empty or "/").
@@ -100,7 +100,4 @@ def is_valid_proxy_url(proxy_url: str) -> bool:
         return False
 
     # Ensure that there is no extra path (only allow an empty path or a single "/")
-    if parsed.path and parsed.path not in ("", "/"):  # noqa: SIM103
-        return False
-
-    return True
+    return not parsed.path or parsed.path in ("", "/")

{mm_web3-0.5.6 → mm_web3-0.6.0}/src/mm_web3/validators.py

@@ -62,32 +62,32 @@ class ConfigValidators:
             ValueError: If addresses are invalid, format is wrong, or no transfers found
         """
 
+        def _parse_transfer_line(line: str, source: str) -> Transfer:
+            arr = line.split()
+            if len(arr) < 2 or len(arr) > 3:
+                raise ValueError(f"illegal {source}: {line}")
+            return Transfer(from_address=arr[0], to_address=arr[1], value=arr[2] if len(arr) > 2 else "")
+
         def validator(v: str) -> list[Transfer]:
-            result = []
+            result: list[Transfer] = []
             for line in parse_lines(v, remove_comments=True):  # don't use lowercase here because it can be a file: /To/Path.txt
                 if line.startswith("file:"):
-                    for file_line in read_lines_from_file(line.removeprefix("file:").strip()):
-                        arr = file_line.split()
-                        if len(arr) < 2 or len(arr) > 3:
-                            raise ValueError(f"illegal file_line: {file_line}")
-                        result.append(Transfer(from_address=arr[0], to_address=arr[1], value=arr[2] if len(arr) > 2 else ""))
-
+                    result.extend(
+                        _parse_transfer_line(fl, "file_line") for fl in read_lines_from_file(line.removeprefix("file:").strip())
+                    )
                 else:
-                    arr = line.split()
-                    if len(arr) < 2 or len(arr) > 3:
-                        raise ValueError(f"illegal line: {line}")
-                    result.append(Transfer(from_address=arr[0], to_address=arr[1], value=arr[2] if len(arr) > 2 else ""))
+                    result.append(_parse_transfer_line(line, "line"))
 
             if lowercase:
                 result = [
                     Transfer(from_address=r.from_address.lower(), to_address=r.to_address.lower(), value=r.value) for r in result
                 ]
 
-            for route in result:
-                if not is_address(route.from_address):
-                    raise ValueError(f"illegal address: {route.from_address}")
-                if not is_address(route.to_address):
-                    raise ValueError(f"illegal address: {route.to_address}")
+            for transfer in result:
+                if not is_address(transfer.from_address):
+                    raise ValueError(f"illegal address: {transfer.from_address}")
+                if not is_address(transfer.to_address):
+                    raise ValueError(f"illegal address: {transfer.to_address}")
 
             if not result:
                 raise ValueError("No valid transfers found")

{mm_web3-0.5.6 → mm_web3-0.6.0}/tests/test_config.py

@@ -84,7 +84,7 @@ count = -5
         result = SimpleTestConfig.read_toml_config(validation_error_config)
         assert result.is_err()
         assert result.error == "validator_error"
-        assert result.extra is not None and "errors" in result.extra
+        assert result.context is not None and "errors" in result.context
 
         # Test extra fields (should fail due to forbid extra)
         extra_fields_config = config_dir / "extra.toml"
@@ -200,7 +200,7 @@ name = "test"
 count = -10
 """)
 
-        with patch("sys.exit") as mock_exit, patch("mm_print.plain") as mock_print:
+        with patch("sys.exit") as mock_exit, patch("mm_web3.config.print_plain") as mock_print:
             SimpleTestConfig.read_toml_config_or_exit(validation_error_config)
             mock_exit.assert_called_with(1)
             mock_print.assert_called()
@@ -210,7 +210,7 @@ count = -10
 
         # Test file error exit
         missing_file = config_dir / "missing.toml"
-        with patch("sys.exit") as mock_exit, patch("mm_print.plain") as mock_print:
+        with patch("sys.exit") as mock_exit, patch("mm_web3.config.print_plain") as mock_print:
             SimpleTestConfig.read_toml_config_or_exit(missing_file)
             mock_exit.assert_called_with(1)
             mock_print.assert_called()
@@ -220,7 +220,7 @@ def test_print_and_exit():
     """Test the print_and_exit method functionality."""
     config = SimpleTestConfig(name="test", count=42, enabled=True)
 
-    with patch("sys.exit") as mock_exit, patch("mm_print.json") as mock_print_json:
+    with patch("sys.exit") as mock_exit, patch("mm_web3.config.print_json") as mock_print_json:
         config.print_and_exit()
         mock_exit.assert_called_with(0)
         mock_print_json.assert_called_once()
@@ -230,7 +230,7 @@ def test_print_and_exit():
         assert printed_data["enabled"] is True
 
     # Test with exclude and count parameters
-    with patch("sys.exit") as mock_exit, patch("mm_print.json") as mock_print_json:
+    with patch("sys.exit") as mock_exit, patch("mm_web3.config.print_json") as mock_print_json:
         config.print_and_exit(exclude={"enabled"}, count={"name"})
         printed_data = mock_print_json.call_args[0][0]
         assert "enabled" not in printed_data

{mm_web3-0.5.6 → mm_web3-0.6.0}/tests/test_retry.py

@@ -13,9 +13,9 @@ class TestRetryWithNodeAndProxy:
         result = await retry_with_node_and_proxy(3, "node1", "proxy1", func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 1
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 1
 
     async def test_success_on_second_try(self) -> None:
         attempts = 0
@@ -30,9 +30,9 @@ class TestRetryWithNodeAndProxy:
         result = await retry_with_node_and_proxy(3, "node1", "proxy1", func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 2
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 2
 
     async def test_all_attempts_fail(self) -> None:
         async def func(_node: str, _proxy: str | None) -> Result[str]:
@@ -41,9 +41,9 @@ class TestRetryWithNodeAndProxy:
         result = await retry_with_node_and_proxy(3, "node1", "proxy1", func)
         assert result.is_err()
         assert result.error == "failure"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 3
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 3
 
     async def test_multiple_nodes_and_proxies(self) -> None:
         nodes = ["node1", "node2"]
@@ -60,9 +60,9 @@ class TestRetryWithNodeAndProxy:
         result = await retry_with_node_and_proxy(3, nodes, proxies, func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 2
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 2
 
 
 class TestRetryWithProxy:
@@ -73,9 +73,9 @@ class TestRetryWithProxy:
         result = await retry_with_proxy(3, "proxy1", func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 1
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 1
 
     async def test_success_on_second_try(self) -> None:
         attempts = 0
@@ -90,9 +90,9 @@ class TestRetryWithProxy:
         result = await retry_with_proxy(3, "proxy1", func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 2
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 2
 
     async def test_all_attempts_fail(self) -> None:
         async def func(_proxy: str | None) -> Result[str]:
@@ -101,9 +101,9 @@ class TestRetryWithProxy:
         result = await retry_with_proxy(3, "proxy1", func)
         assert result.is_err()
         assert result.error == "failure"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 3
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 3
 
     async def test_multiple_proxies(self) -> None:
         proxies = ["proxy1", "proxy2"]
@@ -119,6 +119,6 @@ class TestRetryWithProxy:
         result = await retry_with_proxy(3, proxies, func)
         assert result.is_ok()
         assert result.value == "success"
-        assert result.extra is not None
-        assert "retry_logs" in result.extra
-        assert len(result.extra["retry_logs"]) == 2
+        assert result.context is not None
+        assert "retry_logs" in result.context
+        assert len(result.context["retry_logs"]) == 2