chainhound 0.1.0__tar.gz

chainhound-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: chainhound
+Version: 0.1.0
+Summary: Add your description here
+Author: spin3l
+Author-email: spin3l <dev.christianlopezgarcia@gmail.com>
+Requires-Dist: anyio>=4.13.0
+Requires-Dist: pydantic-settings>=2.14.1
+Requires-Dist: returns[compatible-mypy,mypy-compatible]>=0.28.0
+Requires-Dist: web3>=7.16.0
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+

chainhound-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "chainhound"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "spin3l", email = "dev.christianlopezgarcia@gmail.com" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "anyio>=4.13.0",
+    "pydantic-settings>=2.14.1",
+    "returns[compatible-mypy,mypy-compatible]>=0.28.0",
+    "web3>=7.16.0",
+]
+
+[project.scripts]
+chainhound = "chainhound:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pytest>=9.0.3",
+]

chainhound-0.1.0/src/chainhound/__init__.py

@@ -0,0 +1,4 @@
+from chainhound.entrypoint import main
+
+if __name__ == "__main__":
+    main()

chainhound-0.1.0/src/chainhound/blockchain.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from logging import getLogger
+
+from returns.result import Failure, Result, Success
+from web3 import AsyncBaseProvider, AsyncHTTPProvider, AsyncWeb3
+
+logger = getLogger(__name__)
+
+
+class BlockchainError(Exception):
+    def __init__(self, message: str = "") -> None:
+        self.message = message
+
+
+@dataclass(frozen=True, slots=True)
+class Blockchain:
+    web3: AsyncWeb3[AsyncBaseProvider]
+
+    @classmethod
+    def build(cls, endpoint: str) -> Blockchain:
+        if not endpoint:
+            raise ValueError(f"Incorrect endpoint: {endpoint}")
+
+        return cls(web3=AsyncWeb3(AsyncHTTPProvider(endpoint)))
+
+
+async def is_connected(blockchain: Blockchain) -> bool:
+    return await blockchain.web3.provider.is_connected()
+
+
+async def close_connection(blockchain: Blockchain) -> None:
+    assert blockchain is not None, "Must pass a valid blockchain"
+
+    logger.info("Closing blockchain connection")
+    await blockchain.web3.provider.disconnect()
+
+
+async def get_last_block_number(blockchain: Blockchain) -> Result[int, BlockchainError]:
+    if not await is_connected(blockchain):
+        return Failure(
+            BlockchainError("The given blockchain instance is not connected")
+        )
+
+    return Success(await blockchain.web3.eth.block_number)

chainhound-0.1.0/src/chainhound/config.py

@@ -0,0 +1,11 @@
+from pydantic import AnyUrl
+from pydantic_settings import BaseSettings
+
+
+class RpcSettings(BaseSettings):
+    endpoint: AnyUrl
+    chunk_size: int
+
+
+class Settings(BaseSettings):
+    rpc: RpcSettings = RpcSettings.model_construct()

chainhound-0.1.0/src/chainhound/entrypoint.py

@@ -0,0 +1,5 @@
+from anyio import run
+
+
+def main() -> None:
+    run()