> [dcom](https://github.com/emre/dcom) (**d**iscord **com**munity bot) is a (python3.6+)  bot for communities to trigger upvotes from specified discord channels/servers. - [announcement post](https://steemit.com/utopian-io/@emrebeyler/dcom-a-curation-bot-on-discord-for-steem-communities)

<center><img src="https://cdn.steemitimages.com/DQmYT3svFg4mQczC83uTQ7QMvLVLZMT63kfRBV3utZnGgLJ/Screen%20Shot%202018-12-17%20at%209.50.29%20AM.png"></center>

dcom's registration module was a success. It has been working the last 2-3 days and working well.

The remaining planned features were also completed today.

# Automatic Curation

After having registration and manual curation capabilities, the next step was building an automatic curation process.

- **Step 1**: Discord user gains access to a designated role. (Let's call it patron.) in the discord server.

- **Step 2**: Discord user registers his STEEM account to their discord handle by using the ```$register``` command and verifies ownership.

- **Step 4**: dcom checks the voting power of the main curation account in the background, periodically.

- **Step 5**: If the voting power is greater than %99, it will fetch a list of votable patron posts in the STEEM blockchain and upvote them with a %20 voting weight. (Voting weight and voting power should be configurable in the .env file.)

There are a couple of limitations are already in place. Ex: A patron can only get one upvote in 24 hours.

<center><img src="https://cdn.steemitimages.com/DQmWFRAjkYLNpQEDoxKwp4mNj8oKmJyYtZLTiSdn3p4m1iF/Screen%20Shot%202018-12-19%20at%2012.00.09%20PM.png"></center>
<sup>Bot listens the user change events and marks or remove user's patron role in it's internal database.</sup>

# Listening the "role" change events

In order to implement Step1, dcom needs to track [member_update](https://discordpy.readthedocs.io/en/latest/api.html#discord.on_member_update) events in the discord server.

By attaching your custom function to that event, you get two parameters. The first one is the old instance of the user, the second one is the fresh instance of the user.

That way I could check the roles in both old and fresh instances and checked if there was a change in their "patron" roles.

<center><img src="https://cdn.steemitimages.com/DQmP2ppLC21Wur8CFW1JcD1PqN4FKfFxKEibJ7SVyzSAgmh/Screen%20Shot%202018-12-19%20at%2012.03.07%20PM.png"></center>
<center><sup>The snippet to check role change events</sup></center>


# Curating in the background

After completing the step1 by listening role changes, the rest of the logic was easy to implement.

A new background task called [auto_curation](https://github.com/emre/dcom/blob/master/dcom/client.py#L308) is attached to the main ```asyncio``` loop.

This function checks

- if the VP is enough
- if there are registered and available patrons available for curating
- if there are suitable posts with the available patrons

and curates automatically.

One minor problem in this part is that the blocking calls to the STEEM blockchain. Steem doesn't have any asynchronous library to interact with the chain, so there are some parts blocking the i/o.

I don't think that's a huge problem on a small scale like this, but if that results with a lag in the bot, I am thinking about separating the background voter from the main bot.


## Pull request on automatic curation

- [Implement auto-curation](https://github.com/emre/dcom/pull/4)

# Implementing global blacklist API

@themarkymark has been maintaining a [global blacklist API](https://steemit.com/utopian-io/@themarkymark/global-blacklist-api-now-supports-actifit-s-blacklist) for a while. For the ```$upvote``` command of the bot, there is a check placed if the author is blacklisted in any community, then the upvote operation won't happen.


<center><img src="https://cdn.steemitimages.com/DQmf5khPanhXTmhHSny5yMubWtweqBpUr4EmdgXjBMGmqPH/blacklist.png"></center>

The same "blocking i/o" problem was also the case for here, too. Using the good, old ```requests``` library in here creates the same problem.

So, I have used ```aiohttp``` library to make sure the main ```asyncio``` loop is not blocked.

<center><img src="https://cdn.steemitimages.com/DQmPC8W9gYVSEt8evwReYFvW3zUyt61A8toaPDQLidX7NCv/Screen%20Shot%202018-12-19%20at%2012.18.39%20PM.png"></center>

## Pull Request on blacklist feature

- [Implement global blacklist api](https://github.com/emre/dcom/pull/6)


# Updating the bot

```
$ pip install dcom --upgrade
```


# New configuration parameters

A .dcom_env file at your user path should store the below fields:

| Key                   | Value                                                     |
|-----------------------|-----------------------------------------------------------|
| BOT_ACCOUNT           | The account used for the curation                         |
| BOT\_POSTING\_KEY       | Private posting key of the curation account               |
| STEEM_NODES           | A list of STEEM nodes (comma separated)                   |
| DISCORD\_BOT\_TOKEN     | \<Token of the discord bot\>                                |
| CHANNEL_WHITELIST     | Curation channel id list (comma separated)                |
| LATE\_CURATION\_WINDOW  | Maximum age for a post (in seconds)                       |
| EARLY\_CURATION\_WINDOW | Minimum age for a post (in seconds)                       |
| CURATOR_GROUPS        | Discord roles authorized to use the bot (comma separated) |
| REGISTRATION_CHANNEL  | Registration channel (ID)                                 |
| REGISTRATION_ACCOUNT | Registration account (steem username)                      |
| REGISTRATION\_ACCOUNT\_ACTIVE_KEY | Registration account's active key               |
| ROLE\_FOR\_REGISTERED_USERS| Role name for registered users                         |
| MONGO_URI                | Mongodb connection URI                                 |
| COMMUNITY_NAME            | Community name                                         |
| **PATRON_ROLE**           | Designated discord role                                 |
| **BOT\_LOG\_CHANNEL**.      | Channel id for the bot logs on auto-curation.           |
| **ACCOUNT\_FOR\_VP\_CHECK**  | Which account's VP should be checked for auto-curation  |
| **LIMIT\_ON\_MAXIMUM\_VP**   | When should auto-curation triggered   				  |
| **AUTO\_CURATION\_VOTE_WEIGHT** | The default voting weight.  						  |
*(New parameters with this version is marked as bold.)*



# Running

```bash
$ dcom
```

***

That's all for this update. I think ```dcom``` is in a good state for feature-wise at the moment. All planned requirements are implemented.