torii 参考资料

名称

torii - 世界合约的自动索引器和网络层。

用例

torii [OPTIONS]

描述

torii会启动索引器,并公开 GraphQL/gRPC API 端点。索引器会向指定的 Starknet RPC 端点查询事务块,并监听与世界契约相关的事务。这些事务包括组件/系统注册、实体状态更新、系统调用和事件。解析后的数据将存储在本地 SQLite 数据库中。

GraphQL 和 gRPC API 端点与索引器同步运行,为客户端应用程序提供特定于世界契约的自定义查询。

数据库 URL

torii 使用sqlite数据库存储索引数据。数据库既可以存储在内存中,也可以持久地存储在文件系统中。

  • 内存数据库是非持久存在的,只有索引器运行时才会存在。这是在开发/测试中启动索引器的快速而简单的选择。
  • 生产环境中应使用持久存储。它依赖本地文件系统进行存储。

注意:如果使用内存数据库,在一段时间不活动后内存将被垃圾回收,导致查询出错。解决方法是使用 --block-time 选项启动 katana 或使用持久数据库。

# Persistent database storage using file indexer.db
torii --database-url sqlite:indexer.db

选项

常规选项

-w, --world      要索引的世界合同的地址

--rpc      要使用的Starknet RPC 终端 [默认:http//localhost:5050]

-m, --manifest <MANIFEST>      指定要初始化的本地清单

-d, --database-url <DATABASE_URL>      数据库 URL(更多信息请阅读上文) [默认:sqlite::memory:]

-s, --start-block <START_BLOCK>      指定要从哪个块开始建立索引,如果存在存储头,则忽略 [默认:0]

-h, --help      打印帮助

-V, --version      打印版本信息