Skip to content

caesrcd/gnoban

Repository files navigation

GNOBAN

Tests Build Release

A program to analyze and ban Bitcoin nodes based on custom criteria.

Description

GNOBAN (Global Node Search & Ban) evaluates Bitcoin nodes connected to your node and bans those that match specified criteria — such as service flags, protocol versions, user agent strings, or minimum transaction fees.

Requirements

  • Bitcoin node running with RPC access allowed
  • Python 3.11+ (only if running from source)

How to use

Features

  • Scans all known addresses stored in your node's addrman
  • Bans nodes according to defined criteria:
    • Minimum transaction fees
    • Protocol version
    • User agent substring match
    • Service flags
    • Transport protocol type (v1/v2)
  • Unbans nodes that no longer meet the criteria
  • Unbans inactive addresses after multiple failed attempts
  • Supports SOCKS5 proxy connections

License

Distributed under the MIT software license, see the accompanying file COPYING or visit: https://opensource.org/licenses/mit.

About

A program to analyze and ban Bitcoin nodes based on custom criteria.

Resources

License

Stars

Watchers

Forks

Contributors

Languages