chainhound 0.1.0__py3-none-any.whl

chainhound/__init__.py

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

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/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/entrypoint.py

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

chainhound-0.1.0.dist-info/METADATA

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

@@ -0,0 +1,8 @@
+chainhound/__init__.py,sha256=Tss2VDS-l8OEp-wlZwg5K63o7vFOHifMLmPriNbnlR4,78
+chainhound/blockchain.py,sha256=GyVHHh--1W_PWfYFBNCdlJ2kuLL1yfbWuEqN5y7sKeo,1375
+chainhound/config.py,sha256=05qZtEna8VXGpaGK4wQo-NI30jaUEv-NvzIcnX78BXc,243
+chainhound/entrypoint.py,sha256=s4u77UySp-WFoFhsakbICYr3t-5VzUjn9H890_dl0OU,59
+chainhound-0.1.0.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+chainhound-0.1.0.dist-info/entry_points.txt,sha256=e2WQV4-MU8mNqaTAs-ANxPY4Lt_RIJXrmgHnI7bz6-w,48
+chainhound-0.1.0.dist-info/METADATA,sha256=9Rn_Tzzl8QYkXf6rfqLrFBc2KWWFp_uWkAey7NduWtI,389
+chainhound-0.1.0.dist-info/RECORD,,

chainhound-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.18
+Root-Is-Purelib: true
+Tag: py3-none-any

chainhound-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+chainhound = chainhound:main
+