frida-fusion 0.1.8__tar.gz → 0.1.9__tar.gz

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frida-fusion
-Version: 0.1.8
+Version: 0.1.9
 Summary: Hook your mobile tests with Frida
 Author-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
 Maintainer-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
@@ -73,6 +73,43 @@ Modules:
 pip3 install frida-fusion
 ```
 
+## Custom Frida script
+
+You must provide a custom Frida script as usual. To do this you must provide `-s/--script-path` parameter.
+
+```bash
+# Just one file
+frida-fusion -f [app_id] -U --script-path mytest.js
+
+# A entire directory
+frida-fusion -f [app_id] -U --script-path /tmp/scripts
+```
+
+### Exposed JavaScript (frida) functions
+
+The Frida Fusion define/expose several functions to be used at frida scripts. Follows the typedef of these functions.
+
+```java
+# Send message/data to Frida-Fusion
+void    fusion_sendMessage(String level, String message);
+void    fusion_sendMessageWithTrace(String level, String message);
+void    fusion_sendKeyValueData(String module, Object items);
+
+# Print StackTrace
+void    fusion_printStackTrace();
+
+# Print all methods of class 'name'
+void    fusion_printMethods(String name);
+
+# Wait until the class 'name' exists in memory to execute the callback function
+void    fusion_waitForClass(String name, CallbackFunction onReady)
+
+# Conversions
+byte[]  fusion_stringToBase64(String message);
+String  fusion_bytesToBase64(byte[] byteArray);
+String  fusion_encodeHex(byte[] byteArray);
+```
+
 ## Module engine
 
 You can check available modules with `frida-fusion --list-modules` command.
@@ -104,7 +141,7 @@ export FUSION_MODULES=/tmp/modules
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 At windows:
@@ -116,7 +153,7 @@ $env:FUSION_MODULES = "C:\extra_mods"
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 ### Community modules
@@ -131,3 +168,4 @@ export FUSION_MODULES=/tmp/frida-fusion-community-modules
 # List all modules
 frida-fusion --list-modules
 ```
+

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/README.md

@@ -38,6 +38,43 @@ Modules:
 pip3 install frida-fusion
 ```
 
+## Custom Frida script
+
+You must provide a custom Frida script as usual. To do this you must provide `-s/--script-path` parameter.
+
+```bash
+# Just one file
+frida-fusion -f [app_id] -U --script-path mytest.js
+
+# A entire directory
+frida-fusion -f [app_id] -U --script-path /tmp/scripts
+```
+
+### Exposed JavaScript (frida) functions
+
+The Frida Fusion define/expose several functions to be used at frida scripts. Follows the typedef of these functions.
+
+```java
+# Send message/data to Frida-Fusion
+void    fusion_sendMessage(String level, String message);
+void    fusion_sendMessageWithTrace(String level, String message);
+void    fusion_sendKeyValueData(String module, Object items);
+
+# Print StackTrace
+void    fusion_printStackTrace();
+
+# Print all methods of class 'name'
+void    fusion_printMethods(String name);
+
+# Wait until the class 'name' exists in memory to execute the callback function
+void    fusion_waitForClass(String name, CallbackFunction onReady)
+
+# Conversions
+byte[]  fusion_stringToBase64(String message);
+String  fusion_bytesToBase64(byte[] byteArray);
+String  fusion_encodeHex(byte[] byteArray);
+```
+
 ## Module engine
 
 You can check available modules with `frida-fusion --list-modules` command.
@@ -69,7 +106,7 @@ export FUSION_MODULES=/tmp/modules
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 At windows:
@@ -81,7 +118,7 @@ $env:FUSION_MODULES = "C:\extra_mods"
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 ### Community modules
@@ -96,3 +133,4 @@ export FUSION_MODULES=/tmp/frida-fusion-community-modules
 # List all modules
 frida-fusion --list-modules
 ```
+

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/frida_fusion/__meta__.py

@@ -1,8 +1,8 @@
-__version__ = '0.1.8'
+__version__ = '0.1.9'
 __title__ = "Frida Fusion"
 __description__ = "📱 frida-fusion - runtime mobile exploration"
 __url__ = "https://github.com/helviojunior/frida-fusion"
-__build__ = 0x36275f5
+__build__ = 0x2c0d061
 __author__ = "Helvio Junior (M4v3r1ck)"
 __author_email__ = "helvio_junior@hotmail.com"
 __license__ = "GPL-3.0"

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/frida_fusion/fusion.py

@@ -167,14 +167,14 @@ class Fusion(object):
             else:
                 Logger.pl("{*} Loading script file " + file_name)
                 for r in ["*", "-", "+", "!"]:
-                    file_data = file_data.replace(f"console.log('[{r}] ", f"sendMessage('{r}', '")
-                    file_data = file_data.replace(f'console.log("[{r}] ', f'sendMessage("{r}", "')
-                    file_data = file_data.replace(f"console.log('[{r}]", f"sendMessage('{r}', '")
-                    file_data = file_data.replace(f'console.log("[{r}]', f'sendMessage("{r}", "')
+                    file_data = file_data.replace(f"console.log('[{r}] ", f"fusion_sendMessage('{r}', '")
+                    file_data = file_data.replace(f'console.log("[{r}] ', f'fusion_sendMessage("{r}", "')
+                    file_data = file_data.replace(f"console.log('[{r}]", f"fusion_sendMessage('{r}', '")
+                    file_data = file_data.replace(f'console.log("[{r}]', f'fusion_sendMessage("{r}", "')
 
