🗿 rosetta-frida

Write Frida hooks against real Java class and method names — a per-version translation layer handles the obfuscated names that actually exist at runtime. Write once, hook many versions.

What it is

Every minor release of a large obfuscated Android app rotates the class and method names that Frida hooks reference, so a hook that worked yesterday breaks today. rosetta-frida decouples what you want to hook (the real name) from how it is spelled today (the obfuscated name) by loading a per-version JSON map at attach time. You write one hook against real names; ship a new map per release, and the same script keeps working — no static-analysis-and-repatch cycle every version.

Usage

import { rosetta } from 'rosetta-frida';
import map from './maps/com.example.app/30405.json' with { type: 'json' };

Java.perform(() => {
    rosetta.session({ map });

    rosetta.hook('com.example.app.IRemoteService$Stub.requestTicket', function (bundle, callback) {
        console.log('requestTicket:', bundle.keySet());
        return rosetta.proceed(bundle, callback);
    });
});

Same source, any version that has a map. The rotation problem disappears. Full walkthrough in the quick start.

Install

Availability: the npm package lands with the first tagged release (v*). Until then, build from source (below) — that is the working path today.

Once the first release is published (publishing is tag-driven: a v* version tag triggers the release workflow, which rebuilds, re-runs the 100% coverage gate, and publishes with npm provenance — so a release can only ship a green build), install it from npm:

npm install rosetta-frida

import { rosetta } from 'rosetta-frida';

This gives you the runtime library and the rosetta CLI (run it with npx rosetta <command>).

Today, build from source:

git clone https://github.com/Xiddoc/rosetta-frida
cd rosetta-frida
npm install
npm run build

See the installation guide for requirements and details.

Documentation

Full docs are published to GitHub Pages (source under docs/):

• Getting started — install, quick start, concepts
• API reference — the three-tier hook API + session
• Map format & authoring — schema 3, version_code, authoring
• CLI reference — init, pull, validate, convert, patch, extract, inspect
• Recipes — common hook patterns
• Design and Roadmap — architecture and what's next
• Contributing — dev setup, the verify pipeline, conventions

License

MIT