Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Forks Issues Contributors


Logo

EtherHound (Core)

The core of EtherHound — fast, flexible Ethereum blockchain event tracker.

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

EtherHound Core is the foundational service of the EtherHound suite — a modular, event-driven blockchain scanner designed to monitor Ethereum networks with high precision.

(back to top)

Built With

  • Web3.py
  • FastAPI
  • Pydantic
  • Typer

(back to top)

Getting Started

Prerequisites

  • python >= 3.10
  • web3 >= 7.12.0
  • fastapi[standard]
  • pydantic
  • typer (CLI)

Installation

  1. clone the repo
git clone https://github.com/EtherHounds/Core.git
  1. cd into the repo
cd Core
  1. build
pip install . -U
  1. done!

PyPi:

pip install etherhound-core

(back to top)

Usage

CLI (hound)

deploy

used to deploy the Hound Server

Args:

  • host (str): the uvicorn server host, default=localhost
  • port (int): the uvicorn server port, default=8080
  • rpc (str): the RPC url from your provider
  • mode (str): the scanner mode, default="fast"
  • detach (bool): de-attach from the server, default=False
  • load_env (bool): get the rpc,mode from the .env file, default=False

(back to top)

Roadmap

  • Examples
  • Better Documentation
  • Docker image (docker hub)
  • BlockScanner Implementation

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Top contributors:

contrib.rocks image

License

Distributed under the project_license. See LICENSE.txt for more information.

(back to top)

Contact

SpicyPenguin - @kerolis55463

Project Link: https://github.com/EtherHounds/Core

(back to top)

Metadata

Release files for etherhound-core 0.1.2b1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for etherhound-core 0.1.2b1
File Size Uploaded Provenance Actions
etherhound_core-0.1.2b1.tar.gz 25.7 kB Without provenance Details for etherhound_core-0.1.2b1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for etherhound-core 0.1.2b1
File Interpreter ABI Platform Actions
etherhound_core-0.1.2b1-py3-none-any.whl Python 3 none any Details for etherhound_core-0.1.2b1-py3-none-any.whl

Total release size: 54.9 kB

Release files / etherhound_core-0.1.2b1.tar.gz

Download URL etherhound_core-0.1.2b1.tar.gz
Size 25.7 kB
Tags Source
SHA-256 checksum
How to use checksums
bbb4656fc976e27e518701ec47d0f700dfcfabff843153bebe18d878c031a98a
BLAKE2b-256 checksum
How to use checksums
e21b40179b8f464dcfc5f07a1fd6ddfdabf2e49b912c7a1533134b3497538af0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / etherhound_core-0.1.2b1-py3-none-any.whl

Download URL etherhound_core-0.1.2b1-py3-none-any.whl
Size 29.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
057cc1371e6300746cf356bb66c51aef485f304deaf0ef6e8887e8de299ad73c
BLAKE2b-256 checksum
How to use checksums
e5bb34d6acfe9f2c951646a16e96330357240c22217b92645c4a914c925cdbae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Security for etherhound-core 0.1.2b1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page