Tip Bot

An ERC20 Tip bot made for Discord, with MySQL as a DB.

This code is based off of kayabaNerve's Tip Bot but with some extra goodies thrown in.

Setting up the Bot

Edit settings.json

• coin:
  • symbol set to the coin's symbol ("ERC").
  • decimals set to the amount of the coin's decimals (18).
  • withdrawFee set to the amount of the coin to charge every withdraw.
  • infura set to the WebSocket URL of the Infura Project the bot is run through.
  • keys set to the directory used for keystore files. Every keystore in this directory must be encrypted with a blank password, and the bot will work with every keystore.
• coin.addresses:
  • wallet set to the address which will host all the Ether used to fund TXs. This must be an address in a keystore file already in the keys directory.
  • contract set to the ERC20's contract address.

Create a Discord Bot User.

1. Go to https://discordapp.com/developers/applications/me.
2. Click New App.
3. Enter a name and upload an icon (optional).
4. Click Create a Bot User.
5. Grab the Client ID from the top, and go to this link: https://discordapp.com/oauth2/authorize?client_id=<CLIENT_ID>&scope=bot&permissions=68672, after replacing <CLIENT_ID> with the bot's client ID. This will allow you to add the bot to a server with the proper permissions of Read Messages/Send Messages/Add Reactions (the last one is only necessary if you use giveaways).

• Edit the settings.json file's discord var to include:
  • token set to the bot user token. This is not the client user.
  • user set to the value gotten by right-clicking the bot on your server and clicking Copy ID. This requires Developer Mode to be enabled on your Discord client.
  • giveawayEmoji set to the emoji you want to use for giveaways. This defaults to 🎉.

Set up pools

Either delete or modify the ones in settings.json.

• admins control who can add/remove members.
• members is anyone who can spend the money in the pool.

Lock down channels

Set up any channel locked commands in settings.json's commands var.

• If you wish to lock a command to a channel, edit example to be the name of the command, and ROOM ID to be the value gotten from right-clicking a room and clicking Copy ID. You can add multiple channel IDs to the array.
• To setup more channel locks, simply copy the example template and fill it out properly.

---

All pools must be created via settings.json. All edits to the list of admins must also be done there. Members can be added and removed with !pool NAME add @USER and !pool NAME remove @USER, where NAME is the name of the pool, and @USER is a ping of the Discord user. To send from a pool, use !tip POOL @USER AMOUNT.

There is also a giveaway command to run giveaways with, yet it is currently disabled due to changes with how emojis are handled. If you don't want it, either don't setup the giveaways pool or comment out the line that loads it in main.js. To use it, run !giveaway Ts Ww A, where T is the time in seconds (or use "m" as a suffix for minutes), W is the amount of winners, and A is the amount each win. The amount will come from the giveaways pool and be tipped out to the winners.

Neither of these commands are documented as they are only to be used by whoever runs the bot, and that is not most people. It's not for security via obscurity, but rather because a long help file where half the commands aren't needed is annoying.