Skip to content
Watchdog for EOS account and new transactions
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

EOS Account Watch Tool

This tool is watching transactions for EOS accounts, and sends an email alert whenever new transactions are seen in the network.

The tool requires an RPC URL of an EOS node that has the history plugin enabled and is using wildcard filter. Most of BP nodes do not support this feature. Here you can find instructions for building your own node for this purpose:

Installing the software

Packages required for Ubuntu or Debian:

apt-get install -y libjson-xs-perl libredis-perl libjson-perl \
 libwww-perl liblwp-protocol-https-perl libdigest-sha-perl \
 libemail-sender-perl libemail-mime-perl \
 postfix redis-server

mkdir -p $HOME/tools $HOME/etc $HOME/var/eosaccwatch
cd $HOME/tools
git clone

CentOS or RHEL can also be used, and you just need to install required Perl modules.

Configuration file

The configuration file is in Perl script syntax. There is am example file in the tool distribution. A recommendded place for it is etc folder in your home directory.

It should define the following elements:

  • $Conf::rpcurl: the URL to a nodeos node in the network with enabled history plugin and wildcard filter enabled. Most BP's do not have that enabled.

  • $Conf::workdir: the working directory where the tool keeps its state information. var/eosaccwatch in your home directory is a good example for such a directory. It slowly grows in size, as the tool saves copies of every email it sends.

  • $Conf::smtp_from: the sender email address that the tool will use for outgoing email. This should be a valid address with a valid domain, so that recipient mail servers don't treat the messages as spam.

  • @Conf::watchlist: the list of EOS account names and correspondig email addresses for notifications. Each entry is a hash with keys account_name and notify_email. The notify_email entry can point to an individual address, or to an array of email addresses. If an entry has a key watch_contract with value 1, this account is only monitored for contract code changes, and all other transactions are ignored.

  • the file should end with 1; to keep Perl happy.

Running the tool

The tool understands two options: the mandatory --cfg option defines the configuration file, and --verbose makes it print additional diagnostics to standard output.

Whenever you run the tool from your shell command line, you typically want the --verbose option, and the cron job command would run without it.

# Command-line example
perl /home/bob/tools/eosaccwatch/ --cfg /home/bob/etc/ --verbose

# cron job example
*/5 * * * * /usr/bin/perl perl /home/bob/tools/eosaccwatch/ --cfg /home/bob/etc/

Setting up the mail server

This is the most tricky part: the script needs to be able to send email that is not rreated as spam by recipients. The general recommendations are as follows:

  • The server's IPv4 and IPv6 addresses need reverse DNS records, and these records should not contain any keywords like ppp, adsl, docsis, dynamic.

  • The sender's email address should have a valid domain name. The best is if the domain has SPF records explicitly alowing your server send email from it.

  • If your ISP provides an SMTP server for outbound email, use it.

Copyright and License

Copyright 2018

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Donations and paid service

ETH address: 0x7137bfe007B15F05d3BF7819d28419EAFCD6501E

EOS account: cc32dninexxx

You can send me equivalent of US$100 per account, and I will set up the watching service for you for 10 years.

You can’t perform that action at this time.