Notifier Plugin

This plugin calls webhooks when a certain events occurs. You can use it to post alerts on Slack, Discord, send Emails/SMS or use whichever service that supports webhooks.

❤️ Support maintenance and development of plugins

If you find this or other plugins useful please consider voting for deadlock delegate on Solar or Ark networks.

Installation

Adding plugin to config

Before restarting your process, you need to add the plugin into the very end core.plugins or relay.plugins section of app.json file:

{
    "package": "@deadlock-delegate/notifier",
    "options": {
        "enabled": true,
        "explorerTx": "https://explorer.ark.io/transaction/",
        "webhooks": [{
          "endpoint": "https://discordapp.com/api/webhooks/612412465124612462/A1Ag12F&ijafa-3mtASA121mja",
          "payload": {
            "msg": "content"
          },
          "events": ["wallet.vote", "wallet.unvote", "forger.missing", "forger.failed"]
        }, {
          "endpoint": "https://hooks.slack.com/services/T1212ASDA/BAEWAS12/ASxASJL901ajkS",
          "payload": {
            "msg": "text"
          },
          "events": ["wallet.vote", "wallet.unvote", "forger.missing", "forger.failed"]
        },
        {
          "endpoint": "https://api.pushover.net/",
          "payload": {
            "msg": "message",
            "user": "<pushover user key>",
            "token": "<pushover token>"
          },
          "events": ["forger.missing", "forger.failed"]
        }]
    }
}

For production (eg. mainnet/testnet/devnet):

1. Install plugin: <command> plugin:install @deadlock-delegate/notifier, eg: ark plugin:install @deadlock-delegate/notifier or solar plugin:install @deadlock-delegate/notifier
2. Add plugin to app.json
3. Start your node as you usually start it

For active development:

Assuming you don't run testnet locally via docker:

1. Clone this plugin into plugins/ directory of the core project
2. Add plugin to app.json, for testnet the file can be found in: core/packages/core/bin/config/testnet/app.json
3. Go into the plugin's directory: cd notifier
4. Build plugin: yarn build
5. Run yarn full:testnet inside core/packages/core directory to start testnet with notifier plugin

Configuration explanation

{
  "package": "@deadlock-delegate/notifier",
  "options": {
    "enabled": true,
    "explorerTx": "https://explorer.ark.io/transaction/",
    "webhooks": [{
      "endpoint": "webhook endpoint url",
      "payload": {
        "msg": "name of the message field eg. Discord has 'content', Slack has 'text', Pushover has 'message'"
      },
      "events": ["list of events you want to subscribe to"],
    }]
  }
}

Events you can subscribe to

Handlers for unticked events haven't been implemented yet. Feel free to make a contribution.

• <input checked="" disabled="" type="checkbox"> wallet.vote
• <input checked="" disabled="" type="checkbox"> wallet.unvote
• <input checked="" disabled="" type="checkbox"> forger.missing - when a delegate fails to forge in a round (could be any delegate)
• <input checked="" disabled="" type="checkbox"> forger.failed - if your forger process fails to forge (only works if a plugin is running on a node with a forging process running)
• <input checked="" disabled="" type="checkbox"> forger.started - when your forging process starts
• <input disabled="" type="checkbox"> block.applied
• <input checked="" disabled="" type="checkbox"> block.forged - when your forging process forges a new block
• <input disabled="" type="checkbox"> block.reverted
• <input checked="" disabled="" type="checkbox"> delegate.registered
• <input checked="" disabled="" type="checkbox"> delegate.resigned
• <input disabled="" type="checkbox"> peer.added
• <input disabled="" type="checkbox"> peer.removed
• <input disabled="" type="checkbox"> transaction.applied
• <input disabled="" type="checkbox"> transaction.expired
• <input disabled="" type="checkbox"> transaction.forged
• <input disabled="" type="checkbox"> transaction.reverted
• <input checked="" disabled="" type="checkbox"> activedelegateschanged - when active delegates change (voted out/in) (note: this is a custom event and does not existing in core!)
• <input checked="" disabled="" type="checkbox"> voterbalancechanged:<delegate name> - when a specific delegates voter balance changes

Credits

• roks0n
• console
• All Contributors

License

MIT © deadlock delegate