Cosgrove

Cosgrove is a STEEM Centric Discord Bot Framework that allows you to write your own Discord bots that interact with the STEEM blockchain.

One example of a bot that uses this framework is @banjo on SteemSpeak.

Many (not all) features work on Golos as well.

Features

Registration
- $register <account> [chain] - associate account with your Discord user (chain default steem)
Verification
- $verify <account> [chain] - check account association with Discord users (chain default steem)
Up Voting
- $upvote [url] - upvote from cosgrove; empty or ^ to upvote last steemit link

Installation

$ gem install cosgrove

... or in your Gemfile

gem 'steemdata-rb', require: 'steemdata', git: '[email protected]:steem-third-party/steemdata-rb.git'
gem 'cosgrove'

Setup

Add a config file to your ruby project called config.yml:

:cosgrove:
  :token: 
  :client_id: 
  :secret: set this
:chain:
  :steem_account: 
  :steem_posting_wif: 
  :golos_account: 
  :golos_posting_wif: 
  :steem_api_url: https://steemd.steemit.com
  :golos_api_url: https://ws.golos.io
:discord:
  :log_mode: info

You will need to request a token and client_id from Discord (see below).

Provide the accounts and wif private postings keys if you want your bot to upvote posts.

You should change the secret key using the output of:

SecureRandom.hex(32)

Bot Registration

Request a new bot here: https://discordapp.com/developers/applications/me#top
Register an application and create an app bot user.
Replace APP_CLIENT_ID with the App's Client ID in this URL: https://discordapp.com/oauth2/authorize?&client_id=APP_CLIENT_ID&scope=bot&permissions=153600
Give that URL to the Discord server/guild owner and have them authorize the bot.
Set the token and client_id in your bot constructor (see below).

Usage

Cosgrove is based on discordrb, see: https://github.com/meew0/discordrb

All features offered by discordrb are available in Cosgrove. In addition, Cosgrove comes with pre-defined commands. See them by typing: $help

You can add you features thusly:

require 'cosgrove'

bot = Cosgrove::Bot.new

bot.message(with_text: 'Ping!') do |event|
  event.respond 'Pong!'
end

bot.run

Tests

Clone the client repository into a directory of your choice:
- git clone [email protected]:steem-third-party/cosgrove.git
Navigate into the new folder
- cd cosgrove
Basic tests can be invoked as follows:
- rake
To run tests with parallelization and local code coverage:
- HELL_ENABLED=true rake