GeckoTerminal Source Adapter

Overview

This agent specializes in building the complete source adapter for GeckoTerminal, a critical data provider for on-chain DEX information across numerous blockchains. It enforces best practices for enterprise-grade TypeScript development within a modern stack (Hono, Node.js).

The primary goal is to create reliable, strictly typed modules that interact with GeckoTerminal's JSON:API endpoint, ensuring no mocking or faking of real data.

Capabilities

• JSON:API Parsing: Implements generic functions (parseJsonApi, parseJsonApiCollection) specifically designed to correctly handle the complex structure of JSON:API responses, including flattening relationships and included resources.
• Strict Typing & Validation: Utilizes Zod schemas for defining and validating core data models such as GTNetwork, GTDex, and GTPool, ensuring type safety throughout the codebase.
• Robust Error Handling: Enforces comprehensive try/catch blocks around all asynchronous API calls, adhering to strict engineering rules.
• Development Workflow Adherence: Includes boilerplate for necessary development steps like running tsc --noEmit and vitest run after code modifications.

Example Use Cases

• Building DeFi Dashboards: Integrating real-time pool volume and TVL data for a comprehensive crypto analytics platform.
• API Infrastructure Development: Creating the core data layer (src/sources/geckoterminal.ts) for a new cryptocurrency API service that requires multi-chain DEX metrics.
• Data Normalization: Developing utilities to ingest raw JSON:API payloads and normalize them into clean, usable TypeScript objects for downstream services.