A discord bot for reverse engineers and exploit developers.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dictionary Initial Commit Jul 29, 2018
.gitignore Initial Commit Jul 29, 2018
LICENSE.md Create LICENSE.md Jul 29, 2018
README.md Update README.md Jul 29, 2018
commands-asm.go Update commands-asm.go Oct 16, 2018
commands-cve.go Initial Commit Jul 29, 2018
commands-dev.go Initial Commit Jul 29, 2018
commands.go Initial Commit Jul 29, 2018
config.go Initial Commit Jul 29, 2018
config.ini Create config.ini Jul 29, 2018
dictionary.go Initial Commit Jul 29, 2018
main.go Update main.go Sep 30, 2018
utils.go Initial Commit Jul 29, 2018

README.md

REBot

Release Mode Maintenance Version

REBot is a Discord bot programmed in the Golang programming language to provide useful commands to reverse engineers and exploit developers. It provides features such as on-the-fly assembly and disassembly for common (and even less common) architectures, such as x86/64, ARM/AARCH64, PPC, and MIPS. It also provides other features such as a technical dictionary, CVE look-up, and giving tips and tricks on reverse engineering and exploit development practices.

You can join the official REBot to your server using this discord invite link. REBot doesn't need any special permissions - only text read and send permissions so it can interact with you.

Getting Started

Below are some instructions on how to get the project building on your machine. I personally built this on Windows 10. The project itself is platform independent - however the way you build and configure keystone and capstone will vary depending on your target system.

Prerequisites

The following software is required to built and use REBot.

  • Golang
  • Keystone Assembler Engine
  • Capstone Disassembler Engine

Go Dependencies

The following dependencies are required to build the project using Go.

Building

Installing prerequisites

Windows

You should install Golang using their official Windows installer provided here. As for Keystone and Capstone, for Windows I recommend that you use the pre-compiled libraries they provide here (for keystone) and here (for capstone).

The libraries and header files for Keystone and Capstone should go in dedicated folders, I personally chose C:\src\keystone and C:\src\capstone respectively. The .lib files can be disgarded/deleted/renamed, as if they're present in the folder when you go to build, you may encounter linker errors. The .dll file is sufficient.

You may also need to edit the bindings to build the project successfully - changing the cgo directives to reflect the directories you setup the libraries in. For Keystone, I edited go/src/github.com/keystone-engine/keystone/bindings/go/keystone/keystone-binding.go and set the cgo directives to the following:

//#cgo windows CFLAGS: -IC:/src/keystone/include
//#cgo windows LDFLAGS: -LC:/src/keystone -lkeystone -lstdc++ -lm

For Capstone, nearly all the .go files for the binding had to be edited for the cgo directives. I edited them to the following:

//#cgo windows CFLAGS: -IC:/src/capstone/include
//#cgo windows LDFLAGS: -LC:/src/capstone -lcapstone

Linux (Debian)

Firstly, you should install Golang. You can do this via the following commands in the terminal:

sudo apt-get update
sudo apt-get install golang-go

For Keystone and Capstone, you may have to build the libraries yourself. Follow Keystone's and Capstone's COMPILE instructions for your given system.

Building the project

Finally, you can build the project by simply running go build. You will however need to add your Discord app authentication token to the config.ini file - or REBot won't be able to connect to discord.

License

Specter (Cryptogenic) - @SpecterDev

This project is licensed under the WTFPL license - see the LICENSE.md file for details.