SybilShield

A solution for detecting and preventing sybil attacks on Starknet blockchain

Report a Bug - Request a Feature - Ask a Question

About

SybilShield is an open-source project built for the StarkNet ecosystem that utilizes blockchain data to detect Sybil attack behaviors.

A Sybil attack is a type of attack where an attacker creates multiple fake identities (also known as Sybil nodes) in a network in order to gain control or disrupt the network's operation.

SybilShield is implemented using Apibara technology to explore on-chain data, allowing it to detect and mitigate Sybil attacks by identifying and isolating fake identities.

Getting Started

• Install Python version management tool: pyenv or asdf
• Install Python 3.9.14 using the Python version management tool and activate that version
• Clone this repository
• Verify the active Python version: python -V
• Install Poetry — a dependency manager
• Create Python virtual environment in the project directory: poetry env use 3.9
• Activate environment: poetry shell
• Upgrade pip: pip install --upgrade pip
• Install project dependencies: poetry install
  • MacBook M1/M2: To define
• Verify the setup by running tests: poetry run test
• Export entrypoint: export FLASK_APP=app
• Run the server: poetry run flask run

Prerequisites

Typescript

Roadmap

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

Support

Reach out to the maintainer at one of the following places:

• GitHub Discussions

Project assistance

If you want to say thank you or/and support active development:

• Add a GitHub Star to the project.
• Write interesting articles about the project on Dev.to, Medium or your personal blog.

Together, we can make SybilShield better!

Contributing

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

For a full list of all authors and contributors, see the contributors page.

Security

SybilShield follows good practices of security, but 100% security cannot be assured. SybilShield is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

License

This project is licensed under the MIT license.

See LICENSE for more information.

Resources

Here are some interesting resources about detection and mitigation of Sybil attacks:

• Review on Detection and Mitigation of Sybil Attack in the Network

Note: This list is not exhaustive, and is not intended to be.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!