spice-mcp 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

spice_mcp/mcp/tools/base.py

@@ -20,7 +20,7 @@ class MCPTool(ABC):
         raise NotImplementedError
 
     @abstractmethod
-    async def execute(self, **kwargs) -> dict[str, Any]:
+    def execute(self, **kwargs) -> dict[str, Any]:
         """Execute tool logic and return result dictionary."""
         raise NotImplementedError
 

spice_mcp/mcp/tools/execute_query.py

@@ -5,8 +5,10 @@ import re
 import time
 from typing import Any
 
-from ...adapters.dune import extract as dune_extract
 from ...adapters.dune import urls as dune_urls
+from ...adapters.dune.query_wrapper import execute_query as execute_dune_query
+# Import user_agent from separate module to avoid importing overloaded functions
+from ...adapters.dune.user_agent import get_user_agent as get_dune_user_agent
 from ...adapters.http_client import HttpClient
 from ...config import Config
 from ...core.errors import error_response
@@ -80,7 +82,7 @@ class ExecuteQueryTool(MCPTool):
             "additionalProperties": False,
         }
 
-    async def execute(
+    def execute(
         self,
         *,
         query: str,
@@ -103,7 +105,7 @@ class ExecuteQueryTool(MCPTool):
             q_use = _maybe_rewrite_show_sql(query) or query
             # Poll-only: return execution handle without fetching results
             if format == "poll":
-                exec_obj = dune_extract.query(
+                exec_obj = execute_dune_query(
                     q_use,
                     parameters=parameters,
                     api_key=self.config.dune.api_key,
@@ -149,74 +151,41 @@ class ExecuteQueryTool(MCPTool):
                 return {"type": "execution", "execution_id": execution_id, "status": "submitted"}
 
             if format == "metadata":
-                try:
-                    meta = self.query_service.fetch_metadata(
-                        query=q_use,
-                        parameters=parameters,
-                        max_age=max_age,
-                        limit=limit,
-                        offset=offset,
-                        sample_count=sample_count,
-                        sort_by=sort_by,
-                        columns=columns,
-                        extras=extras,
-                        performance=performance,
-                    )
-                except TypeError:
-                    # Back-compat: older services without 'extras'
-                    meta = self.query_service.fetch_metadata(
-                        query=q_use,
-                        parameters=parameters,
-                        max_age=max_age,
-                        limit=limit,
-                        offset=offset,
-                        sample_count=sample_count,
-                        sort_by=sort_by,
-                        columns=columns,
-                        performance=performance,
-                    )
-                return {
-                    "type": "metadata",
-                    "metadata": meta.get("metadata"),
-                    "next_uri": meta.get("next_uri"),
-                    "next_offset": meta.get("next_offset"),
-                }
-            try:
-                result = self.query_service.execute(
+                meta = self.query_service.fetch_metadata(
                     query=q_use,
                     parameters=parameters,
-                    refresh=refresh,
                     max_age=max_age,
-                    poll=True,
-                    timeout_seconds=timeout_seconds,
                     limit=limit,
                     offset=offset,
                     sample_count=sample_count,
                     sort_by=sort_by,
                     columns=columns,
                     extras=extras,
-                    include_execution=True,
                     performance=performance,
-                    return_raw=format == "raw",
-                )
-            except TypeError:
-                # Back-compat: older services without 'extras'
-                result = self.query_service.execute(
-                    query=q_use,
-                    parameters=parameters,
-                    refresh=refresh,
-                    max_age=max_age,
-                    poll=True,
-                    timeout_seconds=timeout_seconds,
-                    limit=limit,
-                    offset=offset,
-                    sample_count=sample_count,
-                    sort_by=sort_by,
-                    columns=columns,
-                    include_execution=True,
-                    performance=performance,
-                    return_raw=format == "raw",
                 )
+                return {
+                    "type": "metadata",
+                    "metadata": meta.get("metadata"),
+                    "next_uri": meta.get("next_uri"),
+                    "next_offset": meta.get("next_offset"),
+                }
+            result = self.query_service.execute(
+                query=q_use,
+                parameters=parameters,
+                refresh=refresh,
+                max_age=max_age,
+                poll=True,
+                timeout_seconds=timeout_seconds,
+                limit=limit,
+                offset=offset,
+                sample_count=sample_count,
+                sort_by=sort_by,
+                columns=columns,
+                extras=extras,
+                include_execution=True,
+                performance=performance,
+                return_raw=format == "raw",
+            )
 
             duration_ms = int((time.time() - t0) * 1000)
             execution = result.get("execution", {})
@@ -340,7 +309,7 @@ class ExecuteQueryTool(MCPTool):
             # Add debugging information for raw SQL failures
             if q_type == "raw_sql" and "could not determine execution" in str(exc):
                 context.update({
-                    "debug_info": "Raw SQL execution failed - this may be related to FastMCP async/concurrency handling",
+                    "debug_info": "Raw SQL execution failed - check template query configuration and API key",
                     "template_query_id": template_id_value,
                     "environment_vars": {
                         "SPICE_RAW_SQL_QUERY_ID": os.getenv("SPICE_RAW_SQL_QUERY_ID"),
@@ -366,7 +335,7 @@ class ExecuteQueryTool(MCPTool):
             query_id = dune_urls.get_query_id(query)
             headers = {
                 "X-Dune-API-Key": dune_urls.get_api_key(),
-                "User-Agent": dune_extract.get_user_agent(),
+                "User-Agent": get_dune_user_agent(),
             }
             resp = self._http.request(
                 "GET",
@@ -395,7 +364,7 @@ class ExecuteQueryTool(MCPTool):
                 url = dune_urls.get_execution_status_url(execution_id)
                 headers = {
                     "X-Dune-API-Key": dune_urls.get_api_key(),
-                    "User-Agent": dune_extract.get_user_agent(),
+                    "User-Agent": get_dune_user_agent(),
                 }
                 resp = self._http.request("GET", url, headers=headers, timeout=10.0)
                 data = resp.json()

spice_mcp-0.1.4.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: spice-mcp
+Version: 0.1.4
+Summary: MCP server for Dune Analytics data access
+Author-email: Evan-Kim2028 <ekcopersonal@gmail.com>
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: aiohttp>=3.9.5
+Requires-Dist: fastmcp>=0.3.0
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: polars>=1.35.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich-argparse>=1.5.2
+Requires-Dist: rich>=13.3.3
+Description-Content-Type: text/markdown
+
+# spice-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/spice-mcp.svg)](https://pypi.org/project/spice-mcp/)
+<a href="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp/badge" alt="Spice MCP server" />
+</a>
+
+An MCP server that provides AI agents with direct access to [Dune Analytics](https://dune.com/) data. Execute queries, discover schemas and tables, and manage saved queries—all through a clean, type-safe interface optimized for AI workflows.
+
+## Why spice-mcp?
+
+- **Agent-friendly**: Designed for AI agents using the Model Context Protocol (MCP)
+- **Efficient**: Polars-first pipeline keeps data lazy until needed, reducing memory usage
+- **Discovery**: Built-in tools to explore Dune's extensive blockchain datasets
+- **Type-safe**: Fully typed parameters and responses with FastMCP
+- **Reproducible**: Automatic query history logging and SQL artifact storage
+
+## Quick Start
+
+1. **Install**:
+   ```bash
+   uv pip install spice-mcp
+   ```
+
+2. **Set API key** (choose one method):
+   - **Option A**: Create a `.env` file in your project root:
+     ```bash
+     echo "DUNE_API_KEY=your-api-key-here" > .env
+     ```
+   - **Option B**: Export in your shell:
+     ```bash
+     export DUNE_API_KEY=your-api-key-here
+     ```
+
+3. **Use with Cursor IDE**:
+   Add to Cursor Settings → MCP Servers:
+   ```json
+   {
+     "name": "spice-mcp",
+     "command": "spice-mcp",
+     "env": {
+       "DUNE_API_KEY": "your-dune-api-key-here"
+     }
+   }
+   ```
+
+**Note**: Query history logging is enabled by default. Logs are saved to `logs/queries.jsonl` (or `~/.spice_mcp/logs/queries.jsonl` if not in a project directory). To customize paths, set `SPICE_QUERY_HISTORY` and `SPICE_ARTIFACT_ROOT` environment variables.
+
+## Core Tools
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `dune_query` | Execute queries by ID, URL, or raw SQL | `query` (str), `parameters` (object), `limit` (int), `offset` (int), `format` (`preview\|raw\|metadata\|poll`), `refresh` (bool), `timeout_seconds` (float) |
+| `dune_query_info` | Get metadata for a saved query | `query` (str - ID or URL) |
+| `dune_discover` | Unified discovery across Dune API and Spellbook | `keyword` (str\|list), `schema` (str), `limit` (int), `source` (`dune\|spellbook\|both`), `include_columns` (bool) |
+| `dune_find_tables` | Search schemas and list tables | `keyword` (str), `schema` (str), `limit` (int) |
+| `dune_describe_table` | Get column metadata for a table | `schema` (str), `table` (str) |
+| `spellbook_find_models` | Search Spellbook dbt models | `keyword` (str\|list), `schema` (str), `limit` (int), `include_columns` (bool) |
+| `dune_health_check` | Verify API key and configuration | (no parameters) |
+| `dune_query_create` | Create a new saved query | `name` (str), `query_sql` (str), `description` (str), `tags` (list), `parameters` (list) |
+| `dune_query_update` | Update an existing saved query | `query_id` (int), `name` (str), `query_sql` (str), `description` (str), `tags` (list), `parameters` (list) |
+| `dune_query_fork` | Fork an existing saved query | `source_query_id` (int), `name` (str) |
+
+## Resources
+
+- `spice:history/tail/{n}` — View last N lines of query history (1-1000)
+- `spice:artifact/{sha}` — Retrieve stored SQL by SHA-256 hash
+
+## What is Dune?
+
+[Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API. It aggregates on-chain data from Ethereum, Solana, Polygon, and other chains into queryable SQL tables. See the [Dune Docs](https://dune.com/docs) for more information.
+
+## Installation
+
+**From PyPI** (recommended):
+```bash
+uv pip install spice-mcp
+```
+
+**From source**:
+```bash
+git clone https://github.com/Evan-Kim2028/spice-mcp.git
+cd spice-mcp
+uv sync
+uv pip install -e .
+```
+
+**Requirements**: Python 3.13+
+
+## Documentation
+
+- [Tool Reference](docs/tools.md) — Complete tool documentation with parameters
+- [Architecture](docs/architecture.md) — Code structure and design patterns
+- [Discovery Guide](docs/discovery.md) — How to explore Dune schemas and tables
+- [Dune API Guide](docs/dune_api.md) — Understanding Dune's data structure
+- [Configuration](docs/config.md) — Environment variables and settings
+
+## License
+
+See [LICENSE](LICENSE) file for details.

{spice_mcp-0.1.2.dist-info → spice_mcp-0.1.4.dist-info}/RECORD

@@ -1,39 +1,41 @@
 spice_mcp/__init__.py,sha256=SpDcj8yU1fpT2YZCqal1R3KLZpBty3w--6bkmrmWU6o,55
-spice_mcp/config.py,sha256=edQvaksAPhOcOSvT-_KUYKvnWyGAwxbSFMO7dvfsGU0,2712
+spice_mcp/config.py,sha256=QX-c3veCFEoKjXIHsEX1_Kt4kjrd7tmrdTiOLFS5pSw,2766
 spice_mcp/polars_utils.py,sha256=hCw3M_iZhTFdBnfmcx2SN8J8jpoucfJnpX_ZrXz6JwY,442
 spice_mcp/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 spice_mcp/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/adapters/http_client.py,sha256=CYgSKAsx-5c-uxaNIBCBTgQdaoBe5J3dJvnw8iqda34,5033
-spice_mcp/adapters/dune/__init__.py,sha256=8HRHPxkz0y2cyHSs4oCkHq_LQaUW5MBevbeNxM9RZvo,372
+spice_mcp/adapters/dune/__init__.py,sha256=nspEuDpVOktAxm8B066s-d0LwouCYGpvNEexi0mRMN8,386
 spice_mcp/adapters/dune/admin.py,sha256=yxOueVz-rmgC-ZFbT06k59G24yRgYjiEkZlall5hXNQ,3157
-spice_mcp/adapters/dune/cache.py,sha256=7UmmxpBNeSGPH3KYBBSPHlVXCpiZUi4-X300U2FsSBs,5252
-spice_mcp/adapters/dune/client.py,sha256=JPrQZ_dtaPcGf6lYUguDxGweOtxG-8qMqOiXuhWL9QA,9122
-spice_mcp/adapters/dune/extract.py,sha256=frIFRUNJ99UlP26N9F-p1psX-e_TVq9vJTQxh0MBCr8,48510
+spice_mcp/adapters/dune/cache.py,sha256=7ykT58WN1yHGIN2uV3t7fWOqGb1VJdCvf3I-xZwsv74,4304
+spice_mcp/adapters/dune/client.py,sha256=4-Ay2FQf_vo-eB6I9Kul3f1PgS78PPuUJ7zldebOtKU,9424
+spice_mcp/adapters/dune/extract.py,sha256=30D-5NyiOXDtMZoo1dU9pf5yAAFR_ALn6JWvhipPRG0,30405
 spice_mcp/adapters/dune/helpers.py,sha256=BgDKr_g-UqmU2hoMb0ejQZHta_NbKwR1eDJp33sJYNk,227
+spice_mcp/adapters/dune/query_wrapper.py,sha256=Km64otc00u9ieUhpZmL2aNYb9ETt6PoNb8czShIuPbY,2925
 spice_mcp/adapters/dune/transport.py,sha256=eRP-jPY2ZXxvTX9HSjIFqFUlbIzXspgH95jBFoTlpaQ,1436
 spice_mcp/adapters/dune/types.py,sha256=57TMX07u-Gq4BYwRAuZV0xI81nVXgtpp7KBID9YbKyQ,1195
 spice_mcp/adapters/dune/typing_utils.py,sha256=EpWneGDn-eQdo6lkLuESR09KXkDj9OqGz8bEF3JaFkM,574
 spice_mcp/adapters/dune/urls.py,sha256=bcuPERkFQduRTT2BrgzVhoFrMn-Lkvw9NmktcBZYEig,3902
+spice_mcp/adapters/dune/user_agent.py,sha256=c6Kt4zczbuT9mapDoh8-3sgm268MUtvyIRxDF9yJwXQ,218
+spice_mcp/adapters/spellbook/__init__.py,sha256=D2cdVtSUbmAJdbPRvAyKxYS4-wUQ3unXyX4ZFYxenuk,150
+spice_mcp/adapters/spellbook/explorer.py,sha256=Q3UfEGlALizCDeeW_ZZVRRedzwMXiknmxwSkeOnxxgc,11515
 spice_mcp/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/core/errors.py,sha256=jlfTuyRaAaA_oU07KUk-1pDAAa43KG0BbZc5CINXtoE,3256
-spice_mcp/core/models.py,sha256=2AgAPcaDPEXLdka1E6-0cXN_QNsN2rnDoBnDTDDsO6I,2121
-spice_mcp/core/ports.py,sha256=-wtWjpYSjL-qugUtsm0MTngtJZWzr7QNDbAUCj4BTS0,2028
+spice_mcp/core/models.py,sha256=i0C_-UE16OWyyZo_liooEJeYvbChE5lpK80aN2OF4lk,1795
+spice_mcp/core/ports.py,sha256=nEdeA3UH7v0kB_hbguMrpDljb9EhSxUAO0SdhjpoijQ,1618
 spice_mcp/logging/query_history.py,sha256=doE9lod64uzJxlA2XzHH2-VAmC6WstYAkQ0taEAxiIM,4315
 spice_mcp/mcp/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-spice_mcp/mcp/server.py,sha256=RtvK0u9Q3dp3JMALrVFL43Li1lKdaQwLvtZuoo0pkbY,18082
+spice_mcp/mcp/server.py,sha256=lHYEI76oQpPcpPT9pEoGXpUmAjDFXlOXuUrlOWV8s2c,28729
 spice_mcp/mcp/tools/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-spice_mcp/mcp/tools/base.py,sha256=Xw8k5WAXotCdZRd-cVJIFPH87JH8DH0sh1zKu-KmW3w,1047
-spice_mcp/mcp/tools/execute_query.py,sha256=y2HU3Cv6T7QBXBDMea0TlXcf8_ERkq2sJeaexR6kBXE,17556
-spice_mcp/mcp/tools/sui_package_overview.py,sha256=a1CcpfBzEFzScjXgxLu9urxdtSbXjF98ugWPOX167rc,1736
+spice_mcp/mcp/tools/base.py,sha256=zJkVxLgXR48iZcJeng8cZ2rXvbyicagoGlMN7BK7Img,1041
+spice_mcp/mcp/tools/execute_query.py,sha256=CJtoNKpRY6pCkyqjwFy_cTYqTIg9-EsZA8GrH-2MFjk,16262
 spice_mcp/observability/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/observability/logging.py,sha256=ceJUEpKGpf5PAgPBmpB49zjqhdGCAESfLemFUhDSmI8,529
 spice_mcp/service_layer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/service_layer/discovery_service.py,sha256=202O0SzCZGQukd9kb2JYfarLygZHgiXlHqp_nTAdrWA,730
 spice_mcp/service_layer/query_admin_service.py,sha256=4q1NAAuTui7cm83Aq2rFDLIzKTHX17yzbSoSJyCmLbI,1356
 spice_mcp/service_layer/query_service.py,sha256=q0eAVW5I3sUxm29DgzPN_cH3rZEzmKwmdE3Xj4qP9lI,3878
-spice_mcp/service_layer/sui_service.py,sha256=G-LOsl-z-ldMxAYAetnG17IQlpVtLchGUjN6opU-PF0,4712
-spice_mcp-0.1.2.dist-info/METADATA,sha256=TB63rlJQOinwNKj3XvevK0OLLF2Ic0xYmeLU_kaiuas,9316
-spice_mcp-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-spice_mcp-0.1.2.dist-info/entry_points.txt,sha256=4XiXX13Vy-oiUJwlcO_82OltBaxFnEnkJ-76sZGm5os,56
-spice_mcp-0.1.2.dist-info/licenses/LICENSE,sha256=r0GNDnDY1RSkVQp7kEEf6MQU21OrNGJkxUHIsv6eyLk,1079
-spice_mcp-0.1.2.dist-info/RECORD,,
+spice_mcp-0.1.4.dist-info/METADATA,sha256=MyGS87Cwkx0G5urib8a2JbqZVP4stYdGeVknRxzPw5A,5053
+spice_mcp-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+spice_mcp-0.1.4.dist-info/entry_points.txt,sha256=4XiXX13Vy-oiUJwlcO_82OltBaxFnEnkJ-76sZGm5os,56
+spice_mcp-0.1.4.dist-info/licenses/LICENSE,sha256=r0GNDnDY1RSkVQp7kEEf6MQU21OrNGJkxUHIsv6eyLk,1079
+spice_mcp-0.1.4.dist-info/RECORD,,

spice_mcp/mcp/tools/sui_package_overview.py

@@ -1,56 +0,0 @@
-from __future__ import annotations
-
-from typing import Any
-
-from ...core.errors import error_response
-from ...service_layer.sui_service import SuiService
-from .base import MCPTool
-
-
-class SuiPackageOverviewTool(MCPTool):
-    """Overview of Sui packages: events, transactions, objects (small preview)."""
-
-    def __init__(self, sui_service: SuiService):
-        self.sui_service = sui_service
-
-    @property
-    def name(self) -> str:
-        return "sui_package_overview"
-
-    @property
-    def description(self) -> str:
-        return (
-            "Return a compact overview (counts + previews) of Sui package activity "
-            "over a time window, with polling timeouts."
-        )
-
-    def get_parameter_schema(self) -> dict[str, Any]:
-        return {
-            "type": "object",
-            "properties": {
-                "packages": {"type": "array", "items": {"type": "string"}},
-                "hours": {"type": "integer", "default": 72},
-                "timeout_seconds": {"type": "number", "default": 30},
-            },
-            "required": ["packages"],
-            "additionalProperties": False,
-        }
-
-    async def execute(
-        self, *, packages: list[str], hours: int = 72, timeout_seconds: float | None = 30
-    ) -> dict[str, Any]:
-        try:
-            return self.sui_service.package_overview(
-                packages,
-                hours=hours,
-                timeout_seconds=timeout_seconds,
-            )
-        except Exception as exc:
-            return error_response(
-                exc,
-                context={
-                    "tool": "sui_package_overview",
-                    "packages": packages,
-                    "hours": hours,
-                },
-            )

spice_mcp/service_layer/sui_service.py

@@ -1,131 +0,0 @@
-from __future__ import annotations
-
-import time
-
-from .query_service import QueryService
-
-
-class SuiService:
-    """Opinionated helpers for Sui package exploration."""
-
-    def __init__(self, query_service: QueryService):
-        self.query_service = query_service
-
-    def events_preview(
-        self, packages: list[str], *, hours: int = 72, limit: int = 50, performance: str = "large"
-    ) -> dict[str, object]:
-        now_ms = int(time.time() * 1000)
-        start_ms = now_ms - hours * 3600 * 1000
-
-        norms = _normalize_packages(packages)
-        if norms:
-            preds = [f"lower(event_type) LIKE '{pkg}::%'" for pkg in norms]
-            where = " OR ".join(preds)
-            sql = (
-                "SELECT timestamp_ms, package, module, event_type FROM sui.events "
-                f"WHERE ({where}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC "
-                f"LIMIT {limit}"
-            )
-        else:
-            sql = (
-                "SELECT timestamp_ms, package, module, event_type FROM sui.events "
-                f"WHERE timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC LIMIT {limit}"
-            ).format(limit=limit)
-
-        result = self.query_service.execute(
-            sql,
-            performance=performance,
-            timeout_seconds=60,
-            limit=limit,
-        )
-        return {
-            "rowcount": result["rowcount"],
-            "columns": result["columns"],
-            "data_preview": result["data_preview"],
-        }
-
-    def package_overview(
-        self,
-        packages: list[str],
-        *,
-        hours: int = 72,
-        timeout_seconds: float | None = 30,
-        performance: str = "large",
-    ) -> dict[str, object]:
-        now_ms = int(time.time() * 1000)
-        start_ms = now_ms - hours * 3600 * 1000
-        norms = _normalize_packages(packages)
-        in_clause = ",".join(f"'{pkg}'" for pkg in norms)
-
-        out: dict[str, object] = {"ok": True}
-
-        def _run(sql: str, limit: int) -> dict[str, object]:
-            return self.query_service.execute(
-                sql,
-                performance=performance,
-                timeout_seconds=timeout_seconds,
-                limit=limit,
-            )
-
-        # Events
-        try:
-            sql_ev = (
-                "SELECT timestamp_ms, package, module, event_type, event_json FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC LIMIT 200"
-            )
-            ev = _run(sql_ev, 200)
-            out["events_preview"] = ev.get("data_preview")
-            out["events_count"] = ev.get("rowcount")
-        except TimeoutError:
-            out["events_timeout"] = True
-        except Exception as exc:
-            out["events_error"] = str(exc)
-
-        # Transactions
-        try:
-            sql_tx = (
-                "WITH txs AS (SELECT DISTINCT transaction_digest FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms}) "
-                "SELECT t.* FROM sui.transactions t "
-                "JOIN txs ON t.transaction_digest = txs.transaction_digest "
-                "ORDER BY t.timestamp_ms DESC LIMIT 200"
-            )
-            tx = _run(sql_tx, 200)
-            out["transactions_preview"] = tx.get("data_preview")
-            out["transactions_count"] = tx.get("rowcount")
-        except TimeoutError:
-            out["transactions_timeout"] = True
-        except Exception as exc:
-            out["transactions_error"] = str(exc)
-
-        # Objects
-        try:
-            sql_ob = (
-                "WITH txs AS (SELECT DISTINCT transaction_digest FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms}) "
-                "SELECT o.* FROM sui.objects o "
-                "WHERE o.previous_transaction IN (SELECT transaction_digest FROM txs) "
-                "ORDER BY o.timestamp_ms DESC LIMIT 200"
-            )
-            ob = _run(sql_ob, 200)
-            out["objects_preview"] = ob.get("data_preview")
-            out["objects_count"] = ob.get("rowcount")
-        except TimeoutError:
-            out["objects_timeout"] = True
-        except Exception as exc:
-            out["objects_error"] = str(exc)
-
-        return out
-
-
-def _normalize_packages(packages: list[str]) -> list[str]:
-    norms: list[str] = []
-    for p in packages:
-        value = p.lower()
-        if not value.startswith("0x"):
-            value = "0x" + value
-        norms.append(value)
-    return norms