JavaScript ROP framework
Latest commit dba239c Sep 23, 2015 @CTurt Update stack base
Failed to load latest commit information. Update syntax Jul 21, 2015
gadgets.js General cleanup Jun 22, 2015
just-rop.js Update stack base Sep 23, 2015


A framework which lets you directly write dynamic ROP chains in JavaScript before executing them via a browser exploit.

Using JavaScript to write and execute dynamic ROP chains gives us a tremendous advantage over a standard buffer overflow attack.

For one thing, we can read the modules table and calculate the addresses of all gadgets before we trigger ROP execution, bypassing ASLR.

We can also read the user agent of the browser, and provide a different ROP chain for different browser versions.

We can even use JavaScript to read the memory at our gadgets' addresses to check that they are correct.

Writing ROP chains dynamically, rather than generating them with a script beforehand, just makes sense.

Porting to your exploits

All gadgets and chains shown here were tested on PlayStation 4 firmware 1.76. To use this with any other exploit you will need to make several manual tweaks (for 32bit, you should replace things like * 8 with * 4 for example).

Expose the following globally:

  • getU8(address), getU64(address), and setU64(address, value)
  • stackBase
  • returnAddress (so stackBase + returnAddress points to the return value of a function)
  • moduleBases (an array of module base addresses)

Modify the chainAddress declaration to point somewhere suitable for your exploit.

Then place your gadgets in the the gadgets array, using this syntax to declare a gadget:

gadget(instructions, module, address)

For example:

// moduleBases[webkit] is the base address of the webkit module
var webkit = 14;
var libKernel = 1;

var gadgets = {
    "mov [rax], rcx": new gadget([0x48, 0x89, 0x08], webkit, 0x9ecde6),
    "mov [rax], rdx": new gadget([], webkit, 0x3579c0),
    "mov [rax], rsi": new gadget([], webkit, 0x2adea7),

    "mov [rdi], rax": new gadget([0x48, 0x89, 0x07], libKernel, 0xb0c8),

The instructions parameter is optional, if it is non-empty then the memory at the gadget's pointer will be checked to ensure that it is correct (and followed by a ret instruction).


Make sure to include just-rop.js before gadgets.js to avoid getting a reference error:

<script type="text/javascript" src="just-rop.js"></script>
<script type="text/javascript" src="gadgets.js"></script>

And what you can do now depends largely on what gadgets you have available, and the system that you are exploiting (sandboxing might disable some system calls for example).

Here's a simple example chain:

var chain = new rop();

try {
    chain.syscall("getpid", 20);

    // rax is the return value

    chain.execute(function() {
        console.log("PID: " + chain.getVariable(0).toString());
catch(e) {
    logAdd("Incorrect gadget address " + e.toString(16));