y11en / emoji-shellcoding

🤩 Emoji shellcoding tools for RISC-V (32-bit and 64-bit)

RISC-V: Emoji Shellcoding 🙂

By Hаdrien Ваrrаl and Georges-Axel Jaloyan

This work has been presented at DEFCON30 (slides)

Overview

This tool ⚒️ helps design RISC-V (both 32-bit and 64-bit) shellcodes capable of running arbitrary code, whose ASCII binary representation use only Unicode UTF-8 emojis 🤯.

It consists of an emoji unpacker. For any target shellcode (non-emoji), the tool will produce an emoji shellcode with the unpacker and the packed version of your shellcode. Run it on a RISC-V simulator/cpu and enjoy!

For a general introduction on RISC-V shellcoding, you may read the blog post by Thomas Karpiniec.

You can find our previous work on RISC-V alphanumeric shellcoding here: https://github.com/RischardV/riscv-alphanumeric-shellcoding.

Folder contents:

• qemu: Full source code and prebuilt binary for the baremetal QEMU demo
• esp32: Demos running on the Espressif ESP32-C3 board
• hifiveu: Demos running on the HiFive-Unleashed board
• payload: Source code of the payloads used
• block: How we generated the available instructions
• nopsled: The source code of our ⛔🛷 nopsled
• scripts: Various helpers

Quick-try

Building the shellcodes requires to build a RISC-V toolchain from source. We only provide easy-to-test pre-built QEMU baremetal shellcodes.

The only prerequisite is having a RISC-V QEMU v6.0.0 or newer https://www.qemu.org/. On Ubuntu 22.04, you can install it using apt install qemu-system-misc.

Then:

• cd emoji-shellcoding/qemu/prebuilt
• cat shellcode.bin (optional, to print the shellcode. Open it in your favorite editor if your console does not support emojis)
• ./launch_prebuilt use Ctrl+C to exit

Building && Testing

Start by cloning the repository:

git clone https://github.com/RischardV/emoji-shellcoding.git
cd emoji-shellcoding

Prerequisites:

• Python 3.10 or later https://www.python.org/
• RISC-V toolchain
• RISC-V QEMU: install QEMU v6.0 or newer https://www.qemu.org/
• GNU m4

On Ubuntu 22.04:

apt install build-essential gcc-riscv64-linux-gnu gcc-riscv64-unknown-elf qemu-system-misc m4

QEMU bare-metal shellcodes

• Build the instructions lists (takes some time)
  • cd emoji-shellcoding/block
  • make
• Build the shellcodes
  • cd emoji-shellcoding/qemu
  • make
• Run the shellcodes
  • cd emoji-shellcoding/qemu
  • cat out/shellcode.bin (optional, to print the shellcode)
  • ./l use Ctrl+C to exit Expected results: The string "Hello, world!" should print on the screen.

Espressif ESP32-C3 shellcodes

Prerequisites:

• An Espressif ESP32-C3 board: https://www.espressif.com/en/products/socs/esp32-c3 (esp32-c3-devkitm-1 or esp32-c3-devkitc-02 are easily available for <10$)

• The ESP-IDF SDK: https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html

• Build the shellcodes

  • cd emoji-shellcoding/esp32
  • make -j

Running instructions are very similar to QEMU Linux shellcodes above. Refer to them.

HiFive Unleashed Linux shellcodes

Prerequisites:

• A HiFive-Unleashed board: https://www.sifive.com/boards/hifive-unleashed (note: this board is not sold anymore)

• Build the shellcodes

  • cd emoji-shellcoding/hifiveu
  • make -j

Running instructions are very similar to QEMU Linux shellcodes above. Refer to them.

License

This tool is released under Apache license. See LICENSE file.