> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Home

> BlockDB Documentation Hub — quality DeFi data: verifiable, real-time, complete.

{/* Page wrapper aligned to nav */}

<div className="mx-auto w-full max-w-7xl px-6 lg:px-8">
  {/* ======= Hero (full width, no left blue edge) ======= */}
</div>

<section
  data-theme-immutable="true"
  className="relative w-full h-60 lg:h-[20rem] overflow-hidden"
  style={{
backgroundColor: '#0B1220',
backgroundImage: [
  // brand gradient sweep
  'linear-gradient(270deg, #739cf4 0%, #343ced 45%, #0B1220 100%)',
  // soft glow at top-right
  'radial-gradient(1200px 360px at 92% 8%, rgba(125,188,249,0.35) 0%, rgba(125,188,249,0.15) 35%, rgba(125,188,249,0) 70%)',
  // subtle diagonal texture
  'repeating-linear-gradient(-12deg, rgba(255,255,255,0.05) 0px, rgba(255,255,255,0.05) 1px, rgba(255,255,255,0) 1px, rgba(255,255,255,0) 18px)'
].join(','),
backgroundRepeat: 'no-repeat',
backgroundSize: 'cover',
}}
>
  {/* Decorative polygons - adjusted to remove left line */}

  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 323" preserveAspectRatio="none" className="absolute bottom-0 left-0 w-full h-auto opacity-80">
    <polygon fill="#ffffff" style={{ fillOpacity: 0.06 }} points="0,322 0,121 658,212" />

    <polygon fill="#ffffff" style={{ fillOpacity: 0.10 }} points="0,323 1920,323 1920,0" />
  </svg>

  {/* Centered content */}

  <div className="relative z-10 h-full flex items-center justify-center">
    <div className="text-center px-6">
      <h1 className="text-3xl md:text-4xl font-extrabold tracking-tight text-white">
        Welcome to BlockDB Documentation
      </h1>

      <p className="mt-3 text-lg md:text-xl text-white/85">
        Build with verifiable, real-time, and complete DeFi data across chains.
      </p>
    </div>
  </div>
</section>

{/* Content Area (aligned to nav) */}

