mm-apt 0.4.2__tar.gz → 0.5.0__tar.gz

mm_apt-0.5.0/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(curl:*)",
+      "Bash(just test:*)",
+      "Bash(just lint:*)",
+      "WebFetch(domain:aptoscan.com)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:aptos.dev)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

mm_apt-0.5.0/.env.example

@@ -0,0 +1 @@
+MAINNET_RPC_URL=https://api.mainnet.aptoslabs.com/v1

mm_apt-0.5.0/.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+      - id: check-added-large-files

mm_apt-0.5.0/CLAUDE.md

@@ -0,0 +1,13 @@
+# 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.

{mm_apt-0.4.2 → mm_apt-0.5.0}/PKG-INFO

@@ -1,5 +1,5 @@
 Metadata-Version: 2.4
 Name: mm-apt
-Version: 0.4.2
+Version: 0.5.0
 Requires-Python: >=3.13
-Requires-Dist: mm-web3~=0.5.1
+Requires-Dist: mm-web3~=0.5.4

mm_apt-0.5.0/README.txt

@@ -0,0 +1,2 @@
+https://aptos.dev/
+https://aptoscan.com/

{mm_apt-0.4.2 → mm_apt-0.5.0}/justfile

@@ -15,7 +15,7 @@ format:
 test:
     uv run pytest -n auto tests
 
-lint: format
+lint: format pre-commit
     uv run ruff check src tests
     uv run mypy src
 
@@ -33,3 +33,9 @@ publish: build
 
 sync:
     uv sync
+
+pre-commit:
+    uv run pre-commit run --all-files
+
+pre-commit-autoupdate:
+    uv run pre-commit autoupdate

mm_apt-0.5.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "mm-apt"
+version = "0.5.0"
+description = ""
+requires-python = ">=3.13"
+dependencies = ["mm-web3~=0.5.4"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pytest~=8.4.2",
+    "pytest-asyncio~=1.2.0",
+    "pytest-xdist~=3.8.0",
+    "ruff~=0.14.2",
+    "pip-audit~=2.9.0",
+    "bandit~=1.8.6",
+    "mypy~=1.18.2",
+    "pre-commit~=4.3.0",
+    "python-dotenv~=1.2.1",
+]
+
+[tool.mypy]
+python_version = "3.13"
+warn_no_return = false
+strict = true
+exclude = ["^tests/", "^tmp/"]
+
+[tool.ruff]
+line-length = 130
+target-version = "py313"
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "TC",       # flake8-type-checking, TYPE_CHECKING is dangerous, for example it doesn't work with pydantic
+    "A005",     # flake8-builtins: stdlib-module-shadowing
+    "ERA001",   # eradicate: commented-out-code
+    "PT",       # flake8-pytest-style
+    "D",        # pydocstyle
+    "FIX",      # flake8-fixme
+    "PLR0911",  # pylint: too-many-return-statements
+    "PLR0912",  # pylint: too-many-branches
+    "PLR0913",  # pylint: too-many-arguments
+    "PLR2004",  # pylint: magic-value-comparison
+    "PLC0414",  # pylint: useless-import-alias
+    "FBT",      # flake8-boolean-trap
+    "EM",       # flake8-errmsg
+    "TRY003",   # tryceratops: raise-vanilla-args
+    "C901",     # mccabe: complex-structure,
+    "BLE001",   # flake8-blind-except
+    "S311",     # bandit: suspicious-non-cryptographic-random-usage
+    "TD002",    # flake8-todos: missing-todo-author
+    "TD003",    # flake8-todos: missing-todo-link
+    "RET503",   # flake8-return: implicit-return
+    "COM812",   # it's used in ruff formatter
+    "ASYNC109",
+    "G004",
+]
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = ["ANN", "S"]
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.bandit]
+exclude_dirs = ["tests"]
+skips = ["B311"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"

{mm_apt-0.4.2 → mm_apt-0.5.0}/src/mm_apt/ans.py

@@ -7,7 +7,7 @@ async def address_to_name(address: str, timeout: float = 5, proxy: str | None =
     res = await http_request(url, proxy=proxy, timeout=timeout)
     if res.is_err():
         return res.to_result_err()
-    json_res = res.parse_json_body()
+    json_res = res.parse_json()
     if res.status_code == 200 and json_res == {}:
         return res.to_result_ok(None)
     if "name" in json_res:
@@ -20,7 +20,7 @@ async def address_to_primary_name(address: str, timeout: float = 5, proxy: str |
     res = await http_request(url, proxy=proxy, timeout=timeout)
     if res.is_err():
         return res.to_result_err()
-    json_res = res.parse_json_body()
+    json_res = res.parse_json()
     if res.status_code == 200 and json_res == {}:
         return res.to_result_ok(None)
     if "name" in json_res:

mm_apt-0.5.0/src/mm_apt/balance.py

@@ -0,0 +1,32 @@
+from mm_http import http_request
+from mm_result import Result
+
+
+async def get_balance(node: str, account: str, coin_type: str, timeout: float = 5, proxy: str | None = None) -> Result[int]:
+    url = f"{node}/view"
+
+    if "::" in coin_type:
+        # Coin type (e.g., 0x1::aptos_coin::AptosCoin)
+        body = {
+            "function": "0x1::coin::balance",
+            "type_arguments": [coin_type],
+            "arguments": [account],
+        }
+    else:
+        # Fungible Asset metadata address
+        body = {
+            "function": "0x1::primary_fungible_store::balance",
+            "type_arguments": ["0x1::fungible_asset::Metadata"],
+            "arguments": [account, coin_type],
+        }
+
+    res = await http_request(url, method="POST", json=body, proxy=proxy, timeout=timeout)
+    try:
+        json_res = res.parse_json()
+        if isinstance(json_res, list) and len(json_res) > 0:
+            return res.to_result_ok(int(json_res[0]))
+        if isinstance(json_res, dict) and json_res.get("error_code") == "resource_not_found":
+            return res.to_result_ok(0)
+        return res.to_result_err(f"Unexpected response format: {json_res}")
+    except Exception as e:
+        return res.to_result_err(e)

mm_apt-0.5.0/src/mm_apt/coin.py

@@ -0,0 +1,5 @@
+APTOS_COIN_TYPE = "0x1::aptos_coin::AptosCoin"
+APTOS_COIN_DECIMALS = 8
+
+USDT_METADATA = "0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b"
+USDT_DECIMALS = 6

{mm_apt-0.4.2 → mm_apt-0.5.0}/tests/test_account.py

@@ -32,7 +32,7 @@ def test_invalid_full_length_addresses():
     bad_char = "0x" + "g" + "0" * 63
     assert is_valid_address(bad_char) is False
     # Numeric type
-    assert is_valid_address(123) is False
+    assert is_valid_address(123) is False  # pyright: ignore[reportArgumentType]
 
 
 def test_address_out_of_range():

mm_apt-0.5.0/tests/test_balance.py

@@ -0,0 +1,12 @@
+from mm_apt.balance import get_balance
+from mm_apt.coin import APTOS_COIN_TYPE, USDT_METADATA
+
+
+async def test_get_balance(mainnet_rpc_url, okx_address):
+    res = await get_balance(mainnet_rpc_url, okx_address, APTOS_COIN_TYPE)
+    assert res.unwrap() > 1000
+
+
+async def test_get_balance_usdt(mainnet_rpc_url, okx_address):
+    res = await get_balance(mainnet_rpc_url, okx_address, USDT_METADATA)
+    assert res.unwrap() > 0