${ mainChain.blockexplorer ? `\n\n\n\n` : "" }${ mainChain.url ? `\n\n\n\n` : "" }${ mainChain.nativegastoken ? `\n\n\n\n` : "" }

Property	Value
Chain Name	`${mainChain.name}`
Chain ID	`${mainChain.chain_id}`
Network Type	${ category.charAt(0).toUpperCase() + category.slice(1) } Chain
Support Level	${mainChain.support_level \|\| "Standard"}
Block Explorer	${ mainChain.blockexplorerlabel \|\| "Explorer" }
Official Website	${ mainChain.label } Website
Native Gas Token	${mainChain.nativegastoken}

` : `## Network Details

${ primaryChain.blockexplorer ? `\n\n\n\n` : "" }${ primaryChain.url ? `\n\n\n\n` : "" }${ primaryChain.nativegastoken ? `\n\n\n\n` : "" }

Property	Value
Chain Name	`${primaryChain.name}`
Chain ID	`${primaryChain.chain_id}`
Network Type	${category.charAt(0).toUpperCase() + category.slice(1)} Chain
Support Level	${primaryChain.support_level \|\| "Standard"}
Block Explorer	${ primaryChain.blockexplorerlabel \|\| "Explorer" }
Official Website	${ primaryChain.label } Website
Native Gas Token	${primaryChain.nativegastoken}

` } ${ testChains.length > 0 ? `## Testnet${testChains.length > 1 ? "s" : ""} ${testChains .map( (testChain, index) => `${ testChains.length > 1 ? `### ${testChain.label.replace(" Testnet", "")} Testnet\n\n` : "" }

${ testChain.blockexplorer ? `\n\n\n\n` : "" }${ testChain.url ? `\n\n\n\n` : "" }${ testChain.nativegastoken ? `\n\n\n\n` : "" }

Property	Value
Chain Name	`${testChain.name}`
Chain ID	`${testChain.chain_id}`
Purpose	Development and testing network
Support Level	${testChain.support_level \|\| "Standard"}
Block Explorer	${ testChain.blockexplorerlabel \|\| "Explorer" }
Official Website	${ testChain.label } Website
Native Gas Token	${testChain.nativegastoken}

