twisterad

Lightweight, in-memory CLI tool & daemon to rotate multiple twister ads on single worker, through modified Bitcoin Core JSON-RPC API library.

Optimal to run as systemd unit that waits for twisterd connection and then begins updating promotional messages with each new block found.

Check out config.json to setup remote or local twisterd connection and update default promotions asset!

See also the project Wiki and The twister P2P Book for more details!

Install

Stable

cargo install twisterad

• run twisterad -c path/to/config.json

Repository

• git clone https://github.com/twisterarmy/twisterad.git
• cd twisterad
• cargo run -- -c path/to/config.json

CLI

Usage: twisterad [OPTIONS] --config <CONFIG>

Options:
  -c, --config <CONFIG>        Configuration file, required
  -d, --delay <DELAY>          Rotation queue delay, seconds [default: 60]
      --host <HOST>            RPC host [default: 127.0.0.1]
  -j, --jobs <JOBS>            Processor jobs to mine at once
  -l, --latency <LATENCY>      Miner latency in seconds, useful when blocks are being generated too quickly
  -m, --mode <MODE>            Rotation mode: * `c` - cycle * `s` - stop, disable worker [default: c]
  -p, --password <PASSWORD>    RPC password [default: pwd]
      --port <PORT>            RPC port [default: 28332]
  -r, --rotations <ROTATIONS>  Rotations quantity, before apply rotation `mode`
  -s, --scheme <SCHEME>        RPC scheme [default: http]
  -u, --user <USER>            RPC user [default: user]
  -w, --wait <WAIT>            Wait to server reconnect, seconds [default: 900]
  -h, --help                   Print help
  -V, --version                Print version

System

To run twisterad as the systemd unit (background process):

• cd twisterad - navigate sources directory
• cargo build --release - compile optimized binary
• useradd twisterad - create new user for twisterad process
• cp target/release/twisterad /usr/bin/twisterad - copy binary into native system location
• chmod 0700 /usr/bin/twisterad - give required permissions
• chown twisterad:twisterad /usr/bin/twisterad - allow user/group access
• mkdir /var/log/twisterad - create destination for the logs
• cp config.conf /etc/twisterad.conf - copy and customize default config

Create new systemd configuration file: nano /etc/systemd/system/twisterad.service

[Unit]
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=twisterad
Group=twisterad
ExecStart=/usr/bin/twisterad -c /etc/twisterad.conf
StandardOutput=file:/var/log/twisterad/debug.log
StandardError=file:/var/log/twisterad/error.log

[Install]
WantedBy=multi-user.target

• to disable debug output, set null for StandardOutput or StandardError

Apply changes:

• systemctl daemon-reload - reload unit configuration
• systemctl enable - start on system boot
• systemctl start twisterad - launch
• systemctl status twisterad - check service status

On change config.json:

systemctl restart twisterad