PyAutoBlockchain 0.3

PAB is a framework for developing and running custom tasks in crypto blockchains.

PyAutoBlockchain (PAB)

PAB is a framework that helps with development and automation of periodic tasks on blockchains.

For a more in-depth guide see GUIDE.md, the example at examples or a more complex implementation at PolyCompounder.

Installation

Using pip:

$ pip install PyAutoBlockchain

Usage

(venv) $ pab create-keyfile [-o keyfile]  # Create keyfile
(venv) $ pab edit-config  # Edit config file
(venv) $ pab list-strategies -v  # List available strategies and parameters
(venv) $ pab run  # Run tasks

Configuration

Configure wallet and RPC

Create project config and keyfile:

(venv) $ pab edit-config
(venv) $ pab create-keyfile

A basic config file without alerts enabled might look like:

{
    "blockchain": "POLYGON",
    "chainId": 137,
    "endpoint": "https://mainnet.infura.io/v3/your_key",
    "myAddress": "0xyour_address"
}

You can get a free RPC endpoint for most known blockchains (e.g. Infura or MaticVigil).

Adding extra contracts

To use contracts in the strategies you first need to add the abi file to abis and modify the contracts.json file to load it.

For example, given the contract for MYTOKEN at 0x12345 create the abifile at abis/mytoken.abi and add to contracts.json the following:

{
    "MYTOKEN": {
        "address": "0x12345",
        "abifile": "mytoken.abi"
    }
}

Adding extra strategies

You can add strategies to execute at strategies.json. For example, the following example defines 1 estrategy to execute, using the strategy BaseStrategy and the contracts BNB, WBTC, PAIR, MASTERCHEF and ROUTER.

[
    {
        "strategy": "BaseStrategy",
        "name": "BNB-WBTC",
        "repeat_every": {
            "days": 1
        },
        "params": {
            "swap_path": ["BNB", "WBTC"],
            "pair": "PAIR",
            "masterchef": "MASTERCHEF",
            "router": "ROUTER",
            "pool_id": 11
        }
    }
]

Strategies are dictionaries with:

• strategy: Class name of strategy (must be subclass of pab.strategy.BaseStrategy, see pab list-strategies)
• name: Name, just for logging.
• params: Dictionary with strategy parameters. (see pab list-strategies -v)
• repeat_every: Optional. Dictionary with periodicity of the process, same arguments as datetime.timedelta.

Run pab list-strategies -v to see available strategies and parameters.

Email alerts

You can setup email alerts for when something goes wrong. Add the following to your config.json:

{
    "emails": {
        "enabled": true,
        "host": "smtp.host.com",
        "port": 465,
        "address": "[e-mail]",
        "password": "password",
        "recipient": "[e-mail]"
    }   
}

Developing

For details see ARCHITECTURE.md

Running tests

Using pytest:

(venv) $ pip install -e requirements-dev.txt
(venv) $ ./tests.sh