${index < testChains.length - 1 ? "\n\n\n" : ""}` ) .join("\n")}` : "" } ## API Usage To use this blockchain network in GoldRush API calls, use: #### Chain Name ${ mainChain ? `- \`${mainChain.name}\` (mainnet)${ testChains.length > 0 ? testChains .map((t) => `\n- \`${t.name}\` (testnet)`) .join("") : "" }` : testChains.length > 0 ? testChains.map((t) => `- \`${t.name}\` (testnet)`).join("\n") : `- \`${primaryChain.name}\`` } #### Example API Calls ${ mainChain ? `\`\`\`bash Chain Name (Mainnet) curl -X GET "https://api.covalenthq.com/v1/${ mainChain.name }/address/${getWalletAddressForChain(mainChain.name)}/balances_v2/?key=API_KEY" \`\`\` ${ testChains.length > 0 ? testChains .map( (testChain) => `\`\`\`bash Chain Name (${ testChain.label.includes("Testnet") ? testChain.label.replace(" Testnet", "") + " Testnet" : "Testnet" }) curl -X GET "https://api.covalenthq.com/v1/${ testChain.name }/address/${getWalletAddressForChain(testChain.name)}/balances_v2/?key=API_KEY" \`\`\` \`\`\`bash \`\`\`` ) .join("\n\n") : "" }` : `\`\`\`bash Chain Name curl -X GET "https://api.covalenthq.com/v1/${primaryChain.name}/address/${getWalletAddressForChain(primaryChain.name)}/balances_v2/?key=API_KEY" \`\`\` ` } #### SDK Usage ${ mainChain ? `\`\`\`typescript TypeScript SDK (Mainnet) import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "${mainChain.name}", walletAddress: "${getWalletAddressForChain(mainChain.name)}" }); \`\`\` ${ testChains.length > 0 ? testChains .map( (testChain) => `\`\`\`typescript TypeScript SDK (${ testChain.label.includes("Testnet") ? testChain.label.replace(" Testnet", "") + " Testnet" : "Testnet" }) import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "${testChain.name}", walletAddress: "${getWalletAddressForChain(testChain.name)}" }); \`\`\` ` ) .join("") : "" }` : `\`\`\`typescript TypeScript SDK import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "${primaryChain.name}", walletAddress: "${getWalletAddressForChain(primaryChain.name)}" }); \`\`\`` } ${ primaryChain.label === "Bitcoin" ? `## Foundational API Support This chain supports **3** GoldRush Foundational APIs: #### Wallet API - **[Get Bitcoin balance for non-HD address](/api-reference/foundational-api/balances/get-bitcoin-balance-for-address)** - **[Get Bitcoin balances for HD address](/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address)** #### Activity Feed API - **[Get transactions for Bitcoin address](/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address)** ` : primaryChain.label === "Solana" ? `## Foundational API Support This chain supports **1** GoldRush Foundational API: #### Wallet API - **[Get token balances for address](/api-reference/foundational-api/balances/get-token-balances-for-address)** ` : "" } ${ primaryChain.foundationalapi === true && primaryChain.supportedEndpoints && primaryChain.label !== "Bitcoin" && primaryChain.label !== "Solana" && primaryChain.supportedEndpoints.length > 0 ? `## Foundational API Support This chain supports **${ (() => { const endpointsByGroup = {}; const utilityEndpoints = getUtilityEndpoints(); const hasUtilityEndpoints = utilityEndpoints.length > 0; const referencedSlugs = getReferencedEndpointSlugs(); primaryChain.supportedEndpoints .filter((endpoint) => endpoint.title !== "Get XY=K pools") .filter((endpoint) => { if (hasUtilityEndpoints && endpoint.grouping === "base") { return false; } return true; }) .filter((endpoint) => { return endpoint.slug && referencedSlugs.has(endpoint.slug); }) .forEach((endpoint) => { const group = endpoint.grouping || "other"; if (!endpointsByGroup[group]) { endpointsByGroup[group] = []; } const isDuplicate = endpointsByGroup[group].some( (existingEndpoint) => existingEndpoint.title === endpoint.title && existingEndpoint.slug === endpoint.slug ); if (!isDuplicate) { endpointsByGroup[group].push(endpoint); } }); if (hasUtilityEndpoints) { endpointsByGroup["utility"] = utilityEndpoints; } return Object.entries(endpointsByGroup) .filter(([group]) => group !== "allchains") .filter(([group]) => group !== "bitcoin") .reduce((sum, [, endpoints]) => sum + endpoints.length, 0); })() }** GoldRush Foundational APIs: ${(() => { const endpointsByGroup = {}; const utilityEndpoints = getUtilityEndpoints(); const hasUtilityEndpoints = utilityEndpoints.length > 0; const referencedSlugs = getReferencedEndpointSlugs(); primaryChain.supportedEndpoints .filter((endpoint) => endpoint.title !== "Get XY=K pools") .filter((endpoint) => { if (hasUtilityEndpoints && endpoint.grouping === "base") { return false; } return true; }) .filter((endpoint) => { return endpoint.slug && referencedSlugs.has(endpoint.slug); }) .forEach((endpoint) => { const group = endpoint.grouping || "other"; if (!endpointsByGroup[group]) { endpointsByGroup[group] = []; } const isDuplicate = endpointsByGroup[group].some( (existingEndpoint) => existingEndpoint.title === endpoint.title && existingEndpoint.slug === endpoint.slug ); if (!isDuplicate) { endpointsByGroup[group].push(endpoint); } }); if (hasUtilityEndpoints) { endpointsByGroup["utility"] = utilityEndpoints; } return Object.entries(endpointsByGroup) .sort(([a], [b]) => a.localeCompare(b)) .filter(([group, endpoints]) => group !== "allchains") .filter(([group, endpoints]) => group !== "bitcoin") .map(([group, endpoints]) => { switch (group) { case "balances": groupTitle = "Wallet API"; break; case "transactions": groupTitle = "Activity Feed API"; break; case "nft": groupTitle = "NFT API"; break; case "pricing": groupTitle = "Pricing API"; break; case "bitcoin": groupTitle = "Bitcoin API"; break; case "security": groupTitle = "Security API"; break; case "utility": groupTitle = "Block Explorer API"; break; default: groupTitle = group.charAt(0).toUpperCase() + group.slice(1); } return `#### ${groupTitle} ${endpoints .map((endpoint) => { if (endpoint.slug) { const urlGroup = group === "pricing" ? "utility" : group === "allchains" ? "cross-chain" : group; return `- **[${endpoint.title}](/api-reference/foundational-api/${urlGroup}/${endpoint.slug})**`; } else { return `- **${endpoint.title}**`; } }) .join("\n")}`; }) .join("\n\n"); })()} ` : "" } ${ (() => { const streamingEndpointsRaw = (primaryChain.supportedEndpoints || []).filter( (endpoint) => endpoint.grouping === "streaming" ); const unique = []; const seen = new Set(); for (const ep of streamingEndpointsRaw) { const key = `${ep.title}::${ep.slug || ""}`; if (!seen.has(key)) { seen.add(key); unique.push(ep); } } unique.sort((a, b) => (a.title || "").localeCompare(b.title || "")); if (unique.length === 0) return ""; const items = unique .map((ep) => `- [${ep.title}](/goldrush-streaming-api/${createSafeFilename(ep.title)})`) .join("\n"); return `## Streaming API Support This chain supports the following GoldRush Streaming APIs: ${items} `; })() } ## Additional Resources - [GoldRush API Documentation](https://goldrush.dev/docs/) - [Supported Chains List](https://goldrush.dev/chains/) - [API Reference](https://goldrush.dev/docs/api-reference/) ${ primaryChain.is_appchain ? `- [AppChain Documentation](https://goldrush.dev/docs/appchains/)` : "" }`; return { filename: `${chainSlug}.mdx`, filepath: path.join(OUTPUT_DIR, `${chainSlug}.mdx`), content: content, category: category, chainName: primaryChain.name, label: primaryChain.label .replace(" Mainnet", "") .replace(" Testnet", ""), hasTestnet: testChains.length > 0, hasMainnet: !!mainChain, logo_url: logoUrl, weight: primaryChain.weight || null, order: primaryChain.order || 0, }; } function updateDocsJson(chainDocs) { try { const docsData = JSON.parse(fs.readFileSync(DOCS_JSON_PATH, "utf8")); const chainsPath = path.resolve(__dirname, "../data/dato-chains.json"); const popularChainNames = new Set(); if (fs.existsSync(chainsPath)) { try { const chainsData = JSON.parse(fs.readFileSync(chainsPath, "utf8")); const chains = chainsData?.data?.allBlockchains || []; chains.forEach((chain) => { // Keep behavior aligned with getChainsFromData() if (chain.hide || chain.phantom || chain.suspended === true) { return; } if (chain.popular !== true) { return; } const rawLabel = chain.displayname || chain.chainname .split("-") .map( (word) => word.charAt(0).toUpperCase() + word.slice(1) ) .join(" "); const baseName = rawLabel .replace( /\s+(Testnet|Sepolia|Goerli|Mumbai|Amoy|Holesky).*$/i, "" ) .replace(/\s+Mainnet$/i, "") .replace(/\s+Testnet$/i, "") .trim(); if (baseName) { popularChainNames.add(baseName.toLowerCase()); } }); } catch (error) { console.error("Error reading popular chains:", error.message); } } const chainsByCategory = { foundational: [], frontier: [], community: [], archived: [], }; const uniqueChains = new Map(); chainDocs.forEach((doc) => { const baseName = doc.label.replace( /\s+(Testnet|Sepolia|Goerli|Mumbai|Amoy|Holesky).*$/i, "" ); const key = `${baseName}-${doc.category}`; if (!uniqueChains.has(key)) { uniqueChains.set(key, { page: `chains/${doc.filename.replace(".mdx", "")}`, label: baseName, logo_url: doc.logo_url, hasTestnet: doc.hasTestnet, hasMainnet: doc.hasMainnet, category: doc.category, weight: doc.weight || null, chainName: doc.chainName, order: doc.order || 0, }); } else { const existing = uniqueChains.get(key); existing.hasTestnet = existing.hasTestnet || doc.hasTestnet; existing.hasMainnet = existing.hasMainnet || doc.hasMainnet; } }); const sortedChains = Array.from(uniqueChains.values()).sort((a, b) => { const weightA = a.weight !== null ? a.weight : Infinity; const weightB = b.weight !== null ? b.weight : Infinity; if (weightA !== weightB) { return weightA - weightB; } // If weights are equal (or both null), sort alphabetically by chainname return a.chainName.localeCompare(b.chainName); }); const popularChains = sortedChains .filter((doc) => popularChainNames.has((doc.label || "").toLowerCase())) .map((doc) => doc.page); sortedChains.forEach((doc) => { if (chainsByCategory[doc.category]) { chainsByCategory[doc.category].push({ page: doc.page, label: doc.label, }); } }); let chainsTab = docsData.navigation.tabs.find( (tab) => tab.tab === "Chains" ); if (!chainsTab) { chainsTab = { tab: "Chains", groups: [], }; docsData.navigation.tabs.push(chainsTab); } chainsTab.groups = []; chainsTab.groups.push({ group: "Overview", pages: ["chains/overview"], }); if (popularChains.length > 0) { chainsTab.groups.push({ group: "Popular Chains 🔥", pages: popularChains, }); } if (chainsByCategory.foundational.length > 0) { chainsTab.groups.push({ group: "Foundational Chains", pages: chainsByCategory.foundational.map((chain) => chain.page), }); } if (chainsByCategory.frontier.length > 0) { chainsTab.groups.push({ group: "Frontier Chains", pages: chainsByCategory.frontier.map((chain) => chain.page), }); } if (chainsByCategory.community.length > 0) { chainsTab.groups.push({ group: "Community Chains", pages: chainsByCategory.community.map((chain) => chain.page), }); } if (chainsByCategory.archived.length > 0) { chainsTab.groups.push({ group: "Archived Chains", pages: chainsByCategory.archived.map((chain) => chain.page), }); } fs.writeFileSync(DOCS_JSON_PATH, JSON.stringify(docsData, null, 2)); } catch (error) { console.error("Failed to update docs.json:", error.message); } } function createChainsOverview(chainDocs) { const chainsByCategory = { foundational: [], frontier: [], community: [], archived: [], }; const uniqueChains = new Map(); chainDocs.forEach((doc) => { const baseName = doc.label.replace( /\s+(Testnet|Sepolia|Goerli|Mumbai|Amoy|Holesky).*$/i, "" ); const key = `${baseName}-${doc.category}`; if (!uniqueChains.has(key)) { uniqueChains.set(key, { ...doc, label: baseName, combinedTestnets: doc.hasTestnet ? 1 : 0, weight: doc.weight || null, chainName: doc.chainName, order: doc.order || 0, }); } else { const existing = uniqueChains.get(key); existing.combinedTestnets += doc.hasTestnet ? 1 : 0; existing.hasTestnet = existing.hasTestnet || doc.hasTestnet; existing.hasMainnet = existing.hasMainnet || doc.hasMainnet; existing.order = Math.max(existing.order || 0, doc.order || 0); // Use the largest order } }); const sortedChains = Array.from(uniqueChains.values()).sort((a, b) => { const weightA = a.weight !== null ? a.weight : Infinity; const weightB = b.weight !== null ? b.weight : Infinity; if (weightA !== weightB) { return weightA - weightB; } return a.chainName.localeCompare(b.chainName); }); sortedChains.forEach((doc) => { chainsByCategory[doc.category].push(doc); }); function generateChainCard(chain) { let networkType; if (chain.hasMainnet && chain.hasTestnet) { networkType = "Mainnet & Testnet"; } else if (chain.hasMainnet && !chain.hasTestnet) { networkType = "Mainnet"; } else if (!chain.hasMainnet && chain.hasTestnet) { networkType = "Testnet"; } else { networkType = "Network"; // fallback } if (chain.logo_url) { return `

