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

# The Medallion Architecture

> GoldRush delivers refined, structured blockchain data - not raw RPC responses. Learn how our medallion architecture transforms raw chain data into application-ready and analytics-ready data like DEX swaps, stablecoin transfers, and decoded events.

Most blockchain data providers give you raw RPC data and leave the hard part to you: decoding logs, resolving token metadata, scaling decimals, attaching USD and fiat prices, and classifying transaction types. GoldRush takes a different approach.

We process raw chain data through the **medallion architecture** - bronze, silver, and gold layers - so you receive clean, structured, application-ready and analytics-ready data out of the box.

```
                            ╔═ GoldRush Medallion Pipeline ═════════════════════╗
                            ║                                                   ║░          ╔══════════════════╗
╔═══════════════╗           ║   ╔═══════════╗    ╔══════════╗    ╔════════════╗ ║░          ║ Delivery         ║░
║ 100+ Chains   ║░          ║   ║ Bronze    ║    ║ Silver   ║    ║ Gold       ║ ║░          ║                  ║░
║               ║░          ║   ║           ║ ─▶ ║          ║ ─▶ ║            ║ ║░          ║ Foundational API ║░
║ raw RPC       ║░ ─index─▶ ║   ║ Raw       ║    ║ Decode & ║    ║ Structured ║ ║░ ─serve─▶ ║ Streaming API    ║░
║ logs · traces ║░          ║   ║ ingestion ║    ║ enrich   ║    ║ data       ║ ║░          ║ Pipeline API     ║░
╚═══════════════╝░          ║   ╚═══════════╝    ╚══════════╝    ╚════════════╝ ║░          ╚══════════════════╝░
 ░░░░░░░░░░░░░░░░░          ║                                                   ║░           ░░░░░░░░░░░░░░░░░░░░
                            ╚═══════════════════════════════════════════════════╝░
                             ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
```

## Raw Data vs Refined Data

<Columns cols={2}>
  <Card title="Raw RPC Data" icon="cube">
    What you get from a node or raw data provider:

    * Hex-encoded log topics and data fields
    * No token names, symbols, or decimals
    * Amounts in wei (18-decimal integers)
    * No USD/Fiat pricing
    * No transaction classification
    * You build and maintain the decoding pipeline
  </Card>

  <Card title="GoldRush Refined Data" icon="gem">
    What you get from GoldRush:

    * Human-readable decoded event logs
    * Full token metadata (name, symbol, decimals, logo)
    * Scaled, human-readable amounts
    * Spot and historical USD pricing
    * Transaction type classification (swap, transfer, bridge, etc.)
    * Spam token filtering
  </Card>
</Columns>

## The Medallion Layers

<Steps>
  <Step title="Bronze - Raw Ingestion">
    We index every block, transaction, receipt, log, and trace from genesis to the latest block across 100+ chains. This is the raw, unprocessed chain data - the foundation everything else is built on.
  </Step>

  <Step title="Silver - Decoding & Enrichment">
    Raw logs are decoded using verified ABIs. Token metadata is resolved. Amounts are scaled to human-readable values. USD prices are attached at the time of the transaction. Internal transfers and traces are extracted. DEX trades are decoded. Spam tokens are flagged and filtered.
  </Step>

  <Step title="Gold - Structured Data">
    Decoded events are classified into high-level data types that map directly to business logic:

    | Data                     | Description                                                    | Example Fields                                                   |
    | ------------------------ | -------------------------------------------------------------- | ---------------------------------------------------------------- |
    | **DEX Swaps**            | Token-to-token trades on decentralized exchanges               | `token_in`, `token_out`, `amount_in`, `amount_out`, pool address |
    | **Token Transfers**      | ERC20, ERC721, ERC1155, and native token movements             | `from`, `to`, `amount`, `quote_usd`, token metadata              |
    | **Stablecoin Transfers** | USDC, USDT, DAI and other stablecoin movements with USD values | `from`, `to`, `amount`, `quote_usd`, stablecoin metadata         |
    | **OHLCV Price Data**     | Open/High/Low/Close/Volume candles derived from DEX trades     | Token or pair, configurable intervals, real-time updates         |
  </Step>
</Steps>

## Access Refined Data Your Way

The same refined data are available through multiple delivery methods, depending on your use case:

<CardGroup cols={3}>
  <Card title="Foundational API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/foundational.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=8a0b97060449218c1b477fe1fffc8a92" href="/goldrush-foundational-api/overview" width="24" height="24" data-path="images/icons/foundational.svg">
    **Pull historical data via REST.**
    Query structured balances, transactions, decoded events, and NFT data across 100+ chains. Ideal for wallets, dashboards, and analytics.
  </Card>

  <Card title="Streaming API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/streaming.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=c4a22e003bde989c0cd2d01a67bd6adf" href="/goldrush-streaming-api/overview" width="24" height="24" data-path="images/icons/streaming.svg">
    **Push real-time data via WebSockets.**
    Subscribe to live DEX swaps, token transfers, price feeds, and wallet activity with sub-second latency. Ideal for trading bots and alerting.
  </Card>

  <Card title="Pipeline API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/pipeline.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=f0027120a50c03e5660514e94a26cabb" width="24" height="24" data-path="images/icons/pipeline.svg">
    Continuous delivery of refined blockchain data directly to your Snowflake, BigQuery, or S3 - no API calls needed. Ideal for analytics teams and data science.
  </Card>
</CardGroup>

## Why This Matters

Building a decoding and enrichment pipeline yourself means:

* **Maintaining ABI registries** across hundreds of protocols and thousands of contracts
* **Tracking token metadata** that changes over time (rebrands, migrations, decimals)
* **Building price oracles** or integrating multiple pricing feeds
* **Classifying transactions** by type - a swap on Uniswap V2 looks completely different from one on Uniswap V3, Curve, or Balancer
* **Handling chain-specific quirks** - each of 100+ chains has its own edge cases

GoldRush handles all of this so you can focus on your product, not your data pipeline.