mm-strk 0.4.2__py3-none-any.whl → 0.5.0__py3-none-any.whl

mm_strk/__init__.py

@@ -0,0 +1 @@
+"""Starknet utilities library."""

mm_strk/account.py

@@ -1,3 +1,5 @@
+"""Starknet address validation."""
+
 import re
 
 # Maximum allowable value for a StarkNet address (251 bits)
@@ -5,15 +7,14 @@ MAX_STARKNET_ADDRESS = 2**251
 
 
 def is_address(address: str) -> bool:
-    """
-    Validates a StarkNet address.
+    """Validate a Starknet address.
 
     - Must be a string starting with '0x'.
     - Hex part 1-64 chars.
     - Integer value < 2**251.
     - Accepts either:
-      • Full 64-hex-character padded form.
-      • Minimal form without leading zeros (canonical).
+      * Full 64-hex-character padded form.
+      * Minimal form without leading zeros (canonical).
     """
     # Type and prefix
     if not isinstance(address, str) or not address.startswith("0x"):
@@ -39,5 +40,5 @@ def is_address(address: str) -> bool:
         return True
 
     # Minimal form (no leading zeros)
-    canonical = hex(value)[2:]
+    canonical = f"{value:x}"
     return hex_part.lower() == canonical

mm_strk/balance.py

@@ -1,3 +1,5 @@
+"""Token balance querying on Starknet."""
+
 import aiohttp
 from aiohttp_socks import ProxyConnector
 from mm_result import Result
@@ -19,6 +21,7 @@ STRK_DECIMALS = 18
 
 
 async def get_balance(rpc_url: str, address: str, token: str, timeout: float = 5, proxy: str | None = None) -> Result[int]:
+    """Get token balance for a Starknet address."""
     try:
         timeout_config = aiohttp.ClientTimeout(total=timeout)
         connector = ProxyConnector.from_url(proxy) if proxy else None

mm_strk/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI package for mm-strk."""

mm_strk/cli/cli.py

@@ -1,7 +1,9 @@
+"""CLI entry point for mm-strk."""
+
 from typing import Annotated
 
-import mm_print
 import typer
+from mm_print import print_plain
 
 from mm_strk.cli import cli_utils, commands
 
