{"id":13453304,"url":"https://github.com/EOSIO/patroneos","last_synced_at":"2025-03-24T01:31:21.477Z","repository":{"id":57634356,"uuid":"132928899","full_name":"EOSIO/patroneos","owner":"EOSIO","description":"RPC Checkpoint for EOS nodes","archived":false,"fork":false,"pushed_at":"2022-09-21T17:26:59.000Z","size":580,"stargazers_count":47,"open_issues_count":2,"forks_count":36,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-01-25T04:52:45.949Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EOSIO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-10T16:47:44.000Z","updated_at":"2022-06-25T16:13:26.000Z","dependencies_parsed_at":"2022-09-16T03:50:37.708Z","dependency_job_id":null,"html_url":"https://github.com/EOSIO/patroneos","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EOSIO%2Fpatroneos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EOSIO%2Fpatroneos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EOSIO%2Fpatroneos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EOSIO%2Fpatroneos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EOSIO","download_url":"https://codeload.github.com/EOSIO/patroneos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245194211,"owners_count":20575725,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T08:00:37.767Z","updated_at":"2025-03-24T01:31:20.741Z","avatar_url":"https://github.com/EOSIO.png","language":"Go","funding_links":[],"categories":["EOS Smart Contract Development","Tools","Developers"],"sub_categories":["Node Tools","Block Producer tools"],"readme":"# Patroneos [![Build Status](https://travis-ci.org/EOSIO/patroneos.svg?branch=master)](https://travis-ci.org/EOSIO/patroneos)\n\nPatroneos provides a layer of protection for EOSIO nodes designed to protect against some of the basic Denial of Service attack vectors. It runs in a simple configuration and a more advanced configuration.\n\n## Building\nTo build patroneos, you can simply clone the repository, and then run `./build.sh` from within the repository directory.\n\n```\ngit clone https://github.com/EOSIO/patroneos\ncd patroneos\n./build.sh\n```\n\nYou can also target a specific branch/tag/release. In the below example, we are building Patroneos v1.1.0.\n```\ngit clone -b 1.1.0 https://github.com/EOSIO/patroneos\ncd patroneos\n./build.sh\n```\n\nYou can confirm the version by using `patroneosd -v` which will output the Branch/Tag/Release, Git Commit ID, and Build Date/Time.\n\n## Simple Configuration\nThe simple configuration is designed to simply drop requests that are invalid or could cause unnecessary load on the node. This is done by running the request through a set of middleware (described below) that apply rules to the request. If a request passes all the middleware, it is forwarded to the node with the response returned to the user. Otherwise, an error code and the failure condition is returned to the user.\n\n```\nSuccessful request data flow\n-----------------------------\nUser --\u003e Patroneos --\u003e Nodeos --\u003e Patroneos --\u003e User\n```\n```\nFailed request data flow\n-------------------------\nUser --\u003e Patroneos --\u003e User\n```\n\nTo setup Patroneos in the simple configuration, a user just needs nodeos running, a compiled patroneos binary, and a correct `config.json`. See [Basic Patroneos Setup](TUTORIAL-SIMPLE.md) for a walkthrough of setting up and using Patroneos.\n\n#### Middleware Verification Layer\n\n* validateJSON\n    * This middleware checks that the body provided can be parsed into a JSON object.\n\n* validateMaxTransactions\n    * This middleware checks that the number of transactions in a request does not exceed the defined maximum.\n\n* validateMaxSignatures\n    * This middleware checks that the number of signatures on the transaction are not greater than the defined maximum.\n\n* validateContract\n    * This middleware checks that the contract is not in a list of blacklisted contracts.\n\n* validateTransactionSize\n    * This middleware checks that the size of the transaction data does not exceed the defined maximum.\n\n## Advanced Configuration\nThe advanced configuration works in coordination with fail2ban to ban users that repeatedly submit blocked requests. It requires a reverse proxy, patroneos running in fail2ban-relay mode, fail2ban, patroneos running in filter mode, and nodeos.\n\nThe advanced configuration is defined more in depth at [Advanced Patroneos Setup](TUTORIAL-ADVANCED.md)\n\n## Data Flow Diagram\n\n![Data Flow Diagram](patroneos-diagram.png \"Patroneos Data Flow Diagram\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEOSIO%2Fpatroneos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEOSIO%2Fpatroneos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEOSIO%2Fpatroneos/lists"}