vechain · libotony · Feb 23, 2024 · Dec 19, 2023 · Dec 19, 2023 · Dec 19, 2023
@@ -7,6 +7,8 @@ on:
 jobs:
   stale:
     runs-on: ubuntu-latest
+    # only run this action on `vechain/thor` repository
+    if: github.repository == 'vechain/thor'
 
     permissions:
       contents: write

@@ -7,6 +7,8 @@ on:
 
 jobs:
   scan_qodana:
+    # only run this action on `vechain/thor` repository
+    if: github.repository == 'vechain/thor'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code

@@ -200,7 +200,7 @@ Once `thor` has started, the online *OpenAPI* doc can be accessed in your browse
 A special shout out to following projects:
 
 * [Ethereum](https://github.com/ethereum)
-* [Swagger](https://github.com/swagger-api)
+* [Stoplight Elements](https://github.com/stoplightio/elements)
 
 ## Contributing
 

@@ -52,15 +52,15 @@ func New(
 
 	router := mux.NewRouter()
 
-	// to serve api doc and swagger-ui
+	// to serve api docs
 	router.PathPrefix("/doc").Handler(
 		http.StripPrefix("/doc/", http.FileServer(http.FS(doc.FS))),
 	)
 
-	// redirect swagger-ui
+	// redirect api-docs
 	router.Path("/").HandlerFunc(
 		func(w http.ResponseWriter, req *http.Request) {
-			http.Redirect(w, req, "doc/swagger-ui/", http.StatusTemporaryRedirect)
+			http.Redirect(w, req, "doc/api-docs/", http.StatusTemporaryRedirect)
 		})
 
 	accounts.New(repo, stater, callGasLimit, forkConfig).

@@ -1 +1,19 @@
-swagger-ui from https://github.com/swagger-api/swagger-ui @v3.17.6
+## Swagger
+
+swagger-ui from https://github.com/swagger-api/swagger-ui @v5.11.2
+- Created [window-observer.js](swagger-ui/window-observer.js) to remove `Try it out` functionality for subscription endpoints
+
+```bash
+curl https://unpkg.com/swagger-ui-dist@5.11.2/swagger-ui.css > swagger-ui/swagger-ui.css
+curl https://unpkg.com/swagger-ui-dist@5.11.2/swagger-ui-bundle.js > swagger-ui/swagger-ui-bundle.js
+curl https://unpkg.com/swagger-ui-dist@5.11.2/swagger-ui-standalone-preset.js > swagger-ui/swagger-ui-standalone-preset.js
+```
+
+## Stoplight
+Spotlight UI from https://github.com/stoplightio/elements @v8.0.3
+- Created [window-observer.js](api-docs/window-observer.js) to remove `Send API Request` functionality for subscription endpoints
+
+```bash
+curl https://unpkg.com/@stoplight/elements@8.0.3/styles.min.css > api-docs/styles.min.css
+curl https://unpkg.com/@stoplight/elements@8.0.3/web-components.min.js > api-docs/web-components.min.js
+```
diff --git a/api/doc/api-docs/index.html b/api/doc/api-docs/index.html
@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta content="width=device-width, initial-scale=1, shrink-to-fit=no" name="viewport">
+    <title>Thor API</title>
+    <!-- Embed elements Elements via Web Component -->
+    <script src="./web-components.min.js"></script>
+    <script charset="UTF-8" src="./window-observer.js"> </script>
+    <link href="./styles.min.css" rel="stylesheet">
+    <link href="/doc/icons/favicon-32x32.png" rel="icon" sizes="32x32" type="image/png" />
+    <link href="/doc/icons/favicon-16x16.png" rel="icon" sizes="16x16" type="image/png" />
+    <link href="/doc/icons/favicon-96x96.png" rel="icon" sizes="96x96" type="image/png" />
+
+</head>
+<body>
+    <elements-api
+        apiDescriptionUrl="/doc/thor.yaml"
+        layout="sidebar"
+        logo="/doc/icons/favicon-96x96.png"
+        router="hash"
+    />
+</body>
+</html>
diff --git a/api/doc/api-docs/styles.min.css b/api/doc/api-docs/styles.min.css
diff --git a/api/doc/api-docs/web-components.min.js b/api/doc/api-docs/web-components.min.js
diff --git a/api/doc/api-docs/window-observer.js b/api/doc/api-docs/window-observer.js
@@ -0,0 +1,19 @@
+/**
+ * This script is used to remove the "Send API request" button and the "Response" sections from WebSocket operations.
+ * @type {MutationObserver}
+ */
+const mutationObserver = new MutationObserver(() => {
+
+
+    if (window.location.hash?.includes("#/paths/subscriptions")) {
+
+        const element = document.querySelector('[data-testid="two-column-right"]');
+
+        if (element) {
+            element.remove();
+        }
+    }
+
+})
+
+mutationObserver.observe(document, {attributes: false, childList: true, characterData: false, subtree:true});
@@ -11,7 +11,9 @@ import (
 	"gopkg.in/yaml.v2"
 )
 
-//go:embed swagger-ui thor.yaml
+// FS embeds the Open API specs and documentation.
+//
+//go:embed thor.yaml api-docs swagger-ui icons
 var FS embed.FS
 var version string
 

@@ -1,60 +1,30 @@
-<!-- HTML for static distribution bundle build -->
 <!DOCTYPE html>
 <html lang="en">
-  <head>
-    <meta charset="UTF-8">
-    <title>Swagger UI</title>
-    <link rel="stylesheet" type="text/css" href="./swagger-ui.css" >
-    <link rel="icon" type="image/png" href="./favicon-32x32.png" sizes="32x32" />
-    <link rel="icon" type="image/png" href="./favicon-16x16.png" sizes="16x16" />
-    <style>
-      html
-      {
-        box-sizing: border-box;
-        overflow: -moz-scrollbars-vertical;
-        overflow-y: scroll;
-      }
-
-      *,
-      *:before,
-      *:after
-      {
-        box-sizing: inherit;
-      }
-
-      body
-      {
-        margin:0;
-        background: #fafafa;
-      }
-    </style>
-  </head>
-
-  <body>
-    <div id="swagger-ui"></div>
-
-    <script src="./swagger-ui-bundle.js"> </script>
-    <script src="./swagger-ui-standalone-preset.js"> </script>
-    <script>
-    window.onload = function() {
-
-      // Build a system
-      const ui = SwaggerUIBundle({
-        url: "../thor.yaml",
-        dom_id: '#swagger-ui',
-        deepLinking: true,
-        presets: [
-          SwaggerUIBundle.presets.apis,
-          SwaggerUIStandalonePreset
-        ],
-        plugins: [
-          SwaggerUIBundle.plugins.DownloadUrl
-        ],
-        layout: "StandaloneLayout"
-      })
-
-      window.ui = ui
-    }
-  </script>
-  </body>
+<head>
+    <meta charset="utf-8" />
+    <title>Thor Swagger</title>
+    <link href="./swagger-ui.css" rel="stylesheet" />
+    <link href="/doc/icons/favicon-32x32.png" rel="icon" sizes="32x32" type="image/png" />
+    <link href="/doc/icons/favicon-16x16.png" rel="icon" sizes="16x16" type="image/png" />
+    <link href="/doc/icons/favicon-96x96.png" rel="icon" sizes="96x96" type="image/png" />
+</head>
+<body>
+<div id="swagger-ui"></div>
+<script charset="UTF-8" src="./window-observer.js"> </script>
+<script crossorigin src="./swagger-ui-bundle.js"></script>
+<script crossorigin src="./swagger-ui-standalone-preset.js"></script>
+<script>
+    window.onload = () => {
+        window.ui = SwaggerUIBundle({
+            url: `${window.location.origin}/doc/thor.yaml`,
+            dom_id: '#swagger-ui',
+            presets: [
+                SwaggerUIBundle.presets.apis,
+                SwaggerUIStandalonePreset
+            ],
+            layout: "StandaloneLayout",
+        });
+    };
+</script>
+</body>
 </html>