Algod: Add disassembly endpoint and implement cucumber test

algosdk/v2client/algod.py

@@ -403,6 +403,28 @@ def compile(self, source, source_map=False, **kwargs):
             "POST", req, params=params, data=source.encode("utf-8"), **kwargs
         )
 
+    def disassemble(self, program_bytes, **kwargs):
+        """
+        Disassable TEAL program bytes with remote algod.
+        Args:
+            program (bytes): bytecode to be disassembled
+            request_header (dict, optional): additional header for request
+        Returns:
+            str: disassembled TEAL source code in plain text
+        """
+        if not isinstance(program_bytes, bytes):
+            raise error.InvalidProgram(
+                message=f"disassemble endpoints only accepts bytes but request program_bytes is of type {type(program_bytes)}"
+            )
+
+        req = "/teal/disassemble"
+        headers = util.build_headers_from(
+            kwargs.get("headers", False),
+            {"Content-Type": "application/x-binary"},
+        )
+        kwargs["headers"] = headers
+        return self.algod_request("POST", req, data=program_bytes, **kwargs)
+
     def dryrun(self, drr, **kwargs):
         """
         Dryrun with remote algod.
@@ -450,7 +472,7 @@ def transaction_proof(
             req,
             params=params,
             response_format=response_format,
-            **kwargs
+            **kwargs,
         )
 
     def lightblockheader_proof(self, round_num, **kwargs):

tests/integration.tags

@@ -6,6 +6,7 @@
 @auction
 @c2c
 @compile
+@compile.disassemble
 @compile.sourcemap
 @dryrun
 @dryrun.testing

tests/steps/other_v2_steps.py

@@ -1072,6 +1072,17 @@ def b64decode_compiled_teal_step(context, binary):
     assert base64.b64decode(response_result.encode()) == binary
 
 
+@then('disassembly of "{bytecode_filename}" matches "{source_filename}"')
+def disassembly_matches_source(context, bytecode_filename, source_filename):
+    bytecode = load_resource(bytecode_filename)
+    expected_source = load_resource(source_filename).decode("utf-8")
+
+    context.response = context.app_acl.disassemble(bytecode)
+    actual_source = context.response["result"]
+
+    assert actual_source == expected_source
+
+
 @when('I dryrun a "{kind}" program "{program}"')
 def dryrun_step(context, kind, program):
     data = load_resource(program)