# Telegram Bot: Orchestrator Watcher

**URL:** <https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077>\
**Category:** Uncategorized\
**Created:** [May 11, 2020, 8:36pm UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077 "2020-05-11T20:36:51Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [May 11, 2020, 8:36pm UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/1 "2020-05-11T20:36:51Z")

</div>

**My telegram bot is back!** (original bot & thread: [Transcoder Watcher](https://forum.livepeer.org/t/telegram-bot-transcoder-watcher/609))!

It took a while, but I finally found the time to updated the scripts and get the bot running again.

Also: If you want to support me, feel free to bond to my orchestrator/transcoder: [0x525 Orchestrator/Transcoder](https://explorer.livepeer.org/accounts/0x525419ff5707190389bfb5c87c375d710f5fcb0e/campaign) 🙂

**Link:**  
[Click here for the Orchestrator-Watcher bot](https://t.me/OrchestratorWatcherBot) or look for it in Telegram: @OrchestratorWatcherBot

**How does it work?**  
By writing “/start”, the bot will give you an introduction and informs about the available commands:

- subscribe -orchestrator address-
- remove -orchestrator address-
- subscriptions

If you subscribe to an orchestrator (or multiple, there is no limit), you will get notified about the following events:

- reward calls
- missing reward calls
- reward/fee cut changes
- orchestrator becomes active/inactive

Whenever possible, the transaction link is included so that you can be sure that no incorrect information is sent. Please note that it’s always possible that there is an error in the script.

**To use the bot in a telegram group** :

1. Add the bot the the group (do not promote to admin!)
2. Access the commands with “/” - e.g. “/subscribe 0xabc”

**Some screenshots:**

Start:

 ![](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/1301f099eae9e105ce5060838e796ce252378c4c.png)

Warnings:  
 ![](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/318a9c8e7f501a943242122460f04f7f15d843dc.png)

Reward Calls:  
 ![image](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/7a01321dbefc60423cf2370872a66eb7b1b99237.png)

Reward/Fee Cut changes:  
 ![image](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/623bfb118e9e681f9c04d7d75e589c41b210c1d7.png)

If you find any bugs/errors or have a feature request, please reach out to me on Discord @vires-in-numeris, reply here or open an issue on github.

Also, the scripts for the bot are now open source: [https://github.com/ppunktw/web3-livepeer-bot](https://github.com/ppunktw/web3-livepeer-bot)

---

<div class="post-metadata">

**Author:** ![chrishobcroft](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/chrishobcroft/32/1340_2.png) [@chrishobcroft](https://forum.livepeer.org/u/chrishobcroft)\
**Post date:** [May 12, 2020, 7:30am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/2 "2020-05-12T07:30:58Z")

</div>

Excellent job, @vires-in-numeris!

Glad to see it back up and running!

For any issues, should we raise them here [https://github.com/ppunktw/web3-livepeer-bot/issues](https://github.com/ppunktw/web3-livepeer-bot/issues) ?

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [May 12, 2020, 8:19am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/3 "2020-05-12T08:19:06Z")

</div>

Thank you!

Yes, github would be ideal for issues/feature requests!

---

<div class="post-metadata">

**Author:** ![chris-chainflow](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/chris-chainflow/32/704_2.png) [@chris-chainflow](https://forum.livepeer.org/u/chris-chainflow)\
**Post date:** [May 15, 2020, 6:56pm UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/4 "2020-05-15T18:56:14Z")

</div>

Alright! Thanks for this 🙏 👏

---

<div class="post-metadata">

**Author:** ![yasu](https://avatars.discourse-cdn.com/v4/letter/y/958977/32.png) [@yasu](https://forum.livepeer.org/u/yasu)\
**Post date:** [January 25, 2021, 3:42am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/5 "2021-01-25T03:42:47Z")

</div>

Seem the bot not working now?

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [January 25, 2021, 9:04am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/6 "2021-01-25T09:04:48Z")

</div>

Thanks for notifying me - the subscription part of the bot crashed while the notifications were still working. It’s up again!

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [February 18, 2022, 2:59pm UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/7 "2022-02-18T14:59:38Z")

</div>

I’ve updated the Orchestrator Watcher bot to work on Arbitrum!

Claiming the daily reward now only costs ~$2 in tx fees, so there’s no longer an excuse to not do that. And switching Orchestrators will also cost only a few dollars. This bot hopefully helps to expose unreasonable reward/fee cuts or stealthy changes of them.

It also helps Orchestrator operators to identify issues by notifying them that the reward has not been claimed yet:  
 ![image](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/6606105b5ec93444178cb36d39f5aa37c3382e56.png)

And as a new feature, I’ve add a ticket redemption notification 🎟:

![image](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/1X/30dec50ab73c48906c0f8e6b111aa6558f945d5f.png)

Keep in mind, that the bot only processes new events every ~2h (every 500 mainnet blocks). And I’m basically testing in prod - I already apologize for any bugs you might encounter 🙂

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [June 25, 2022, 9:23am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/8 "2022-06-25T09:23:11Z")

</div>

Just FYI: About 10 days ago I set up a systemd for the bot (so that I don’t have to manually restart the script in case it crashes). But there was a small bug so the bot didn’t save/report any changes in the subscriptions during those past 10 days.  
So if you did any changes, please do them again. Sorry for the inconvenience 🙂

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [September 4, 2022, 10:08am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/9 "2022-09-04T10:08:19Z")

</div>

Due to the low gas prices on Arbitrum Nitro and therefore low ticket values (~$20), the bot got quite spammy on the ticket redemption notifications. I feel like the main functionality of the bot should be the warnings on missing reward claims and fee/reward cut changes. And due to the many ticket redemption notifications, one might easily miss those.

**That’s why I’ve updated the bot to aggregate winning tickets and send one notification once the total value is greater than 0.1 ETH**

By doing that you still get an idea on how much an Orchestrator is earning without potentially missing more important notifications. This is how it looks like:  
 ![image](https://canada1.discourse-cdn.com/flex030/uploads/livepeer/original/2X/7/7409cf6e4866b86ac09d88c6fc585d3fa0c7e9cc.png)

---

<div class="post-metadata">

**Author:** ![vires-in-numeris](https://yyz2.discourse-cdn.com/flex030/user_avatar/forum.livepeer.org/vires-in-numeris/32/731_2.png) [@vires-in-numeris](https://forum.livepeer.org/u/vires-in-numeris)\
**Post date:** [September 6, 2022, 10:35am UTC](https://forum.livepeer.org/t/telegram-bot-orchestrator-watcher/1077/10 "2022-09-06T10:35:15Z")

</div>

After community feedback, I’ve adjusted the ticket notification limit to be stake-based instead of a fixed number.

The bot now adjusts the limit by dividing the Orchestrator’s total stake (rounded to the nearest 100k) by 1e+7 - with a min limit of 0.01 ETH (so basically every ticket) and a max of 0.1 ETH.

Some examples:

- Orchs with \< 150k stake have a 0.01 ETH notification limit
- An Orch with 340k stake has a 0.03 ETH notification limit
- An Orch with 2.1M stake has a 0.1 ETH notification limit
