用途:Torii 是 Dojo 的索引器,监听区块链上的 world 事件、索引模型状态变化,并提供 GraphQL 查询、gRPC 订阅和 SQL 访问,比直接 RPC 查询更快,支持复杂查询、分页与实时订阅。
主要能力:启动并配置 Torii;生成 GraphQL schema(通用查询 entities、models、transactions,以及按模型的 {modelName}Models 查询);支持游标分页(first/after)与 offset/limit 分页;通过 WebSocket 提供 entityUpdated、eventEmitted、modelRegistered 等订阅;数据存入 SQLite,可用 sqlite3 torii.db 直接查询。
使用方式:快速启动 torii --world <WORLD_ADDRESS>,默认 GraphQL 在 http://localhost:8080/graphql、gRPC 在 http://localhost:8080,使用内存数据库。推荐加 --indexing.controllers;生产可用 --db-dir ./torii-db --indexing.controllers。常用配置项包括 --world、--rpc(默认 http://localhost:5050)、--db-dir、--config、--http.cors_origins。客户端可用 @dojoengine/torii-client 或 Apollo Client 接入。远程可用 Slot 部署,需 TOML 配置文件,命令如 slot auth login、slot deployments create <PROJECT_NAME> torii --config torii.toml --version <DOJO_VERSION>,日志用 slot deployments logs <PROJECT_NAME> torii -f。
适用场景:为已部署 world 建立客户端查询与实时订阅、复杂过滤与分页、直接 SQL 聚合分析。
限制:资料未提供具体性能指标、收费与价格信息;部分配置项(如 TOML 全部选项)需参考 Torii 配置指南,本文未展开。