<div className="mx-auto w-full max-w-8xl px-4 sm:px-6 lg:px-12">
  {/* ======= Overview ======= */}

  <section className="mt-12 max-w-3xl">
    <h2 className="text-2xl font-bold text-gray-900 dark:text-white">Knowledge Base</h2>

    <p className="mt-2 text-gray-600 dark:text-gray-300">
      Everything you need to deploy BlockDB, integrate programmatically, and trace rows back to on-chain evidence.
    </p>
  </section>

  {/* ======= Onboarding CTA ======= */}

  <section className="mt-8">
    <div className="relative overflow-hidden rounded-xl border border-gray-200 dark:border-gray-800">
      {/* Solid color background (replaces image) */}

      <div className="absolute inset-0" style={{ backgroundColor: '#3057e7' }} />

      <div className="absolute inset-0 bg-black/10 dark:bg-black/30" />

      <div className="relative z-10 p-6 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
        <div className="max-w-2xl">
          <h2 className="text-white font-semibold">👋 New to BlockDB?</h2>

          <p className="text-white/90">
            Follow the quickstart to connect, authenticate, and run your first query in minutes.
          </p>
        </div>

        <a href="/user-guide/about-blockdb/quick-start-guide" className="inline-flex items-center gap-2 rounded-xl bg-white px-4 py-2 font-medium text-black shadow-lg hover:opacity-95">
          Get Started

          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
            <path d="m9 18 6-6-6-6" />
          </svg>
        </a>
      </div>
    </div>
  </section>

  {/* ======= Primary actions ======= */}

  <section className="mt-12">
    <Columns cols={3} className="gap-6 sm:gap-8">
      <Card icon="database" href="/data-catalog/overview/introduction">
        <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Data Catalog
        </h3>

        <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Browse entities and tables with stable schemas and tracing fields across supported chains.
        </span>
      </Card>

      <Card icon="rocket" href="/user-guide/about-blockdb/quick-start-guide">
        <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Quick Start Guide
        </h3>

        <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Follow the quickstart to connect, authenticate, and run your first query in minutes.
        </span>
      </Card>

      <Card icon="laptop-code" href="/user-guide/query-examples">
        <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Query Cookbook
        </h3>

        <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
          Copy-ready SQL and REST patterns for common DeFi analytics.
        </span>
      </Card>
    </Columns>
  </section>

  {/* ======= APIs ======= */}

  <section className="mt-12">
    <h2 className="text-2xl font-bold text-gray-900 dark:text-white">API Endpoints</h2>
    <p className="mt-2 text-gray-600 dark:text-gray-300">Programmatic access for pipelines, dashboards, and apps.</p>

    <div className="mt-4">
      <Columns cols={3} className="gap-6 sm:gap-8">
        <Card icon="cloud" href="/api-reference/overview/home">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            REST API
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Endpoints, parameters, pagination, and error semantics.
          </span>
        </Card>

        <Card icon="rss" href="/wss-reference/overview/introduction">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            WebSocket (WSS)
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Real-time streams for blocks, swaps, and reserves.
          </span>
        </Card>

        <Card icon="key" href="/api-reference/overview/authorization">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Auth & Rate Limits
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            API keys, headers, quotas, and retry guidance.
          </span>
        </Card>
      </Columns>
    </div>
  </section>

  {/* ======= Datasets ======= */}

  <section className="mt-12">
    <h2 className="text-2xl font-bold text-gray-900 dark:text-white">Datasets</h2>
    <p className="mt-2 text-gray-600 dark:text-gray-300">Start with canonical references, then drill into raw blocks and token analytics.</p>

    <div className="mt-4">
      <Columns cols={3} className="gap-6 sm:gap-8">
        <Card icon="table-columns" href="/data-catalog/evm/dataset-index">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Dataset Index
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Complete list of published datasets and SQL table names.
          </span>
        </Card>

        <Card icon="square-binary" href="/data-catalog/evm/primitives/blocks">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Raw Data
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Blocks, transactions, receipts, and decoded logs.
          </span>
        </Card>

        <Card icon="hexagon-vertical-nft" href="/data-catalog/evm/entities/erc20-tokens">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Tokens & Pools
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Token metadata, pool registries, and standardized identifiers.
          </span>
        </Card>

        <Card icon="coins" href="/data-catalog/evm/reserves/liquidity-pools-reserves">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Reserves
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Historical on-chain reserves with slot-level provenance.
          </span>
        </Card>

        <Card icon="tag" href="/data-catalog/evm/prices/token-to-token-prices-swap-prints">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Pricing
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Swap prints, OHLC, VWAP, and USD benchmarks from on-chain activity.
          </span>
        </Card>

        <Card icon="chart-line" href="/data-catalog/evm/prices/token-to-token-vwap">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Pricing Analytics
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            VWAP, spreads, and liquidity-aware analytics.
          </span>
        </Card>
      </Columns>
    </div>
  </section>

  {/* ======= Help ======= */}

  <section className="mt-12 mb-16">
    <h2 className="text-2xl font-bold text-gray-900 dark:text-white">Troubleshooting & Support</h2>
    <p className="mt-2 text-gray-600 dark:text-gray-300">Resolve common issues quickly or contact the team at <a href="https://www.blockdb.io" className="underline hover:opacity-80">blockdb.io</a>.</p>

    <div className="mt-4">
      <Columns cols={3} className="gap-6 sm:gap-8">
        <Card icon="gear-complex-code" href="/troubleshooting/home">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Troubleshooting
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Connection, auth, schema, and performance fixes.
          </span>
        </Card>

        <Card icon="sparkles" href="/release-notes/home">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Release Notes
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            What's new, improvements, and breaking changes.
          </span>
        </Card>

        <Card icon="info" href="/troubleshooting/raising-a-support-ticket">
          <h3 className="text-base font-semibold text-gray-900 dark:text-white underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Support
          </h3>

          <span className="underline underline-offset-4 decoration-[#4B72E9]" style={{ textDecorationColor: '#4B72E9' }}>
            Get help from BlockDB engineers.
          </span>
        </Card>
      </Columns>
    </div>
  </section>
</div>