mm-btc 0.0.2__py3-none-any.whl

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/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.dist-info/METADATA

@@ -0,0 +1,21 @@
+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.dist-info/RECORD

@@ -0,0 +1,8 @@
+mm_btc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/blockstream.py,sha256=HllRQBO1Ezl0ArVH8b-CPRi0f5zdRNXJT_K3oCpAtgg,2159
+mm_btc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/wallet.py,sha256=XI2Ju5dELc_2wqyag6M-k5s3EZODN9qJKm3yjurJORE,1375
+mm_btc-0.0.2.dist-info/METADATA,sha256=LdFWJbmxkPxaaxnInxW9KlEDh_QMji8xMbf4-n8YxtM,828
+mm_btc-0.0.2.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+mm_btc-0.0.2.dist-info/top_level.txt,sha256=0X0Ppv_QY0ulzgCB5HNezpaHfQ4wvih_B72hn5hHTUE,7
+mm_btc-0.0.2.dist-info/RECORD,,

mm_btc-0.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (72.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mm_btc-0.0.2.dist-info/top_level.txt

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