Skip to content

Latest commit

 

History

History
101 lines (82 loc) · 3.37 KB

README.md

File metadata and controls

101 lines (82 loc) · 3.37 KB
Raw

lwf-checker

Current version: 1.0

This script checks the status of your LWF Delegate by using PHP.
Feel free to rewrite in Python or Bash.

This script will also check whether your node has forked or not.
When forked, it will stop LWF, restore to previous snapshot, and start LWF again.

This script will also check your consensus and switch forging to your backup node.
When both nodes have a bad consensus, it will restart LWF and let you know by sending a Telegram message.

IMPORTANT TO MENTION If you want to use the consensus controller, you need to add your secret(s) to config.php and remove them from your LWF config.json. Also, you have to give access to the forging API calls for both nodes. Like this (1.2.3.4 is the extra IP):

    "forging": {
        "force": false,
        "secret": [],
        "access": {
            "whiteList": [
                "127.0.0.1",
                "1.2.3.4"
            ]
        }
    },

After adding your slavenode IP to your masternode, or your masternode IP to your slavenode config.json and while still in the lwf-node directory, make sure to reload LWF with:

./lwf_manager.bash reload

There are some echo lines in this file.
When you redirect output to a log file in your crontab, these lines will show up.
See section Example crontab for more information.

Be sure to run this script after:

  • You have installed lwf-snapshot
  • You have created a snapshot with lwf-snapshot

Prerequisites

Be sure that your php.ini allows passthru(). It's default that it does though, so just check if this script is not working.

sudo apt install php php-cli php-mbstring php-sqlite3

Installation

You can clone this into every directory of your choosing. I usually just clone it into my home folder.

git clone https://github.com/samuelpaulsun/lwf-checker.git
  • Change settings inside config.php to match your needs
  • Edit your crontab with the example below

Example crontab

* * * * * php ~/lwf-checker/checkdelegate.php >> ~/lwf-checker/logs/checkdelegate.log 2>&1

Telegram bot

lwf-Checker comes with Telegram functionality which will allow shfit-checker to send you a message if anything requires your attention. It's very easy to set up:

  • Open Telegram and start a conversation with: userinfobot
  • Put your ID inside variable $telegramId.
$telegramId = "12345678";
  • Start a conversation with: botfather
  • Say: /newbot
  • Tell botfather your bot's name
  • Tell botfather your bot's username
  • Botfather will say "Congratulations!" and give you a token
  • Put your token inside variable $telegramApiKey.
$telegramApiKey 	= "1122334455:AAEhBOweik6ad9r_QXMENQjcrGbqCr4K-bs";
  • Edit the telegram toggle (true/false)
  • Start a conversation with your bot (username) to enable communication between you two

Contact

Contributors

Seatrips (create snapshot when status is okay)

Mrgr (Shift snapshots)

Donations

If you find this helpful and would like to donate, here you go: LWF = 4264922882619509863LWF SHIFT = 1202102259685170158S OXY = 4851450110347849329X