Change API docs to use Redocly (#214)

Author: includenull

docs/.vitepress/config.mts

@@ -134,6 +134,7 @@ export default defineConfig({
     ],
     resolve: {
       alias: []
-    }
+    },
+    publicDir: 'public'
   }
 })

docs/.vitepress/theme/index.ts

@@ -3,49 +3,8 @@ import { h } from 'vue'
 import DefaultTheme from 'vitepress/theme'
 import type { Theme } from 'vitepress'
 import './style.css'
-import { theme, useOpenapi } from 'vitepress-openapi/client'
-import 'vitepress-openapi/dist/style.css'
 import ActionHighlight from './components/ActionHighlight.vue'
 
-// Global server fetching utility
-export const fetchWaxEndpoints = async () => {
-  // Check cache first
-  const cacheKey = 'wax-endpoints-cache'
-  const cacheExpiry = 1000 * 60 * 60 * 24 // 24 hours in milliseconds
-  
-  try {
-    const cached = localStorage.getItem(cacheKey)
-    if (cached) {
-      const { endpoints: cachedEndpoints, timestamp } = JSON.parse(cached)
-      const now = Date.now()
-      
-      // Use cached endpoints if they're still valid
-      if (now - timestamp < cacheExpiry) {
-        console.log('Using cached endpoint list')
-        return cachedEndpoints
-      }
-    }
-    
-    // Fetch fresh data if cache is expired or doesn't exist
-    console.log('Fetching fresh endpoint list')
-    const response = await fetch('https://validate.eosnation.io/wax/reports/endpoints.json')
-    const data = await response.json()
-    const endpoints = data.report
-    
-    // Cache the new data
-    const cacheData = {
-      endpoints,
-      timestamp: Date.now()
-    }
-    localStorage.setItem(cacheKey, JSON.stringify(cacheData))
-    
-    return endpoints
-  } catch (err) {
-    console.error('Failed to fetch endpoints, using defaults:', err)
-    return null
-  }
-}
-
 /** @type {import('vitepress').Theme} */
 export default {
   extends: DefaultTheme,
@@ -55,17 +14,6 @@ export default {
     })
   },
   async enhanceApp({ app, router, siteData }) {
-    app.component('ActionHighlight', ActionHighlight),
-    useOpenapi({
-      config: {
-        spec: {
-          groupByTags: false,
-        },
-        server: {
-          allowCustomServer: true,
-        },
-      },
-    }),
-    theme.enhanceApp({ app, router, siteData })
+    app.component('ActionHighlight', ActionHighlight)
   }
 } satisfies Theme

docs/apis.md

@@ -0,0 +1,17 @@
+---
+title: WAX API Documentation
+description: Redirecting to API Reference
+---
+
+<script setup>
+import { onMounted } from 'vue'
+
+onMounted(() => {
+  // Redirect to the main API reference page
+  window.location.href = '/build/api-reference'
+})
+</script>
+
+# Redirecting to API Reference...
+
+If you're not redirected automatically, [click here](/build/api-reference) to view the WAX API documentation.

docs/apis/atomic-api.md

@@ -0,0 +1,17 @@
+---
+title: WAX Atomic Assets API
+description: WAX Blockchain Atomic Assets API Documentation
+---
+
+<script setup>
+import { onMounted } from 'vue'
+
+onMounted(() => {
+  // Redirect to the static HTML file
+  window.location.href = '/apis/atomic-api'
+})
+</script>
+
+# Redirecting to Atomic Assets API...
+
+If you're not redirected automatically, [click here](/apis/atomic-api) to view the WAX Atomic Assets API documentation.

docs/apis/chain-api.md

@@ -0,0 +1,17 @@
+---
+title: WAX Chain API
+description: WAX Blockchain Chain API Documentation
+---
+
+<script setup>
+import { onMounted } from 'vue'
+
+onMounted(() => {
+  // Redirect to the static HTML file
+  window.location.href = '/apis/chain-api'
+})
+</script>
+
+# Redirecting to Chain API...
+
+If you're not redirected automatically, [click here](/apis/chain-api) to view the WAX Chain API documentation.

docs/build/api-reference/atomic_api.md

@@ -0,0 +1,17 @@
+---
+title: WAX Atomic Assets API
+description: Redirecting to Atomic Assets API
+---
+
+<script setup>
+import { onMounted } from 'vue'
+
+onMounted(() => {
+  // Redirect to the Atomic Assets API page
+  window.location.href = '/apis/atomic-api'
+})
+</script>
+
+# Redirecting to Atomic Assets API...
+
+If you're not redirected automatically, [click here](/apis/atomic-api) to view the WAX Atomic Assets API documentation.

docs/build/api-reference/rpc_api.md

@@ -0,0 +1,17 @@
+---
+title: WAX RPC API
+description: Redirecting to Chain API
+---
+
+<script setup>
+import { onMounted } from 'vue'
+
+onMounted(() => {
+  // Redirect to the Chain API page
+  window.location.href = '/apis/chain-api'
+})
+</script>
+
+# Redirecting to Chain API...
+
+If you're not redirected automatically, [click here](/apis/chain-api) to view the WAX Chain API documentation.

docs/en/build/api-reference/atomic_api.md

@@ -1,13 +1,19 @@
 ---
 title: WAX API Reference
+description: API documentation for WAX Blockchain
 ---
 
-# WAX API Reference
+# {{ $frontmatter.title }}
 
-Here you'll find detailed documentation, usage guides, and examples to help you understand and integrate WAX APIs into your applications efficiently.
+Here you'll find comprehensive documentation for WAX Blockchain APIs
 
 ## APIs
 
-- [Chain API](/build/api-reference/rpc_api)
-- [AtomiAssets API](/build/api-reference/atomic_api)
-- [CDT](/build/api-reference/cdt_api)
+**[Chain API](/apis/chain-api)**  
+The Chain API offers blockchain data access including account information, transaction details, and blockchain state.
+
+**[Atomic Assets API](/apis/atomic-api)**  
+The Atomic Assets API provides endpoints for managing and querying NFT assets on the WAX blockchain.
+
+**[CDT](/build/api-reference/cdt_api)**  
+Contract Development Toolkit for smart contract development.