mm-btc 0.0.2__tar.gz

mm_btc-0.0.2/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.1
+Name: mm-btc
+Version: 0.0.2
+Requires-Python: >=3.12
+Requires-Dist: mm-std~=0.1.0
+Requires-Dist: hdwallet~=2.2.1
+Provides-Extra: dev
+Requires-Dist: build~=1.2.1; extra == "dev"
+Requires-Dist: twine~=5.1.0; extra == "dev"
+Requires-Dist: pytest~=8.3.2; extra == "dev"
+Requires-Dist: pytest-xdist~=3.6.1; extra == "dev"
+Requires-Dist: pytest-httpserver~=1.0.8; extra == "dev"
+Requires-Dist: coverage~=7.6.0; extra == "dev"
+Requires-Dist: ruff~=0.5.2; extra == "dev"
+Requires-Dist: pip-audit~=2.7.0; extra == "dev"
+Requires-Dist: bandit~=1.7.7; extra == "dev"
+Requires-Dist: mypy~=1.11.0; extra == "dev"
+Requires-Dist: types-python-dateutil~=2.9.0; extra == "dev"
+Requires-Dist: types-requests~=2.32.0.20240523; extra == "dev"
+Requires-Dist: types-PyYAML~=6.0.12.12; extra == "dev"

mm_btc-0.0.2/README.txt

@@ -0,0 +1,2 @@
+For tests:
+ - binance address: 34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo

mm_btc-0.0.2/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "mm-btc"
+version = "0.0.2"
+description = ""
+dependencies = [
+    "mm-std~=0.1.0",
+    "hdwallet~=2.2.1"
+]
+requires-python = ">=3.12"
+[project.optional-dependencies]
+dev = [
+    "build~=1.2.1",
+    "twine~=5.1.0",
+    "pytest~=8.3.2",
+    "pytest-xdist~=3.6.1",
+    "pytest-httpserver~=1.0.8",
+    "coverage~=7.6.0",
+    "ruff~=0.5.2",
+    "pip-audit~=2.7.0",
+    "bandit~=1.7.7",
+    "mypy~=1.11.0",
+    "types-python-dateutil~=2.9.0",
+    "types-requests~=2.32.0.20240523",
+    "types-PyYAML~=6.0.12.12",
+]
+
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+
+[tool.mypy]
+python_version = "3.12"
+warn_no_return = false
+strict = true
+exclude = ["^tests/", "^tmp/"]
+[[tool.mypy.overrides]]
+module = ["hdwallet.*", "hdwallet.symbols.*", "telebot.util.*"]
+ignore_missing_imports = true
+
+
+[tool.ruff]
+line-length = 130
+target-version = "py312"
+lint.select = [
+    "F", # Pyflakes
+    "E", "W", # pycodestyle
+    "UP", # pyupgrade
+    "B", # flake8-bugbear
+    "A", # flake8-builtins
+    "COM", # flake8-commas
+    "C40", # flake8-comprehensions
+    "G", # flake8-logging-format
+    "PIE", # flake8-pie
+    "T20", # flake8-print
+    "RUF", # Ruff-specific rules
+]
+lint.ignore = [
+    "A003", #builtin-attribute-shadowing
+    "UP040", # non-pep695-type-alias
+    "COM812",
+]
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+
+[tool.bandit]
+exclude_dirs = ["tests"]
+skips = ["B311"]

mm_btc-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mm_btc-0.0.2/src/mm_btc/blockstream.py

@@ -0,0 +1,63 @@
+from collections.abc import Sequence
+from typing import TypeAlias
+
+from mm_std import Err, Ok, Result, hr
+from mm_std.random_ import random_str_choice
+from pydantic import BaseModel
+
+MAINNET_BASE_URL = "https://blockstream.info/api"
+TESTNET_BASE_URL = "https://blockstream.info/testnet/api"
+
+ERROR_INVALID_ADDRESS = "INVALID_ADDRESS"
+ERROR_INVALID_NETWORK = "INVALID_NETWORK"
+
+Proxy: TypeAlias = str | Sequence[str] | None
+
+
+class Address(BaseModel):
+    class ChainStats(BaseModel):
+        funded_txo_count: int
+        funded_txo_sum: int
+        spent_txo_count: int
+        spent_txo_sum: int
+        tx_count: int
+
+    class MempoolStats(BaseModel):
+        funded_txo_count: int
+        funded_txo_sum: int
+        spent_txo_count: int
+        spent_txo_sum: int
+        tx_count: int
+
+    chain_stats: ChainStats
+    mempool_stats: MempoolStats
+
+
+def get_address(
+    address: str, testnet: bool = False, timeout: int = 10, proxies: Proxy = None, attempts: int = 1
+) -> Result[Address]:
+    result: Result[Address] = Err("not started yet")
+    data = None
+    base_url = TESTNET_BASE_URL if testnet else MAINNET_BASE_URL
+    for _ in range(attempts):
+        try:
+            res = hr(f"{base_url}/address/{address}", timeout=timeout, proxy=random_str_choice(proxies))
+            data = res.to_dict()
+            if res.code == 400 and (
+                "invalid bitcoin address" in res.body.lower() or "bech32 segwit decoding error" in res.body.lower()
+            ):
+                return Err(ERROR_INVALID_ADDRESS, data=data)
+            elif res.code == 400 and "invalid network" in res.body.lower():
+                return Err(ERROR_INVALID_NETWORK, data=data)
+            return Ok(Address(**res.json))
+        except Exception as err:
+            result = Err(err, data=data)
+    return result
+
+
+def get_confirmed_balance(
+    address: str, testnet: bool = False, timeout: int = 10, proxies: Proxy = None, attempts: int = 1
+) -> Result[int]:
+    return get_address(address, testnet=testnet, timeout=timeout, proxies=proxies, attempts=attempts).and_then(
+        lambda a: Ok(a.chain_stats.funded_txo_sum - a.chain_stats.spent_txo_sum),
+    )

