mm-btc 0.0.5__py3-none-any.whl → 0.1.0__py3-none-any.whl

mm_btc/blockstream.py

@@ -1,7 +1,7 @@
 from collections.abc import Sequence
 from typing import TypeAlias
 
-from mm_std import Err, Ok, Result, hr
+from mm_std import Err, HResponse, Ok, Result, hr
 from mm_std.random_ import random_str_choice
 from pydantic import BaseModel
 
@@ -14,6 +14,13 @@ ERROR_INVALID_NETWORK = "INVALID_NETWORK"
 Proxy: TypeAlias = str | Sequence[str] | None
 
 
+class Mempool(BaseModel):
+    count: int
+    vsize: int
+    total_fee: int
+    fee_histogram: list[tuple[float, int]]
+
+
 class Address(BaseModel):
     class ChainStats(BaseModel):
         funded_txo_count: int
@@ -33,31 +40,71 @@ class Address(BaseModel):
     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),
-    )
+class Utxo(BaseModel):
+    class Status(BaseModel):
+        confirmed: bool
+        block_height: int
+        block_hash: str
+        block_time: int
+
+    txid: str
+    vout: int
+    status: Status
+    value: int
+
+
+class BlockstreamClient:
+    def __init__(self, testnet: bool = False, timeout: int = 10, proxies: Proxy = None, attempts: int = 1):
+        self.testnet = testnet
+        self.timeout = timeout
+        self.proxies = proxies
+        self.attempts = attempts
+        self.base_url = TESTNET_BASE_URL if testnet else MAINNET_BASE_URL
+
+    def get_address(self, address: str) -> Result[Address]:
+        result: Result[Address] = Err("not started yet")
+        data = None
+        for _ in range(self.attempts):
+            try:
+                res = self._request(f"/address/{address}")
+                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), data=data)
+            except Exception as err:
+                result = Err(err, data=data)
+        return result
+
+    def get_confirmed_balance(self, address: str) -> Result[int]:
+        return self.get_address(address).and_then(lambda a: Ok(a.chain_stats.funded_txo_sum - a.chain_stats.spent_txo_sum))
+
+    def get_utxo(self, address: str) -> Result[list[Utxo]]:
+        result: Result[list[Utxo]] = Err("not started yet")
+        data = None
+        for _ in range(self.attempts):
+            try:
+                res = self._request(f"/address/{address}/utxo")
+                data = res.to_dict()
+                return Ok([Utxo(**out) for out in res.json], data=data)
+            except Exception as err:
+                result = Err(err, data=data)
+        return result
+
+    def get_mempool(self) -> Result[Mempool]:
+        result: Result[Mempool] = Err("not started yet")
+        data = None
+        for _ in range(self.attempts):
+            try:
+                res = self._request("/mempool")
+                data = res.to_dict()
+                return Ok(Mempool(**res.json), data=data)
+            except Exception as err:
+                result = Err(err, data=data)
+        return result
+
+    def _request(self, url: str) -> HResponse:
+        return hr(f"{self.base_url}{url}", timeout=self.timeout, proxy=random_str_choice(self.proxies))

mm_btc/cli/cli.py

@@ -1,3 +1,4 @@
+from pathlib import Path
 from typing import Annotated
 
 import typer
@@ -5,7 +6,7 @@ import typer.core
 from mm_std import print_plain
 
 from mm_btc.cli import cli_utils
-from mm_btc.cli.cmd import address_cmd, mnemonic_cmd
+from mm_btc.cli.cmd import address_cmd, create_tx_cmd, decode_tx_cmd, mnemonic_cmd, utxo_cmd
 
 app = typer.Typer(no_args_is_help=True, pretty_exceptions_enable=False, add_completion=False)
 
@@ -42,6 +43,24 @@ def address_command(address: str) -> None:
     address_cmd.run(address)
 
 
