mm-strk 0.4.1__tar.gz → 0.4.3__tar.gz

mm_strk-0.4.3/.claude/settings.local.json

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(just lint:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:docs.starknet.io)",
+      "Bash(curl:*)",
+      "WebFetch(domain:www.starknet.io)",
+      "WebFetch(domain:www.comparenodes.com)",
+      "WebFetch(domain:starknetpy.readthedocs.io)",
+      "WebFetch(domain:pypi.org)"
+    ]
+  }
+}

mm_strk-0.4.3/ADR.md

@@ -0,0 +1,3 @@
+# Architecture Decision Records
+
+Key design decisions for this project. Read this before suggesting changes.

mm_strk-0.4.3/CLAUDE.md

@@ -0,0 +1,19 @@
+# Claude Guidelines
+
+## Critical Guidelines
+
+1. **Always communicate in English** - Regardless of the language the user speaks, always respond in English. All code, comments, and documentation must be in English.
+
+2. **Minimal documentation** - Only add comments/documentation when it simplifies understanding and isn't obvious from the code itself. Keep it strictly relevant and concise.
+
+3. **Critical thinking** - Always critically evaluate user ideas. Users can make mistakes. Think first about whether the user's idea is good before implementing.
+
+4. **Lint after changes** - After making code changes, always run `just lint` to verify code quality and fix any linter issues.
+
+5. **No disabling linter rules** - Never use special disabling comments (like `# noqa`, `# type: ignore`, `# ruff: noqa`, etc.) to turn off linter rules without explicit permission. If you believe a rule should be disabled, ask first.
+
+## Required Reading
+
+Before working on this codebase, read these documents:
+1. `README.md` - Project overview and API
+2. `ADR.md` - Architectural decisions and rationale

mm_strk-0.4.3/PKG-INFO

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

mm_strk-0.4.3/README.md

@@ -0,0 +1,72 @@
+# mm-strk
+
+Starknet utilities library.
+
+**Requires RPC node version 0.9+**
+
+## Installation
+
+```bash
+pip install mm-strk
+```
+
+## API
+
+### is_address
+
+Validates a Starknet address.
+
+```python
+from mm_strk.account import is_address
+
+is_address("0x123abc")  # True - minimal form
+is_address("0x0000000000000000000000000000000000000000000000000000000000123abc")  # True - full 64-char form
+is_address("invalid")  # False
+```
+
+### get_balance
+
+Queries token balance for an address.
+
+```python
+import asyncio
+from mm_strk.balance import get_balance, ETH_ADDRESS_MAINNET, STRK_ADDRESS_MAINNET
+
+result = asyncio.run(get_balance(
+    rpc_url="https://your-rpc-node.com",
+    address="0x123...",
+    token=ETH_ADDRESS_MAINNET,
+))
+if result.is_ok():
+    print(result.ok)  # balance in wei
+```
+
+Token constants:
+- `ETH_ADDRESS_MAINNET`, `ETH_DECIMALS` (18)
+- `STRK_ADDRESS_MAINNET`, `STRK_DECIMALS` (18)
+- `USDC_ADDRESS_MAINNET`, `USDC_DECIMALS` (6)
+- `USDT_ADDRESS_MAINNET`, `USDT_DECIMALS` (6)
+- `DAI_ADDRESS_MAINNET`, `DAI_DECIMALS` (18)
+
+### address_to_domain
+
+Resolves a Starknet address to its Starknet ID domain.
+
+```python
+import asyncio
+from mm_strk.domain import address_to_domain
+
+result = asyncio.run(address_to_domain("0x123..."))
+if result.is_ok():
+    print(result.ok)  # "example.stark" or None if not found
+```
+
+## CLI
+
+### mm-strk node
+
+Check status of Starknet RPC nodes.
+
+```bash
+mm-strk node https://rpc-node-1.com https://rpc-node-2.com
+```

{mm_strk-0.4.1 → mm_strk-0.4.3}/pyproject.toml

@@ -1,13 +1,9 @@
 [project]
 name = "mm-strk"
-version = "0.4.1"
+version = "0.4.3"
 description = ""
 requires-python = ">=3.13"
-dependencies = [
-    "mm-cryptocurrency~=0.4.7",
-    "starknet-py~=0.27.0",
-    "typer>=0.16.0",
-]
+dependencies = ["mm-web3~=0.5.7", "starknet-py~=0.29.0", "typer~=0.21.1"]
 [project.scripts]
 mm-strk = "mm_strk.cli.cli:app"
 
@@ -17,17 +13,20 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 
-[tool.uv]
-dev-dependencies = [
-    "pytest~=8.4.0",
-    "pytest-asyncio~=1.0.0",
-    "pytest-xdist~=3.7.0",
-    "ruff~=0.11.13",
-    "pip-audit~=2.9.0",
-    "bandit~=1.8.3",
-    "mypy~=1.16.0",
-    "python-dotenv>=1.1.0",
+[dependency-groups]
+dev = [
+    "bandit~=1.9.2",
+    "mypy~=1.19.1",
+    "pip-audit~=2.10.0",
+    "pre-commit~=4.5.1",
+    "pytest~=9.0.2",
+    "pytest-asyncio~=1.3.0",
+    "pytest-xdist~=3.8.0",
+    "ruff~=0.14.13",
+    "python-dotenv~=1.2.0",
 ]
+
+[tool.uv]
 override-dependencies = ["pywin32 ; sys_platform == 'win32'"]
 
 

{mm_strk-0.4.1 → mm_strk-0.4.3}/src/mm_strk/account.py

@@ -39,5 +39,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-0.4.1 → mm_strk-0.4.3}/src/mm_strk/cli/commands/node.py

@@ -8,12 +8,16 @@ 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)
@@ -29,8 +33,14 @@ async def _run(urls: list[str]) -> None:
 
 
 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 +56,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-0.4.1 → mm_strk-0.4.3}/src/mm_strk/domain.py

@@ -14,7 +14,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")
+    domain = res.parse_json("domain")
     if domain:
         return res.to_result_ok(domain)
     return res.to_result_err("unknown_response")