欢迎使用 BlockDB
BlockDB 是专为区块链设计的逻辑多模型数据库。它在底层（在线表）提供标准在线数据库的存储能力，在逻辑层提供开箱即用的链上语义表（Block 表）。核心能力
- 高性能在线表：Blockdb从逻辑层对OLTP物理表的读写操作进行约束和针对优化，使得区块场景的读写的吞吐能力都可达 100 万行/秒级别，可稳定支撑高并发在线应用，快速高效的历史区块回填。
- 逻辑多模型设计：用一套在线存储统一承载普通表、Block State/Event 表与 TimeTable，状态、事件、时间序列不必各建一套存储与 ETL。
- 链上数据特化：通过 Block 表直接查询任意时刻的链上状态，或订阅任何合约的实时变动，无需理解底层复杂的区块回滚（Reorg）和数据管理逻辑。
- 事件订阅能力：通过表的事件订阅，自由处理任何上游表的实时数据，让业务代码像”虚拟智能合约”一样运行在数据库的变更流上。
快速开始
用几步完成 BlockDB 的首次读写与订阅：前往快速开始深入了解
核心概念
BlockDB 把链上数据处理抽象为清晰的概念，从数据模型到写入订阅，帮助你逐步理解它的设计。- BlockDB 是什么：了解 BlockDB 的定义、两层模型与核心能力。
- 数据模型：理解 Table、BlockTable、TimeTable 与影子表机制。
- Block State 与 Block Event 表：深入两种链上语义表模型及其区块链语义。
- 写入与事件订阅：了解实时写 / 批量写接口与区块订阅事件。
- Time 表：了解按物理时间分桶、内置去重与存储压缩的序列表。
架构介绍
这里介绍 BlockDB 代码的整体架构与组件，帮助你理解服务是如何组织与协作的。使用指南
通过实战掌握 SDK 的读写、订阅与计算接入。- 读写数据：使用 Table / BlockTable / TimeTable 三类表模型读写数据。
- 实时订阅：订阅区块写入事件，构建实时增量消费管道。
- 多表区块高度对齐订阅：用 Aligned 保证多表同高度就绪后再触发。
- 条件筛选与算子管道：用 Column / Operator 构造过滤与去重预处理。
- 配合 BlockX 高并发计算：对海量区块数据做分布式并发计算。
参考
完整的 API 与协议参考。- API 总览：BlockDB gRPC 服务与方法的完整总览。
- Value 与逻辑类型：Value 动态类型与逻辑类型映射。
- 错误码：业务错误码与 gRPC 状态码映射。