本文介绍了如何使用 QuickNode 上的 Traceye 插件来创建、部署和管理 subgraph。Traceye 是 Zeeve 开发的企业级索引工具,旨在简化 The Graph 协议的 subgraph 索引和查询过程,提供了快速索引、零维护、高可靠性等关键优势,并详细说明了如何在 QuickNode 上启用 Traceye 插件以及如何使用该插件部署 subgraph。
在快速发展但又常常不可预测的 Web3 工程领域,团队在运行托管 subgraph 时始终面临着相当大的挑战,例如停机、数据滞后、缓慢的重新索引、慢查询以及缺乏直接支持。
不妨试试 Traceye,这是一款由 Zeeve 为 The Graph 协议开发的企业级索引工具,可以轻松、可预测且顺畅地索引和查询 subgraph。在本指南中,我们将介绍如何将 Traceye add-on 添加到你的 QuickNode endpoint,然后向你展示如何使用 Traceye 创建和部署 subgraph。让我们开始吧!
依赖项 | 版本 |
---|---|
node.js | 18.13.0 |
graph-cli | 0.49.0 |
区块链基础设施即服务提供商 Zeeve 推出了 Traceye,这是一款用于索引区块链账本和智能合约数据的新工具。Traceye 是一款企业级就绪的托管 graph 解决方案,允许开发人员在托管服务上部署、索引和查询 subgraph。目前,如果 The Graph 的托管服务不支持某个网络,你需要运行自己的 graph 节点来索引它。但是,这可能需要额外的工程工作来设置,并且处理维护和问题可能会成为一种精神负担。Traceye 通过允许开发人员在不到 5 分钟的时间内快速部署 subgraph 来解决此问题。
Traceye 的功能和主要优势包括:
其他功能包括高级指标和性能洞察,以及直接访问从 subgraph 发出的日志。
在下一节中,我们将介绍如何将 Traceye add-on 添加到你的 QuickNode 账户,并演练 Traceye 仪表板。
首先,登录 QuickNode(你可以在此处创建一个免费账户),然后导航到你的 endpoint。对于本教程,你需要在以太坊主网上有一个 endpoint。如果你还没有,请立即创建一个。
设置好以太坊主网 endpoint 后,请妥善保管上面的 HTTP Provider URL,因为稍后你将需要它。
然后,在你的 endpoint 页面上,单击 Add-ons 选项卡,然后单击 Traceye add-on 上的 Explore 按钮。你会看到一个弹出框,解释定价以及该 add-on 与哪些 endpoint 兼容。启用该 add-on 后,你将在 Installed Third-Party Add-Ons 列表中看到它。
安装该 add-on 后,单击 Dashboard 按钮以定向到 Zeeve 的 Traceye 仪表板:
Zeeve 的 Traceye 仪表板:
通过上面的 Traceye 仪表板,你可以快速监督已创建 subgraph 上的活动。在下一节中,我们将向你展示如何在 Traceye 上创建和部署 subgraph。
现在,在你的 Traceye 仪表板中,单击 Add Subgraph 按钮,选择 Create New 选项,系统将提示你输入有关 subgraph 的名称、区块链网络、workspace 以及要与 subgraph 一起使用的 RPC endpoint 的详细信息。
在 Blockchain Network 下选择 Custom 选项,然后将你的 endpoint 的 HTTP provider URL 粘贴到 RPC Endpoints 中。
创建 subgraph 后,单击仪表板上新创建的 subgraph,你将在其中看到 subgraph 的统计信息和配置:
在顶部,你将看到一个标志,指示你的 subgraph 是否已部署,以及一个 Sync Status 栏,显示 subgraph 是否已与链的最新主干同步。
在 subgraph 的 Details 部分中,你将看到有关 subgraph 创建时间、它引用的区块链网络以及你的 workspace(应该是默认 workspace)的信息。Deployment Command 按钮说明了托管 subgraph 的步骤(我们稍后会介绍)。
subgraph 的 Query URL 部分提供了用于查询托管 subgraph 的 URL,还可以通过交互式 playground (通过 Open 按钮) 与之交互。
该界面还提供了几个选项卡来增强你与 subgraph 的交互:
Logs Tab:在此处访问 subgraph 操作的详细日志。“Logs Tab”使你可以查看、筛选和分析 subgraph 发出的事件,这对于监视其性能和解决问题至关重要。
Webhooks Tab:Subgraph Webhook 功能允许你订阅 subgraph 中的特定实体。此功能可确保你在添加或修改与你订阅的实体相关的数据时,直接向你的系统接收实时更新。
Entities Tab:浏览 subgraph 中实体的简化概述。
Settings Tab:在此选项卡中根据你的运营需求管理各种配置。
现在,在 Traceye 上创建 subgraph 后,让我们部署它。在继续之前,请确保已编译 subgraph。如果你还没有 subgraph 项目,或者不知道那是什么,请查看此 QuickNode 指南:如何使用 The Graph 创建和部署自定义 subgraph,以快速启动并运行。
在本教程中,我们将分析部署在以太坊主网上的 Elemental NFT 合约。
在按照 如何使用 The Graph 创建和部署自定义 Subgraph 中的步骤 1-5 操作后,按照以下步骤使用 Traceye 部署 subgraph。
步骤 1:在 Traceye 仪表板上的 subgraph 的 Details 部分中,单击 Deployment Command 按钮,并使用 Traceye 仪表板上的 Step 1 中提供的名称更新 subgraph.yaml(一个包含 subgraph 项目中 subgraph 清单的 YAML 文件)中的 network
字段。
subgraph.yaml 更新为包含 Step 1 中显示的网络名称后,你可以继续。
步骤 2:在 subgraph 的根目录中,在终端中运行 Step 2 中的命令,你将看到类似于以下的输出:
同步过程可能会持续更长时间,具体取决于需要同步的区块编号。
部署 subgraph 并确认其同步状态与链同步更新后,你可以通过 Query 部分中的 Open 按钮与之交互:
然后通过 GraphQL 语言查询 subgraph 的指定模式:
随意使用此示例查询作为起点,以探索和提取区块链上精确区块范围内的详细传输数据。
query MyQuery {
transfers(where: {blockNumber_gt: 19783200, blockNumber_lt: 19783210}) {
Elemental_id
from
to
transactionHash
blockNumber
}
}
注意:如果你查询的区块编号大于 subgraph 已索引和同步的区块编号,则可能会看到空响应。
就这样!你现在知道如何使用 Traceye 创建的 QuickNode Marketplace 上的 Hosted Subgraphs add-on 创建、部署和管理你自己的 subgraph。你无需维护 subgraph,并且可以立即开始以 99.9% 的正常运行时间从中进行查询!
如果你想了解更多信息,请查看以下资源列表:
我们很乐意听到更多关于你正在构建的内容。在 Discord 中给我们留言,或者在 Twitter 上关注我们,以随时了解所有最新信息!
如果你对新主题有任何反馈或要求,请 告诉我们。我们很乐意听取你的意见。
- 原文链接: quicknode.com/guides/mar...
- 登链社区 AI 助手,为大家转译优秀英文文章,如有翻译不通的地方,还请包涵~
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!