Consolidate CCIP tools documentation and remove obsolete JavaScript SDK (#3479)

Unified SDK/CLI pages, replaced EVM-specific offchain tutorials with universal page, added redirects for backward compatibility, and updated robots.txt for cross-site SEO.

Author: aelmanaa

public/llms.txt

@@ -170,4 +170,4 @@ This document offers simple, clean, and comprehensive resources for developers t
 ## Tools
 - [Chainlink Local Development Environment](https://docs.chain.link/chainlink-local): Set up a local Chainlink node environment.
 - [Chainlink Functions Toolkit (NPM)](https://www.npmjs.com/package/@chainlink/functions-toolkit): NPM package for working with Chainlink Functions.
-- [Chainlink CCIP JavaScript SDK (GitHub)](https://github.com/smartcontractkit/ccip-javascript-sdk): SDK for building applications with CCIP.
+- [CCIP Tools (GitHub)](https://github.com/smartcontractkit/ccip-tools-ts): TypeScript SDK and CLI for interacting with CCIP.

public/robots.txt

@@ -1,4 +1,5 @@
 User-agent: *
 Allow: /
 Disallow:
-Sitemap: https://docs.chain.link/sitemap-index.xml
+Sitemap: https://docs.chain.link/sitemap-index.xml
+Sitemap: https://docs.chain.link/ccip/tools/sitemap.xml

src/config/sidebar/__tests__/__snapshots__/ccip-dynamic.test.ts.snap

@@ -349,6 +349,10 @@ exports[`CCIP Sidebar Configuration Snapshot should match the expected sidebar s
         "title": "Acquire Test Tokens",
         "url": "ccip/test-tokens",
       },
+      {
+        "title": "Offchain",
+        "url": "ccip/tutorials/offchain",
+      },
       {
         "chainTypes": [
           "evm",
@@ -377,59 +381,6 @@ exports[`CCIP Sidebar Configuration Snapshot should match the expected sidebar s
         "title": "Using the Token Manager",
         "url": "ccip/tutorials/evm/token-manager",
       },
-      {
-        "chainTypes": [
-          "evm",
-        ],
-        "title": "Using the CCIP JavaScript SDK",
-        "url": "ccip/ccip-javascript-sdk",
-      },
-      {
-        "chainTypes": [
-          "evm",
-        ],
-        "children": [
-          {
-            "chainTypes": [
-              "evm",
-            ],
-            "title": "Transfer Tokens between EOAs",
-            "url": "ccip/tutorials/evm/offchain/transfer-tokens-from-eoa",
-          },
-          {
-            "chainTypes": [
-              "evm",
-            ],
-            "title": "Checking CCIP Message Status",
-            "url": "ccip/tutorials/evm/offchain/get-status-offchain",
-          },
-          {
-            "chainTypes": [
-              "evm",
-            ],
-            "children": [
-              {
-                "chainTypes": [
-                  "evm",
-                ],
-                "title": "Transfer Tokens between EOAs",
-                "url": "ccip/tutorials/evm/offchain/ccip-tools/transfer-tokens-from-eoa",
-              },
-              {
-                "chainTypes": [
-                  "evm",
-                ],
-                "title": "Checking CCIP Message Status",
-                "url": "ccip/tutorials/evm/offchain/ccip-tools/get-status-offchain",
-              },
-            ],
-            "title": "Using CCIP CLI",
-            "url": "ccip/tutorials/evm/offchain/ccip-tools",
-          },
-        ],
-        "title": "Offchain",
-        "url": "ccip/tutorials/evm/offchain",
-      },
       {
         "chainTypes": [
           "evm",
@@ -1233,15 +1184,8 @@ exports[`CCIP Sidebar Configuration Snapshot should match the expected sidebar s
         "url": "ccip/api-reference/aptos",
       },
       {
-        "chainTypes": [
-          "evm",
-        ],
-        "title": "SDK",
-        "url": "ccip/tools-resources/sdk",
-      },
-      {
-        "title": "CLI",
-        "url": "ccip/tools-resources/cli",
+        "title": "CCIP SDK & CLI",
+        "url": "ccip/tools-resources/ccip-tools",
       },
       {
         "title": "Cross-chain Examples",

src/config/sidebar/__tests__/ccip-dynamic.test.ts

@@ -329,39 +329,38 @@ describe("CCIP Sidebar Configuration", () => {
 
       if (toolsSection) {
         const itemTitles = toolsSection.contents.map((item) => item.title)
-        expect(itemTitles).toContain("CLI")
-        expect(itemTitles).toContain("SDK")
+        expect(itemTitles).toContain("CCIP SDK & CLI")
         expect(itemTitles).toContain("Token Manager")
       }
     })
   })
 
   describe("Regression Prevention", () => {
-    it("should maintain CLI redirect (formerly Tools)", () => {
-      // Verify that CLI item exists with correct URL
-      const findCLI = (items: SectionContent[]): SectionContent | null => {
+    it("should maintain CCIP SDK & CLI sidebar item", () => {
+      // Verify that CCIP SDK & CLI item exists with correct URL
+      const findCCIPTools = (items: SectionContent[]): SectionContent | null => {
         for (const item of items) {
-          if (item.title === "CLI") {
+          if (item.title === "CCIP SDK & CLI") {
             return item
           }
           if (item.children) {
-            const found = findCLI(item.children)
+            const found = findCCIPTools(item.children)
             if (found) return found
           }
         }
         return null
       }
 
-      let cliItem: SectionContent | null = null
+      let ccipToolsItem: SectionContent | null = null
       for (const section of CCIP_SIDEBAR_CONTENT) {
-        cliItem = findCLI(section.contents)
-        if (cliItem) break
+        ccipToolsItem = findCCIPTools(section.contents)
+        if (ccipToolsItem) break
       }
 
-      expect(cliItem).toBeDefined()
-      expect(cliItem?.url).toBe("ccip/tools-resources/cli")
-      // CLI should be universal (no chainTypes restriction)
-      expect(cliItem?.chainTypes).toBeUndefined()
+      expect(ccipToolsItem).toBeDefined()
+      expect(ccipToolsItem?.url).toBe("ccip/tools-resources/ccip-tools")
+      // CCIP SDK & CLI should be universal (no chainTypes restriction)
+      expect(ccipToolsItem?.chainTypes).toBeUndefined()
     })
 
     it("should maintain HyperEVM as EVM-specific content", () => {
@@ -390,31 +389,6 @@ describe("CCIP Sidebar Configuration", () => {
       }
     })
 
-    it("should maintain SDK as EVM-only", () => {
-      const findSDK = (items: SectionContent[]): SectionContent | null => {
-        for (const item of items) {
-          if (item.title === "SDK") {
-            return item
-          }
-          if (item.children) {
-            const found = findSDK(item.children)
-            if (found) return found
-          }
-        }
-        return null
-      }
-
-      let sdkItem: SectionContent | null = null
-      for (const section of CCIP_SIDEBAR_CONTENT) {
-        sdkItem = findSDK(section.contents)
-        if (sdkItem) break
-      }
-
-      expect(sdkItem).toBeDefined()
-      expect(sdkItem?.chainTypes).toBeDefined()
-      expect(sdkItem?.chainTypes).toEqual(["evm"])
-    })
-
     it("should maintain Token Manager as EVM-only", () => {
       const findTokenManager = (items: SectionContent[]): SectionContent | null => {
         for (const item of items) {

src/config/sidebar/ccip-dynamic.ts

@@ -329,6 +329,11 @@ export const CCIP_SIDEBAR_CONTENT: SectionEntry[] = [
         url: "ccip/test-tokens",
         // Universal
       },
+      {
+        title: "Offchain",
+        url: "ccip/tutorials/offchain",
+        // Universal - supports all chain families
+      },
       {
         title: "Transfer Tokens",
         url: "ccip/tutorials/evm/transfer-tokens-from-contract",
@@ -349,50 +354,6 @@ export const CCIP_SIDEBAR_CONTENT: SectionEntry[] = [
         url: "ccip/tutorials/evm/token-manager",
         chainTypes: ["evm"],
       },
-      {
-        title: "Using the CCIP JavaScript SDK",
-        url: "ccip/ccip-javascript-sdk",
-        chainTypes: ["evm"],
-      },
-      {
-        title: "Offchain",
-        url: "ccip/tutorials/evm/offchain",
-        chainTypes: ["evm"],
-        children: [
-          {
-            title: "Transfer Tokens between EOAs",
-            url: "ccip/tutorials/evm/offchain/transfer-tokens-from-eoa",
-            chainTypes: ["evm"],
-          },
-          {
-            title: "Checking CCIP Message Status",
-            url: "ccip/tutorials/evm/offchain/get-status-offchain",
-            chainTypes: ["evm"],
-          },
-          {
-            title: "Using CCIP CLI",
-            url: "ccip/tutorials/evm/offchain/ccip-tools",
-            chainTypes: ["evm"],
-            children: [
-              {
-                title: "Transfer Tokens between EOAs",
-                url: "ccip/tutorials/evm/offchain/ccip-tools/transfer-tokens-from-eoa",
-                chainTypes: ["evm"],
-              },
-              {
-                title: "Checking CCIP Message Status",
-                url: "ccip/tutorials/evm/offchain/ccip-tools/get-status-offchain",
-                chainTypes: ["evm"],
-              },
-              // {
-              //   title: "Get Supported Tokens",
-              //   url: "ccip/tutorials/evm/offchain/ccip-tools/get-supported-tokens",
-              //   chainTypes: ["evm"],
-              // },
-            ],
-          },
-        ],
-      },
       {
         title: "Cross-Chain Token (CCT)",
         url: "ccip/tutorials/evm/cross-chain-tokens",
@@ -729,13 +690,8 @@ export const CCIP_SIDEBAR_CONTENT: SectionEntry[] = [
         ],
       },
       {
-        title: "SDK",
-        url: "ccip/tools-resources/sdk",
-        chainTypes: ["evm"],
-      },
-      {
-        title: "CLI",
-        url: "ccip/tools-resources/cli",
+        title: "CCIP SDK & CLI",
+        url: "ccip/tools-resources/ccip-tools",
         // Universal
       },
       {