r2pipe

The r2pipe-promise module is a frontend for r2pipe that provides a promisified API. It allows you to interact with radare2 using modern asynchronous patterns instead of callbacks, making scripts cleaner and more readable. It supports standard JavaScript .then()/.catch() chains, the co module, bluebird, and native async/await (Node.js 7.6+).

const r2promise = require('r2pipe-promise');

const radare2FTW = async () => {
  try {
    const r2 = await r2promise.open('/bin/ls');
    const msg = await r2.cmd('?E hello world');
    console.log(msg);
    return r2.quit();
  } catch (err) {
    console.error(err);
  }
}

radare2FTW();

The r2pipe.go module provides Go bindings to allow Go applications to interact with the radare2 framework via its pipe interface. For detailed API documentation, refer to the official GoDoc page.

https://godoc.org/github.com/radare/r2pipe-go

R2Pipe.Swift is a Swift 2.0 API that allows you to run commands in a radare2 session. It supports multiple communication channels and execution modes:

Communication Channels

• http
• spawn
• pipe

Execution Modes

• Sync: Synchronous command execution.
• Async: Asynchronous command execution using closures.

JSON Support

Native JSON parsing is not built-in; you should integrate libraries like SwiftyJSON or swift-json to handle JSON responses from radare2.

if let r2p = R2Pipe("http://cloud.radare.org/cmd/") {
	if let str = r2p.cmdSync ("?V") {
		print ("Version: \(str)");
	} else {
		print ("ERROR: HTTP Sync Call failed");
	}
	r2p.cmd("pi 5 @ entry0", closure:{
		(str:String)->() in
		print ("Disasm:\n\(str)");
	});
}

While designed primarily for NodeJS, this module may also run in the following environments:

• r2js
• bun
• deno

The core functionality of the API is centered around a single function, cmd, which executes a radare2 command and returns the output as a string.

For better integration with TypeScript/JavaScript, use cmdj() when executing commands that return JSON. This method automatically parses the output and converts it into a JavaScript object, making it ideal for structured data manipulation.

// Conceptual usage
const output = await r2.cmd('aaa'); // returns string
const data = await r2.cmdj('aaa');  // returns parsed JSON object

The R2Pipe.sync constructor supports several transport mechanisms to connect to radare2:

• spawn: Spawns a local process. Example: new R2Pipe.sync ("/bin/ls")
• HTTP: Connects to a radare2 instance listening via HTTP. Example: new R2Pipe.sync ("http://127.0.0.1:9090")
• in-process pipe: Connects via an in-process pipe. Example: new R2Pipe.sync () or new R2Pipe.sync ("#!pipe")

Additionally, you can use cmdj("ij") for JSON parsing of command outputs.

To build and run the test suite for the .NET implementation, use the following commands from the repository root.

make -C dotnet test