Skip to main content

EtherHound Core - Blockchain Event Scanner Server

Project description

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

Github installation (recommended):

  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)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

etherhound_core-0.1.2b1.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

etherhound_core-0.1.2b1-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

Details for the file etherhound_core-0.1.2b1.tar.gz.

File metadata

  • Download URL: etherhound_core-0.1.2b1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for etherhound_core-0.1.2b1.tar.gz
Algorithm Hash digest
SHA256 bbb4656fc976e27e518701ec47d0f700dfcfabff843153bebe18d878c031a98a
MD5 ea54176c3bc12d70e913f9daba735bfe
BLAKE2b-256 e21b40179b8f464dcfc5f07a1fd6ddfdabf2e49b912c7a1533134b3497538af0

See more details on using hashes here.

File details

Details for the file etherhound_core-0.1.2b1-py3-none-any.whl.

File metadata

File hashes

Hashes for etherhound_core-0.1.2b1-py3-none-any.whl
Algorithm Hash digest
SHA256 057cc1371e6300746cf356bb66c51aef485f304deaf0ef6e8887e8de299ad73c
MD5 2b87d6b2dbd45f0c019c71a5f30dfff7
BLAKE2b-256 e5bb34d6acfe9f2c951646a16e96330357240c22217b92645c4a914c925cdbae

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page