Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/EOSIO/patroneos
RPC Checkpoint for EOS nodes
https://github.com/EOSIO/patroneos
Last synced: about 1 month ago
JSON representation
RPC Checkpoint for EOS nodes
- Host: GitHub
- URL: https://github.com/EOSIO/patroneos
- Owner: EOSIO
- License: mit
- Created: 2018-05-10T16:47:44.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-09-21T17:26:59.000Z (about 2 years ago)
- Last Synced: 2024-01-25T04:52:45.949Z (11 months ago)
- Language: Go
- Size: 566 KB
- Stars: 47
- Watchers: 38
- Forks: 36
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-eos-security - Partron EOS - Patroneos provides a layer of protection for EOSIO nodes designed to protect against some of the basic Denial of Service attack vectors (EOS Smart Contract Development / Node Tools)
- awesome-EOS - PatronEOS - RPC Checkpoint for EOS nodes. (Tools / Node Tools)
- awesome-eosio - Patroneos - RPC Checkpoint for EOSIO nodes. (Developers / Block Producer tools)
README
# Patroneos [](https://travis-ci.org/EOSIO/patroneos)
Patroneos 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.
## Building
To build patroneos, you can simply clone the repository, and then run `./build.sh` from within the repository directory.
```
git clone https://github.com/EOSIO/patroneos
cd patroneos
./build.sh
```
You can also target a specific branch/tag/release. In the below example, we are building Patroneos v1.1.0.
```
git clone -b 1.1.0 https://github.com/EOSIO/patroneos
cd patroneos
./build.sh
```
You can confirm the version by using `patroneosd -v` which will output the Branch/Tag/Release, Git Commit ID, and Build Date/Time.
## Simple Configuration
The 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.
```
Successful request data flow
-----------------------------
User --> Patroneos --> Nodeos --> Patroneos --> User
```
```
Failed request data flow
-------------------------
User --> Patroneos --> User
```
To 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.
#### Middleware Verification Layer
* validateJSON
* This middleware checks that the body provided can be parsed into a JSON object.
* validateMaxTransactions
* This middleware checks that the number of transactions in a request does not exceed the defined maximum.
* validateMaxSignatures
* This middleware checks that the number of signatures on the transaction are not greater than the defined maximum.
* validateContract
* This middleware checks that the contract is not in a list of blacklisted contracts.
* validateTransactionSize
* This middleware checks that the size of the transaction data does not exceed the defined maximum.
## Advanced Configuration
The 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.
The advanced configuration is defined more in depth at [Advanced Patroneos Setup](TUTORIAL-ADVANCED.md)
## Data Flow Diagram
