Hubot Kredits

This repository provides scripts for integrating Kosmos Kredits in Hubot chatbots. The bot will watch for project-related things happening on the Internet and automatically create ERC721 tokens for issuing kredits for project contributions.

Setup

Wallet

You will need a keypair/wallet for your bot, so it can interact with the smart contracts. npm run create-wallet will do the job for you.

The wallet must be funded with enough native chain tokens to interact with the contracts (i.e. it must be able to pay gas/tx fees)

Contract permissions

Warning: outdated instructions!

TODO adapt instructions for new permission model

The bot wallet needs the following Aragon contract permissions to interact with kredits-contracts:

1. ADD_CONTRIBUTION_ROLE on the Contribution contract
2. MANAGE_CONTRIBUTORS_ROLE on the Contributor contract

These permissions can be configured using the Aragon CLI (see kredits-contracts.

aragon dao acl grant [DAO address] [contribution app address] ADD_CONTRIBUTION_ROLE [bot wallet address]
aragon dao acl grant [DAO address] [contributor app address] MANAGE_CONTRIBUTORS_ROLE [bot wallet address]

To get the Contribution and Contributor app addresses use aragon dao apps.

Configuration

As usual in Hubot, you can add all config as environment variables.

| Key | Description | | --- | --- | | KREDITS_WEBHOOK_TOKEN | A string for building your secret webhook URLs | | KREDITS_ROOM | The bot will talk to you in this room | | KREDITS_WALLET_PATH | Path to an wallet JSON file (default: ./wallet.json) | | KREDITS_WALLET_PASSWORD | Wallet password | | KREDITS_PROVIDER_URL | JSON-RPC URL of a blockchain node (default: http://localhost:7545) | | KREDITS_WEB_URL | URL of the Kredits Web app (default: https://kredits.kosmos.org) | | KREDITS_SESSION_SECRET | Secret used by grant to sign the session ID | | KREDITS_GRANT_HOST | Host used by grant to generate OAuth redirect URLs (default: localhost:8888) | | KREDITS_GRANT_PROTOCOL | Protocol (http or https) used by grant to generate the OAuth redirect URLs (default: "http") |

Integrations

GitHub

The GitHub integration will watch for closed issues and merged pull requests, which carry a kredits label: kredits-1, kredits-2, kredits-3 for small, medium and large contributions. If there are multiple people assigned, it will issue contribution tokens for all of them.

If KREDITS_GITHUB_KEY and KREDITS_GITHUB_SECRET are set, the bot will also expose OAuth endpoints to authenticate new contributors and register new contributor profiles on the smart contract. For this feature, a GitHub OAuth app is required and the OAuth grant config variables must be set.

Setup

Point a GitHub organization webhook to the following URL:

https://your-hubot.example.com/incoming/kredits/github/{webhook_token}

Config

| Key | Description | | --- | --- | | KREDITS_GITHUB_REPO_BLACKLIST | Repos which you do not want to issue kredits for. Format: orgname/reponame, e.g. 67P/test-one-two | | KREDITS_GITHUB_KEY | Key of the GitHub OAuth app used to authenticate contributors | | KREDITS_GITHUB_SECRET | Secret of the GitHub OAuth app used to authenticate contributors |

Gitea

The Gitea integration will watch for closed issues and merged pull requests, which carry a kredits label: kredits-1, kredits-2, kredits-3 for small, medium and large contributions. If there are multiple people assigned, it will issue contribution tokens for all of them.

Setup

Point a Gitea organization webhook to the following URL:

https://your-hubot.example.com/incoming/kredits/gitea/{webhook_token}

Config

| Key | Description | | --- | --- | | KREDITS_GITEA_REPO_BLACKLIST | Repos which you do not want to issue kredits for. Format: orgname/reponame, e.g. kosmos/test-one-two |

MediaWiki

The MediaWiki integration will periodically check for wiki page creations and edits. It will create kredits contribution tokens based on amount of text added.

Setup

No setup needed, except for configuring the wiki URL. The bot will poll your wiki's API on its own.

Config

| Key | Description | | --- | --- | | KREDITS_MEDIAWIKI_URL | Your wiki URL, e.g. https://wiki.kosmos.org/ |

Zoom

The Zoom integration creates contributions for meeting participations.

Every meeting that is longer than 15 minutes and with more than 2 participants will be registered. An optional meeting whitelist can be configured to create contributions only for specific meetings.

Setup

A Zoom JWT app has to be set up and an event webhook subscription on meeting.ended has to be configured to the following URL:

https://your-hubot.example.com/incoming/kredits/zoom/{webhook_token}

Config

| Key | Description | | --- | --- | | KREDITS_ZOOM_JWT | The JWT for the Zoom application (required) | KREDITS_ZOOM_MEETING_WHITELIST | Comma separated list of meeting names for which kredits should be tracked (optional) | KREDITS_ZOOM_CONTRIBUTION_AMOUNT | The amount of kredits issued for each meeting. (default: 500)

Zoom apps