-                file_data = re.sub(r'(?<!\w)send\(', 'iSend(', file_data)
+                file_data = re.sub(r'(?<!\w)send\(', 'fusion_Send(', file_data)
 
-                file_data = file_data.replace(f'console.log(', f'sendMessage("I", ')
+                file_data = file_data.replace(f'console.log(', f'fusion_sendMessage("I", ')
                 file_data += "\n\n"
 
                 line_cnt = len(file_data.split("\n")) - 1
@@ -371,7 +371,11 @@ class Fusion(object):
                         for m in matches:
                             stack = stack.replace(m[0], f"{m[1].file_name}:{m[1].line}")
 
-                        if script_location.file_name == "class-factory.js" and len(matches) == 1:
+                        if script_location.file_name == "fusion_bundle.js" and len(matches) >= 1:
+                            script_location.file_name = matches[0][1].file_name
+                            script_location.line = matches[0][1].line
+
+                        elif script_location.file_name == "class-factory.js" and len(matches) == 1:
                             script_location.file_name = matches[0][1].file_name
                             script_location.line = matches[0][1].line
 

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/frida_fusion/libs/helpers.js

@@ -1,9 +1,16 @@
-/*  Android Scripts
-    Author: Hélvio - M4v3r1ck
+/*  Frida Fusion helper functions
+    Author: Helvio Junior - M4v3r1ck
 */
 
+function fusion_Send(payload1, payload2){
+    const info = fusion_getCallerInfo();
+    send({
+      payload: payload1,
+      location: info
+    }, payload2);
+}
 