@@ -9,14 +11,15 @@ app = typer.Typer(no_args_is_help=True, pretty_exceptions_enable=False, add_comp
 
 
 def version_callback(value: bool) -> None:
+    """Print version and exit when --version is passed."""
     if value:
-        mm_print.plain(f"mm-strk: {cli_utils.get_version()}")
+        print_plain(f"mm-strk: {cli_utils.get_version()}")
         raise typer.Exit
 
 
 @app.callback()
 def main(_version: bool = typer.Option(None, "--version", callback=version_callback, is_eager=True)) -> None:
-    pass
+    """Starknet utilities CLI."""
 
 
 @app.command(name="node", help="Checks RPC URLs for availability and status")
@@ -24,4 +27,5 @@ def node_command(
     urls: Annotated[list[str], typer.Argument()],
     proxy: Annotated[str | None, typer.Option("--proxy", "-p", help="Proxy")] = None,
 ) -> None:
+    """Check RPC node availability and status."""
     commands.node.run(urls, proxy)

mm_strk/cli/cli_utils.py

@@ -1,5 +1,8 @@
+"""CLI utility functions."""
+
 import importlib.metadata
 
 
 def get_version() -> str:
+    """Return the installed version of mm-strk."""
     return importlib.metadata.version("mm-strk")

mm_strk/cli/commands/__init__.py

@@ -1,3 +1,5 @@
+"""CLI commands for mm-strk."""
+
 from . import node
 
 __all__ = ["node"]

mm_strk/cli/commands/node.py

@@ -1,19 +1,25 @@
+"""Starknet node status checking."""
+
 import asyncio
 
-import mm_print
 import typer
+from mm_print import print_json
 from pydantic import BaseModel
 from starknet_py.net.client_models import SyncStatus
 from starknet_py.net.full_node_client import FullNodeClient
 
 
 class NodeStatus(BaseModel):
+    """Starknet node status response."""
+
+    spec_version: str
     block_number: int | str
     chain_id: int | str
     syncing_status: bool | SyncStatus | str
 
 
 def run(urls: list[str], proxy: str | None) -> None:
+    """Check status of Starknet nodes."""
     if proxy:
         typer.echo("proxy is not supported yet")
         raise typer.Exit(code=1)
@@ -21,16 +27,23 @@ def run(urls: list[str], proxy: str | None) -> None:
 
 
 async def _run(urls: list[str]) -> None:
+    """Fetch and print status for all given node URLs."""
     result = {}
     for url in urls:
         result[url] = (await _node_status(url)).model_dump()
 
-    mm_print.json(result)
+    print_json(result)
 
 
 async def _node_status(url: str) -> NodeStatus:
+    """Fetch status from a single node."""
     client = FullNodeClient(node_url=url)
 
+    try:
+        spec_version: str = await client.spec_version()
+    except Exception as e:
+        spec_version = str(e)
+
     try:
         block_number: int | str = await client.get_block_number()
     except Exception as e:
@@ -46,4 +59,4 @@ async def _node_status(url: str) -> NodeStatus:
     except Exception as e:
         syncing_status = str(e)
 
-    return NodeStatus(block_number=block_number, chain_id=chain_id, syncing_status=syncing_status)
+    return NodeStatus(spec_version=spec_version, block_number=block_number, chain_id=chain_id, syncing_status=syncing_status)

mm_strk/domain.py

@@ -1,9 +1,12 @@
+"""Starknet domain resolution via starknet.id API."""
+
 from mm_http import http_request
 from mm_result import Result
 from mm_std import str_contains_any
 
 
 async def address_to_domain(address: str, timeout: float = 5.0, proxy: str | None = None) -> Result[str | None]:
+    """Resolve a Starknet address to its .stark domain name."""
     url = "https://api.starknet.id/addr_to_domain"
     res = await http_request(url, params={"addr": address}, proxy=proxy, timeout=timeout)
     if (
@@ -14,7 +17,7 @@ async def address_to_domain(address: str, timeout: float = 5.0, proxy: str | Non
         return res.to_result_ok(None)
     if res.is_err():
         return res.to_result_err()
-    domain = res.parse_json_body("domain")
-    if domain:
-        return res.to_result_ok(domain)
+    domain_res = res.json_body("domain")
+    if domain_res.is_ok():
+        return res.to_result_ok(domain_res.unwrap())
     return res.to_result_err("unknown_response")

mm_strk-0.5.0.dist-info/METADATA

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: mm-strk
+Version: 0.5.0
+Requires-Python: >=3.14
+Requires-Dist: mm-web3~=0.6.2
+Requires-Dist: starknet-py~=0.29.0
+Requires-Dist: typer~=0.21.1

mm_strk-0.5.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+mm_strk/__init__.py,sha256=iVp6MtowXGcOwwIwwoVjvBUFURUA8c6A_HiQDb7lNDw,34
+mm_strk/account.py,sha256=WqoUhqdqIMccrlKjUi6Xw6aK7hZX1yDzcXA1VMwDmbo,1123
+mm_strk/balance.py,sha256=gteqS9o4b_kI7uHm6CnGbRVdJPFu8rUNwouQB77LkQU,1774
+mm_strk/domain.py,sha256=oeX45K7WBn_jAoNZ3EXHYN5CglDAwXvtRdxtC8o4_ys,902
+mm_strk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_strk/cli/__init__.py,sha256=UZhmfBAMir94NIN3gk9u4hKTdwqjAzv-Aq3J3--PsIM,31
+mm_strk/cli/cli.py,sha256=Mfrx-9oEWV6yY0YCoEdHSmhepneY1ImsbvRtcYgEqcs,946
+mm_strk/cli/cli_utils.py,sha256=G-JltQCbj7SrE98GXgyrfOX3PW7gPwkMf-ATZV4MABM,184
+mm_strk/cli/commands/__init__.py,sha256=EYFq7dwcjxWGV28xbSgF0OqFxD8ecRJi3K2FUCkhy-k,72
+mm_strk/cli/commands/node.py,sha256=SC4eI75jzFtYdEhGS_2x6lcR-4VWqnyMNs_rScEiV_Q,1679
+mm_strk-0.5.0.dist-info/METADATA,sha256=gt3HeSL7lYOrgQhEqqvvtHJFve3cAltgwBwQvTu3cCk,169
+mm_strk-0.5.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mm_strk-0.5.0.dist-info/entry_points.txt,sha256=X6zWJaYaUkTgJrY4LAVpcov8O43PmUU4cQ1ue8prYqQ,48
+mm_strk-0.5.0.dist-info/RECORD,,

{mm_strk-0.4.2.dist-info → mm_strk-0.5.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

mm_strk-0.4.2.dist-info/METADATA

@@ -1,7 +0,0 @@
-Metadata-Version: 2.4
-Name: mm-strk
-Version: 0.4.2
-Requires-Python: >=3.13
-Requires-Dist: mm-web3~=0.5.1
-Requires-Dist: starknet-py~=0.27.0
-Requires-Dist: typer>=0.16.0

mm_strk-0.4.2.dist-info/RECORD

@@ -1,14 +0,0 @@
-mm_strk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_strk/account.py,sha256=kalmNZgM-X2aEGWIk4s4XJUpS3TM2LL188Vjd-hMVds,1099
-mm_strk/balance.py,sha256=jOCV1rm4lqXwwGU8CO49znOaUJWQxPukAbJiMkmti7k,1679
-mm_strk/domain.py,sha256=cE_f7RZaifjuJaUa7G5bJRvQ8-jr1nszMtLZPI4oQYw,760
-mm_strk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_strk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_strk/cli/cli.py,sha256=nQfgYlgaXPD9MEiTkUTwgHeWPqwavv1VtfYp-rWL2hY,762
-mm_strk/cli/cli_utils.py,sha256=4_QLJ_rEotHK90PRQqsvCuFydDOXPrXrnMndBffMPIg,103
-mm_strk/cli/commands/__init__.py,sha256=ipr1wm0YQIJoEZLupmrGaom6uJUENhxFuSCOVvCJuW8,39
-mm_strk/cli/commands/node.py,sha256=Lt7t8z5inY4G12gHI-4uSEIAYuuNyHwaJ55apOBkNEk,1271
-mm_strk-0.4.2.dist-info/METADATA,sha256=X7fkV7pBHHR5J_NQLTSbkfgUdAhvoNMBF0wP0Eru_g0,169
-mm_strk-0.4.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mm_strk-0.4.2.dist-info/entry_points.txt,sha256=X6zWJaYaUkTgJrY4LAVpcov8O43PmUU4cQ1ue8prYqQ,48
-mm_strk-0.4.2.dist-info/RECORD,,