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

# Logs

> Every smart contract event log across Ethereum & EVM chains — RLP-verified. The source for DeFi, NFT, and token analytics.

## Overview

* **Dataset ID:** `0103`
* **Table:** `blockdb_evm.b0103_logs_v1`
* **Description:** Event logs emitted by contract transactions
* **Primary key:** `(block_number, tx_index, log_index)`
* **API:** [POST /evm/raw/logs](/api-reference/evm/primitives/logs)
* **CSV Sample:** [Download](https://huggingface.co/datasets/BlockDB/Raw-Logs-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0103_logs_v1.csv?download=true)
* **JSON Sample:** [Download](https://huggingface.co/datasets/BlockDB/Raw-Logs-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0103_logs_v1.json?download=true)

## Sample Viewer

<Frame>
  <iframe src="https://huggingface.co/datasets/BlockDB/Raw-Logs-Ethereum-And-EVM-Cryptocurrency-Data/embed/viewer/default/train" frameborder="0" width="100%" height="600px" />
</Frame>

## Columns

| Column             | Type          | Description                                                                                       |
| ------------------ | ------------- | ------------------------------------------------------------------------------------------------- |
| `block_number`     | `BIGINT`      | Block height containing this log.                                                                 |
| `block_time`       | `TIMESTAMPTZ` | UTC timestamp of the block.                                                                       |
| `tx_index`         | `INTEGER`     | Zero-based transaction index within the block.                                                    |
| `log_index`        | `INTEGER`     | Position of the log within the transaction; indirectly verified by RLP (All logs must be present) |
| `contract_address` | `BYTEA`       | Address of the contract that emitted the log (20 bytes); directly verified by RLP                 |
| `topic_zero`       | `BYTEA`       | Primary topic hash identifying the event type (32 bytes); directly verified by RLP                |
| `data_topics`      | `BYTEA[]`     | Optional raw concatenation of topics\[1..n] (implementation detail); directly verified by RLP     |
| `data`             | `BYTEA`       | Raw event data; directly verified by RLP                                                          |
| `_tracing_id`      | `BYTEA`       | Tracing ID of the genesis log record.                                                             |
| `_created_at`      | `TIMESTAMPTZ` | Record creation timestamp.                                                                        |
| `_updated_at`      | `TIMESTAMPTZ` | Record last update timestamp.                                                                     |

## Use Cases

* DeFi protocol event tracking (swaps, transfers, mints, burns)
* Token transfer and balance change monitoring
* Smart contract interaction analysis
* Event-driven analytics and alerting systems
* Protocol state reconstruction from events
* Cross-contract event correlation and analysis

## Related Datasets

<CardGroup cols={3}>
  <Card title="Transactions" icon="arrow-right-arrow-left" href="/data-catalog/evm/primitives/transactions">
    Parent transactions that emitted these logs.
  </Card>

  <Card title="Token Transfers" icon="coins" href="/data-catalog/evm/transfers/token-transfers">
    Transfer events decoded from ERC-20/721/1155 logs.
  </Card>

  <Card title="ERC-20 Tokens" icon="circle-dollar-to-slot" href="/data-catalog/evm/entities/erc20-tokens">
    Token metadata for contracts appearing in logs.
  </Card>
</CardGroup>