+@app.command("create-tx")
+def create_tx_command(config_path: Annotated[Path, typer.Argument(exists=True)]) -> None:
+    """Create a transaction"""
+    create_tx_cmd.run(config_path)
+
+
+@app.command("decode-tx")
+def decode_tx_command(tx_hex: str, testnet: Annotated[bool, typer.Option("--testnet", "-t")] = False) -> None:
+    """Decode a transaction"""
+    decode_tx_cmd.run(tx_hex, testnet)
+
+
+@app.command("utxo")
+def utxo_command(address: str) -> None:
+    """Get UTXOs from Blockstream API"""
+    utxo_cmd.run(address)
+
+
 def version_callback(value: bool) -> None:
     if value:
         print_plain(f"mm-btc: v{cli_utils.get_version()}")

mm_btc/cli/cmd/address_cmd.py

@@ -1,10 +1,10 @@
 from mm_std import print_json
 
-from mm_btc import blockstream
+from mm_btc.blockstream import BlockstreamClient
 from mm_btc.wallet import is_testnet_address
 
 
 def run(address: str) -> None:
-    testnet = is_testnet_address(address)
-    res = blockstream.get_address(address, testnet=testnet)
+    client = BlockstreamClient(testnet=is_testnet_address(address))
+    res = client.get_address(address)
     print_json(res)

mm_btc/cli/cmd/create_tx_cmd.py

@@ -0,0 +1,27 @@
+from pathlib import Path
+
+from bit import PrivateKey, PrivateKeyTestnet
+from mm_std import BaseConfig, print_console
+
+from mm_btc.wallet import is_testnet_address
+
+
+class Config(BaseConfig):
+    class Output(BaseConfig):
+        address: str
+        amount: int
+
+    from_address: str
+    private: str
+    outputs: list[Output]
+
+
+def run(config_path: Path) -> None:
+    config = Config.read_config(config_path)
+    testnet = is_testnet_address(config.from_address)
+    key = PrivateKeyTestnet(config.private) if testnet else PrivateKey(config.private)
+
+    outputs = [(o.address, o.amount, "satoshi") for o in config.outputs]
+
+    tx = key.create_transaction(outputs)
+    print_console(tx)

mm_btc/cli/cmd/decode_tx_cmd.py

@@ -0,0 +1,8 @@
+from mm_std import print_json
+
+from mm_btc.tx import decode_tx
+
+
+def run(tx_hex: str, testnet: bool = False) -> None:
+    res = decode_tx(tx_hex, testnet)
+    print_json(res)

mm_btc/cli/cmd/utxo_cmd.py

@@ -0,0 +1,11 @@
+from mm_std import print_json
+
+from mm_btc.blockstream import BlockstreamClient
+from mm_btc.wallet import is_testnet_address
+
+
+def run(address: str) -> None:
+    client = BlockstreamClient(testnet=is_testnet_address(address))
+    res = client.get_utxo(address)
+
+    print_json(res.ok_or_err())

mm_btc/tx.py

@@ -0,0 +1,5 @@
+from bitcoinlib.transactions import Transaction
+
+
+def decode_tx(tx_hex: str, testnet: bool = False) -> dict[str, object]:
+    return Transaction.parse(tx_hex, network="testnet" if testnet else "mainnet").as_dict()  # type: ignore[no-any-return]

mm_btc-0.1.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.3
+Name: mm-btc
+Version: 0.1.0
+Requires-Python: >=3.12
+Requires-Dist: bitcoinlib~=0.6.15
+Requires-Dist: bit~=0.8.0
+Requires-Dist: hdwallet~=2.2.1
+Requires-Dist: mm-std~=0.1.2
+Requires-Dist: typer~=0.12.3

