mm-btc 0.0.5__tar.gz → 0.0.6__tar.gz

{mm_btc-0.0.5 → mm_btc-0.0.6}/PKG-INFO

@@ -1,9 +1,11 @@
 Metadata-Version: 2.1
 Name: mm-btc
-Version: 0.0.5
+Version: 0.0.6
 Requires-Python: >=3.12
 Requires-Dist: mm-std~=0.1.0
 Requires-Dist: hdwallet~=2.2.1
+Requires-Dist: bit~=0.8.0
+Requires-Dist: bitcoinlib~=0.6.15
 Requires-Dist: typer~=0.12.3
 Provides-Extra: dev
 Requires-Dist: build~=1.2.1; extra == "dev"

mm_btc-0.0.6/README.txt

@@ -0,0 +1,9 @@
+mm-btc
+
+
+Links:
+- https://en.bitcoin.it/wiki/Transaction
+- https://en.bitcoin.it/wiki/List_of_address_prefixes
+- https://github.com/bitcoin/bips/blob/master/README.mediawiki
+
+- https://github.com/Blockstream/esplora/blob/master/API.md

{mm_btc-0.0.5 → mm_btc-0.0.6}/pyproject.toml

@@ -1,10 +1,12 @@
 [project]
 name = "mm-btc"
-version = "0.0.5"
+version = "0.0.6"
 description = ""
 dependencies = [
     "mm-std~=0.1.0",
     "hdwallet~=2.2.1",
+    "bit~=0.8.0",
+    "bitcoinlib~=0.6.15",
     "typer~=0.12.3"
 ]
 requires-python = ">=3.12"
@@ -39,7 +41,7 @@ warn_no_return = false
 strict = true
 exclude = ["^tests/", "^tmp/"]
 [[tool.mypy.overrides]]
-module = ["hdwallet.*", "hdwallet.symbols.*", "telebot.util.*"]
+module = ["hdwallet.*", "hdwallet.symbols.*", "bit.*", "bitcoinlib.transactions.*"]
 ignore_missing_imports = true
 
 

mm_btc-0.0.6/src/mm_btc/blockstream.py

@@ -0,0 +1,91 @@
+from collections.abc import Sequence
+from typing import TypeAlias
+
+from mm_std import Err, HResponse, 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
+
+
+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 _request(self, url: str) -> HResponse:
+        return hr(f"{self.base_url}{url}", timeout=self.timeout, proxy=random_str_choice(self.proxies))

{mm_btc-0.0.5 → mm_btc-0.0.6}/src/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-0.0.6/src/mm_btc/cli/cmd/address_cmd.py

@@ -0,0 +1,10 @@
+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_address(address)
+    print_json(res)

mm_btc-0.0.6/src/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-0.0.6/src/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-0.0.6/src/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-0.0.6/src/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.0.5 → mm_btc-0.0.6}/src/mm_btc.egg-info/PKG-INFO

@@ -1,9 +1,11 @@
 Metadata-Version: 2.1
 Name: mm-btc
-Version: 0.0.5
+Version: 0.0.6
 Requires-Python: >=3.12
 Requires-Dist: mm-std~=0.1.0
 Requires-Dist: hdwallet~=2.2.1
+Requires-Dist: bit~=0.8.0
+Requires-Dist: bitcoinlib~=0.6.15
 Requires-Dist: typer~=0.12.3
 Provides-Extra: dev
 Requires-Dist: build~=1.2.1; extra == "dev"

{mm_btc-0.0.5 → mm_btc-0.0.6}/src/mm_btc.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ pyproject.toml
 src/mm_btc/__init__.py
 src/mm_btc/blockstream.py
 src/mm_btc/py.typed
+src/mm_btc/tx.py
 src/mm_btc/wallet.py
 src/mm_btc.egg-info/PKG-INFO
 src/mm_btc.egg-info/SOURCES.txt
@@ -15,6 +16,9 @@ src/mm_btc/cli/cli.py
 src/mm_btc/cli/cli_utils.py
 src/mm_btc/cli/cmd/__init__.py
 src/mm_btc/cli/cmd/address_cmd.py
+src/mm_btc/cli/cmd/create_tx_cmd.py
+src/mm_btc/cli/cmd/decode_tx_cmd.py
 src/mm_btc/cli/cmd/mnemonic_cmd.py
+src/mm_btc/cli/cmd/utxo_cmd.py
 tests/test_blockstream.py
 tests/test_wallet.py

{mm_btc-0.0.5 → mm_btc-0.0.6}/src/mm_btc.egg-info/requires.txt

@@ -1,5 +1,7 @@
 mm-std~=0.1.0
 hdwallet~=2.2.1
+bit~=0.8.0
+bitcoinlib~=0.6.15
 typer~=0.12.3
 
 [dev]

mm_btc-0.0.6/tests/test_blockstream.py

@@ -0,0 +1,28 @@
+from mm_btc import blockstream
+from mm_btc.blockstream import BlockstreamClient
+
+
+def test_get_address(binance_address, proxies):
+    client = BlockstreamClient(proxies=proxies, timeout=5, attempts=5)
+
+    # non-empty address
+    res = client.get_address(binance_address)
+    assert res.unwrap().chain_stats.tx_count > 800
+
+    # empty address
+    res = client.get_address("bc1pa48c294qk7yd7sc8y0wxydc3a2frv5j83e65rvm48v3ej098s5zs8kvh6d")
+    assert res.unwrap().chain_stats.tx_count == 0
+
+    # invalid address
+    res = client.get_address("bc1pa48c294qk7yd7sc8y0wxydc3a2frv5j83e65rvm48v3ej098s5zs8kvh5d")
+    assert res.unwrap_err() == blockstream.ERROR_INVALID_ADDRESS
+
+    # invalid network
+    res = client.get_address("mqkwWDWdgXhYunfoKvQfYyydwB5vdma3cK")
+    assert res.unwrap_err() == blockstream.ERROR_INVALID_NETWORK
+
+
+def test_get_confirmed_balance(binance_address, proxies):
+    client = BlockstreamClient(proxies=proxies)
+    res = client.get_confirmed_balance(binance_address)
+    assert res.unwrap() > 0

mm_btc-0.0.5/README.txt

@@ -1 +0,0 @@
-mm-btc

mm_btc-0.0.5/src/mm_btc/blockstream.py

@@ -1,63 +0,0 @@
-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.5/src/mm_btc/cli/cmd/address_cmd.py

@@ -1,10 +0,0 @@
-from mm_std import print_json
-
-from mm_btc import blockstream
-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)
-    print_json(res)

mm_btc-0.0.5/tests/test_blockstream.py

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