-function waitForClass(name, onReady) {
+function fusion_waitForClass(name, onReady) {
     var intv = setInterval(function () {
       try {
         var C = Java.use(name);
@@ -13,24 +20,24 @@ function waitForClass(name, onReady) {
     }, 100);
 }
 
-function printStackTrace(){
+function fusion_printStackTrace(){
     var trace = Java.use("android.util.Log").getStackTraceString(Java.use("java.lang.Exception").$new());
     trace = trace.replace("java.lang.Exception\n", "Stack trace:\n");
-    sendMessage("*", trace);
+    fusion_sendMessage("I", trace);
 }
 
-function toBytes(message){
+function fusion_toBytes(message){
     try{
         const StringClass = Java.use('java.lang.String');
         var bTxt = StringClass.$new(message).getBytes('utf-8');
 
         return bTxt;
     } catch (err) {
-        sendMessage("*", err)
+        fusion_sendMessage("W", err)
     }
 }
 
-function toBase64(message){
+function fusion_stringToBase64(message){
     try{
         const StringClass = Java.use('java.lang.String');
         const Base64Class = Java.use('android.util.Base64');
@@ -39,19 +46,19 @@ function toBase64(message){
 
         return b64Msg;
     } catch (err) {
-        sendMessage("*", err)
+        fusion_sendMessage("W", err)
     }
 }
 
-function bytesToBase64(message){
+function fusion_bytesToBase64(byteArray){
 
-    if (message === null || message === undefined) return "IA==";
+    if (byteArray === null || byteArray === undefined) return "IA==";
     try {
         // 1) Confirma tipo byte[], se não tenta converter em string
-        message = Java.array('byte', message);
+        byteArray = Java.array('byte', byteArray);
 
         // 2) Tem 'length' numérico
-        const len = message.length;
+        const len = byteArray.length;
         if (typeof len !== "number") return "IA==";
 
         // 3) (opcional) Exigir conteúdo
@@ -64,16 +71,16 @@ function bytesToBase64(message){
     try{
         
         const Base64Class = Java.use('android.util.Base64');
-        var b64Msg = Base64Class.encodeToString(message, 0x00000002); //Base64Class.NO_WRAP = 0x00000002
+        var b64Msg = Base64Class.encodeToString(byteArray, 0x00000002); //Base64Class.NO_WRAP = 0x00000002
 
         return b64Msg;
     } catch (err) {
-        sendMessage("*", err)
+        fusion_sendMessage("W", err)
         return "IA==";
     }
 }
 
-function getCallerInfo() {
+function fusion_getCallerInfo() {
   try{
     const stack = new Error().stack.split("\n");
 
@@ -89,9 +96,9 @@ function getCallerInfo() {
         const file = m[2];
         const ln   = parseInt(m[3], 10);
 
-        // Ignora funções cujo nome comece com "send" (qualquer case)
+        // Ignore helper functions (with name "send")
         if (/^send/i.test(func)) continue;
-        if (/^isend/i.test(func)) continue;
+        if (/^fusion_Send/i.test(func)) continue;
 
         return { file_name: file, function_name: func, line: ln };
       }
@@ -102,29 +109,8 @@ function getCallerInfo() {
   return null;
 }
 
-function iSend(payload1, payload2){
-    try{
-        const info = getCallerInfo();
-        send({
-          payload: payload1,
-          location: info
-        }, payload2);
-    } catch (err) {
-        //sendMessage("*", err)
-        console.log(`Error: ${err}`)
-    }
-}
-
-function sendData(mType, jData, bData){
-    //iSend('{"type" : "'+ mType +'", "jdata" : "'+ jData +'"}', bData);
-    iSend({
-      type: mType,
-      jdata: jData
-    }, bData)
-}
-
-function sendKeyValueData(module, items) {
-    var st = getB64StackTrace();
+function fusion_sendKeyValueData(module, items) {
+    var st = fusion_getB64StackTrace();
 
     var data = [];
 
@@ -133,67 +119,75 @@ function sendKeyValueData(module, items) {
         data = data.concat([{key: `${items[i].key}`, value:`${items[i].value}`}]);
     }
 
-    iSend({
+    fusion_Send({
       type: "key_value_data",
       module: module,
       data: data,
       stack_trace: st
     }, null);
 
+}
+
+function fusion_sendMessage(level, message){
+    try{
+        const StringClass = Java.use('java.lang.String');
+        const Base64Class = Java.use('android.util.Base64');
+        var bTxt = StringClass.$new(message).getBytes('utf-8');
+        var b64Msg = Base64Class.encodeToString(bTxt, 0x00000002); //Base64Class.NO_WRAP = 0x00000002
 
-    /*
-    var jData = `{"type" : "key_value_data", "module": "${module}", "data": [`;
-    for (let i = 0; i < items.length; i++) {
-        if (i > 0) {
-            jData += `, `
-        }
-        jData += `{"key": "${items[i].key}", "value": "${items[i].value}"}`
+        //send('{"type" : "message", "level" : "'+ level +'", "message" : "'+ b64Msg +'"}');
+        fusion_Send({
+          type: "message",
+          level: level,
+          message: b64Msg
+        }, null)
+    } catch (err) {
+        fusion_sendMessage("W", err)
     }
-    jData += `], "stack_trace": "${st}"}`;
-    iSend(jData, "");
-    */
 }
 
-function sendMessage(level, message){
+function fusion_sendMessageWithTrace(level, message){
     try{
         const StringClass = Java.use('java.lang.String');
         const Base64Class = Java.use('android.util.Base64');
+
+        var trace = Java.use("android.util.Log").getStackTraceString(Java.use("java.lang.Exception").$new());
+        trace = trace.replace("java.lang.Exception\n", "Stack trace:\n");
+        message += "\n"
+        message += trace
+
         var bTxt = StringClass.$new(message).getBytes('utf-8');
         var b64Msg = Base64Class.encodeToString(bTxt, 0x00000002); //Base64Class.NO_WRAP = 0x00000002
 
         //send('{"type" : "message", "level" : "'+ level +'", "message" : "'+ b64Msg +'"}');
-        iSend({
+        fusion_Send({
           type: "message",
           level: level,
           message: b64Msg
         }, null)
     } catch (err) {
-        sendMessage("*", err)
-        //sendMessage('-', 'secret_key_spec.$init.overload error: ' + err + '\n' + err.stack);
+        fusion_sendMessage("W", err)
     }
 }
 
-function sendError(error) {
+function fusion_sendError(error) {
     try{
-        sendMessage("-", error + '\n' + error.stack);
+        fusion_sendMessage("E", error + '\n' + error.stack);
     } catch (err) {
-        sendMessage("*", err)
+        fusion_sendMessage("W", err)
     }
 }
 
-function encodeHex(byteArray) {
+function fusion_encodeHex(byteArray) {
     
     const HexClass = Java.use('org.apache.commons.codec.binary.Hex');
     const StringClass = Java.use('java.lang.String');
     const hexChars = HexClass.encodeHex(byteArray);
-    //sendMessage("*", StringClass.$new(hexChars).toString());
-    //Buffer.from(bufStr, 'utf8');
-    //sendMessage("*", new Uint8Array(byteArray));
     return StringClass.$new(hexChars).toString();
     
 }
 
-function getB64StackTrace(){
+function fusion_getB64StackTrace(){
 
     try{
         const StringClass = Java.use('java.lang.String');
@@ -206,33 +200,18 @@ function getB64StackTrace(){
         return b64Msg
 
     } catch (err) {
-        sendMessage("*", err);
+        fusion_sendMessage("W", err);
         return '';
     }
 }
 
-function enumMethods(targetClass)
+function fusion_printMethods(targetClass)
 {
   var hook = Java.use(targetClass);
   var ownMethods = hook.class.getDeclaredMethods();
-  hook.$dispose;
-
-  return ownMethods;
-}
-
-function printMethods(hook)
-{
-  var ownMethods = hook.class.getDeclaredMethods();
-  ownMethods.forEach(function(s) { 
-    //sendMessage(s);
-    sendMessage('*', s);
+  ownMethods.forEach(function(s) {
+    fusion_sendMessage('I', s);
   });
-
-}
-
-function intToHex(intVal)
-{
-    return intVal.toString(16);
 }
 
 
@@ -263,7 +242,7 @@ Java.perform(function () {
   Thread.setDefaultUncaughtExceptionHandler(UEH.$new());
 });
 
-function formatBacktrace(frames) {
+function fusion_formatBacktrace(frames) {
   return frames.map((addr, i) => {
     const sym = DebugSymbol.fromAddress(addr);
     const mod = Process.findModuleByAddress(addr);
@@ -282,7 +261,7 @@ Process.setExceptionHandler(function (details) {
     frames = Thread.backtrace(details.context, Backtracer.FUZZY);
   }
 
-  const pretty = formatBacktrace(frames);
+  const pretty = fusion_formatBacktrace(frames);
 
   send({
     type: "native-exception",
@@ -302,4 +281,4 @@ Process.setExceptionHandler(function (details) {
   return false;
 });
 
-sendMessage("W", "Helper functions have been successfully initialized.")
+fusion_sendMessage("W", "Helper functions have been successfully initialized.")

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/frida_fusion/modules/crypto/crypto.js

@@ -21,23 +21,23 @@ setTimeout(function() {
         const System = Java.use("java.lang.System");
 
         if (MODULES.KeyGenerator) {
-            sendMessage('*', "Module attached: javax.crypto.KeyGenerator");
+            fusion_sendMessage('*', "Module attached: javax.crypto.KeyGenerator");
             const keyGenerator = Java.use("javax.crypto.KeyGenerator");
 
             keyGenerator.generateKey.implementation = function () {
-                sendMessage('*', "keyGenerator.generateKey");
+                fusion_sendMessage('*', "keyGenerator.generateKey");
                 return this.generateKey();
             };
 
             keyGenerator.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("keyGenerator.getInstance", [
+                fusion_sendKeyValueData("keyGenerator.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             keyGenerator.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("keyGenerator.getInstance", [
+                fusion_sendKeyValueData("keyGenerator.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -45,7 +45,7 @@ setTimeout(function() {
             };
 
             keyGenerator.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("keyGenerator.getInstance", [
+                fusion_sendKeyValueData("keyGenerator.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -55,17 +55,17 @@ setTimeout(function() {
         }
 
         if (MODULES.KeyPairGenerator) {
-            sendMessage('*', "Module attached: java.security.KeyPairGenerator");
+            fusion_sendMessage('*', "Module attached: java.security.KeyPairGenerator");
             const keyPairGenerator = Java.use("java.security.KeyPairGenerator");
             keyPairGenerator.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("keyPairGenerator.getInstance", [
+                fusion_sendKeyValueData("keyPairGenerator.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             keyPairGenerator.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("keyPairGenerator.getInstance", [
+                fusion_sendKeyValueData("keyPairGenerator.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -73,7 +73,7 @@ setTimeout(function() {
             };
 
             keyPairGenerator.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("keyPairGenerator.getInstance", [
+                fusion_sendKeyValueData("keyPairGenerator.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -82,11 +82,11 @@ setTimeout(function() {
         }
 
         if (MODULES.SecretKeySpec) {
-            sendMessage('*', "Module attached: javax.crypto.spec.SecretKeySpec");
+            fusion_sendMessage('*', "Module attached: javax.crypto.spec.SecretKeySpec");
             const secretKeySpec = Java.use("javax.crypto.spec.SecretKeySpec");
             secretKeySpec.$init.overload("[B", "java.lang.String").implementation = function (key, cipher) {
-                const keyBase64 = bytesToBase64(key);
-                sendKeyValueData("secretKeySpec.init", [
+                const keyBase64 = fusion_bytesToBase64(key);
+                fusion_sendKeyValueData("secretKeySpec.init", [
                     {key: "Key", value: keyBase64},
                     {key: "Algorithm", value: cipher}
                 ]);
@@ -95,17 +95,17 @@ setTimeout(function() {
         }
 
         if (MODULES.MessageDigest) {
-            sendMessage('*', "Module attached: java.security.MessageDigest");
+            fusion_sendMessage('*', "Module attached: java.security.MessageDigest");
             const messageDigest = Java.use("java.security.MessageDigest");
             messageDigest.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("messageDigest.getInstance", [
+                fusion_sendKeyValueData("messageDigest.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             messageDigest.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("messageDigest.getInstance", [
+                fusion_sendKeyValueData("messageDigest.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -113,7 +113,7 @@ setTimeout(function() {
             };
 
             messageDigest.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("messageDigest.getInstance", [
+                fusion_sendKeyValueData("messageDigest.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -121,8 +121,8 @@ setTimeout(function() {
             };
 
             messageDigest.update.overload("[B").implementation = function (input) {
-                const inputBase64 = bytesToBase64(input);
-                sendKeyValueData("messageDigest.update", [
+                const inputBase64 = fusion_bytesToBase64(input);
+                fusion_sendKeyValueData("messageDigest.update", [
                     {key: "HashCode", value: System.identityHashCode(this)},
                     {key: "Input", value: inputBase64},
                     {key: "Algorithm", value: this.getAlgorithm()}
@@ -132,8 +132,8 @@ setTimeout(function() {
 
             messageDigest.digest.overload().implementation = function () {
                 const output = messageDigest.digest.overload().call(this);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("messageDigest.digest", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("messageDigest.digest", [
                     {key: "HashCode", value: System.identityHashCode(this)},
                     {key: "Output", value: outputBase64},
                     {key: "Algorithm", value: this.getAlgorithm()}
@@ -143,8 +143,8 @@ setTimeout(function() {
 
             /*
             messageDigest.digest.overload("[B").implementation = function (input) {
-                const inputBase64 = bytesToBase64(input);
-                sendKeyValueData("messageDigest.digest", [
+                const inputBase64 = fusion_bytesToBase64(input);
+                fusion_sendKeyValueData("messageDigest.digest", [
                     {key: "Input", value: inputBase64},
                     {key: "Algorithm", value: this.getAlgorithm()}
                 ]);
@@ -152,8 +152,8 @@ setTimeout(function() {
             };
 
             messageDigest.digest.overload("[B", "int", "int").implementation = function (input, offset, len) {
-                const inputBase64 = bytesToBase64(input);
-                sendKeyValueData("messageDigest.digest", [
+                const inputBase64 = fusion_bytesToBase64(input);
+                fusion_sendKeyValueData("messageDigest.digest", [
                     {key: "Input", value: inputBase64},
                     {key: "Algorithm", value: this.getAlgorithm()},
                     {key: "Offset", value: offset},
@@ -166,17 +166,17 @@ setTimeout(function() {
         }
 
         if (MODULES.SecretKeyFactory) {
-            sendMessage('*', "Module attached: javax.crypto.SecretKeyFactory");
+            fusion_sendMessage('*', "Module attached: javax.crypto.SecretKeyFactory");
             const secretKeyFactory = Java.use("javax.crypto.SecretKeyFactory");
             secretKeyFactory.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("secretKeyFactory.getInstance", [
+                fusion_sendKeyValueData("secretKeyFactory.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             secretKeyFactory.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("secretKeyFactory.getInstance", [
+                fusion_sendKeyValueData("secretKeyFactory.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -184,7 +184,7 @@ setTimeout(function() {
             };
 
             secretKeyFactory.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("secretKeyFactory.getInstance", [
+                fusion_sendKeyValueData("secretKeyFactory.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -193,17 +193,17 @@ setTimeout(function() {
         }
 
         if (MODULES.Signature) {
-            sendMessage('*', "Module attached: java.security.Signature");
+            fusion_sendMessage('*', "Module attached: java.security.Signature");
             const signature = Java.use("java.security.Signature");
             signature.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("signature.getInstance", [
+                fusion_sendKeyValueData("signature.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             signature.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("signature.getInstance", [
+                fusion_sendKeyValueData("signature.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -211,7 +211,7 @@ setTimeout(function() {
             };
 
             signature.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("signature.getInstance", [
+                fusion_sendKeyValueData("signature.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -220,15 +220,15 @@ setTimeout(function() {
         }
 
         if (MODULES.Cipher) {
-            sendMessage('*', "Module attached: javax.crypto.Cipher");
+            fusion_sendMessage('*', "Module attached: javax.crypto.Cipher");
             var iv_parameter_spec = Java.use("javax.crypto.spec.IvParameterSpec");
             var pbe_parameter_spec = Java.use("javax.crypto.spec.PBEParameterSpec");
             var gcm_parameter_spec = Java.use("javax.crypto.spec.GCMParameterSpec");
             const cipher = Java.use("javax.crypto.Cipher");
             cipher.init.overload("int", "java.security.Key").implementation = function (opmode, key) {
-                sendKeyValueData("cipher.init", [
+                fusion_sendKeyValueData("cipher.init", [
                     {key: "HashCode", value: this.hashCode().toString()},
-                    {key: "Key", value: keyToBase64(key)},
+                    {key: "Key", value: fusion_keyToBase64(key)},
                     {key: "Opmode", value: this.getOpmodeString(opmode)},
                     {key: "Algorithm", value: this.getAlgorithm()}
                 ]);
@@ -236,9 +236,9 @@ setTimeout(function() {
             }
 
             cipher.init.overload("int", "java.security.cert.Certificate").implementation = function (opmode, certificate) {
-                sendKeyValueData("cipher.init", [
+                fusion_sendKeyValueData("cipher.init", [
                     {key: "HashCode", value: this.hashCode().toString()},
-                    {key: "Certificate", value: keyToBase64(certificate)},
+                    {key: "Certificate", value: fusion_keyToBase64(certificate)},
                     {key: "Opmode", value: this.getOpmodeString(opmode)},
                     {key: "Algorithm", value: this.getAlgorithm()}
                 ]);
@@ -246,9 +246,9 @@ setTimeout(function() {
             }
 
             cipher.init.overload("int", "java.security.Key", "java.security.AlgorithmParameters").implementation = function (opmode, key, algorithmParameter) {
-                sendKeyValueData("cipher.init", [
+                fusion_sendKeyValueData("cipher.init", [
                     {key: "HashCode", value: this.hashCode().toString()},
-                    {key: "Key", value: keyToBase64(key)},
+                    {key: "Key", value: fusion_keyToBase64(key)},
                     {key: "Opmode", value: this.getOpmodeString(opmode)},
                     {key: "Algorithm", value: this.getAlgorithm()}
                 ]);
@@ -260,7 +260,7 @@ setTimeout(function() {
                 try{
                     var data = [
                         {key: "HashCode", value: this.hashCode().toString()},
-                        {key: "Key", value: keyToBase64(key)},
+                        {key: "Key", value: fusion_keyToBase64(key)},
                         {key: "Opmode", value: this.getOpmodeString(opmode)},
                         {key: "Algorithm", value: this.getAlgorithm()}
                     ];
@@ -270,41 +270,41 @@ setTimeout(function() {
                     //Cast from javax.crypto.spec.PBEParameterSpec to javax.crypto.spec.IvParameterSpec
                     try{
                         data = data.concat([
-                            {key: "IV_Key", value: bytesToBase64(Java.cast(z, iv_parameter_spec).getIV())}
+                            {key: "IV_Key", value: fusion_bytesToBase64(Java.cast(z, iv_parameter_spec).getIV())}
                         ]);
 
                     } catch (err) {
                         try{
                             data = data.concat([
-                                {key: "PBE_Salt", value: bytesToBase64(Java.cast(z, pbe_parameter_spec).getSalt())}
+                                {key: "PBE_Salt", value: fusion_bytesToBase64(Java.cast(z, pbe_parameter_spec).getSalt())}
                             ]);
                         } catch (err) {
                             try{
                                 gcm = Java.cast(z, gcm_parameter_spec)
                                 data = data.concat([
-                                    {key: "IV_Key", value: bytesToBase64(gcm.getIV())},
+                                    {key: "IV_Key", value: fusion_bytesToBase64(gcm.getIV())},
                                     {key: "Auth_Tag_Length", value: gcm.getTLen().toString()},
                                 ]);
                             } catch (err) { }
                         }
                     }
 
-                    sendKeyValueData("cipher.init", data);
+                    fusion_sendKeyValueData("cipher.init", data);
                 } catch (err1) {
-                    sendError(err1)
+                    fusion_sendError(err1)
                 }
                 this.init.overload("int", "java.security.Key", "java.security.spec.AlgorithmParameterSpec").call(this, opmode, key, algorithmParameter);
             }
 
             cipher.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("cipher.getInstance", [
+                fusion_sendKeyValueData("cipher.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             cipher.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("cipher.getInstance", [
+                fusion_sendKeyValueData("cipher.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -312,7 +312,7 @@ setTimeout(function() {
             };
 
             cipher.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("cipher.getInstance", [
+                fusion_sendKeyValueData("cipher.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -320,10 +320,10 @@ setTimeout(function() {
             };
 
             cipher.doFinal.overload("[B").implementation = function (arg0) {
-                const inputBase64 = bytesToBase64(arg0);
+                const inputBase64 = fusion_bytesToBase64(arg0);
                 const output = this.doFinal.overload("[B").call(this, arg0);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("cipher.doFinal", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("cipher.doFinal", [
                     {key: "HashCode", value: this.hashCode().toString()},
                     {key: "Input", value: inputBase64},
                     {key: "Output", value: outputBase64}
@@ -332,10 +332,10 @@ setTimeout(function() {
             };
 
             cipher.doFinal.overload("[B", "int").implementation = function (arg0, arg1) {
-                const inputBase64 = bytesToBase64(arg0);
+                const inputBase64 = fusion_bytesToBase64(arg0);
                 const output = this.doFinal.overload("[B", "int").call(this, arg0, arg1);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("cipher.doFinal", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("cipher.doFinal", [
                     {key: "HashCode", value: this.hashCode().toString()},
                     {key: "Input", value: inputBase64},
                     {key: "Output", value: outputBase64}
@@ -344,10 +344,10 @@ setTimeout(function() {
             }
 
             cipher.doFinal.overload("[B", "int", "int").implementation = function (arg0, arg1, arg2) {
-                const inputBase64 = bytesToBase64(arg0);
+                const inputBase64 = fusion_bytesToBase64(arg0);
                 const output = this.doFinal.overload("[B", "int", "int").call(this, arg0, arg1, arg2);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("cipher.doFinal", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("cipher.doFinal", [
                     {key: "HashCode", value: this.hashCode().toString()},
                     {key: "Input", value: inputBase64},
                     {key: "Output", value: outputBase64}
@@ -356,10 +356,10 @@ setTimeout(function() {
             }
 
             cipher.doFinal.overload("[B", "int", "int", "[B").implementation = function (arg0, arg1, arg2, arg3) {
-                const inputBase64 = bytesToBase64(arg0);
+                const inputBase64 = fusion_bytesToBase64(arg0);
                 const output = this.doFinal.overload("[B", "int", "int", "[B").call(this, arg0, arg1, arg2, arg3);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("cipher.doFinal", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("cipher.doFinal", [
                     {key: "HashCode", value: this.hashCode().toString()},
                     {key: "Input", value: inputBase64},
                     {key: "Output", value: outputBase64}
@@ -368,10 +368,10 @@ setTimeout(function() {
             }
 
             cipher.doFinal.overload("[B", "int", "int", "[B", "int").implementation = function (arg0, arg1, arg2, arg3, arg4) {
-                const inputBase64 = bytesToBase64(arg0);
+                const inputBase64 = fusion_bytesToBase64(arg0);
                 const output = this.doFinal.overload("[B", "int", "int", "[B", "int").call(this, arg0, arg1, arg2, arg3, arg4);
-                const outputBase64 = bytesToBase64(output);
-                sendKeyValueData("cipher.doFinal", [
+                const outputBase64 = fusion_bytesToBase64(output);
+                fusion_sendKeyValueData("cipher.doFinal", [
                     {key: "HashCode", value: this.hashCode().toString()},
                     {key: "Input", value: inputBase64},
                     {key: "Output", value: outputBase64}
@@ -382,17 +382,17 @@ setTimeout(function() {
 
 
         if (MODULES.Mac) {
-            sendMessage('*', "Module attached: javax.crypto.Mac");
+            fusion_sendMessage('*', "Module attached: javax.crypto.Mac");
             const mac = Java.use("javax.crypto.Mac");
             mac.getInstance.overload("java.lang.String").implementation = function (arg0) {
-                sendKeyValueData("mac.getInstance", [
+                fusion_sendKeyValueData("mac.getInstance", [
                     {key: "Algorithm", value: arg0}
                 ]);
                 return this.getInstance(arg0);
             };
 
             mac.getInstance.overload("java.lang.String", "java.lang.String").implementation = function (arg0, arg1) {
-                sendKeyValueData("mac.getInstance", [
+                fusion_sendKeyValueData("mac.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -400,7 +400,7 @@ setTimeout(function() {
             };
 
             mac.getInstance.overload("java.lang.String", "java.security.Provider").implementation = function (arg0, arg1) {
-                sendKeyValueData("mac.getInstance", [
+                fusion_sendKeyValueData("mac.getInstance", [
                     {key: "Algorithm", value: arg0},
                     {key: "Provider", value: arg1}
                 ]);
@@ -409,7 +409,7 @@ setTimeout(function() {
         }
 
         if (MODULES.KeyGenParameterSpec) {
-            sendMessage('*', "Module attached: android.security.keystore.KeyGenParameterSpec$Builder");
+            fusion_sendMessage('*', "Module attached: android.security.keystore.KeyGenParameterSpec$Builder");
             const useKeyGen = Java.use("android.security.keystore.KeyGenParameterSpec$Builder");
             useKeyGen.$init.overload("java.lang.String", "int").implementation = function (keyStoreAlias, purpose) {
                 let purposeStr = "";
@@ -427,7 +427,7 @@ setTimeout(function() {
                     purposeStr = purpose;
                 }
 
-                sendKeyValueData("KeyGenParameterSpec.init", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.init", [
                     {key: "KeyStoreAlias", value: keyStoreAlias},
                     {key: "Purpose", value: purposeStr}
                 ]);
@@ -435,66 +435,66 @@ setTimeout(function() {
             }
 
             useKeyGen.setBlockModes.implementation = function (modes) {
-                sendKeyValueData("KeyGenParameterSpec.setBlockModes", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setBlockModes", [
                     {key: "BlockMode", value: modes.toString()}
                 ]);
                 return useKeyGen.setBlockModes.call(this, modes);
             }
 
             useKeyGen.setDigests.implementation = function (digests) {
-                sendKeyValueData("KeyGenParameterSpec.setDigests", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setDigests", [
                     {key: "Digests", value: digests.toString()}
                 ]);
                 return useKeyGen.setDigests.call(this, digests);
             }
 
             useKeyGen.setKeySize.implementation = function (keySize) {
-                sendKeyValueData("KeyGenParameterSpec.setKeySize", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setKeySize", [
                     {key: "KeySize", value: keySize}
                 ]);
                 return useKeyGen.setKeySize.call(this, keySize);
             }
 
             useKeyGen.setEncryptionPaddings.implementation = function (paddings) {
-                sendKeyValueData("KeyGenParameterSpec.setEncryptionPaddings", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setEncryptionPaddings", [
                     {key: "Paddings", value: paddings.toString()}
                 ]);
                 return useKeyGen.setEncryptionPaddings.call(this, paddings);
             }
 
             useKeyGen.setSignaturePaddings.implementation = function (paddings) {
-                sendKeyValueData("KeyGenParameterSpec.setSignaturePaddings", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setSignaturePaddings", [
                     {key: "Paddings", value: paddings.toString()}
                 ]);
                 return useKeyGen.setSignaturePaddings.call(this, paddings);
             }
 
             useKeyGen.setAlgorithmParameterSpec.implementation = function (spec) {
-                sendKeyValueData("KeyGenParameterSpec.setAlgorithmParameterSpec", [
+                fusion_sendKeyValueData("KeyGenParameterSpec.setAlgorithmParameterSpec", [
                     {key: "ParameterSpec", value: spec.toString()}
                 ]);
                 return useKeyGen.setAlgorithmParameterSpec.call(this, spec);
             }
 
             useKeyGen.build.implementation = function () {
-                sendMessage('*', "KeyGenParameterSpec.build");
+                fusion_sendMessage('*', "KeyGenParameterSpec.build");
                 return useKeyGen.build.call(this);
             }
         }
 
         if (MODULES.IvParameterSpec) {
-            sendMessage('*', "Module attached: javax.crypto.spec.IvParameterSpec");
+            fusion_sendMessage('*', "Module attached: javax.crypto.spec.IvParameterSpec");
             const ivParameter = Java.use("javax.crypto.spec.IvParameterSpec");
             ivParameter.$init.overload("[B").implementation = function (ivKey) {
-                sendKeyValueData("IvParameterSpec.init", [
-                    {key: "IV_Key", value: bytesToBase64(ivKey)}
+                fusion_sendKeyValueData("IvParameterSpec.init", [
+                    {key: "IV_Key", value: fusion_bytesToBase64(ivKey)}
                 ]);
                 return this.$init.overload("[B").call(this, ivKey);
             }
 
             ivParameter.$init.overload("[B", "int", "int").implementation = function (ivKey, offset, len) {
-                sendKeyValueData("IvParameterSpec.init", [
-                    {key: "IV Key", value: bytesToBase64(ivKey)},
+                fusion_sendKeyValueData("IvParameterSpec.init", [
+                    {key: "IV Key", value: fusion_bytesToBase64(ivKey)},
                     {key: "Offset", value: offset},
                     {key: "Length", value: len}
                 ]);
@@ -503,19 +503,19 @@ setTimeout(function() {
         }
 
         if (MODULES.GCMParameterSpec) {
-            sendMessage('*', "Module attached: javax.crypto.spec.GCMParameterSpec");
+            fusion_sendMessage('*', "Module attached: javax.crypto.spec.GCMParameterSpec");
             const gcmParameter = Java.use("javax.crypto.spec.GCMParameterSpec");
             gcmParameter.$init.overload("int", "[B").implementation = function (tLen, ivKey) {
-                sendKeyValueData("GCMParameterSpec.init", [
-                    {key: "IV_Key", value: bytesToBase64(ivKey)},
+                fusion_sendKeyValueData("GCMParameterSpec.init", [
+                    {key: "IV_Key", value: fusion_bytesToBase64(ivKey)},
                     {key: "Auth_Tag_Length", value: tLen.toString()}
                 ]);
                 return this.$init.overload("int", "[B").call(this, tLen, ivKey);
             }
 
             gcmParameter.$init.overload("int", "[B", "int", "int").implementation = function (tLen, ivKey, offset, len) {
-                sendKeyValueData("GCMParameterSpec.init", [
-                    {key: "IV_Key", value: bytesToBase64(ivKey)},
+                fusion_sendKeyValueData("GCMParameterSpec.init", [
+                    {key: "IV_Key", value: fusion_bytesToBase64(ivKey)},
                     {key: "Auth_Tag_Length", value: tLen.toString()},
                     {key: "Offset", value: offset},
                     {key: "Length", value: len}
@@ -525,11 +525,11 @@ setTimeout(function() {
         }
 
         if (MODULES.PBEParameterSpec) {
-            sendMessage('*', "Module attached: javax.crypto.spec.PBEParameterSpec");
+            fusion_sendMessage('*', "Module attached: javax.crypto.spec.PBEParameterSpec");
             const pbeParameter = Java.use("javax.crypto.spec.PBEParameterSpec");
             pbeParameter.$init.overload("[B", "int").implementation = function (salt, iterationCount) {
-                sendKeyValueData("PBEParameterSpec.init", [
-                    {key: "PBE_Salt", value: bytesToBase64(salt)},
+                fusion_sendKeyValueData("PBEParameterSpec.init", [
+                    {key: "PBE_Salt", value: fusion_bytesToBase64(salt)},
                     {key: "Iteration_Count", value: iterationCount.toString()}
                 ]);
                 return this.$init.overload("[B", "int").call(this, salt, iterationCount);
@@ -538,7 +538,7 @@ setTimeout(function() {
             pbeParameter.$init.overload("[B", "int", "java.security.spec.AlgorithmParameterSpec").implementation = function (salt, iterationCount, paramSpec) {
                 
                 var data = [
-                    {key: "PBE_Salt", value: bytesToBase64(salt)},
+                    {key: "PBE_Salt", value: fusion_bytesToBase64(salt)},
                     {key: "Iteration_Count", value: iterationCount.toString()}
                     
                 ]
@@ -546,42 +546,41 @@ setTimeout(function() {
                 try{
                     data = data.concat([
                         {key: "Algorithm", value: paramSpec.getAlgorithm()},
-                        {key: "ParamSpec", value: keyToBase64(paramSpec)},
+                        {key: "ParamSpec", value: fusion_keyToBase64(paramSpec)},
                         {key: "Provider", value: paramSpec.getProvider()}
                     ]);
                 } catch (err) { }
 
-                sendKeyValueData("PBEParameterSpec.init", data);
+                fusion_sendKeyValueData("PBEParameterSpec.init", data);
                 return this.$init.overload("[B", "int", "java.security.spec.AlgorithmParameterSpec").call(this, salt, iterationCount, paramSpec);
             }
         }
 
         if (MODULES.X509EncodedKeySpec) {
-            sendMessage('*', "Module attached: java.security.spec.X509EncodedKeySpec");
+            fusion_sendMessage('*', "Module attached: java.security.spec.X509EncodedKeySpec");
             const x509EncodedKeySpec = Java.use("java.security.spec.X509EncodedKeySpec");
             x509EncodedKeySpec.$init.overload("[B").implementation = function (encodedKey) {
-                sendKeyValueData("X509EncodedKeySpec.init", [
-                    {key: "Key", value: bytesToBase64(encodedKey)}
+                fusion_sendKeyValueData("X509EncodedKeySpec.init", [
+                    {key: "Key", value: fusion_bytesToBase64(encodedKey)}
                 ]);
                 return this.$init.overload("[B").call(this, encodedKey);
             }
 
         }
 
-        sendMessage("W", "Crypto functions have been successfully initialized.")
+        fusion_sendMessage("W", "Crypto functions have been successfully initialized.")
     });
     
 }, 0);
 
-
-function keyToBase64(key){
+function fusion_keyToBase64(key){
     if (key === null || key === undefined) return "IA==";
     try{
         
-        return bytesToBase64(key.getEncoded())
+        return fusion_bytesToBase64(key.getEncoded())
 
     } catch (err) {
-        sendMessage("*", err);
+        fusion_sendMessage("W", err);
         return "IA==";
     }
 }

{frida_fusion-0.1.8 → frida_fusion-0.1.9}/frida_fusion.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frida-fusion
-Version: 0.1.8
+Version: 0.1.9
 Summary: Hook your mobile tests with Frida
 Author-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
 Maintainer-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
@@ -73,6 +73,43 @@ Modules:
 pip3 install frida-fusion
 ```
 
+## Custom Frida script
+
+You must provide a custom Frida script as usual. To do this you must provide `-s/--script-path` parameter.
+
+```bash
+# Just one file
+frida-fusion -f [app_id] -U --script-path mytest.js
+
+# A entire directory
+frida-fusion -f [app_id] -U --script-path /tmp/scripts
+```
+
+### Exposed JavaScript (frida) functions
+
+The Frida Fusion define/expose several functions to be used at frida scripts. Follows the typedef of these functions.
+
+```java
+# Send message/data to Frida-Fusion
+void    fusion_sendMessage(String level, String message);
+void    fusion_sendMessageWithTrace(String level, String message);
+void    fusion_sendKeyValueData(String module, Object items);
+
+# Print StackTrace
+void    fusion_printStackTrace();
+
+# Print all methods of class 'name'
+void    fusion_printMethods(String name);
+
+# Wait until the class 'name' exists in memory to execute the callback function
+void    fusion_waitForClass(String name, CallbackFunction onReady)
+
+# Conversions
+byte[]  fusion_stringToBase64(String message);
+String  fusion_bytesToBase64(byte[] byteArray);
+String  fusion_encodeHex(byte[] byteArray);
+```
+
 ## Module engine
 
 You can check available modules with `frida-fusion --list-modules` command.
@@ -104,7 +141,7 @@ export FUSION_MODULES=/tmp/modules
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 At windows:
@@ -116,7 +153,7 @@ $env:FUSION_MODULES = "C:\extra_mods"
 frida-fusion --list-modules
 
 # Using available module
-frida-fusion -f [app_id] -U --script-path . -m [module_name]
+frida-fusion -f [app_id] -U --script-path mytest.js -m [module_name]
 ```
 
 ### Community modules
@@ -131,3 +168,4 @@ export FUSION_MODULES=/tmp/frida-fusion-community-modules
 # List all modules
 frida-fusion --list-modules
 ```
+