mm_btc-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+mm_btc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/blockstream.py,sha256=U2_pc6RYAkFcCvH_WrxjIm13VNavyY3WgK8ePowV-Ic,3620
+mm_btc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/tx.py,sha256=7KTMNuL1n8rRj_245BV1bH9M2_PctNvlvPsLEsRTYx4,245
+mm_btc/wallet.py,sha256=0ejOIl5gbm1oMO4WY3AsQRiF3PCrB4WC2LknaYPmMfY,1838
+mm_btc/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/cli/cli.py,sha256=D_yQ_L7oBY9aJ3_TKeJOQmXFsx8yK3lmARTAsmMXjO8,2413
+mm_btc/cli/cli_utils.py,sha256=g2o5ySLu-Tw8dZm84ZAsx8862yHij4sDfz4z6uLS2hw,102
+mm_btc/cli/cmd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mm_btc/cli/cmd/address_cmd.py,sha256=fipX9FiQ2EgCEq8nVN6ELnDMoR5KTIX7bpAaRK3t_yg,284
+mm_btc/cli/cmd/create_tx_cmd.py,sha256=dIuQBTOqTSefC6aMbrBN6Pq0EwV2G2ESM1tLU4WyFoU,690
+mm_btc/cli/cmd/decode_tx_cmd.py,sha256=0jGlUjnA1X2Q2aYwSBeAjqVNZIBsW5X2lEwIpSfWJsU,175
+mm_btc/cli/cmd/mnemonic_cmd.py,sha256=zAAHr9j0SLJX5BXoiMTZj8pIzTPX26aJEOUi7IN40Ug,1192
+mm_btc/cli/cmd/utxo_cmd.py,sha256=mp-lVLURpXFqO3IeBIEwnHusEvT5tFjUKxnRYC-rFqQ,294
+mm_btc-0.1.0.dist-info/METADATA,sha256=iCt1hMCcgWPzk7ush5pSB3QxfSfrhlind16xbDUSC1M,223
+mm_btc-0.1.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+mm_btc-0.1.0.dist-info/entry_points.txt,sha256=KphzLNE9eb9H1DO-L0gvBQaQT5ImedyVCN4a6svfiRg,46
+mm_btc-0.1.0.dist-info/RECORD,,

{mm_btc-0.0.5.dist-info → mm_btc-0.1.0.dist-info}/WHEEL

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

mm_btc-0.0.5.dist-info/METADATA

@@ -1,22 +0,0 @@
-Metadata-Version: 2.1
-Name: mm-btc
-Version: 0.0.5
-Requires-Python: >=3.12
-Requires-Dist: mm-std ~=0.1.0
-Requires-Dist: hdwallet ~=2.2.1
-Requires-Dist: typer ~=0.12.3
-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.5.dist-info/RECORD

@@ -1,15 +0,0 @@
-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=0ejOIl5gbm1oMO4WY3AsQRiF3PCrB4WC2LknaYPmMfY,1838
-mm_btc/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_btc/cli/cli.py,sha256=5UWUzlJvaV8qq2hZ_XptkaLPf81EbwlYFNcT-_xmQ_U,1825
-mm_btc/cli/cli_utils.py,sha256=g2o5ySLu-Tw8dZm84ZAsx8862yHij4sDfz4z6uLS2hw,102
-mm_btc/cli/cmd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mm_btc/cli/cmd/address_cmd.py,sha256=vOjPgK9D91w2YWyCvbRO1_dWfuRDxpjNzOUpJYvYEVE,262
-mm_btc/cli/cmd/mnemonic_cmd.py,sha256=zAAHr9j0SLJX5BXoiMTZj8pIzTPX26aJEOUi7IN40Ug,1192
-mm_btc-0.0.5.dist-info/METADATA,sha256=28ask6JTpLCaDXE_gNWlatFVY88mgZbovq3CvdMvg84,858
-mm_btc-0.0.5.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-mm_btc-0.0.5.dist-info/entry_points.txt,sha256=KphzLNE9eb9H1DO-L0gvBQaQT5ImedyVCN4a6svfiRg,46
-mm_btc-0.0.5.dist-info/top_level.txt,sha256=0X0Ppv_QY0ulzgCB5HNezpaHfQ4wvih_B72hn5hHTUE,7
-mm_btc-0.0.5.dist-info/RECORD,,

mm_btc-0.0.5.dist-info/top_level.txt

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