Refresh Next type environment

deployment/systemd/solacescanscout-frontend.service

@@ -7,11 +7,11 @@ Wants=network.target
 Type=simple
 User=www-data
 Group=www-data
-WorkingDirectory=/opt/solacescanscout/frontend/current/explorer-monorepo/frontend
+WorkingDirectory=/opt/solacescanscout/frontend/current
 Environment=NODE_ENV=production
 Environment=HOSTNAME=127.0.0.1
 Environment=PORT=3000
-ExecStart=/usr/bin/node /opt/solacescanscout/frontend/current/explorer-monorepo/frontend/server.js
+ExecStart=/usr/bin/node /opt/solacescanscout/frontend/current/server.js
 Restart=always
 RestartSec=5
 StandardOutput=journal

frontend/next-env.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-/// <reference types="next/navigation-types/compat/navigation" />
 /// <reference path="./.next/types/routes.d.ts" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
+// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.

frontend/public/explorer-spa.js

@@ -4518,7 +4518,7 @@
                     title: 'Tools',
                     items: [
                         { title: 'Input Data Decoder', icon: 'fa-file-code', status: 'Live', badgeClass: 'badge-info', desc: 'Open transaction detail pages to decode calldata, logs, and contract interactions already exposed by the explorer.', action: 'showTransactionsList();', href: '/transactions' },
-                        { title: 'Unit Converter', icon: 'fa-scale-balanced', status: 'Live', badgeClass: 'badge-success', desc: 'Convert wei, gwei, ether, and common Chain 138 stablecoin units with a quick in-page helper.', action: 'showUnitConverterModal();', href: '/operations' },
+                        { title: 'Unit Converter', icon: 'fa-scale-balanced', status: 'Live', badgeClass: 'badge-success', desc: 'Convert wei, gwei, ether, and common Chain 138 6-decimal electronic-money units with a quick in-page helper.', action: 'showUnitConverterModal();', href: '/operations' },
                         { title: 'CSV Export', icon: 'fa-file-csv', status: 'Live', badgeClass: 'badge-success', desc: 'Export pool state and route inventory snapshots for operator review and downstream ingestion.', action: 'showPools(); updatePath(\'/pools\'); setTimeout(function(){ if (typeof exportPoolsCSV === \"function\") exportPoolsCSV(); }, 200);', href: '/pools' },
                         { title: 'Account Balance Checker', icon: 'fa-wallet', status: 'Live', badgeClass: 'badge-success', desc: 'Jump into indexed addresses to inspect balances, token inventory, internal transfers, and recent activity.', action: 'showAddresses();', href: '/addresses' }
                     ]
@@ -4602,12 +4602,12 @@
             modal.innerHTML = '' +
                 '<div style="width:min(560px, 100%); border-radius:18px; border:1px solid var(--border); background:var(--background); box-shadow:0 24px 90px rgba(0,0,0,0.35); overflow:hidden;">' +
                     '<div style="display:flex; justify-content:space-between; align-items:center; padding:1rem 1.1rem; border-bottom:1px solid var(--border);">' +
-                        '<div><div style="font-size:1.1rem; font-weight:800;">Unit Converter</div><div style="color:var(--text-light); font-size:0.9rem; margin-top:0.2rem;">Wei, gwei, ether, and 6-decimal stablecoin units for Chain 138.</div></div>' +
+                        '<div><div style="font-size:1.1rem; font-weight:800;">Unit Converter</div><div style="color:var(--text-light); font-size:0.9rem; margin-top:0.2rem;">Wei, gwei, ether, and 6-decimal electronic-money units for Chain 138.</div></div>' +
                         '<button type="button" class="btn btn-secondary" id="unitConverterCloseBtn"><i class="fas fa-times"></i></button>' +
                     '</div>' +
                     '<div style="padding:1rem 1.1rem; display:grid; gap:0.9rem;">' +
                         '<label style="display:grid; gap:0.35rem;"><span style="font-weight:700;">Amount</span><input id="unitConverterAmount" type="number" min="0" step="any" placeholder="1.0" style="padding:0.8rem 0.9rem; border:1px solid var(--border); border-radius:12px; background:var(--light); color:var(--text);"></label>' +
-                        '<label style="display:grid; gap:0.35rem;"><span style="font-weight:700;">Unit</span><select id="unitConverterUnit" style="padding:0.8rem 0.9rem; border:1px solid var(--border); border-radius:12px; background:var(--light); color:var(--text);"><option value="ether">Ether / WETH</option><option value="gwei">Gwei</option><option value="wei">Wei</option><option value="stable">Stablecoin (6 decimals)</option></select></label>' +
+                        '<label style="display:grid; gap:0.35rem;"><span style="font-weight:700;">Unit</span><select id="unitConverterUnit" style="padding:0.8rem 0.9rem; border:1px solid var(--border); border-radius:12px; background:var(--light); color:var(--text);"><option value="ether">Ether / WETH</option><option value="gwei">Gwei</option><option value="wei">Wei</option><option value="stable">Electronic money (6 decimals)</option></select></label>' +
                         '<div id="unitConverterResults" style="display:grid; gap:0.55rem;"></div>' +
                     '</div>' +
                 '</div>';

