Zaino 索引器

Zaino 是一个用于 Zcash 区块链的 Rust 索引器。它从 Zebra 全节点读取链上数据，并提供钱包、区块浏览器、水龙头及其他服务所需的数据，而无需让 Zebra 本身负责面向每个客户端的索引。

TL;DR

Zebra 验证 Zcash 链。
Zaino 索引 Zebra 的链上数据，并提供面向客户端的 API。
Zallet 是 Z3 技术栈中的钱包组件。在默认的 Z3 设置中，Zallet 直接与 Zebra 通信，无需独立的 Zaino 服务。
当运营者需要兼容 lightwalletd 的 gRPC 端点、JSON-RPC 代理，或为轻钱包、区块浏览器、水龙头及类似服务提供基础设施时，独立的 Zaino 服务十分有用。
Zaino 是活跃的基础设施，但运营者在生产环境运行前，应查看官方 Zaino 和 Z3 文档以了解当前部署细节。

Zaino 位于 Zebra 与客户端软件之间。Zebra 是共识节点：它下载、验证并跟踪 Zcash 区块链。Zaino 使用 Zebra 作为链上数据来源，然后准备可供客户端应用高效查询的索引视图。

这种分离使各自职责明确：

Zaino 为轻客户端、全客户端或钱包以及区块浏览器提供功能。它提供对已最终确认链、未最终确认的最佳链，以及由 Zebra 持有的内存池数据的访问。

当前的 Z3 技术栈围绕 Zebra、Zallet 和可选的 Zaino 构建。

在默认的 Z3 部署中，Zebra 和 Zallet 一起运行。Zallet 直接访问 Zebra，因此仅运行本地钱包技术栈的运营者不需要启动独立的 Zaino 服务。

当运营者希望服务外部客户端时，会添加 Zaino。在 Z3 中，它运行在 indexer Compose 配置文件之后，并增加：

这使 Zaino 对钱包后端、公共基础设施运营者、区块浏览器、水龙头，以及测试需要已索引 Zcash 链上数据的服务的开发者尤为重要。

lightwalletd 是原始的轻钱包服务器。Zaino 是该角色的 Rust 后继方案。其目标是在可能的情况下提供兼容的 API，使钱包和服务能够迁移，而不必一次性完全重写。

这并不意味着每个 lightwalletd 部署都已迁移至 Zaino。运营者应将 Zaino 视为当前基于 Zebra 的技术栈的一部分，并在决定运行什么之前查看最新的项目文档、版本发布和服务仪表板。

最简单且权威的部署路径是 Z3 仓库。Z3 将 Zaino 作为可选服务包含在内：

Code-highlight

docker compose --env-file .env.<network> --profile indexer up -d

请先运行常规 Z3 设置，并等待 Zebra 同步完成后，再在主网或测试网上启动依赖服务。

Zaino 提供两类网络服务。gRPC 服务是面向 lightwallet 的 API。除非外部层提供保护，否则 JSON-RPC 服务适用于回环网络或受信任的私有网络。请勿将未经身份验证或未加密的 JSON-RPC 端点暴露在公共互联网中。

Zaino Internal Architecture

Zebra Live Service Architecture

Zaino System Architecture

将 Zaino 当作全节点。 Zaino 不是验证器。Zebra 验证链；Zaino 从 Zebra 索引数据。

认为每个 Z3 部署都需要独立的 Zaino。 在默认的 Z3 技术栈中，Zallet 可以直接访问 Zebra。当您需要为外部客户端提供独立索引器服务时，再启动 Zaino。

将计划中的功能表述为已部署。 Zaino 正在积极开发中，因此在将某项功能描述为可用之前，请查看当前的发行说明和文档。

不谨慎地暴露 JSON-RPC。 除非有另一层保护，Zaino 的 JSON-RPC 接口仅适用于回环网络或受信任的私有网络。

**最后更新：**2026 年 8 月