${ICONS.sparkles}

${CONFIG.hotkey}

`; document.body.appendChild(this.root); this.els = { container: this.root.querySelector('#ea-container'), wrapper: this.root.querySelector('#ea-wrapper'), input: this.root.querySelector('#ea-input'), send: this.root.querySelector('#ea-send'), results: this.root.querySelector('#ea-results'), content: this.root.querySelector('#ea-content'), sourcesSection: this.root.querySelector('#ea-sources'), sourcesGrid: this.root.querySelector('#ea-sources-grid'), }; } initScrollBehavior() { let lastScrollY = window.scrollY; const handleScroll = () => { // Only apply scroll hide behavior on mobile if (!this.isMobile) return; // Don't hide if results are open if (this.els.results.classList.contains('active')) return; // Don't hide if input is focused if (document.activeElement === this.els.input) return; const currentScrollY = window.scrollY; const isScrollingDown = currentScrollY > lastScrollY; lastScrollY = currentScrollY; // Hide on scroll if (Math.abs(currentScrollY - lastScrollY) > 5 || isScrollingDown) { this.els.container.classList.add('scroll-hidden'); } // Clear existing timeout if (this.scrollTimeout) { clearTimeout(this.scrollTimeout); } // Show after 2 seconds of no scrolling this.scrollTimeout = setTimeout(() => { this.els.container.classList.remove('scroll-hidden'); }, CONFIG.scrollHideDelay); }; // Use passive listener for better scroll performance window.addEventListener('scroll', handleScroll, { passive: true }); // Update mobile detection on resize window.addEventListener('resize', () => { this.isMobile = window.innerWidth <= 768; // Show widget when switching to desktop if (!this.isMobile) { this.els.container.classList.remove('scroll-hidden'); } }); } bindEvents() { const { input, wrapper, send, container } = this.els; // --- FOCUS HANDLER WITH STATE RESTORATION --- input.addEventListener('focus', () => { wrapper.classList.add('focused'); // Show widget when focused (override scroll hide) this.els.container.classList.remove('scroll-hidden'); // If we have content, restore the results view if (this.els.content.innerHTML.trim() !== '') { this.els.results.classList.add('active'); this.els.container.classList.add('has-results'); } }); input.addEventListener('blur', () => wrapper.classList.remove('focused')); input.addEventListener('input', (e) => { send.classList.toggle('active', e.target.value.trim().length > 0); }); const submit = () => { const val = input.value.trim(); if (val) this.search(val); }; input.addEventListener('keydown', (e) => { if (e.key === 'Enter') { e.preventDefault(); submit(); } if (e.key === 'Escape') this.close(); }); send.addEventListener('click', submit); document.addEventListener('keydown', (e) => { if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') { e.preventDefault(); input.focus(); } }); document.addEventListener('click', (e) => { if (!container.contains(e.target) && this.els.results.classList.contains('active')) { this.close(); } }); this.els.content.addEventListener('click', (e) => { const btn = e.target.closest('.ea-copy-btn'); if (btn) { const code = btn.closest('.ea-code-block').querySelector('code').innerText; navigator.clipboard.writeText(code); const originalHTML = btn.innerHTML; btn.innerHTML = `${ICONS.check} Copied`; setTimeout(() => btn.innerHTML = originalHTML, 2000); } }); // --- LOCAL ROUTING (SPA NAVIGATION) --- this.els.results.addEventListener('click', (e) => { const link = e.target.closest('a'); if (!link) return; const href = link.getAttribute('href'); const isLocal = href.startsWith('/') || href.includes(window.location.hostname); if (isLocal) { e.preventDefault(); this.close(); // Close UI but keep state if (window.next?.router) { window.next.router.push(href); } else { window.history.pushState({}, '', href); window.dispatchEvent(new Event('popstate')); } } }); } search(query) { this.els.results.classList.add('active'); this.els.container.classList.add('has-results'); // Ensure widget is visible during search this.els.container.classList.remove('scroll-hidden'); this.els.content.innerHTML = this.getSkeletonHTML(); this.els.sourcesSection.style.display = 'none'; this.sources = []; if (this.eventSource) this.eventSource.close(); const url = `${CONFIG.apiEndpoint}?query=${encodeURIComponent(query)}&site=all&generate_mode=summarize&display_mode=full`; this.eventSource = new EventSource(url); let accumulated = ''; let isTextStreaming = false; this.eventSource.onmessage = (e) => { try { const data = JSON.parse(e.data); if (data.message_type === 'result_batch' && data.results) { this.sources = data.results; this.renderSources(); } else if (data.message_type === 'summary' && data.message) { if (!isTextStreaming) { this.els.content.innerHTML = ''; isTextStreaming = true; } accumulated += data.message; this.renderContent(accumulated, false); } else if (data.message_type === 'complete') { this.renderContent(accumulated, true); this.eventSource.close(); } } catch (err) { console.error("Stream Error", err); } }; this.eventSource.onerror = () => { this.eventSource.close(); }; } close() { // Only hide UI, do NOT clear content this.els.results.classList.remove('active'); this.els.container.classList.remove('has-results'); if (this.eventSource) this.eventSource.close(); } renderContent(text, isComplete) { const normalized = this.normalizeAnswerText(text); let html = this.parseMarkdown(normalized); if (!isComplete) html += ''; this.els.content.innerHTML = html; const area = this.els.results.querySelector('.ea-scroll-area'); area.scrollTop = area.scrollHeight; } resolveSourceMapping(rawKey) { if (!rawKey) return null; const originalKey = String(rawKey).trim(); const cleanKey = originalKey .replace('processed/', '') .replace(/^.*\//, ''); const mapped = SOURCE_MAPPING[originalKey] || SOURCE_MAPPING[cleanKey] || SOURCE_MAPPING[`processed/${cleanKey}`]; if (mapped) return mapped; const stem = cleanKey.replace(/\.(md|json)$/i, ''); const section = this.inferSectionFromKey(stem); if (!section) return null; return { url: `https://docs.solanatracker.io/${section}`, title: `${section.replace(/-/g, ' ')} docs`, section, type: 'section-fallback' }; } inferSectionFromKey(value) { const stem = String(value || '').toLowerCase(); if (!stem) return null; if (stem.startsWith('raptor-') || stem === 'raptor') return 'raptor'; if (stem.startsWith('datastream-') || stem === 'datastream') return 'datastream'; if (stem.startsWith('solana-rpc-') || stem === 'solana-rpc') return 'solana-rpc'; if (stem.startsWith('swap-api-') || stem.startsWith('general-') || stem === 'swap-api') return 'swap-api'; if (stem.startsWith('docs-') || stem.startsWith('yellowstone-') || stem === 'yellowstone-grpc') return 'yellowstone-grpc'; if (stem.startsWith('data-api-') || stem === 'data-api') return 'data-api'; return null; } getAllowedDocsPaths() { if (this._allowedDocsPaths) return this._allowedDocsPaths; const roots = ['/data-api', '/datastream', '/raptor', '/solana-rpc', '/swap-api', '/yellowstone-grpc']; const mappedPaths = Object.values(SOURCE_MAPPING || {}) .map(v => this.toRelativeDocsUrl(v && v.url)) .filter(Boolean); this._allowedDocsPaths = new Set([...roots, ...mappedPaths]); return this._allowedDocsPaths; } sanitizeDocsLinkUrl(url) { if (!url) return url; const cleaned = String(url).replace('https://docs.solanatracker.io', ''); if (!cleaned.startsWith('/')) return url; const allowed = this.getAllowedDocsPaths(); if (allowed.has(cleaned)) return cleaned; const section = this.inferSectionFromKey(cleaned.slice(1)); if (section) return `/${section}`; return '/'; } toRelativeDocsUrl(fullUrl) { if (!fullUrl) return '/'; return fullUrl.replace('https://docs.solanatracker.io', ''); } buildRelevantLinks(limit = 4) { if (!this.sources || this.sources.length === 0) return []; const unique = new Map(); for (const s of this.sources) { const rawKey = s.filename || s.name || s.title || ''; const mapData = this.resolveSourceMapping(rawKey); if (!mapData) continue; if (!unique.has(mapData.url)) { unique.set(mapData.url, { title: mapData.title || rawKey, url: this.toRelativeDocsUrl(mapData.url) }); } if (unique.size >= limit) break; } return Array.from(unique.values()); } normalizeAnswerText(text) { if (!text) return ''; let out = String(text); // Replace explicit processed file mentions with mapped doc links. out = out.replace(/\bprocessed\/([a-z0-9._-]+\.md)\b/gi, (m, file) => { const mapData = this.resolveSourceMapping(file); if (!mapData) return m; return `[${mapData.title}](${this.toRelativeDocsUrl(mapData.url)})`; }); // Replace bare *.md references when they exist in SOURCE_MAPPING. out = out.replace(/\b([a-z0-9._-]+\.md)\b/gi, (m, file) => { const mapData = this.resolveSourceMapping(file); if (!mapData) return m; return `[${mapData.title}](${this.toRelativeDocsUrl(mapData.url)})`; }); // Normalize docs links to canonical mapped/section URLs only. out = out.replace(/\[([^\]]+)\]$(https?:\/\/docs\.solanatracker\.io[^)\s]+|\/[^)\s]+)$/gi, (m, label, url) => { const safeUrl = this.sanitizeDocsLinkUrl(url); return `[${label}](${safeUrl})`; }); out = out.replace(/https?:\/\/docs\.solanatracker\.io(\/[^\s)]+)/gi, (m, path) => { return this.sanitizeDocsLinkUrl(path); }); // If the model returns ranking/meta narration, collapse to direct links. const hasRankingNarration = /(most relevant result|first result|second result|third result|therefore, the best place)/i.test(out); if (hasRankingNarration) { const links = this.buildRelevantLinks(4); if (links.length > 0) { return `Here are the relevant docs:\n${links.map(l => `- [${l.title}](${l.url})`).join('\n')}`; } } return out; } renderSources() { if (!this.sources || this.sources.length === 0) return; try { this.els.sourcesSection.style.display = 'block'; const html = this.sources.map(s => { const rawKey = s.filename || s.name || s.title || ''; const cleanKey = rawKey.replace('processed/', ''); const mapData = this.resolveSourceMapping(cleanKey); if (!mapData) return ''; let domain = 'docs.solanatracker.io'; const fullUrl = mapData.url; const relativeUrl = fullUrl.replace('https://docs.solanatracker.io', ''); return `

