feat(cli): --disasm option to expose TVM disassembler

via @tact-lang/opcode library
tact-lang · Dec 26, 2024 · 56937e6 · 56937e6
1 parent 136665e
commit 56937e6
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 3 deletions.
diff --git a/.github/workflows/tact.yml b/.github/workflows/tact.yml
@@ -173,6 +173,12 @@ jobs:
         run: |
           tact -e '(1 + 2 * (pow(3,4) - 2) << 1 & 0x54 | 33 >> 1) * 2 + 2'
 
+      - name: CLI Test | Check TVM disassembler flag
+        if: runner.os != 'Windows'
+        run: |
+          tact bin/test/success.tact
+          tact --disasm success_HelloWorld.code.boc
+
       - name: Test compatibility with tact-template
         run: |
           git clone https://github.com/tact-lang/tact-template.git

diff --git a/bin/tact.js b/bin/tact.js
@@ -1,19 +1,20 @@
 #!/usr/bin/env node
+/* eslint-disable @typescript-eslint/no-var-requires */
 
 const pkg = require("../package.json");
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 const main = require("../dist/node.js");
 const meowModule = import("meow");
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 const { execFileSync } = require("child_process");
+const { decompileAll } = require("@tact-lang/opcode");
+const { readFileSync } = require("fs");
 
 void meowModule.then(
     /** @param meow {import('meow/build/index')} */
     (meow) => {
         const cli = meow.default(
             `
     Usage
-      $ tact [...flags] (--config CONFIG | FILE)
+      $ tact [...flags] (--config CONFIG | --disasm BOC-FILE | TACT-FILE)
 
     Flags
       -c, --config CONFIG         Specify path to config file (tact.config.json)
@@ -22,6 +23,7 @@ void meowModule.then(
       --with-decompilation        Full compilation followed by decompilation of produced binary code
       --func                      Output intermediate FunC code and exit
       --check                     Perform syntax and type checking, then exit
+      --disasm BOC-FILE           Disassemble a BoC (bag of cells) file and output TVM instructions to stdout
       -e, --eval EXPRESSION       Evaluate a Tact expression and exit
       -v, --version               Print Tact compiler version and exit
       -h, --help                  Display this text and exit
@@ -62,6 +64,7 @@ void meowModule.then(
                         type: "string",
                         isMultiple: true,
                     },
+                    disasm: { type: "string" },
                     quiet: { shortFlag: "q", type: "boolean", default: false },
                     withDecompilation: { type: "boolean", default: false },
                     func: { type: "boolean", default: false },
@@ -117,6 +120,18 @@ void meowModule.then(
             }
         }
 
+        if (cli.flags.disasm !== undefined) {
+            try {
+                const boc = readFileSync(cli.flags.disasm);
+                const disasmResult = decompileAll({ src: Buffer.from(boc) });
+                console.log(disasmResult);
+                process.exit(0);
+            } catch (error) {
+                console.error(error.message);
+                process.exit(30);
+            }
+        }
+
         // Disallow specifying both config or Tact source file at the same time
         if (cli.flags.config !== undefined && cli.input.length > 0) {
             console.log(