frontend/src/components/common/GruStandardsCard.tsx

@@ -12,7 +12,7 @@ const STANDARD_EXPLANATIONS: Record<string, string> = {
   'ERC-2612': 'Permit support for signature-based approvals without a separate on-chain approve transaction.',
   'ERC-3009': 'Authorization-based transfer model for signed payment flows without prior allowances.',
   'ERC-5267': 'Discoverable EIP-712 domain introspection so wallets and relayers can inspect the signing domain cleanly.',
-  IeMoneyToken: 'Repo-native eMoney token methodology for issuance and redemption semantics.',
+  IeMoneyToken: 'Repo-native electronic-money token methodology for issuance and redemption semantics.',
   DeterministicStorageNamespace: 'Stable namespace for upgrade-aware policy, registry, and audit resolution.',
   JurisdictionAndSupervisionMetadata: 'Governance, supervisory, disclosure, and reporting metadata required by the GRU operating model.',
 }

frontend/src/components/explorer/ContractCodeWorkspace.tsx

@@ -0,0 +1,357 @@
+'use client'
+
+import { FormEvent, useMemo, useState } from 'react'
+import clsx from 'clsx'
+import { Card } from '@/libs/frontend-ui-primitives'
+import EntityBadge from '@/components/common/EntityBadge'
+import { getExplorerApiBase } from '@/services/api/blockscout'
+import type { ContractProfile, ContractSourceFile } from '@/services/api/contracts'
+
+interface ContractCodeWorkspaceProps {
+  address: string
+  profile: ContractProfile
+}
+
+interface OutlineEntry {
+  type: 'contract' | 'interface' | 'library' | 'function' | 'event' | 'error'
+  name: string
+  line: number
+}
+
+const QUICK_PROMPTS = [
+  'What does this contract do?',
+  'What are the functions available in this contract?',
+  'Which functions can change state or move funds?',
+  'Who has special permissions or control in this contract?',
+  'What are potential risks or red flags in this contract?',
+] as const
+
+function makeFallbackSourceFile(profile: ContractProfile): ContractSourceFile | null {
+  if (!profile.source_code_preview && !profile.abi_full && !profile.abi) return null
+  return {
+    path: profile.contract_name ? `${profile.contract_name}.sol` : 'Contract.sol',
+    content: profile.source_code_full || profile.source_code_preview || profile.abi_full || profile.abi || '',
+  }
+}
+
+function parseOutline(content: string): OutlineEntry[] {
+  const entries: OutlineEntry[] = []
+  content.split('\n').forEach((line, index) => {
+    const lineNumber = index + 1
+    const typeMatch = line.match(/^\s*(?:abstract\s+)?(contract|interface|library)\s+([A-Za-z_][A-Za-z0-9_]*)/)
+    if (typeMatch) {
+      entries.push({
+        type: typeMatch[1] as OutlineEntry['type'],
+        name: typeMatch[2],
+        line: lineNumber,
+      })
+      return
+    }
+
+    const memberMatch = line.match(/^\s*(function|event|error)\s+([A-Za-z_][A-Za-z0-9_]*)/)
+    if (memberMatch) {
+      entries.push({
+        type: memberMatch[1] as OutlineEntry['type'],
+        name: memberMatch[2],
+        line: lineNumber,
+      })
+    }
+  })
+  return entries
+}
+
+function sourceExcerptForPrompt(files: ContractSourceFile[]): string {
+  return files
+    .slice(0, 4)
+    .map((file) => `File: ${file.path}\n${file.content.slice(0, 2600)}`)
+    .join('\n\n')
+    .slice(0, 5200)
+}
+
+export default function ContractCodeWorkspace({ address, profile }: ContractCodeWorkspaceProps) {
+  const files = useMemo(() => {
+    const normalized = profile.source_files?.length ? profile.source_files : []
+    const fallback = makeFallbackSourceFile(profile)
+    return normalized.length > 0 ? normalized : fallback ? [fallback] : []
+  }, [profile])
+
+  const [activeTab, setActiveTab] = useState<'source' | 'reader'>('source')
+  const [activePath, setActivePath] = useState(files[0]?.path || '')
+  const [prompt, setPrompt] = useState('What does this contract do?')
+  const [model, setModel] = useState('Explorer AI')
+  const [saveHistory, setSaveHistory] = useState(false)
+  const [submitting, setSubmitting] = useState(false)
+  const [readerAnswer, setReaderAnswer] = useState('')
+  const [readerError, setReaderError] = useState('')
+  const [expanded, setExpanded] = useState(false)
+
+  const activeFile = files.find((file) => file.path === activePath) || files[0]
+  const outline = useMemo(() => parseOutline(activeFile?.content || ''), [activeFile?.content])
+  const sourceLines = useMemo(() => (activeFile?.content || '').split('\n'), [activeFile?.content])
+
+  const selectedFiles = files
+  const sourceAvailable = files.length > 0 && Boolean(activeFile?.content)
+
+  const handleCopySource = async () => {
+    if (!activeFile?.content || typeof navigator === 'undefined') return
+    await navigator.clipboard?.writeText(activeFile.content)
+  }
+
+  const handleCopyLink = async () => {
+    if (typeof navigator === 'undefined' || typeof window === 'undefined') return
+    await navigator.clipboard?.writeText(`${window.location.href.split('#')[0]}#contract-source`)
+  }
+
+  const askReader = async (question: string) => {
+    const trimmed = question.trim()
+    if (!trimmed || submitting) return
+    setPrompt(trimmed)
+    setReaderError('')
+    setReaderAnswer('')
+    setSubmitting(true)
+
+    try {
+      const context = [
+        `Contract address: ${address}`,
+        profile.contract_name ? `Contract name: ${profile.contract_name}` : '',
+        profile.compiler_version ? `Compiler: ${profile.compiler_version}` : '',
+        profile.license_type ? `License: ${profile.license_type}` : '',
+        profile.proxy_type ? `Proxy type: ${profile.proxy_type}` : '',
+        `Read methods: ${profile.read_methods.map((method) => method.signature).slice(0, 24).join(', ') || 'none reported'}`,
+        `Write methods: ${profile.write_methods.map((method) => method.signature).slice(0, 24).join(', ') || 'none reported'}`,
+        sourceAvailable ? `Verified source excerpts:\n${sourceExcerptForPrompt(selectedFiles)}` : 'Verified source text is not available.',
+      ].filter(Boolean).join('\n')
+
+      const response = await fetch(`${getExplorerApiBase()}/api/v1/ai/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          messages: [
+            {
+              role: 'user',
+              content: `${trimmed}\n\nUse this contract context and answer concisely. Do not invent behavior that is not supported by the ABI or source.\n\n${context}`,
+            },
+          ],
+          pageContext: {
+            path: `/addresses/${address}`,
+            view: 'contract-code-reader',
+            address,
+          },
+        }),
+      })
+
+      const payload = await response.json().catch(() => null)
+      if (!response.ok) {
+        throw new Error(payload?.error?.message || `AI reader returned HTTP ${response.status}`)
+      }
+      setReaderAnswer(String(payload?.reply || payload?.message?.content || 'No answer returned.'))
+    } catch (error) {
+      setReaderError(error instanceof Error ? error.message : 'Code Reader is temporarily unavailable.')
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  const handleSubmit = async (event: FormEvent) => {
+    event.preventDefault()
+    await askReader(prompt)
+  }
+
+  if (!sourceAvailable && !profile.abi_available) {
+    return null
+  }
+
+  return (
+    <Card className="mb-6" title="Contract Source Code">
+      <section id="contract-source" className="space-y-4">
+        <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
+          <div className="flex flex-wrap gap-2">
+            <button
+              type="button"
+              onClick={() => setActiveTab('source')}
+              className={clsx(
+                'rounded-lg px-3 py-2 text-sm font-semibold transition',
+                activeTab === 'source'
+                  ? 'bg-primary-600 text-white'
+                  : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-900 dark:text-gray-200 dark:hover:bg-gray-700',
+              )}
+            >
+              Source
+            </button>
+            <button
+              type="button"
+              onClick={() => setActiveTab('reader')}
+              className={clsx(
+                'rounded-lg px-3 py-2 text-sm font-semibold transition',
+                activeTab === 'reader'
+                  ? 'bg-primary-600 text-white'
+                  : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-900 dark:text-gray-200 dark:hover:bg-gray-700',
+              )}
+            >
+              Code Reader
+            </button>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            {profile.source_verified ? <EntityBadge label="verified source" tone="success" /> : null}
+            {profile.abi_available ? <EntityBadge label="abi available" tone="info" /> : null}
+            {profile.compiler_version ? <EntityBadge label={profile.compiler_version} tone="neutral" className="normal-case tracking-normal" /> : null}
+          </div>
+        </div>
+
+        {activeTab === 'source' ? (
+          <div className={clsx('overflow-hidden rounded-lg border border-gray-200 dark:border-gray-700', expanded ? 'min-h-[46rem]' : '')}>
+            <div className="grid lg:grid-cols-[18rem_minmax(0,1fr)]">
+              <aside className="border-b border-gray-200 bg-gray-50 dark:border-gray-700 dark:bg-gray-900 lg:border-b-0 lg:border-r">
+                <div className="flex items-center justify-between border-b border-gray-200 px-4 py-3 text-xs font-semibold uppercase text-gray-500 dark:border-gray-700 dark:text-gray-400">
+                  <span>Explorer</span>
+                  <span>{files.length} file{files.length === 1 ? '' : 's'}</span>
+                </div>
+                <div className="max-h-72 overflow-auto p-2 lg:max-h-[34rem]">
+                  {files.map((file) => (
+                    <button
+                      type="button"
+                      key={file.path}
+                      onClick={() => setActivePath(file.path)}
+                      className={clsx(
+                        'block w-full rounded-md px-3 py-2 text-left text-sm transition',
+                        file.path === activeFile?.path
+                          ? 'bg-white font-semibold text-gray-950 shadow-sm dark:bg-gray-800 dark:text-white'
+                          : 'text-gray-700 hover:bg-white dark:text-gray-300 dark:hover:bg-gray-800',
+                      )}
+                    >
+                      <span className="block truncate">{file.path}</span>
+                    </button>
+                  ))}
+                </div>
+                {outline.length > 0 ? (
+                  <div className="border-t border-gray-200 p-2 dark:border-gray-700">
+                    <div className="px-3 py-2 text-xs font-semibold uppercase text-gray-500 dark:text-gray-400">Outline</div>
+                    <div className="max-h-64 overflow-auto">
+                      {outline.slice(0, 80).map((entry) => (
+                        <button
+                          key={`${entry.type}-${entry.name}-${entry.line}`}
+                          type="button"
+                          onClick={() => document.getElementById(`source-line-${entry.line}`)?.scrollIntoView({ block: 'center' })}
+                          className="flex w-full items-center gap-2 rounded-md px-3 py-1.5 text-left text-xs text-gray-700 hover:bg-white dark:text-gray-300 dark:hover:bg-gray-800"
+                        >
+                          <span className="w-16 uppercase text-gray-400">{entry.type}</span>
+                          <span className="min-w-0 flex-1 truncate font-mono">{entry.name}</span>
+                          <span className="text-gray-400">{entry.line}</span>
+                        </button>
+                      ))}
+                    </div>
+                  </div>
+                ) : null}
+              </aside>
+
+              <div className="min-w-0 bg-gray-950 text-gray-100">
+                <div className="flex flex-col gap-3 border-b border-gray-800 bg-gray-900 px-4 py-3 sm:flex-row sm:items-center sm:justify-between">
+                  <div className="min-w-0">
+                    <div className="truncate font-mono text-sm text-white">{activeFile?.path || 'Source'}</div>
+                    <div className="mt-1 text-xs text-gray-400">{sourceLines.length} lines</div>
+                  </div>
+                  <div className="flex flex-wrap gap-2">
+                    <button type="button" onClick={handleCopySource} className="rounded-md border border-gray-700 px-3 py-1.5 text-xs font-semibold text-gray-200 hover:bg-gray-800">
+                      Copy
+                    </button>
+                    <button type="button" onClick={handleCopyLink} className="rounded-md border border-gray-700 px-3 py-1.5 text-xs font-semibold text-gray-200 hover:bg-gray-800">
+                      Link
+                    </button>
+                    <button type="button" onClick={() => setExpanded((value) => !value)} className="rounded-md border border-gray-700 px-3 py-1.5 text-xs font-semibold text-gray-200 hover:bg-gray-800">
+                      {expanded ? 'Collapse' : 'Expand'}
+                    </button>
+                  </div>
+                </div>
+                <pre className={clsx('overflow-auto p-0 text-xs leading-5', expanded ? 'max-h-[52rem]' : 'max-h-[34rem]')}>
+                  <code className="block min-w-max py-4">
+                    {sourceLines.map((line, index) => (
+                      <span id={`source-line-${index + 1}`} key={`${activeFile?.path}-${index}`} className="grid grid-cols-[4.5rem_minmax(0,1fr)] px-4 hover:bg-white/5">
+                        <span className="select-none pr-4 text-right text-gray-500">{index + 1}</span>
+                        <span className="whitespace-pre text-gray-100">{line || ' '}</span>
+                      </span>
+                    ))}
+                  </code>
+                </pre>
+              </div>
+            </div>
+          </div>
+        ) : (
+          <div className="rounded-lg border border-gray-200 p-4 dark:border-gray-700">
+            <form onSubmit={handleSubmit} className="grid gap-5 lg:grid-cols-[28rem_minmax(0,1fr)]">
+              <div className="space-y-4 lg:border-r lg:border-gray-200 lg:pr-5 lg:dark:border-gray-700">
+                <label className="block">
+                  <span className="mb-2 block text-sm font-semibold text-gray-900 dark:text-white">Choose Model</span>
+                  <select
+                    value={model}
+                    onChange={(event) => setModel(event.target.value)}
+                    className="w-full rounded-lg border border-gray-300 bg-white px-3 py-2 text-sm dark:border-gray-700 dark:bg-gray-950 dark:text-white"
+                  >
+                    <option>Explorer AI</option>
+                    <option>Grok</option>
+                  </select>
+                </label>
+                <div>
+                  <div className="mb-2 text-sm font-semibold text-gray-900 dark:text-white">File Browser</div>
+                  <div className="space-y-2 rounded-lg bg-gray-50 p-3 dark:bg-gray-900">
+                    {files.map((file) => (
+                      <label key={file.path} className="flex items-center gap-2 text-sm text-gray-700 dark:text-gray-200">
+                        <input type="checkbox" checked readOnly className="h-4 w-4 rounded border-gray-300 text-primary-600" />
+                        <span className="truncate">{file.path}</span>
+                      </label>
+                    ))}
+                  </div>
+                </div>
+              </div>
+              <div className="min-w-0 space-y-4">
+                <div className="flex items-center justify-between gap-3">
+                  <div className="text-sm font-semibold text-gray-900 dark:text-white">Prompt</div>
+                  <label className="flex items-center gap-2 text-xs text-gray-600 dark:text-gray-300">
+                    <input type="checkbox" checked={saveHistory} onChange={(event) => setSaveHistory(event.target.checked)} className="h-4 w-4 rounded border-gray-300 text-primary-600" />
+                    Save History
+                  </label>
+                </div>
+                <div className="flex gap-3">
+                  <textarea
+                    value={prompt}
+                    onChange={(event) => setPrompt(event.target.value)}
+                    rows={3}
+                    className="min-h-24 flex-1 rounded-lg border border-gray-300 px-3 py-2 text-sm dark:border-gray-700 dark:bg-gray-950 dark:text-white"
+                  />
+                  <button
+                    type="submit"
+                    disabled={submitting || !prompt.trim()}
+                    className="h-12 rounded-lg bg-primary-600 px-4 text-sm font-semibold text-white transition hover:bg-primary-700 disabled:cursor-not-allowed disabled:opacity-60"
+                  >
+                    {submitting ? '...' : 'Send'}
+                  </button>
+                </div>
+                <div className="flex flex-wrap gap-2">
+                  {QUICK_PROMPTS.map((quickPrompt) => (
+                    <button
+                      key={quickPrompt}
+                      type="button"
+                      onClick={() => void askReader(quickPrompt)}
+                      className="rounded-full border border-gray-300 px-3 py-1.5 text-xs font-semibold text-gray-700 hover:border-primary-400 hover:text-primary-700 dark:border-gray-700 dark:text-gray-300 dark:hover:text-primary-300"
+                    >
+                      {quickPrompt}
+                    </button>
+                  ))}
+                </div>
+                {readerAnswer ? (
+                  <div className="whitespace-pre-wrap rounded-lg bg-gray-50 p-4 text-sm text-gray-800 dark:bg-gray-900 dark:text-gray-100">
+                    {readerAnswer}
+                  </div>
+                ) : null}
+                {readerError ? (
+                  <div className="rounded-lg border border-red-200 bg-red-50 p-3 text-sm text-red-700 dark:border-red-900/60 dark:bg-red-950/40 dark:text-red-200">
+                    {readerError}
+                  </div>
+                ) : null}
+              </div>
+            </form>
+          </div>
+        )}
+      </section>
+    </Card>
+  )
+}

frontend/src/pages/addresses/[address].tsx

@@ -29,6 +29,7 @@ import {
 } from '@/utils/watchlist'
 import PageIntro from '@/components/common/PageIntro'
 import GruStandardsCard from '@/components/common/GruStandardsCard'
+import ContractCodeWorkspace from '@/components/explorer/ContractCodeWorkspace'
 import { getGruStandardsProfileSafe, type GruStandardsProfile } from '@/services/api/gru'
 import { getGruExplorerMetadata } from '@/services/api/gruExplorerData'
 import { tokenAggregationApi, type TokenAggregationTokenSnapshot } from '@/services/api/tokenAggregation'
@@ -702,20 +703,6 @@ export default function AddressDetailPage() {
                     </code>
                   </DetailRow>
                 )}
-                {contractProfile?.source_code_preview && (
-                  <DetailRow label="Source Preview">
-                    <code className="block max-h-56 overflow-auto whitespace-pre-wrap break-words rounded bg-gray-50 p-2 text-xs dark:bg-gray-950">
-                      {contractProfile.source_code_preview}
-                    </code>
-                  </DetailRow>
-                )}
-                {contractProfile?.abi && (
-                  <DetailRow label="ABI Preview">
-                    <code className="block max-h-56 overflow-auto whitespace-pre-wrap break-words rounded bg-gray-50 p-2 text-xs dark:bg-gray-950">
-                      {contractProfile.abi}
-                    </code>
-                  </DetailRow>
-                )}
                 {contractProfile?.read_methods && contractProfile.read_methods.length > 0 && (
                   <DetailRow label="Read Methods">
                     <div className="space-y-3">
@@ -861,6 +848,10 @@ export default function AddressDetailPage() {
             </Card>
           )}
 
+          {addressInfo.is_contract && contractProfile ? (
+            <ContractCodeWorkspace address={addressInfo.address} profile={contractProfile} />
+          ) : null}
+
           {gruProfile ? <div className="mb-6"><GruStandardsCard profile={gruProfile} /></div> : null}
 
           <Card title="Token Balances" className="mb-6">

frontend/src/pages/docs/gru.tsx

@@ -49,6 +49,14 @@ export default function GruDocsPage() {
 
         <Card title="Standards Summary">
           <div className="grid gap-4 md:grid-cols-2">
+            <div className="rounded-xl border border-gray-200 bg-gray-50 p-4 text-sm dark:border-gray-700 dark:bg-gray-900/40 md:col-span-2">
+              <div className="font-medium text-gray-900 dark:text-white">Public token language</div>
+              <div className="mt-2 text-gray-600 dark:text-gray-400">
+                The explorer follows the GRU monetary policy taxonomy: <strong>c</strong> means compliant instrument created by a regulated financial entity or institution,
+                <strong> W</strong> means wrapped representation on a public network, <strong>XXX</strong> is the ISO-4217 currency code or ISO-style commodity code,
+                <strong> C</strong> marks cash-tokenized electronic money, and <strong> T</strong> marks treasury or government bond exposure.
+              </div>
+            </div>
             <div className="rounded-xl border border-gray-200 bg-gray-50 p-4 text-sm dark:border-gray-700 dark:bg-gray-900/40">
               <div className="font-medium text-gray-900 dark:text-white">Base token profile</div>
               <div className="mt-2 text-gray-600 dark:text-gray-400">

frontend/src/pages/tokens/index.tsx

@@ -11,8 +11,8 @@ import { tokenAggregationApi, type TokenAggregationTokenSnapshot } from '@/servi
 import { fetchPublicJson } from '@/utils/publicExplorer'
 
 const quickSearches = [
-  { label: 'cUSDT', description: 'Canonical bridged USDT liquidity and address results.' },
-  { label: 'cUSDC', description: 'Canonical bridged USDC routes and address coverage.' },
+  { label: 'cUSDT', description: 'Canonical compliant USD electronic-money liquidity and address results.' },
+  { label: 'cUSDC', description: 'Canonical compliant USD electronic-money routes and address coverage.' },
   { label: 'cXAUC', description: 'Gold-backed cXAUC pools and token references.' },
   { label: 'cXAUT', description: 'Gold-backed cXAUT references and search coverage.' },
   { label: 'cEURT', description: 'EUR liquidity and cXAUC-connected route coverage.' },

frontend/src/services/api/contracts.test.ts

@@ -67,9 +67,57 @@ describe('contractsApi', () => {
     expect(result.data?.optimization_runs).toBe(200)
     expect(result.data?.constructor_arguments?.endsWith('...')).toBe(true)
     expect(result.data?.abi).toContain('"symbol"')
+    expect(result.data?.abi_full).toContain('"symbol"')
+    expect(result.data?.source_files).toEqual([{ path: 'MockToken.sol', content: 'contract MockToken {}' }])
     expect(result.data?.read_methods.map((method) => method.signature)).toContain('symbol()')
   })
 
+  it('extracts Etherscan-style multi-file verified sources', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            has_custom_methods_read: true,
+            has_custom_methods_write: true,
+            implementations: [],
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            status: '1',
+            message: 'OK',
+            result: '[]',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            status: '1',
+            message: 'OK',
+            result: [
+              {
+                ContractName: 'RWAToken',
+                SourceCode:
+                  '{{"language":"Solidity","sources":{"contracts/RWAToken.sol":{"content":"contract RWAToken {}"},"contracts/interfaces/IRWA.sol":{"content":"interface IRWA {}"}},"settings":{}}}',
+              },
+            ],
+          }),
+        }),
+    )
+
+    const result = await contractsApi.getProfileSafe('0xcontract')
+
+    expect(result.ok).toBe(true)
+    expect(result.data?.source_files).toEqual([
+      { path: 'contracts/RWAToken.sol', content: 'contract RWAToken {}' },
+      { path: 'contracts/interfaces/IRWA.sol', content: 'interface IRWA {}' },
+    ])
+  })
+
   it('calls a simple zero-arg read method through public RPC', async () => {
     vi.stubGlobal(
       'fetch',

frontend/src/services/api/contracts.ts

@@ -18,6 +18,11 @@ export interface ContractMethodExecutionResult {
   value: string
 }
 
+export interface ContractSourceFile {
+  path: string
+  content: string
+}
+
 export interface ContractProfile {
   has_custom_methods_read: boolean
   has_custom_methods_write: boolean
@@ -36,7 +41,10 @@ export interface ContractProfile {
   license_type?: string
   constructor_arguments?: string
   abi?: string
+  abi_full?: string
+  source_code_full?: string
   source_code_preview?: string
+  source_files: ContractSourceFile[]
   source_status_text?: string
   read_methods: ContractMethod[]
   write_methods: ContractMethod[]
@@ -63,6 +71,7 @@ interface ContractCompatibilityAbiResponse {
 interface ContractCompatibilitySourceRecord {
   Address?: string
   ContractName?: string
+  FileName?: string
   CompilerVersion?: string
   OptimizationUsed?: string | number
   Runs?: string | number
@@ -111,6 +120,47 @@ function normalizeNumber(value: string | number | null | undefined): number | un
   return undefined
 }
 
+function displaySourcePath(record: ContractCompatibilitySourceRecord | undefined): string {
+  const fileName = record?.FileName?.trim()
+  if (fileName) return fileName
+  const contractName = record?.ContractName?.trim()
+  if (contractName) return contractName.endsWith('.sol') ? contractName : `${contractName}.sol`
+  return 'Contract.sol'
+}
+
+function parseSourceFiles(sourceCode: string | undefined, record?: ContractCompatibilitySourceRecord): ContractSourceFile[] {
+  const trimmed = sourceCode?.trim()
+  if (!trimmed) return []
+
+  const candidates = [trimmed]
+  if (trimmed.startsWith('{{') && trimmed.endsWith('}}')) {
+    candidates.push(trimmed.slice(1, -1))
+  }
+
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(candidate) as {
+        sources?: Record<string, { content?: string } | string>
+      }
+      if (parsed && typeof parsed === 'object' && parsed.sources && typeof parsed.sources === 'object') {
+        return Object.entries(parsed.sources)
+          .map(([path, value]) => ({
+            path,
+            content: typeof value === 'string' ? value : value?.content || '',
+          }))
+          .filter((file) => file.content.trim().length > 0)
+      }
+    } catch {}
+  }
+
+  return [
+    {
+      path: displaySourcePath(record),
+      content: trimmed,
+    },
+  ]
+}
+
 function parseABI(abiString?: string): ContractMethod[] {
   if (!abiString) return []
   try {
@@ -359,6 +409,7 @@ export const contractsApi = {
             ? sourceRecord.ABI
             : undefined
       const sourceCode = sourceRecord?.SourceCode
+      const sourceFiles = parseSourceFiles(sourceCode, sourceRecord)
       const parsedMethods = parseABI(abiString)
       const sourceVerified = Boolean(
         abiString ||
@@ -391,7 +442,10 @@ export const contractsApi = {
           license_type: sourceRecord?.LicenseType || undefined,
           constructor_arguments: truncateHex(sourceRecord?.ConstructorArguments, 90),
           abi: truncateText(abiString, 1200),
+          abi_full: abiString,
+          source_code_full: sourceCode,
           source_code_preview: truncateText(sourceCode, 1200),
+          source_files: sourceFiles,
           source_status_text: sourceStatusText || undefined,
           read_methods: parsedMethods.filter(isReadMethod),
           write_methods: parsedMethods.filter((method) => !isReadMethod(method)),

frontend/src/services/api/gruExplorerData.ts

@@ -70,13 +70,13 @@ const GRU_EXPLORER_ENTRIES: GruExplorerEntry[] = [
     otherNetworks: [
       networkLink(651940, 'ALL Mainnet (Alltra)', 'AUSDC', '0xa95EeD79f84E6A0151eaEb9d441F9Ffd50e8e881', 'Primary Alltra-native origin counterpart.'),
       networkLink(1, 'Ethereum Mainnet', 'USDC', '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', 'Native Ethereum settlement counterpart.'),
-      networkLink(1, 'Ethereum Mainnet', 'cWUSDC', '0x2de5F116bFcE3d0f922d9C8351e0c5Fc24b9284a', 'GRU wrapped transport representation on Ethereum.'),
+      networkLink(1, 'Ethereum Mainnet', 'cWUSDC', '0x2de5F116bFcE3d0f922d9C8351e0c5Fc24b9284a', 'GRU wrapped public-network representation on Ethereum.'),
       networkLink(56, 'BNB Chain', 'USDC', '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', 'Native BNB Chain settlement counterpart.'),
-      networkLink(56, 'BNB Chain', 'cWUSDC', '0x5355148C4740fcc3D7a96F05EdD89AB14851206b', 'GRU wrapped transport representation on BNB Chain.'),
+      networkLink(56, 'BNB Chain', 'cWUSDC', '0x5355148C4740fcc3D7a96F05EdD89AB14851206b', 'GRU wrapped public-network representation on BNB Chain.'),
       networkLink(137, 'Polygon', 'USDC', '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', 'Native Polygon settlement counterpart.'),
-      networkLink(137, 'Polygon', 'cWUSDC', '0xd6969bC19b53f866C64f2148aE271B2Dae0C58E4', 'GRU wrapped transport representation on Polygon.'),
+      networkLink(137, 'Polygon', 'cWUSDC', '0xd6969bC19b53f866C64f2148aE271B2Dae0C58E4', 'GRU wrapped public-network representation on Polygon.'),
       networkLink(100, 'Gnosis', 'USDC', '0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83', 'Native Gnosis settlement counterpart.'),
-      networkLink(100, 'Gnosis', 'cWUSDC', '0xd6969bC19b53f866C64f2148aE271B2Dae0C58E4', 'GRU wrapped transport representation on Gnosis.'),
+      networkLink(100, 'Gnosis', 'cWUSDC', '0xd6969bC19b53f866C64f2148aE271B2Dae0C58E4', 'GRU wrapped public-network representation on Gnosis.'),
     ],
   },
   {
@@ -96,13 +96,13 @@ const GRU_EXPLORER_ENTRIES: GruExplorerEntry[] = [
     otherNetworks: [
       networkLink(651940, 'ALL Mainnet (Alltra)', 'AUSDT', '0x015B1897Ed5279930bC2Be46F661894d219292A6', 'Primary Alltra-native origin counterpart.'),
       networkLink(1, 'Ethereum Mainnet', 'USDT', '0xdAC17F958D2ee523a2206206994597C13D831ec7', 'Native Ethereum settlement counterpart.'),
-      networkLink(1, 'Ethereum Mainnet', 'cWUSDT', '0xaF5017d0163ecb99D9B5D94e3b4D7b09Af44D8AE', 'GRU wrapped transport representation on Ethereum.'),
+      networkLink(1, 'Ethereum Mainnet', 'cWUSDT', '0xaF5017d0163ecb99D9B5D94e3b4D7b09Af44D8AE', 'GRU wrapped public-network representation on Ethereum.'),
       networkLink(56, 'BNB Chain', 'USDT', '0x55d398326f99059fF775485246999027B3197955', 'Native BNB Chain settlement counterpart.'),
-      networkLink(56, 'BNB Chain', 'cWUSDT', '0x9a1D0dBEE997929ED02fD19E0E199704d20914dB', 'GRU wrapped transport representation on BNB Chain.'),
+      networkLink(56, 'BNB Chain', 'cWUSDT', '0x9a1D0dBEE997929ED02fD19E0E199704d20914dB', 'GRU wrapped public-network representation on BNB Chain.'),
       networkLink(137, 'Polygon', 'USDT', '0xc2132D05D31c914a87C6611C10748AEb04B58e8F', 'Native Polygon settlement counterpart.'),
-      networkLink(137, 'Polygon', 'cWUSDT', '0x0cb0192C056aa425C557BdeAD8E56C7eEabf7acF', 'GRU wrapped transport representation on Polygon.'),
+      networkLink(137, 'Polygon', 'cWUSDT', '0x0cb0192C056aa425C557BdeAD8E56C7eEabf7acF', 'GRU wrapped public-network representation on Polygon.'),
       networkLink(100, 'Gnosis', 'USDT', '0x4ECaBa5870353805a9F068101A40E0f32ed605C6', 'Native Gnosis settlement counterpart.'),
-      networkLink(100, 'Gnosis', 'cWUSDT', '0x0cb0192C056aa425C557BdeAD8E56C7eEabf7acF', 'GRU wrapped transport representation on Gnosis.'),
+      networkLink(100, 'Gnosis', 'cWUSDT', '0x0cb0192C056aa425C557BdeAD8E56C7eEabf7acF', 'GRU wrapped public-network representation on Gnosis.'),
     ],
   },
   {
@@ -116,9 +116,9 @@ const GRU_EXPLORER_ENTRIES: GruExplorerEntry[] = [
     canonicalForwardVersion: 'v2',
     canonicalForwardAddress: '0x243e6581Dc8a98d98B92265858b322b193555C81',
     otherNetworks: [
-      networkLink(56, 'BNB Chain', 'cWEURC', '0x50b073d0D1D2f002745cb9FC28a057d5be84911c', 'GRU wrapped transport representation on BNB Chain.'),
-      networkLink(137, 'Polygon', 'cWEURC', '0x3CD9ee18db7ad13616FCC1c83bC6098e03968E66', 'GRU wrapped transport representation on Polygon.'),
-      networkLink(100, 'Gnosis', 'cWEURC', '0x25603ae4bff0b71d637b3573d1b6657f5f6d17ef', 'GRU wrapped transport representation on Gnosis.'),
+      networkLink(56, 'BNB Chain', 'cWEURC', '0x50b073d0D1D2f002745cb9FC28a057d5be84911c', 'GRU wrapped public-network representation on BNB Chain.'),
+      networkLink(137, 'Polygon', 'cWEURC', '0x3CD9ee18db7ad13616FCC1c83bC6098e03968E66', 'GRU wrapped public-network representation on Polygon.'),
+      networkLink(100, 'Gnosis', 'cWEURC', '0x25603ae4bff0b71d637b3573d1b6657f5f6d17ef', 'GRU wrapped public-network representation on Gnosis.'),
     ],
   },
   {
@@ -132,9 +132,9 @@ const GRU_EXPLORER_ENTRIES: GruExplorerEntry[] = [
     canonicalForwardVersion: 'v2',
     canonicalForwardAddress: '0x2bAFA83d8fF8BaE9505511998987D0659791605B',
     otherNetworks: [
-      networkLink(56, 'BNB Chain', 'cWEURT', '0x1ED9E491A5eCd53BeF21962A5FCE24880264F63f', 'GRU wrapped transport representation on BNB Chain.'),
-      networkLink(137, 'Polygon', 'cWEURT', '0xBeF5A0Bcc0E77740c910f197138cdD90F98d2427', 'GRU wrapped transport representation on Polygon.'),
-      networkLink(100, 'Gnosis', 'cWEURT', '0x8e54c52d34a684e22865ac9f2d7c27c30561a7b9', 'GRU wrapped transport representation on Gnosis.'),
+      networkLink(56, 'BNB Chain', 'cWEURT', '0x1ED9E491A5eCd53BeF21962A5FCE24880264F63f', 'GRU wrapped public-network representation on BNB Chain.'),
+      networkLink(137, 'Polygon', 'cWEURT', '0xBeF5A0Bcc0E77740c910f197138cdD90F98d2427', 'GRU wrapped public-network representation on Polygon.'),
+      networkLink(100, 'Gnosis', 'cWEURT', '0x8e54c52d34a684e22865ac9f2d7c27c30561a7b9', 'GRU wrapped public-network representation on Gnosis.'),
     ],
   },
   ...[

scripts/deploy-next-frontend-to-vmid5000.sh

@@ -114,7 +114,9 @@ fi
 APP_RELATIVE_DIR="."
 APP_SERVER_PATH="${STANDALONE_ROOT}/server.js"
 if [[ ! -f "${APP_SERVER_PATH}" ]]; then
-  ALT_SERVER_PATH="$(find "${STANDALONE_ROOT}" -path '*/server.js' -print | head -n 1 || true)"
+  ALT_SERVER_PATH="$(find "${STANDALONE_ROOT}" \
+    -path '*/node_modules' -prune -o \
+    -path '*/server.js' -print | head -n 1 || true)"
   if [[ -n "${ALT_SERVER_PATH}" ]]; then
     APP_SERVER_PATH="${ALT_SERVER_PATH}"
     APP_RELATIVE_DIR="$(dirname "${ALT_SERVER_PATH#${STANDALONE_ROOT}/}")"