rewrite geth_utils with go.work (#875)

* Remove assembly in geth-utils (privacy-scaling-explorations#1553)

Remove geth-utils and examples.

New feature (non-breaking change which adds functionality)

- Assembly was introduced in #91 to build examples to use geth-util. It
was not used elsewhere in the codebase.
- The examples are removed as we currently don't use geth-util like the
way the examples show. (Note that the examples also fail to run now. The
transactions in the examples would fail because the trace config
defaults to a 0 block gas limit. It runs after adding a block gas
limit.)
- I found those examples unused when reviewing how we use the tracing
API. It is much easier to review the tracing code after removing the
Assembly.
- The Readme mentioned a TODO CLI, which we never built. I think it
might be interesting to create a good first issue for people to extend
testool(https://github.com/privacy-scaling-explorations/zkevm-circuits/blob/690b2f143a94b7474f0c99493a99b0f2c53d93b8/testool/README.md#L38)
for it.

* rewrite geth_utils with go.work

* fix make doc

---------

Co-authored-by: Chih Cheng Liang <chihchengliang@gmail.com>

geth-utils/README.md

@@ -2,19 +2,6 @@
 
 The module `gethutil` tried to provide identical output from APIs `debug_trace*` of latest `geth` as test vectors for [`zkevm-circuits`](https://github.com/privacy-scaling-explorations/zkevm-circuits).
 
-## Usage
-
-<!-- ### CLI Usage -->
-<!-- TODO: Implement a CLI to consume bytecode and output logs -->
-
-### Library Usage
-
-For [`./example/mstore_mload.go`](./example/mstore_mload.go) as an example, it defines bytecode directly by builder `asm`, then write the logs produced by `TraceTx` to stdout. To reproduce the logs, run:
-
-```bash
-go run ./example/mstore_mload.go > ./mstore_mload.json
-```
-
 ### Debugging
 
 The execution traces returned by geth omit some information like execution

geth-utils/build.rs

@@ -10,25 +10,16 @@ fn main() {
     // Build
     let mut build = gobuild::Build::new();
     let target_files = if cfg!(feature = "scroll") {
-        vec![
-            "./l2geth/asm.go",
-            "./l2geth/trace.go",
-            "./l2geth/util.go",
-            "./l2geth/lib.go",
-        ]
+        vec!["./l2geth/trace.go", "./l2geth/lib.go"]
     } else {
-        vec!["./lib/lib.go"]
+        vec!["./l1geth/trace.go", "./l1geth/lib.go"]
     };
 
-    // Replace to a custom go-ethereum for scroll.
-    #[cfg(feature = "scroll")]
-    build.modfile("./l2geth/go.mod");
-
     if let Err(e) = build.files(target_files).try_compile(lib_name) {
         // The error type is private so have to check the error string
         if format!("{e}").starts_with("Failed to find tool.") {
             fail(
-                " Failed to find Go. Please install Go 1.16 or later \
+                " Failed to find Go. Please install Go 1.18 or later \
                 following the instructions at https://golang.org/doc/install.
                 On linux it is also likely available as a package."
                     .to_string(),
@@ -41,19 +32,17 @@ fn main() {
     // Files the lib depends on that should recompile the lib
     let dep_files = if cfg!(feature = "scroll") {
         vec![
-            "./l2geth/asm.go",
             "./l2geth/trace.go",
-            "./l2geth/util.go",
             "./l2geth/lib.go",
             "./l2geth/go.mod",
             "./l2geth/go.sum",
         ]
     } else {
         vec![
-            "./gethutil/asm.go",
-            "./gethutil/trace.go",
-            "./gethutil/util.go",
-            "./go.mod",
+            "./l1geth/trace.go",
+            "./l1geth/lib.go",
+            "./l1geth/go.mod",
+            "./l1geth/go.sum",
         ]
     };