> ## 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 ═════════════════════╗
                            ║                                                   ║░
╔═══════════════╗           ║   ╔═══════════╗    ╔══════════╗    ╔════════════╗ ║░          ╔══════════════════╗
║ 100+ Chains   ║░          ║   ║ Bronze    ║    ║ Silver   ║    ║ Gold       ║ ║░          ║ Delivery         ║░
║               ║░          ║   ║           ║ ─▶ ║          ║ ─▶ ║            ║ ║░          ║                  ║░
║ raw RPC       ║░ ─index─▶ ║   ║ Raw       ║    ║ Decode & ║    ║ Structured ║ ║░ ─serve─▶ ║ Foundational API ║░
║ logs · traces ║░          ║   ║ ingestion ║    ║ enrich   ║    ║ data       ║ ║░          ╚══════════════════╝░
╚═══════════════╝░          ║   ╚═══════════╝    ╚══════════╝    ╚════════════╝ ║░           ░░░░░░░░░░░░░░░░░░░░
 ░░░░░░░░░░░░░░░░░          ║                                                   ║░
                            ╚═══════════════════════════════════════════════════╝░
                             ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
```

## Raw Data vs Refined Data

> [card] Raw RPC Data
>
> 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] GoldRush Refined Data
>
> 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

## The Medallion Layers

**1. 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.

**2. 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.

**3. 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 |

## Access Refined Data Your Way

The same refined data are available via the Foundational API:

> [card] [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview.md)
>
> **Pull historical data via REST.**
> Query structured balances, transactions, decoded events, and NFT data across 100+ chains. Ideal for wallets, dashboards, and analytics.

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.