${ICONS.link} ${domain}

${mapData.title || cleanKey}

`; }).join(''); this.els.sourcesGrid.innerHTML = html; } catch (err) { console.error("Source Error", err); } } getSkeletonHTML() { return `

`; } parseMarkdown(text) { text = text.replace(/```(\w+)?\n([\s\S]*?)```/g, (match, lang, code) => { lang = lang || 'text'; return `

${lang}

${this.highlight(code.trim(), lang)}

`; }); // Auto-link plain URLs so they're always clickable text = text.replace(/(^|\s|\()((https?:\/\/)[^\s)]+)/g, '$1[$2]($2)'); text = text .replace(/\*\*(.*?)\*\*/g, '$1') .replace(/`([^`]+)`/g, '$1') .replace(/^### (.*$)/gm, '

$1

') .replace(/^## (.*$)/gm, '

$1

') .replace(/^- (.*$)/gm, '

') .replace(/((

.*<\/li>)+)/s, '

$1') .replace(/\[([^\]]+)\]$([^)]+)$/g, '$1') .replace(/\n\n/g, '

'); return text; } highlight(code, lang) { code = code.replace(/&/g, '&').replace(//g, '>'); const rules = { kw: /\b(function|return|var|let|const|if|else|for|while|class|import|from|def|async|await)\b/g, fn: /\b([a-zA-Z]\w*)(?=\()/g, str: /(['"`])(.*?)\1/g, num: /\b(\d+)\b/g, com: /(\/\/.*|#.*)/g, typ: /\b(string|number|boolean|any|void|Object|Array)\b/g }; code = code.replace(rules.str, '$&'); code = code.replace(rules.com, '$&'); code = code.replace(rules.kw, '$&'); code = code.replace(rules.fn, '$&'); code = code.replace(rules.num, '$&'); code = code.replace(rules.typ, '$&'); return code; } } if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => new EnterpriseWidget()); else new EnterpriseWidget(); })();

WebSocket Methods

Shredstream

Custom Methods

Account Methods

Block Methods

Transaction Methods

Network Methods

Stake Methods

Utility Methods

Resources

Documentation Index