mm_btc-0.0.2/src/mm_btc/wallet.py

@@ -0,0 +1,45 @@
+from dataclasses import dataclass
+
+from hdwallet import BIP44HDWallet, BIP84HDWallet
+from hdwallet.symbols import BTC, BTCTEST
+from hdwallet.utils import generate_mnemonic as new_mnemonic
+
+BIP44_MAINNET_PATH = "m/44'/0'/0'/0"
+BIP44_TESTNET_PATH = "m/44'/1'/0'/0"
+BIP84_MAINNET_PATH = "m/84'/0'/0'/0"
+BIP84_TESTNET_PATH = "m/84'/1'/0'/0"
+
+
+@dataclass
+class Account:
+    address: str
+    private: str
+    path: str
+
+
+def generate_mnemonic(language: str = "english", strength: int = 128) -> str:
+    return new_mnemonic(language=language, strength=strength)  # type: ignore[no-any-return]
+
+
+def derive_accounts(mnemonic: str, passphrase: str, path: str, limit: int) -> list[Account]:
+    if path.startswith("m/84'/1'"):
+        w = BIP84HDWallet(symbol=BTCTEST)
+    elif path.startswith("m/44'/1'"):
+        w = BIP44HDWallet(symbol=BTCTEST)
+    elif path.startswith("m/84'/0'"):
+        w = BIP84HDWallet(symbol=BTC)
+    elif path.startswith("m/44'/0'"):
+        w = BIP44HDWallet(symbol=BTC)
+    else:
+        raise ValueError("Invalid path")
+
+    w.from_mnemonic(mnemonic, passphrase=passphrase)
+    w.clean_derivation()
+
+    accounts = []
+    for index_path in range(limit):
+        w.from_path(path=f"{path}/{index_path}")
+        accounts.append(Account(address=w.address(), private=w.wif(), path=f"{path}/{index_path}"))
+        w.clean_derivation()
+
+    return accounts

mm_btc-0.0.2/src/mm_btc.egg-info/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.1
+Name: mm-btc
+Version: 0.0.2
+Requires-Python: >=3.12
+Requires-Dist: mm-std~=0.1.0
+Requires-Dist: hdwallet~=2.2.1
+Provides-Extra: dev
+Requires-Dist: build~=1.2.1; extra == "dev"
+Requires-Dist: twine~=5.1.0; extra == "dev"
+Requires-Dist: pytest~=8.3.2; extra == "dev"
+Requires-Dist: pytest-xdist~=3.6.1; extra == "dev"
+Requires-Dist: pytest-httpserver~=1.0.8; extra == "dev"
+Requires-Dist: coverage~=7.6.0; extra == "dev"
+Requires-Dist: ruff~=0.5.2; extra == "dev"
+Requires-Dist: pip-audit~=2.7.0; extra == "dev"
+Requires-Dist: bandit~=1.7.7; extra == "dev"
+Requires-Dist: mypy~=1.11.0; extra == "dev"
+Requires-Dist: types-python-dateutil~=2.9.0; extra == "dev"
+Requires-Dist: types-requests~=2.32.0.20240523; extra == "dev"
+Requires-Dist: types-PyYAML~=6.0.12.12; extra == "dev"

mm_btc-0.0.2/src/mm_btc.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.txt
+pyproject.toml
+src/mm_btc/__init__.py
+src/mm_btc/blockstream.py
+src/mm_btc/py.typed
+src/mm_btc/wallet.py
+src/mm_btc.egg-info/PKG-INFO
+src/mm_btc.egg-info/SOURCES.txt
+src/mm_btc.egg-info/dependency_links.txt
+src/mm_btc.egg-info/requires.txt
+src/mm_btc.egg-info/top_level.txt
+tests/test_blockstream.py
+tests/test_wallet.py

