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

# 欢迎使用 BlockDB

> BlockDB 产品文档：专为区块链设计的逻辑多模型数据库。

# 欢迎使用 BlockDB

BlockDB 是专为区块链设计的**逻辑多模型数据库**。它在底层（在线表）提供标准在线数据库的存储能力，在逻辑层提供开箱即用的**链上语义表**（Block 表）。

## 核心能力

* **高性能在线表**：Blockdb从逻辑层对OLTP物理表的读写操作进行约束和针对优化，使得区块场景的读写的吞吐能力都可达 **100 万行/秒**级别，可稳定支撑高并发在线应用，快速高效的历史区块回填。
* **逻辑多模型设计**：用一套在线存储统一承载普通表、Block State/Event 表与 TimeTable，状态、事件、时间序列不必各建一套存储与 ETL。
* **链上数据特化**：通过 Block 表直接查询任意时刻的链上状态，或订阅任何合约的实时变动，无需理解底层复杂的区块回滚（Reorg）和数据管理逻辑。
* **事件订阅能力**：通过表的事件订阅，自由处理任何上游表的实时数据，让业务代码像"虚拟智能合约"一样运行在数据库的变更流上。

## 快速开始

用几步完成 BlockDB 的首次读写与订阅：**[前往快速开始](/zh/quickstart)**

## 深入了解

### 核心概念

BlockDB 把链上数据处理抽象为清晰的概念，从数据模型到写入订阅，帮助你逐步理解它的设计。

* **[BlockDB 是什么](/zh/concepts/overview)**：了解 BlockDB 的定义、两层模型与核心能力。
* **[数据模型](/zh/concepts/data-model)**：理解 Table、BlockTable、TimeTable 与影子表机制。
* **[Block State 与 Block Event 表](/zh/concepts/block-tables)**：深入两种链上语义表模型及其区块链语义。
* **[写入与事件订阅](/zh/concepts/write-subscribe)**：了解实时写 / 批量写接口与区块订阅事件。
* **[Time 表](/zh/concepts/time-table)**：了解按物理时间分桶、内置去重与存储压缩的序列表。

### 架构介绍

这里介绍 BlockDB 代码的整体架构与组件，帮助你理解服务是如何组织与协作的。

* **[架构总览](/zh/architecture/overview)**：了解 BlockDB 的整体架构、服务拓扑与数据流。
* **[组件介绍](/zh/architecture/components)**：查看 BlockDB 代码中的组件与模块目录。

### 使用指南

通过实战掌握 SDK 的读写、订阅与计算接入。

* **[读写数据](/zh/guides/data-access)**：使用 Table / BlockTable / TimeTable 三类表模型读写数据。
* **[实时订阅](/zh/guides/subscribe)**：订阅区块写入事件，构建实时增量消费管道。
* **[多表区块高度对齐订阅](/zh/guides/multi-table-alignment)**：用 Aligned 保证多表同高度就绪后再触发。
* **[条件筛选与算子管道](/zh/guides/filter-operator)**：用 Column / Operator 构造过滤与去重预处理。
* **[配合 BlockX 高并发计算](/zh/guides/blockx)**：对海量区块数据做分布式并发计算。

### 参考

完整的 API 与协议参考。

* **[API 总览](/zh/reference/api)**：BlockDB gRPC 服务与方法的完整总览。
* **[Value 与逻辑类型](/zh/reference/value-types)**：Value 动态类型与逻辑类型映射。
* **[错误码](/zh/reference/errors)**：业务错误码与 gRPC 状态码映射。


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