${chain.label .replace(" Mainnet", "") .replace(" Testnet", "")}

${networkType}

`; } else { return ` ${networkType} `; } } const overviewContent = `--- title: 'Supported Chains' description: 'Complete list of blockchain networks supported by the GoldRush API.' --- View real-time status of all supported chains. ## Overview GoldRush offers support for **${ Array.from(uniqueChains.values()).length }** blockchain network mainnets with the most comprehensive Blockchain Data API suite for developers, analysts, and enterprises. Whether you are building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our Blockchain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ## Chain Categories ### Foundational Chains These are the top EVM-compatible chains with guaranteed product parity across the entire GoldRush feature suite, including tracing enhancements. Key features that are only supported for these chains include: - **Historical token balances** - **Token holders list for any block height** - **DEX spot prices** ${chainsByCategory.foundational.map(generateChainCard).join("\n")} ### Frontier Chains Cutting-edge blockchain networks where GoldRush continues to expand feature coverage as the ecosystem evolves. This category includes all non-EVM chains and may include special APIs (e.g. Bitcoin). ${chainsByCategory.frontier.map(generateChainCard).join("\n")} ### Community Chains Community-driven blockchain networks with growing GoldRush integration and feature support. All core onchain data such as spot balances, transaction histories for addresses and decoded event logs are provided. ${chainsByCategory.community.map(generateChainCard).join("\n")} ### Archived Chains Previously supported blockchain networks that are now in archived status with limited data availability. No live data is available for these chains. ${chainsByCategory.archived.map(generateChainCard).join("\n")} ## Quick Start To get started with any supported chain, you can use either the chain name or chain ID in your API calls: \`\`\`bash cURL curl -X GET "https://api.covalenthq.com/v1/{chainName}/address/{address}/balances_v2/?key=API_KEY" \`\`\` \`\`\`typescript TypeScript SDK import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-mainnet", // or any supported chain walletAddress: "your-address" }); \`\`\` \`\`\`python Python SDK from covalent import GoldRushClient client = GoldRushClient("API_KEY") response = client.balance_service.get_token_balances_for_wallet_address( "eth-mainnet", // or any supported chain "your-address" ) \`\`\` ## Additional Resources - [API Reference](/api-reference) - [GoldRush SDKs](/goldrush-sdks) `; const overviewPath = path.join(OUTPUT_DIR, "overview.mdx"); fs.writeFileSync(overviewPath, overviewContent); } function getChainsFromData() { try { const chainsPath = path.resolve(__dirname, "../data/dato-chains.json"); const endpointsPath = path.resolve( __dirname, "../data/dato-apiendpoints.json" ); let chainsData = null; let endpointsData = null; if (fs.existsSync(chainsPath)) { chainsData = JSON.parse(fs.readFileSync(chainsPath, "utf8")); } if (fs.existsSync(endpointsPath)) { endpointsData = JSON.parse(fs.readFileSync(endpointsPath, "utf8")); } if (!chainsData || !chainsData.data?.allBlockchains) { return getFallbackChains(); } const chainEndpoints = {}; const allChainsEndpoints = []; if (endpointsData?.data?.allApiendpoints) { endpointsData.data.allApiendpoints.forEach((endpoint) => { if ( endpoint.allChainsSupported === true && endpoint._status === "published" && !endpoint.phantom && endpoint.slug ) { allChainsEndpoints.push({ title: endpoint.title, slug: endpoint.slug, grouping: endpoint.grouping, usecase: endpoint.usecase, class: endpoint.class, realtime: endpoint.realtime, beta: endpoint.beta, }); } if ( endpoint._status === "published" && endpoint.supportedchains && Array.isArray(endpoint.supportedchains) ) { endpoint.supportedchains.forEach((chain) => { const chainKey = `${chain.chainname}-${chain.chainid}`; if (!chainEndpoints[chainKey]) { chainEndpoints[chainKey] = []; } chainEndpoints[chainKey].push({ title: endpoint.title, slug: endpoint.slug, grouping: endpoint.grouping, usecase: endpoint.usecase, class: endpoint.class, realtime: endpoint.realtime, beta: endpoint.beta, }); }); } }); } const chainMap = new Map(); const chains = chainsData.data.allBlockchains; const sortedChains = chains.slice().sort((a, b) => { const weightA = a.weight !== null ? a.weight : Infinity; const weightB = b.weight !== null ? b.weight : Infinity; if (weightA !== weightB) { return weightA - weightB; } return a.chainname.localeCompare(b.chainname); }); sortedChains.forEach((chain, index) => { if (chain.hide || chain.phantom || chain.suspended === true) { return; } let baseChainName; if (chain.chainname.startsWith("polygon-amoy")) { baseChainName = "matic"; } else if ( chain.chainname.startsWith("horizen-gobi") || chain.chainname.startsWith("horizen-yuma") ) { baseChainName = "horizen-eon"; } else { baseChainName = chain.chainname .replace(/-sepolia(-testnet)?$/, "") .replace(/-goerli(-testnet)?$/, "") .replace(/-holesky(-testnet)?$/, "") .replace(/-mumbai(-testnet)?$/, "") .replace(/-amoy(-testnet)?$/, "") .replace(/-mainnet$/, "") .replace(/-testnet$/, "") .replace(/-hekla(-testnet)?$/, "") .replace(/-katla(-testnet)?$/, "") .replace(/-alpha(-testnet)?$/, "") .replace(/-l2(-testnet)?$/, "") .replace(/-gobi(-testnet)?$/, "") .replace(/-yuma(-testnet)?$/, "") .replace(/-forge(-testnet)?$/, "") .replace(/-stardust(-testnet)?$/, ""); } const isMainnet = chain.chainname.includes("mainnet") || (!chain.testnet && !chain.chainname.includes("testnet") && !chain.chainname.includes("goerli") && !chain.chainname.includes("mumbai") && !chain.chainname.includes("amoy") && !chain.chainname.includes("sepolia") && !chain.chainname.includes("holesky") && !chain.chainname.includes("gobi") && !chain.chainname.includes("yuma") && !chain.chainname.includes("hekla") && !chain.chainname.includes("katla") && !chain.chainname.includes("alpha") && !chain.chainname.includes("forge") && !chain.chainname.includes("stardust")); if (!chainMap.has(baseChainName)) { chainMap.set(baseChainName, { mainnet: null, testnets: [], }); } const chainGroup = chainMap.get(baseChainName); const chainKey = `${chain.chainname}-${chain.chainid}`; let category; if (chain.support === "foundational") { category = "foundational"; } else if (chain.support === "frontier") { category = "frontier"; } else if (chain.support === "archived") { category = "archived"; } else if (chain.support === "community") { category = "community"; } else { // Skip chains with other support levels (sunsetted) return; } const chainData = { name: chain.chainname, chain_id: chain.chainid, label: chain.displayname || chain.chainname .split("-") .map( (word) => word.charAt(0).toUpperCase() + word.slice(1) ) .join(" "), category_label: isMainnet ? "Mainnet" : "Testnet", is_testnet: !isMainnet, logo_url: chain.imgsvg?.url || chain.imgwhite?.url || chain.imgblack?.url, imgsvg: chain.imgsvg, imgwhite: chain.imgwhite, imgblack: chain.imgblack, is_appchain: !!chain.appchainof, support_level: chain.support, description: chain.description, url: chain.url, blockexplorer: chain.blockexplorer, blockexplorerlabel: chain.blockexplorerlabel, blocktime: chain.blocktime, nativegastoken: chain.nativegastoken, foundationalapi: chain.foundationalapi, // reportingapi: chain.reportingapi, streamingapi: chain.streamingapi, historicalBalances: chain.historicalBalances, nftAssetsAndMetadata: chain.nftAssetsAndMetadata, suspended: chain.suspended, integrationstage: chain.integrationstage?.stage, supportedEndpoints: [ ...(chainEndpoints[chainKey] || []), ...allChainsEndpoints, ], category: category, weight: chain.weight, order: index, }; if (isMainnet) { if ( !chainGroup.mainnet || chain.chainname.includes("mainnet") ) { chainGroup.mainnet = chainData; } } else { chainGroup.testnets.push(chainData); } }); const chainGroups = Array.from(chainMap.values()) .filter((group) => group.mainnet || group.testnets.length > 0) .map((group) => { const result = { mainnet: group.mainnet, testnets: group.testnets, }; if (group.testnets.length > 0) { result.testnet = group.testnets[0]; } const primaryChain = group.mainnet || group.testnets[0]; result.weight = primaryChain.weight; result.chainname = primaryChain.name; result.maxOrder = primaryChain.order; return result; }) .sort((a, b) => { const weightA = a.weight !== null ? a.weight : Infinity; const weightB = b.weight !== null ? b.weight : Infinity; if (weightA !== weightB) { return weightA - weightB; } return a.chainname.localeCompare(b.chainname); }); const categoryCounts = { foundational: 0, frontier: 0, community: 0, archived: 0, }; chainGroups.forEach((group) => { const mainChain = group.mainnet || group.testnets[0] || group.testnet; const testChains = group.testnets || []; const category = mainChain.category; categoryCounts[category]++; }); return chainGroups; } catch (error) { console.error("Error reading chain data:", error.message); return getFallbackChains(); } } function getFallbackChains() { return [ { mainnet: { name: "eth-mainnet", chain_id: "1", label: "Ethereum", category_label: "Mainnet", is_testnet: false, logo_url: null, is_appchain: false, category: "foundational", supportedEndpoints: [], streamingapi: false, order: 0, }, testnets: [], }, { mainnet: { name: "matic-mainnet", chain_id: "137", label: "Polygon", category_label: "Mainnet", is_testnet: false, logo_url: null, is_appchain: false, category: "foundational", supportedEndpoints: [], streamingapi: false, order: 1, }, testnets: [], }, ]; } // Main function async function generateChainDocs() { try { createDirectoryStructure(); const chainGroups = getChainsFromData(); let successCount = 0; let errorCount = 0; chainGroups.forEach((group) => { const mainChain = group.mainnet || group.testnets[0] || group.testnet; const testChains = group.testnets || []; const testSuffix = testChains.length > 0 ? `(mainnet + ${testChains.length} testnet${ testChains.length > 1 ? "s" : "" })` : group.mainnet ? "(mainnet only)" : "(testnet only)"; }); const consolidatedChains = []; const seenChains = new Set(); for (const chainGroup of chainGroups) { try { const primaryChain = chainGroup.mainnet || chainGroup.testnet; const baseName = primaryChain.label.replace( /\s+(Testnet|Sepolia|Goerli|Mumbai|Amoy|Holesky).*$/i, "" ); const category = primaryChain.category; const key = `${baseName}-${category}`; if (!seenChains.has(key)) { const doc = generateChainDoc(chainGroup); doc.label = baseName; doc.filename = `${createSafeFilename( baseName.toLowerCase() )}.mdx`; doc.filepath = path.join(OUTPUT_DIR, doc.filename); doc.weight = chainGroup.weight; doc.chainName = chainGroup.chainname; doc.order = chainGroup.maxOrder; fs.writeFileSync(doc.filepath, doc.content); consolidatedChains.push(doc); seenChains.add(key); successCount++; } else { const existingIndex = consolidatedChains.findIndex( (d) => d.label === baseName && d.category === category ); if (existingIndex !== -1) { const existing = consolidatedChains[existingIndex]; existing.hasTestnet = existing.hasTestnet || (chainGroup.testnets && chainGroup.testnets.length > 0); const updatedDoc = generateChainDoc(chainGroup); updatedDoc.label = baseName; updatedDoc.filename = existing.filename; updatedDoc.filepath = existing.filepath; updatedDoc.hasTestnet = existing.hasTestnet; updatedDoc.weight = existing.weight; updatedDoc.chainName = existing.chainName; updatedDoc.order = existing.order; fs.writeFileSync( updatedDoc.filepath, updatedDoc.content ); consolidatedChains[existingIndex] = updatedDoc; } } } catch (error) { errorCount++; const primaryChain = chainGroup.mainnet || chainGroup.testnet; console.error( `Failed to generate doc for ${primaryChain.name}:`, error.message ); } } const chainDocs = consolidatedChains.sort((a, b) => { const weightA = a.weight !== null ? a.weight : Infinity; const weightB = b.weight !== null ? b.weight : Infinity; if (weightA !== weightB) { return weightA - weightB; } return a.chainName.localeCompare(b.chainName); }); createChainsOverview(chainDocs); updateDocsJson(chainDocs); } catch (error) { console.error("Fatal error:", error.message); process.exit(1); } } if (require.main === module) { generateChainDocs(); } module.exports = { generateChainDocs };

GoldRush Streaming API

Subscriptions

Queries

Resources

Page Not Found