mm_btc-0.0.2/src/mm_btc.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mm_btc-0.0.2/src/mm_btc.egg-info/requires.txt

@@ -0,0 +1,17 @@
+mm-std~=0.1.0
+hdwallet~=2.2.1
+
+[dev]
+build~=1.2.1
+twine~=5.1.0
+pytest~=8.3.2
+pytest-xdist~=3.6.1
+pytest-httpserver~=1.0.8
+coverage~=7.6.0
+ruff~=0.5.2
+pip-audit~=2.7.0
+bandit~=1.7.7
+mypy~=1.11.0
+types-python-dateutil~=2.9.0
+types-requests~=2.32.0.20240523
+types-PyYAML~=6.0.12.12

mm_btc-0.0.2/src/mm_btc.egg-info/top_level.txt

@@ -0,0 +1 @@
+mm_btc

mm_btc-0.0.2/tests/test_blockstream.py

@@ -0,0 +1,24 @@
+from mm_btc import blockstream
+
+
+def test_get_address(binance_address):
+    # non-empty address
+    res = blockstream.get_address(binance_address)
+    assert res.unwrap().chain_stats.tx_count > 800
+
+    # empty address
+    res = blockstream.get_address("bc1pa48c294qk7yd7sc8y0wxydc3a2frv5j83e65rvm48v3ej098s5zs8kvh6d")
+    assert res.unwrap().chain_stats.tx_count == 0
+
+    # invalid address
+    res = blockstream.get_address("bc1pa48c294qk7yd7sc8y0wxydc3a2frv5j83e65rvm48v3ej098s5zs8kvh5d")
+    assert res.unwrap_err() == blockstream.ERROR_INVALID_ADDRESS
+
+    # invalid network
+    res = blockstream.get_address(binance_address, testnet=True)
+    assert res.unwrap_err() == blockstream.ERROR_INVALID_NETWORK
+
+
+def test_get_confirmed_balance(binance_address):
+    res = blockstream.get_confirmed_balance(binance_address)
+    assert res.unwrap() > 0

mm_btc-0.0.2/tests/test_wallet.py

@@ -0,0 +1,44 @@
+from mm_btc.wallet import (
+    BIP44_MAINNET_PATH,
+    BIP44_TESTNET_PATH,
+    BIP84_MAINNET_PATH,
+    BIP84_TESTNET_PATH,
+    derive_accounts,
+    generate_mnemonic,
+)
+
+
+def test_generate_mnemonic():
+    mnemonic = generate_mnemonic(strength=256)
+    assert len(mnemonic.split()) == 24
+
+    assert generate_mnemonic() != generate_mnemonic()
+
+
+def test_derive_accounts():
+    mnemonic = "arrange mutual earth tackle smart kangaroo rigid census exotic acoustic stock dream eager area laptop"
+    passphrase = "my-secret"
+
+    # mainnet bip44
+    accs = derive_accounts(mnemonic, passphrase, BIP44_MAINNET_PATH, 2)
+    assert accs[1].path == "m/44'/0'/0'/0/1"
+    assert accs[1].address == "1L4Ghh4kuJuRCXrFrczwCV2TaggfCgf6B3"
+    assert accs[1].private == "Kz4zoYPJ5astywoTbxHQr5SgFvMCekMqnWDFnXjY9CfvFtyNnGiE"
+
+    # mainnet bip84
+    accs = derive_accounts(mnemonic, passphrase, BIP84_MAINNET_PATH, 2)
+    assert accs[1].path == "m/84'/0'/0'/0/1"
+    assert accs[1].address == "bc1qrq2mwuqz3utyqz97xjq5npl0dyq5gmddpxdf8k"
+    assert accs[1].private == "L447sW2JenqmEMMi7GoiUZDxTpY3Ni5ZfRrRxAbufiYwZV1AHytj"
+
+    # testnet bip44
+    accs = derive_accounts(mnemonic, passphrase, BIP44_TESTNET_PATH, 2)
+    assert accs[1].path == "m/44'/1'/0'/0/1"
+    assert accs[1].address == "n3DsvbopmKJaxHNgdZ6VVK4mB9fcuhXy5w"
+    assert accs[1].private == "cVsAhYpSm2x8V2fQJdjmfBGm1aW7xKH1U8eZTpG9giz8usxNv4da"
+
+    # testnet bip84
+    accs = derive_accounts(mnemonic, passphrase, BIP84_TESTNET_PATH, 2)
+    assert accs[1].path == "m/84'/1'/0'/0/1"
+    assert accs[1].address == "tb1q4cu7pgs0w5s4ctjz4m6gx6m4rv8eqjwtnt0a4j"
+    assert accs[1].private == "cPASMrozgCxXD6GQsJhge7hPY81j3huF8RJBY1PYwKmUVSYgeSRw"