text */ const getPageTitle = () => { const el = document.querySelector("title"); const raw = el ? el.textContent : ""; return raw.split("|")[0].trim() || "Helius Docs"; }; /** Read published/modified dates from Open Graph meta tags injected by Mintlify */ const getPageDates = () => { let published = document.querySelector('meta[property="article:published_time"]'); const modified = document.querySelector('meta[property="article:modified_time"]'); if (!published) published = document.querySelector('meta[property="og:updated_time"]'); return { datePublished: published ? published.getAttribute("content") || "" : "", dateModified: modified ? modified.getAttribute("content") || "" : "", }; }; /** Read the meta description */ const getMetaDescription = () => { const el = document.querySelector('meta[name="description"]'); return el ? el.getAttribute("content") || "" : ""; }; /** Build the canonical URL for the current page */ const getCanonicalUrl = () => { const path = getPagePath(); if (path === "/") return BASE_URL; return BASE_URL + path; }; /** Get a human-readable breadcrumb label for a path segment */ const getBreadcrumbLabel = (segment) => { if (BREADCRUMB_LABELS[segment]) return BREADCRUMB_LABELS[segment]; // Fallback: capitalize first letter and replace hyphens with spaces return segment.charAt(0).toUpperCase() + segment.slice(1).replace(/-/g, " "); }; /** Inject a JSON-LD script element into the <head> with a marker attribute */ const injectJsonLd = (data) => { const script = document.createElement("script"); script.type = "application/ld+json"; script.setAttribute("data-helius-sd", ""); script.textContent = JSON.stringify(data); document.head.appendChild(script); }; /** Remove all previously injected JSON-LD elements */ const cleanup = () => { const scripts = document.querySelectorAll( 'script[type="application/ld+json"][data-helius-sd]' ); for (let i = 0; i < scripts.length; i++) { scripts[i].remove(); } }; // ── Breadcrumbs ────────────────────────────────────────────────────── const buildBreadcrumbList = () => { const path = getPagePath(); const items = [ { "@type": "ListItem", position: 1, name: "Helius Docs", item: BASE_URL, }, ]; if (path === "/") return null; const segments = path.split("/").filter(Boolean); let cumulative = ""; for (let i = 0; i < segments.length; i++) { cumulative += "/" + segments[i]; items.push({ "@type": "ListItem", position: i + 2, name: i === segments.length - 1 ? getPageTitle() : getBreadcrumbLabel(segments[i]), item: BASE_URL + cumulative, }); } return { "@context": "https://schema.org", "@type": "BreadcrumbList", itemListElement: items, }; }; // ── Page-type detection (operates on normalized path, without /zh/) ── const isHomepage = (path) => path === "/" || path === "/index"; const isApiReference = (path) => path.indexOf("/api-reference") === 0; const isProductOverview = (path) => PRODUCT_OVERVIEWS.hasOwnProperty(path); const GUIDE_PREFIXES = [ "/rpc/", "/laserstream/", "/gatekeeper/", "/grpc/", "/sending-transactions/", "/das/", "/enhanced-transactions/", "/dedicated-nodes/", "/webhooks/", "/data-streaming/", "/priority-fee/", "/wallet-api/", "/nfts/", "/zk-compression/", "/staking/", "/shred-delivery/", "/agents/", "/billing/", "/support/", "/orb/", ]; const GUIDE_EXACT = ["/grpc", "/agents", "/quickstart", "/getting-data", "/data-streaming"]; const isGuide = (path) => GUIDE_EXACT.indexOf(path) !== -1 || GUIDE_PREFIXES.some(function (prefix) { return path.indexOf(prefix) === 0; }); const isFaqPage = (path) => path.indexOf("/faqs") === 0; const isPricingPage = (path) => path === "/billing/plans"; const isGlossary = (path) => path === "/glossary"; // ── Determine the programmingModel for API reference pages ─────────── const getProgrammingModel = (path) => { if (path.indexOf("/rpc/websocket") !== -1) return "WebSocket JSON-RPC"; if (path.indexOf("/rpc/http") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/laserstream") !== -1) return "gRPC"; if (path.indexOf("/webhooks") !== -1) return "REST (Webhooks)"; if (path.indexOf("/wallet-api") !== -1) return "REST"; if (path.indexOf("/sender") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/das") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/priority-fee") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/enhanced-transactions") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/zk-compression") !== -1) return "HTTP JSON-RPC"; return "HTTP JSON-RPC"; }; // ── Schema builders ────────────────────────────────────────────────── const buildWebSiteSchema = () => ({ "@context": "https://schema.org", "@type": "WebSite", "@id": "https://www.helius.dev/docs#website", name: "Helius Documentation", url: BASE_URL, description: "Developer documentation for Helius — the leading Solana RPC and infrastructure platform", publisher: { "@id": "https://www.helius.dev/#organization" }, }); const buildApiReferenceSchema = (normalizedPath) => { const lang = getLanguage(); const desc = getMetaDescription(); const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "APIReference", headline: getPageTitle(), url: getCanonicalUrl(), mainEntityOfPage: { "@type": "WebPage", "@id": getCanonicalUrl() }, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, targetPlatform: "Solana", programmingModel: getProgrammingModel(normalizedPath), speakable: SPEAKABLE, inLanguage: lang, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildTechArticleSchema = () => { const lang = getLanguage(); const desc = getMetaDescription(); const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "TechArticle", headline: getPageTitle(), url: getCanonicalUrl(), mainEntityOfPage: { "@type": "WebPage", "@id": getCanonicalUrl() }, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, inLanguage: lang, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildFaqSchema = () => { const questions = []; // Extract Q&A from <details>/<summary> elements (Mintlify Accordions) const details = document.querySelectorAll("details"); for (let i = 0; i < details.length; i++) { const summary = details[i].querySelector("summary"); if (!summary) continue; const clone = details[i].cloneNode(true); const summaryClone = clone.querySelector("summary"); if (summaryClone) summaryClone.remove(); const answerText = (clone.textContent || "").trim(); if (answerText) { questions.push({ "@type": "Question", name: summary.textContent.trim(), acceptedAnswer: { "@type": "Answer", text: answerText, }, }); } } if (questions.length === 0) return null; const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "FAQPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, mainEntity: questions, speakable: SPEAKABLE, inLanguage: getLanguage(), }; if (desc) schema.description = desc; return schema; }; const buildProductSchema = (normalizedPath) => { const product = PRODUCT_OVERVIEWS[normalizedPath]; const desc = product.description || getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "SoftwareApplication", name: product.name, url: getCanonicalUrl(), image: product.image, applicationCategory: "DeveloperApplication", operatingSystem: "Solana", description: desc, author: { "@id": "https://www.helius.dev/#organization" }, offers: { "@type": "Offer", price: "0", priceCurrency: "USD", description: "Free tier available", url: BASE_URL + "/billing/plans", }, }; return schema; }; const buildPricingSchema = () => { const offers = PRICING_TIERS.map(function (tier) { return { "@type": "Offer", name: "Helius " + tier.name, price: tier.price, priceCurrency: "USD", priceValidUntil: PRICE_VALID_UNTIL, description: tier.description + " (billed monthly)", url: BASE_URL + "/billing/plans", availability: "https://schema.org/InStock", }; }); const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, mainEntity: { "@type": "SoftwareApplication", name: "Helius", applicationCategory: "DeveloperApplication", operatingSystem: "Solana", offers: offers, }, inLanguage: getLanguage(), }; if (desc) schema.description = desc; return schema; }; const buildGlossarySchema = () => { const headings = document.querySelectorAll("h3"); if (headings.length === 0) return null; const baseUrl = getCanonicalUrl(); const setId = baseUrl + "#termset"; const lang = getLanguage(); const desc = getMetaDescription(); const slugify = (text) => text .toLowerCase() .replace(/[^\w\s-]/g, "") .replace(/\s+/g, "-") .replace(/-+/g, "-") .replace(/^-|-$/g, ""); // Mintlify injects a U+200B zero-width space inside the heading anchor // link (the clickable hash icon). textContent picks it up and trim() // doesn't classify U+200B as whitespace, so it leaks into the term name. // Strip all zero-width characters (U+200B-U+200D, U+FEFF) before trimming. const cleanText = (text) => (text || "").replace(/[\u200B-\u200D\uFEFF]/g, "").trim(); // Headings of the form "Foo (Bar)" — strip the parens for `name` and // surface the inner text as an alias. Merged with TERM_ALIASES for // entries whose heading doesn't carry both forms. const PAREN_RE = /^(.+?)\s+$([^)]+)$\s*$/; const computeAliases = (rawName) => { const m = rawName.match(PAREN_RE); const displayName = m ? m[1].trim() : rawName; const aliases = []; const push = (val) => { const v = (val || "").trim(); if (v && v !== displayName && aliases.indexOf(v) === -1) { aliases.push(v); } }; const dictEntry = TERM_ALIASES[rawName]; if (dictEntry) { for (let i = 0; i < dictEntry.length; i++) push(dictEntry[i]); } if (m) push(m[2]); return { displayName: displayName, aliases: aliases }; }; const terms = []; for (let i = 0; i < headings.length; i++) { const heading = headings[i]; const name = cleanText(heading.textContent); if (!name) continue; const id = heading.getAttribute("id") || slugify(name); if (!id) continue; // Walk following siblings until the next h3 or h2, gathering definition text let definition = ""; // Append a chunk of text with smart sentence joining: if the previous // segment already ends in sentence-terminating punctuation or a colon // (a natural lead-in to a list), use a single space; otherwise use // ". " so list items and adjacent prose read as discrete sentences // instead of running together. const append = (text) => { if (!text) return; if (definition) { const lastChar = definition.slice(-1); definition += /[.!?:]/.test(lastChar) ? " " : ". "; } definition += text; }; let sibling = heading.nextElementSibling; while (sibling) { const tag = sibling.tagName; if (tag === "H3" || tag === "H2") break; // Mintlify wraps prose in <span data-as="p"> rather than emitting a // raw <p>. Treat both as paragraphs so we don't skip every term that // is just plain prose (the majority of the glossary). const isParagraph = tag === "P" || (tag === "SPAN" && sibling.getAttribute("data-as") === "p"); if (isParagraph) { const text = cleanText(sibling.textContent); // Skip "See ..." cross-reference paragraphs if (text && !/^See\s/i.test(text)) { append(text); } } else if (tag === "UL" || tag === "OL") { const items = sibling.querySelectorAll("li"); for (let j = 0; j < items.length; j++) { append(cleanText(items[j].textContent)); } } sibling = sibling.nextElementSibling; } if (!definition) continue; // Cap to keep payload reasonable if (definition.length > 1500) { definition = definition.substring(0, 1497) + "..."; } const { displayName, aliases } = computeAliases(name); const term = { "@type": "DefinedTerm", "@id": baseUrl + "#" + id, name: displayName, description: definition, inDefinedTermSet: { "@id": setId }, url: baseUrl + "#" + id, }; if (aliases.length === 1) { term.alternateName = aliases[0]; } else if (aliases.length > 1) { term.alternateName = aliases; } terms.push(term); } if (terms.length === 0) return null; // Nest the DefinedTermSet inside a WebPage so page-level signals // (speakable, dates) attach to the WebPage where they're valid since // speakable is not a property of DefinedTermSet. Mirrors the pattern // used by buildPricingSchema (WebPage > mainEntity > SoftwareApplication). const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: baseUrl, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, inLanguage: lang, mainEntity: { "@type": "DefinedTermSet", "@id": setId, name: getPageTitle(), url: baseUrl, hasDefinedTerm: terms, }, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildWebPageSchema = (options) => { const enriched = options && options.enriched; const lang = getLanguage(); const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, inLanguage: lang, }; if (desc) schema.description = desc; if (enriched) { schema.speakable = SPEAKABLE; const dates = getPageDates(); if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; } return schema; }; // ── Main ───────────────────────────────────────────────────────────── const run = () => { cleanup(); const normalizedPath = getNormalizedPath(); // 1. Standalone entity blocks (all pages) — injected so Google can resolve // @id references in nested publisher/isPartOf fields across all pages injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); // 2. Breadcrumbs (all pages except homepage) const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); // 3. Page-specific schema if (isHomepage(normalizedPath)) { injectJsonLd(buildWebSiteSchema()); } else if (isApiReference(normalizedPath)) { injectJsonLd(buildApiReferenceSchema(normalizedPath)); } else if (isFaqPage(normalizedPath)) { const faqSchema = buildFaqSchema(); if (faqSchema) { injectJsonLd(faqSchema); } else { // On SPA navigation the <title> changes before accordion content renders. // Fall back to WebPage immediately, then retry once content has settled. setTimeout(function () { const retrySchema = buildFaqSchema(); if (retrySchema) { cleanup(); injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); injectJsonLd(retrySchema); } }, 800); injectJsonLd(buildWebPageSchema()); } } else if (isPricingPage(normalizedPath)) { injectJsonLd(buildWebPageSchema()); // Also inject FAQ schema if the pricing page has accordion Q&A pairs var pricingFaq = buildFaqSchema(); if (pricingFaq) injectJsonLd(pricingFaq); injectJsonLd(buildPricingSchema()); } else if (isProductOverview(normalizedPath)) { injectJsonLd(buildProductSchema(normalizedPath)); } else if (isGlossary(normalizedPath)) { const glossarySchema = buildGlossarySchema(); if (glossarySchema) { injectJsonLd(glossarySchema); } else { // SPA navigation: <title> changes before glossary content renders. // Fall back to enriched WebPage immediately, then retry once content has settled. setTimeout(function () { const retrySchema = buildGlossarySchema(); if (retrySchema) { cleanup(); injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); injectJsonLd(retrySchema); } }, 800); injectJsonLd(buildWebPageSchema({ enriched: true })); } } else if (isGuide(normalizedPath)) { injectJsonLd(buildTechArticleSchema()); } else { injectJsonLd(buildWebPageSchema({ enriched: true })); } }; // ── Lifecycle ──────────────────────────────────────────────────────── // SPA navigation: re-run when Mintlify updates the <title> on route change const setupObserver = () => { let debounceTimer; const scheduleRun = () => { clearTimeout(debounceTimer); debounceTimer = setTimeout(run, 150); }; // Watch <head> for <title> element being replaced (Next.js replaces the // entire element on route change rather than mutating its text in place) new MutationObserver((mutations) => { for (let i = 0; i < mutations.length; i++) { const added = mutations[i].addedNodes; for (let j = 0; j < added.length; j++) { if (added[j].nodeName === "TITLE") { scheduleRun(); return; } } } }).observe(document.head, { childList: true }); // Also watch the current title element for in-place text changes const titleEl = document.querySelector("title"); if (titleEl) { new MutationObserver(scheduleRun).observe(titleEl, { childList: true, characterData: true, subtree: true, }); } }; if (document.readyState === "loading") { document.addEventListener("DOMContentLoaded", () => { run(); setupObserver(); }); } else { run(); setupObserver(); } })(); </article></body></html>

/** * Structured Data (JSON-LD) for our Helius documentation * * Mintlify does not generate JSON-LD server-side. This script runs client-side * and injects schema.org structured data into the based on the current page * * * Schema types used: * - WebSite → homepage * - Organization → every page (standalone top-level entity for Knowledge Panel) * - BreadcrumbList → all pages * - APIReference → /api-reference/* pages * - TechArticle → guides, tutorials, how-tos * - FAQPage → /faqs/* pages (when Q&A pairs are present) * - SoftwareApplication → product overview pages * - WebPage + Offers → pricing page (/billing/plans) * - DefinedTermSet → /glossary (each h3 becomes a DefinedTerm) * - WebPage (enriched) → everything else (with speakable + dates) */ (() => { "use strict"; const BASE_URL = "https://www.helius.dev/docs"; const ORGANIZATION = { "@context": "https://schema.org", "@type": "Organization", "@id": "https://www.helius.dev/#organization", name: "Helius", url: "https://www.helius.dev", logo: { "@type": "ImageObject", url: "https://www.helius.dev/Helius-Brandkit/Helius/PNG/Helius-Horizontal-Logo.png", width: 562, height: 118, }, sameAs: [ "https://github.com/helius-labs", "https://discord.com/invite/6GXdee3gBj", "https://x.com/helius", "https://www.linkedin.com/company/heliusapi", ], }; const DOCUMENTATION_SITE = { "@context": "https://schema.org", "@type": "WebSite", "@id": "https://www.helius.dev/docs#website", name: "Helius Documentation", url: BASE_URL, }; // Human-readable labels for known breadcrumb path segments const BREADCRUMB_LABELS = { "api-reference": "API Reference", rpc: "RPC", http: "HTTP Methods", websocket: "WebSocket", das: "DAS", "zk-compression": "ZK Compression", laserstream: "LaserStream", grpc: "gRPC", sender: "Sender", webhooks: "Webhooks", "enhanced-transactions": "Enhanced Transactions API", "enhanced-websockets": "LaserStream WebSocket", "wallet-api": "Wallet API", "priority-fee": "Priority Fee", "sending-transactions": "Sending Transactions", "data-streaming": "Data Streaming", "dedicated-nodes": "Dedicated Nodes", billing: "Billing", faqs: "FAQs", agents: "Agents", mcp: "MCP", guides: "Guides", nfts: "NFTs", orb: "Orb", support: "Support", staking: "Staking", gatekeeper: "Gatekeeper", "shred-delivery": "Shred Delivery", skills: "Skills", zh: "中文", }; // Product overview pages that should use Product schema // TODO: replace PRODUCT_IMAGE with per-product card images once available const PRODUCT_IMAGE = "https://www.helius.dev/docs/images/hero-dark.png"; const PRODUCT_OVERVIEWS = { "/rpc/overview": { name: "Helius RPC", category: "Solana RPC Infrastructure", description: "High-performance Solana RPCs", image: PRODUCT_IMAGE, }, "/laserstream": { name: "Helius LaserStream gRPC", category: "Solana Data Streaming", description: "Ultra-low latency gRPC data streaming for Solana with historical replay", image: PRODUCT_IMAGE, }, "/rpc/websocket": { name: "Helius LaserStream WebSocket", category: "Solana Data Streaming", description: "Unified Solana WebSocket streaming with standard subscription methods and Helius extensions", image: PRODUCT_IMAGE, }, "/das-api": { name: "Helius DAS API", category: "Solana API", description: "Unified API for querying Solana digital assets — NFTs, tokens, and compressed assets", image: PRODUCT_IMAGE, }, "/webhooks": { name: "Helius Webhooks", category: "Solana Event Notification Service", description: "Real-time HTTP POST notifications for Solana events", image: PRODUCT_IMAGE, }, "/sending-transactions/sender": { name: "Helius Sender", category: "Solana Transaction Service", description: "Ultra-low latency transaction sending via staked connections and Jito", image: PRODUCT_IMAGE, }, "/dedicated-nodes": { name: "Helius Dedicated Nodes", category: "Solana Infrastructure", description: "Private Solana nodes with no rate limits and full Yellowstone gRPC support", image: PRODUCT_IMAGE, }, "/priority-fee-api": { name: "Helius Priority Fee API", category: "Solana API", description: "Smart priority fee estimation based on real-time Solana network conditions", image: PRODUCT_IMAGE, }, "/wallet-api/overview": { name: "Helius Wallet API", category: "Solana API", description: "REST endpoints for querying Solana wallet balances, history, identities, funding, and transfers", image: PRODUCT_IMAGE, }, "/gatekeeper/overview": { name: "Helius Gatekeeper", category: "Solana Edge Gateway", description: "Low-latency edge gateway for Solana infrastructure with intelligent routing", image: PRODUCT_IMAGE, }, "/api-reference/zk-compression": { name: "Helius ZK Compression", category: "Solana Data Compression", description: "Compress Solana account data to reduce storage costs by 95%+ using zero-knowledge proofs, indexed by Photon", image: PRODUCT_IMAGE, }, "/shred-delivery": { name: "Helius Shred Delivery", category: "Solana Data Streaming", description: "Raw Solana shreds delivered via UDP — the earliest possible on-chain signal for propAMMs, snipers, copy traders, liquidation bots, arbitrage, and RPC node operators", image: PRODUCT_IMAGE, }, "/agents/mcp": { name: "Helius MCP", category: "Solana AI Developer Tool", description: "Model Context Protocol server giving AI agents direct access to Helius APIs — querying, transactions, webhooks, streaming, and autonomous account signup", image: PRODUCT_IMAGE, }, "/agents/cli": { name: "Helius CLI", category: "Solana Developer Tool", description: "Full-featured command-line interface for Helius with 95+ commands for account management, queries, transactions, webhooks, and streaming", image: PRODUCT_IMAGE, }, "/orb": { name: "Orb", category: "Solana Block Explorer", description: "Full-featured Solana block explorer by Helius with reverse search, slot and time filtering, transaction heatmaps, and petabyte-scale archival data", image: PRODUCT_IMAGE, }, }; // Speakable specification — signals AI models which content is quotable const SPEAKABLE = { "@type": "SpeakableSpecification", cssSelector: ["h1", 'meta[name="description"]'], }; // Glossary alias table for entries whose heading carries only the // abbreviation OR only the expansion. Keyed by the raw H3 heading text // (pre-paren-strip). Headings of the form "Foo (Bar)" are handled // automatically by buildGlossarySchema and don't need an entry here. // Add new entries when the heading alone doesn't surface both forms. const TERM_ALIASES = { "DAS API": ["Digital Asset Standard", "DAS"], "RPC": ["Remote Procedure Call"], "gRPC": ["gRPC Remote Procedure Call"], "IDL": ["Interface Definition Language"], "SPL Token": ["Solana Program Library Token"], "ZK Compression": ["Zero-Knowledge Compression"], "Rent / Rent-exempt": ["Rent-exempt"], }; // Pricing tiers for the billing/plans page // Source of truth: https://dashboard.helius.dev and /billing/plans.mdx // Update this array whenever plan names, prices, or limits change. // priceValidUntil signals search engines when to re-check pricing. const PRICE_VALID_UNTIL = "2026-12-31"; const PRICING_TIERS = [ { name: "Free", price: "0", description: "1M monthly credits, 10 RPC req/s, 2 DAS & Enhanced API req/s, standard WebSockets, community support", }, { name: "Agent", price: "1", description: "1M monthly credits, 10 RPC req/s, 2 DAS & Enhanced API req/s, standard WebSockets, community support. 1 USDC one-time signup fee, programmatic access via CLI or MCP", }, { name: "Developer", price: "49", description: "10M monthly credits, 50 RPC req/s, 10 DAS & Enhanced API req/s, LaserStream WebSocket standard methods and Helius extensions, LaserStream gRPC devnet, chat support", }, { name: "Business", price: "499", description: "100M monthly credits, 200 RPC req/s, 50 DAS & Enhanced API req/s, LaserStream WebSocket Helius extensions, LaserStream gRPC mainnet + devnet, priority chat support", }, { name: "Professional", price: "999", description: "200M monthly credits, 500 RPC req/s, 100 DAS & Enhanced API req/s, LaserStream WebSocket Helius extensions, LaserStream gRPC mainnet + devnet, Slack/Telegram support", }, ]; // ── Helpers ────────────────────────────────────────────────────────── /** Strip /docs prefix, optional /zh/ lang prefix, and trailing slash */ const getPagePath = () => { const path = window.location.pathname .replace(/^\/docs\/?/, "/") .replace(/\/$/, ""); return path || "/"; }; /** Detect language from URL path */ const getLanguage = () => { const path = window.location.pathname.replace(/^\/docs\/?/, "/"); return path.indexOf("/zh/") === 0 || path === "/zh" ? "zh" : "en"; }; /** Get the path without the language prefix (for page-type detection) */ const getNormalizedPath = () => { const path = getPagePath(); return path.replace(/^\/zh\/?/, "/") || "/"; }; /** Read the page text */ const getPageTitle = () => { const el = document.querySelector("title"); const raw = el ? el.textContent : ""; return raw.split("|")[0].trim() || "Helius Docs"; }; /** Read published/modified dates from Open Graph meta tags injected by Mintlify */ const getPageDates = () => { let published = document.querySelector('meta[property="article:published_time"]'); const modified = document.querySelector('meta[property="article:modified_time"]'); if (!published) published = document.querySelector('meta[property="og:updated_time"]'); return { datePublished: published ? published.getAttribute("content") || "" : "", dateModified: modified ? modified.getAttribute("content") || "" : "", }; }; /** Read the meta description */ const getMetaDescription = () => { const el = document.querySelector('meta[name="description"]'); return el ? el.getAttribute("content") || "" : ""; }; /** Build the canonical URL for the current page */ const getCanonicalUrl = () => { const path = getPagePath(); if (path === "/") return BASE_URL; return BASE_URL + path; }; /** Get a human-readable breadcrumb label for a path segment */ const getBreadcrumbLabel = (segment) => { if (BREADCRUMB_LABELS[segment]) return BREADCRUMB_LABELS[segment]; // Fallback: capitalize first letter and replace hyphens with spaces return segment.charAt(0).toUpperCase() + segment.slice(1).replace(/-/g, " "); }; /** Inject a JSON-LD script element into the <head> with a marker attribute */ const injectJsonLd = (data) => { const script = document.createElement("script"); script.type = "application/ld+json"; script.setAttribute("data-helius-sd", ""); script.textContent = JSON.stringify(data); document.head.appendChild(script); }; /** Remove all previously injected JSON-LD elements */ const cleanup = () => { const scripts = document.querySelectorAll( 'script[type="application/ld+json"][data-helius-sd]' ); for (let i = 0; i < scripts.length; i++) { scripts[i].remove(); } }; // ── Breadcrumbs ────────────────────────────────────────────────────── const buildBreadcrumbList = () => { const path = getPagePath(); const items = [ { "@type": "ListItem", position: 1, name: "Helius Docs", item: BASE_URL, }, ]; if (path === "/") return null; const segments = path.split("/").filter(Boolean); let cumulative = ""; for (let i = 0; i < segments.length; i++) { cumulative += "/" + segments[i]; items.push({ "@type": "ListItem", position: i + 2, name: i === segments.length - 1 ? getPageTitle() : getBreadcrumbLabel(segments[i]), item: BASE_URL + cumulative, }); } return { "@context": "https://schema.org", "@type": "BreadcrumbList", itemListElement: items, }; }; // ── Page-type detection (operates on normalized path, without /zh/) ── const isHomepage = (path) => path === "/" || path === "/index"; const isApiReference = (path) => path.indexOf("/api-reference") === 0; const isProductOverview = (path) => PRODUCT_OVERVIEWS.hasOwnProperty(path); const GUIDE_PREFIXES = [ "/rpc/", "/laserstream/", "/gatekeeper/", "/grpc/", "/sending-transactions/", "/das/", "/enhanced-transactions/", "/dedicated-nodes/", "/webhooks/", "/data-streaming/", "/priority-fee/", "/wallet-api/", "/nfts/", "/zk-compression/", "/staking/", "/shred-delivery/", "/agents/", "/billing/", "/support/", "/orb/", ]; const GUIDE_EXACT = ["/grpc", "/agents", "/quickstart", "/getting-data", "/data-streaming"]; const isGuide = (path) => GUIDE_EXACT.indexOf(path) !== -1 || GUIDE_PREFIXES.some(function (prefix) { return path.indexOf(prefix) === 0; }); const isFaqPage = (path) => path.indexOf("/faqs") === 0; const isPricingPage = (path) => path === "/billing/plans"; const isGlossary = (path) => path === "/glossary"; // ── Determine the programmingModel for API reference pages ─────────── const getProgrammingModel = (path) => { if (path.indexOf("/rpc/websocket") !== -1) return "WebSocket JSON-RPC"; if (path.indexOf("/rpc/http") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/laserstream") !== -1) return "gRPC"; if (path.indexOf("/webhooks") !== -1) return "REST (Webhooks)"; if (path.indexOf("/wallet-api") !== -1) return "REST"; if (path.indexOf("/sender") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/das") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/priority-fee") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/enhanced-transactions") !== -1) return "HTTP JSON-RPC"; if (path.indexOf("/zk-compression") !== -1) return "HTTP JSON-RPC"; return "HTTP JSON-RPC"; }; // ── Schema builders ────────────────────────────────────────────────── const buildWebSiteSchema = () => ({ "@context": "https://schema.org", "@type": "WebSite", "@id": "https://www.helius.dev/docs#website", name: "Helius Documentation", url: BASE_URL, description: "Developer documentation for Helius — the leading Solana RPC and infrastructure platform", publisher: { "@id": "https://www.helius.dev/#organization" }, }); const buildApiReferenceSchema = (normalizedPath) => { const lang = getLanguage(); const desc = getMetaDescription(); const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "APIReference", headline: getPageTitle(), url: getCanonicalUrl(), mainEntityOfPage: { "@type": "WebPage", "@id": getCanonicalUrl() }, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, targetPlatform: "Solana", programmingModel: getProgrammingModel(normalizedPath), speakable: SPEAKABLE, inLanguage: lang, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildTechArticleSchema = () => { const lang = getLanguage(); const desc = getMetaDescription(); const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "TechArticle", headline: getPageTitle(), url: getCanonicalUrl(), mainEntityOfPage: { "@type": "WebPage", "@id": getCanonicalUrl() }, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, inLanguage: lang, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildFaqSchema = () => { const questions = []; // Extract Q&A from <details>/<summary> elements (Mintlify Accordions) const details = document.querySelectorAll("details"); for (let i = 0; i < details.length; i++) { const summary = details[i].querySelector("summary"); if (!summary) continue; const clone = details[i].cloneNode(true); const summaryClone = clone.querySelector("summary"); if (summaryClone) summaryClone.remove(); const answerText = (clone.textContent || "").trim(); if (answerText) { questions.push({ "@type": "Question", name: summary.textContent.trim(), acceptedAnswer: { "@type": "Answer", text: answerText, }, }); } } if (questions.length === 0) return null; const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "FAQPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, mainEntity: questions, speakable: SPEAKABLE, inLanguage: getLanguage(), }; if (desc) schema.description = desc; return schema; }; const buildProductSchema = (normalizedPath) => { const product = PRODUCT_OVERVIEWS[normalizedPath]; const desc = product.description || getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "SoftwareApplication", name: product.name, url: getCanonicalUrl(), image: product.image, applicationCategory: "DeveloperApplication", operatingSystem: "Solana", description: desc, author: { "@id": "https://www.helius.dev/#organization" }, offers: { "@type": "Offer", price: "0", priceCurrency: "USD", description: "Free tier available", url: BASE_URL + "/billing/plans", }, }; return schema; }; const buildPricingSchema = () => { const offers = PRICING_TIERS.map(function (tier) { return { "@type": "Offer", name: "Helius " + tier.name, price: tier.price, priceCurrency: "USD", priceValidUntil: PRICE_VALID_UNTIL, description: tier.description + " (billed monthly)", url: BASE_URL + "/billing/plans", availability: "https://schema.org/InStock", }; }); const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, mainEntity: { "@type": "SoftwareApplication", name: "Helius", applicationCategory: "DeveloperApplication", operatingSystem: "Solana", offers: offers, }, inLanguage: getLanguage(), }; if (desc) schema.description = desc; return schema; }; const buildGlossarySchema = () => { const headings = document.querySelectorAll("h3"); if (headings.length === 0) return null; const baseUrl = getCanonicalUrl(); const setId = baseUrl + "#termset"; const lang = getLanguage(); const desc = getMetaDescription(); const slugify = (text) => text .toLowerCase() .replace(/[^\w\s-]/g, "") .replace(/\s+/g, "-") .replace(/-+/g, "-") .replace(/^-|-$/g, ""); // Mintlify injects a U+200B zero-width space inside the heading anchor // link (the clickable hash icon). textContent picks it up and trim() // doesn't classify U+200B as whitespace, so it leaks into the term name. // Strip all zero-width characters (U+200B-U+200D, U+FEFF) before trimming. const cleanText = (text) => (text || "").replace(/[\u200B-\u200D\uFEFF]/g, "").trim(); // Headings of the form "Foo (Bar)" — strip the parens for `name` and // surface the inner text as an alias. Merged with TERM_ALIASES for // entries whose heading doesn't carry both forms. const PAREN_RE = /^(.+?)\s+$([^)]+)$\s*$/; const computeAliases = (rawName) => { const m = rawName.match(PAREN_RE); const displayName = m ? m[1].trim() : rawName; const aliases = []; const push = (val) => { const v = (val || "").trim(); if (v && v !== displayName && aliases.indexOf(v) === -1) { aliases.push(v); } }; const dictEntry = TERM_ALIASES[rawName]; if (dictEntry) { for (let i = 0; i < dictEntry.length; i++) push(dictEntry[i]); } if (m) push(m[2]); return { displayName: displayName, aliases: aliases }; }; const terms = []; for (let i = 0; i < headings.length; i++) { const heading = headings[i]; const name = cleanText(heading.textContent); if (!name) continue; const id = heading.getAttribute("id") || slugify(name); if (!id) continue; // Walk following siblings until the next h3 or h2, gathering definition text let definition = ""; // Append a chunk of text with smart sentence joining: if the previous // segment already ends in sentence-terminating punctuation or a colon // (a natural lead-in to a list), use a single space; otherwise use // ". " so list items and adjacent prose read as discrete sentences // instead of running together. const append = (text) => { if (!text) return; if (definition) { const lastChar = definition.slice(-1); definition += /[.!?:]/.test(lastChar) ? " " : ". "; } definition += text; }; let sibling = heading.nextElementSibling; while (sibling) { const tag = sibling.tagName; if (tag === "H3" || tag === "H2") break; // Mintlify wraps prose in <span data-as="p"> rather than emitting a // raw <p>. Treat both as paragraphs so we don't skip every term that // is just plain prose (the majority of the glossary). const isParagraph = tag === "P" || (tag === "SPAN" && sibling.getAttribute("data-as") === "p"); if (isParagraph) { const text = cleanText(sibling.textContent); // Skip "See ..." cross-reference paragraphs if (text && !/^See\s/i.test(text)) { append(text); } } else if (tag === "UL" || tag === "OL") { const items = sibling.querySelectorAll("li"); for (let j = 0; j < items.length; j++) { append(cleanText(items[j].textContent)); } } sibling = sibling.nextElementSibling; } if (!definition) continue; // Cap to keep payload reasonable if (definition.length > 1500) { definition = definition.substring(0, 1497) + "..."; } const { displayName, aliases } = computeAliases(name); const term = { "@type": "DefinedTerm", "@id": baseUrl + "#" + id, name: displayName, description: definition, inDefinedTermSet: { "@id": setId }, url: baseUrl + "#" + id, }; if (aliases.length === 1) { term.alternateName = aliases[0]; } else if (aliases.length > 1) { term.alternateName = aliases; } terms.push(term); } if (terms.length === 0) return null; // Nest the DefinedTermSet inside a WebPage so page-level signals // (speakable, dates) attach to the WebPage where they're valid since // speakable is not a property of DefinedTermSet. Mirrors the pattern // used by buildPricingSchema (WebPage > mainEntity > SoftwareApplication). const dates = getPageDates(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: baseUrl, isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, speakable: SPEAKABLE, inLanguage: lang, mainEntity: { "@type": "DefinedTermSet", "@id": setId, name: getPageTitle(), url: baseUrl, hasDefinedTerm: terms, }, }; if (desc) schema.description = desc; if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; return schema; }; const buildWebPageSchema = (options) => { const enriched = options && options.enriched; const lang = getLanguage(); const desc = getMetaDescription(); const schema = { "@context": "https://schema.org", "@type": "WebPage", name: getPageTitle(), url: getCanonicalUrl(), isPartOf: { "@id": "https://www.helius.dev/docs#website" }, publisher: { "@id": "https://www.helius.dev/#organization" }, inLanguage: lang, }; if (desc) schema.description = desc; if (enriched) { schema.speakable = SPEAKABLE; const dates = getPageDates(); if (dates.datePublished) schema.datePublished = dates.datePublished; if (dates.dateModified) schema.dateModified = dates.dateModified; } return schema; }; // ── Main ───────────────────────────────────────────────────────────── const run = () => { cleanup(); const normalizedPath = getNormalizedPath(); // 1. Standalone entity blocks (all pages) — injected so Google can resolve // @id references in nested publisher/isPartOf fields across all pages injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); // 2. Breadcrumbs (all pages except homepage) const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); // 3. Page-specific schema if (isHomepage(normalizedPath)) { injectJsonLd(buildWebSiteSchema()); } else if (isApiReference(normalizedPath)) { injectJsonLd(buildApiReferenceSchema(normalizedPath)); } else if (isFaqPage(normalizedPath)) { const faqSchema = buildFaqSchema(); if (faqSchema) { injectJsonLd(faqSchema); } else { // On SPA navigation the <title> changes before accordion content renders. // Fall back to WebPage immediately, then retry once content has settled. setTimeout(function () { const retrySchema = buildFaqSchema(); if (retrySchema) { cleanup(); injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); injectJsonLd(retrySchema); } }, 800); injectJsonLd(buildWebPageSchema()); } } else if (isPricingPage(normalizedPath)) { injectJsonLd(buildWebPageSchema()); // Also inject FAQ schema if the pricing page has accordion Q&A pairs var pricingFaq = buildFaqSchema(); if (pricingFaq) injectJsonLd(pricingFaq); injectJsonLd(buildPricingSchema()); } else if (isProductOverview(normalizedPath)) { injectJsonLd(buildProductSchema(normalizedPath)); } else if (isGlossary(normalizedPath)) { const glossarySchema = buildGlossarySchema(); if (glossarySchema) { injectJsonLd(glossarySchema); } else { // SPA navigation: <title> changes before glossary content renders. // Fall back to enriched WebPage immediately, then retry once content has settled. setTimeout(function () { const retrySchema = buildGlossarySchema(); if (retrySchema) { cleanup(); injectJsonLd(ORGANIZATION); injectJsonLd(DOCUMENTATION_SITE); const breadcrumbs = buildBreadcrumbList(); if (breadcrumbs) injectJsonLd(breadcrumbs); injectJsonLd(retrySchema); } }, 800); injectJsonLd(buildWebPageSchema({ enriched: true })); } } else if (isGuide(normalizedPath)) { injectJsonLd(buildTechArticleSchema()); } else { injectJsonLd(buildWebPageSchema({ enriched: true })); } }; // ── Lifecycle ──────────────────────────────────────────────────────── // SPA navigation: re-run when Mintlify updates the <title> on route change const setupObserver = () => { let debounceTimer; const scheduleRun = () => { clearTimeout(debounceTimer); debounceTimer = setTimeout(run, 150); }; // Watch <head> for <title> element being replaced (Next.js replaces the // entire element on route change rather than mutating its text in place) new MutationObserver((mutations) => { for (let i = 0; i < mutations.length; i++) { const added = mutations[i].addedNodes; for (let j = 0; j < added.length; j++) { if (added[j].nodeName === "TITLE") { scheduleRun(); return; } } } }).observe(document.head, { childList: true }); // Also watch the current title element for in-place text changes const titleEl = document.querySelector("title"); if (titleEl) { new MutationObserver(scheduleRun).observe(titleEl, { childList: true, characterData: true, subtree: true, }); } }; if (document.readyState === "loading") { document.addEventListener("DOMContentLoaded", () => { run(); setupObserver(); }); } else { run(); setupObserver(); } })(); </article></body></html>