Token API docs optimization (#1054)

* optimized tokenapi quickstart

* remove bun lock

* reorder sidebar to highlight most popular routes

* realign translations to english

* add sdk for typescript

* clarify api key locations

* Run `pnpm check:fix`

* Replace `CodeTabs` with GDS’s `CodeBlock.Tabs`

---------

Co-authored-by: benface <benoit.rouleau@icloud.com>

Author: nsjames

nginx.conf

@@ -169,6 +169,7 @@ http {
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
+        rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/endpoint-pricing/$                  $scheme://$http_host/docs/$1/token-api/endpoints/pricing/                           permanent;
         # Temporary redirects (302)
         rewrite ^/docs/en/querying/graph-client/$                                       $scheme://$http_host/docs/en/subgraphs/querying/graph-client/README/                redirect;
         rewrite ^/docs/en/developing/graph-ts/$                                         $scheme://$http_host/docs/en/subgraphs/developing/creating/graph-ts/README/         redirect;

website/src/components/CodeBlock.tsx

@@ -28,10 +28,25 @@ export const CodeBlock = ({ className, children, ...props }: CodeBlockProps) =>
     <ExperimentalCodeBlock
       language={language as ExperimentalCodeBlockProps['language']}
       lineNumbers={lineCount > 1}
-      className={classNames(['graph-docs-not-markdown --:my-8 --:last:mb-0 -:is-[li>*]:my-4', className])}
+      className={classNames([
+        `graph-docs-not-markdown
+        --:not-in-group/code-block-tabs:my-8
+        --:not-in-group/code-block-tabs:last:mb-0
+        -:not-in-group/code-block-tabs:is-[li>*]:my-4`,
+        className,
+      ])}
       {...(props as ComponentProps<'div'>)}
     >
       {code}
     </ExperimentalCodeBlock>
   )
 }
+
+export const CodeBlockTabs = ({ className, ...props }: ComponentProps<typeof ExperimentalCodeBlock.Tabs>) => {
+  return (
+    <ExperimentalCodeBlock.Tabs
+      className={classNames(['graph-docs-not-markdown --my-8 -:is-[li>*]:my-4', className])}
+      {...props}
+    />
+  )
+}

website/src/layout/Layout.tsx

@@ -56,6 +56,7 @@ import {
 import {
   Callout,
   CodeBlock,
+  CodeBlockTabs,
   DocSearch,
   Heading,
   Image,
@@ -610,6 +611,8 @@ export default function Layout({ pageOpts, children }: NextraThemeLayoutProps<Fr
                 img: ImageWrapper,
                 // TODO: Fix "[Shiki] X instances have been created. Shiki is supposed to be used as a singleton" warnings
                 pre: CodeBlock,
+                CodeBlock,
+                CodeBlockTabs,
                 // TODO: Build and use `ExperimentalTable`
                 table: Table,
                 VideoEmbed,

website/src/pages/ar/token-api/_meta.js

@@ -2,15 +2,15 @@ import titles from './_meta-titles.json'
 
 export default {
   'quick-start': '',
+  'svm-tokens': titles['svm-tokens'] ?? '',
+  'svm-dexs': titles['svm-dexs'] ?? '',
   'evm-tokens': titles['evm-tokens'] ?? '',
   'evm-dexs': titles['evm-dexs'] ?? '',
   'evm-nfts': titles['evm-nfts'] ?? '',
-  'svm-tokens': titles['svm-tokens'] ?? '',
-  'svm-dexs': titles['svm-dexs'] ?? '',
   'tvm-tokens': titles['tvm-tokens'] ?? '',
   'tvm-dexs': titles['tvm-dexs'] ?? '',
   monitoring: titles['monitoring'] ?? '',
-  'endpoint-pricing': '',
+  endpoints: titles['endpoints'] ?? '',
   guides: titles['guides'] ?? '',
   faq: '',
 }

website/src/pages/ar/token-api/endpoints/_meta.js

@@ -0,0 +1,4 @@
+export default {
+  pricing: '',
+  support: '',
+}

…/pages/en/token-api/endpoint-pricing.mdx …pages/ar/token-api/endpoints/pricing.mdxwebsite/src/pages/en/token-api/endpoint-pricing.mdx renamed to website/src/pages/ar/token-api/endpoints/pricing.mdx website/src/pages/en/token-api/endpoint-pricing.mdx renamed to website/src/pages/ar/token-api/endpoints/pricing.mdx

@@ -1,5 +1,6 @@
 ---
 title: Endpoint Pricing
+sidebarTitle: Pricing
 ---
 
 ## Pricing Tiers

website/src/pages/ar/token-api/endpoints/support.mdx

@@ -0,0 +1,23 @@
+---
+title: Endpoint Feature Matrix
+sidebarTitle: Support Matrix
+---
+
+import { Check } from '@edgeandnode/gds/icons'
+
+## Chain and Feature Support
+
+| Network           |          Tokens           |           Swaps           |           NFTs            |
+| ----------------- | :-----------------------: | :-----------------------: | :-----------------------: |
+| Ethereum Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| BSC Mainnet       | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Base Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Unichain Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Arbitrum One      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Optimism Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Polygon Mainnet   | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Avalanche C-Chain | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Solana Mainnet    | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+| Tron Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+
+A full list of chain support for The Graph services can be found [here](/supported-networks/).

website/src/pages/ar/token-api/evm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }

website/src/pages/ar/token-api/evm-tokens/_meta.js

@@ -1,8 +1,8 @@
 export default {
-  tokens: '',
   transfers: '',
+  holders: '',
+  tokens: '',
   balances: '',
   'balances-native': '',
   'balances-historical': '',
-  holders: '',
 }

website/src/pages/ar/token-api/svm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }