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.1b1.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.1b1-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: etherhound_core-0.1.1b1.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.1b1.tar.gz
Algorithm Hash digest
SHA256 747cd9e000b0c6e7c77d9cb6b81b6f23a927d8122900a5649d52d1dcf889ed8a
MD5 f25f29d4caae644eecc97795377a2426
BLAKE2b-256 ffec198fb150aedbec6b26988319dddcde9cea743a02e2477a5cdd10efac829b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for etherhound_core-0.1.1b1-py3-none-any.whl
Algorithm Hash digest
SHA256 2a4107cdbf3d933aa599dfaea3f306b9a2006cd7d5d20176b15508c77b66e539
MD5 f3b4d6005a27d921c008698f6e40ee5f
BLAKE2b-256 f1dce16bfe6e9ce583b554fda0cfe00ba3c51373f5307b986dce36df930de59b

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