用途:为 Monad 合约初始化 HyperIndex 索引器,捕获链上智能合约事件,并在 Envio Cloud 上部署与管理,适合需要历史事件流或活动数据源的场景。
主要能力:初始化新索引器;部署到 Envio Cloud;查看、提升、重启或删除已有部署;管理索引器环境变量与 IP 允许列表;调试部署或同步失败的索引器;获取索引器的 GraphQL API URL。
使用方式:在项目根目录的 indexer/ 文件夹内运行 init 命令。硬性前提是合约必须已在 Monad 浏览器上部署并验证,否则 contract-import 会失败。主网命令:mkdir -p indexer && cd indexer,然后 pnpx envio@3.0.0-alpha.21 init contract-import explorer -b monad -c <CONTRACT_ADDRESS> -n <CONTRACT_NAME> -l typescript -d ./ -o ./ --all-events --single-contract --api-token ""。测试网将 -b monad 换成 -b monad-testnet。版本固定为 envio@3.0.0-alpha.21。初始化后生成 config.yaml、schema.graphql 和 handler 桩,需编辑 handler 决定存储内容。默认 event.transaction.* 类型为 never,如需交易字段,在 config.yaml 顶层添加 field_selection 下的 transaction_fields(如 hash),再运行 pnpm codegen 或 pnpx envio@3.0.0-alpha.21 codegen 重新生成类型。
前提条件:全局安装 envio-cloud(npm install -g envio-cloud);登录 envio-cloud login;安装 GitHub CLI(macOS 用 brew install gh);登录 gh auth login。不要替用户安装或登录,缺失时告知确切命令并等待。
限制:envio-cloud 命令遵循退出码约定,0 成功、1 用户错误、2 API/服务器错误。更多工作流配方与 CLI 参考需按需获取。官方文档:https://docs.envio.dev/docs/HyperIndex/envio-cloud-cli