@envio-dev/hypersync-client

中文文档
1.5.0发布于 2026/10/30MITTypeScriptCommonJS零依赖构建来源已验证近 30 天下载 4.3万

Envio 的超同步客户端

中文使用文档
文档目录10 节
  1. 什么是超同步吗?
  2. 特征
  3. 安装
  4. API 托肯语Name
  5. 快速启动
  6. 连接到不同的网络
  7. 你能建造的东西
  8. 文档
  9. 财务问题
  10. 支助

超同步客户端节点

npm npm downloads Discord

节点.js客户端 恩维奥的 HyperSync. TypeScript-First,通过NAPI绑定高性能区块链数据访问而建于Rust执行之上.

什么是超同步吗?

超同步 是Envio的高性能区块链数据检索层. 它是JSON-RPC端点的专用替代品,提供长达2000x更快速的数据访问,覆盖70+EVM兼容网络和Fuel.

HyperSync 允许您使用灵活的过滤和字段选择来查询日志,交易,块和痕迹,只返回您需要的数据.

如果您需要在 HyperSync 上方与 GraphQL API 和 chema 管理设置一个完整的索引框架,请参见 超索引。 。 。 .

特征

  • 类型脚本第一: 完整类型脚本类型和IntelliSense支持
  • 业绩好: 通过NAPI 绑定在地心上
  • 二进制运输: 优化序列化以尽量减少带宽并最大限度的吞吐量
  • 灵活查询: 过滤日志、交易、块和痕迹
  • 实地选择: 选择要返回的确切字段
  • 预设查询: 用于常见查询模式的内置助手
  • Parquet 导出: 直接将数据流到 Parquet 文件
  • 流线: 处理大型数据集而不将所有数据装入内存
  • 70+网络: 访问任意 超同步支持的网络

安装

# npm
npm install @envio-dev/hypersync-client

# pnpm
pnpm add @envio-dev/hypersync-client

# yarn
yarn add @envio-dev/hypersync-client

API 托肯语Name

使用HyperSync需要API令牌. 把你的信物拿来,然后设置为环境变量:

export ENVIO_API_TOKEN="your-token-here"

快速启动

从 Ethereum 上的 USDT 合同获取传输事件日志 :

import { HypersyncClient, presetQueryLogsOfEvent } from "@envio-dev/hypersync-client";

async function main() {
  const client = new HypersyncClient({
    url: "https://eth.hypersync.xyz",
    apiToken: process.env.ENVIO_API_TOKEN!,
  });

  const usdtContract = "0xdAC17F958D2ee523a2206206994597C13D831ec7";

  // ERC-20 Transfer event topic0
  const transferTopic = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";

  const query = presetQueryLogsOfEvent(usdtContract, transferTopic, 17_000_000, 17_000_050);

  const res = await client.get(query);
  console.log(`Found ${res.data.logs.length} Transfer events`);
}

main();

见 示例目录 用于更多模式,包括块数据、钱包交易、Parquet导出和实时流出.

连接到不同的网络

改变 url 连接到任何支持的网络 :

// Arbitrum
const client = new HypersyncClient({
  url: "https://arbitrum.hypersync.xyz",
  apiToken: process.env.ENVIO_API_TOKEN!,
});

// Base
const client = new HypersyncClient({
  url: "https://base.hypersync.xyz",
  apiToken: process.env.ENVIO_API_TOKEN!,
});

全文见 支持的网络和 URL。 。 。 .

你能建造的东西

Node.js客户端是JavaScript和TypeScript应用的自然相适应的,需要快速,直接地访问块链数据:

  • 实时活动监测: 流出块高地和查询事件时,像这样 证券交易跟踪器 用节点客户端所建
  • 区块链数据分析: 扫描整个链条历史, 以秒计, 不以小时计
  • ETL管道: 提取链上数据并导出至Parquet进行下游处理
  • 区块探索者: 具有全面实时数据访问功能的电源响应接口
  • DeFi 仪表板: 查询协议活动、集合数据以及规模化的符号传输
  • 跨链应用程序:从单一客户端查询跨70+EVM链的统一数据

文档

财务问题

数据采集方法如何与醚.js或viem进行比较? HyperSync检索到2000x的数据比传统的JSON-RPC更快. 它是为批量历史数据访问而设计的,而不是交易签名或合同书写. 使用HyperSync并用醚.js或viem进行读重应用.

我需要一个API代币吗? 对. 拿一个来。 。 。 .

支持哪些网络? 70+ EVM相容网络和燃料. 见 完整列表。 。 。 .

我可以向Parquet输出数据吗? 对 见 examples/parquet-out 用于将数据流到 Parquet 文件的示例.

这和德诺还是邦有关? 包裹通过NAPI捆绑瞄准了Node.js. Bun与Node.js本土模块大致相容. Deno兼容性可能有所不同.

这跟Rust客户有什么不同? 这个客户端是建立在顶部 Rust 客户端 通过国家反垄断局的束缚。 它为JavaScript/Node.js开发者提供TypeScript-first接口. 若您需要最低水平且管理费用最少的接入,请直接使用 Rust 客户端.

HyperSync和HyperIndex有什么区别? HyperSync是原始数据访问层. 当您需要直接访问自己的管道中的区块链数据时使用它. 超索引 是HyperSync上建的全索引框架,有计划管理、事件处理器和一个GraphQL API.

支助

版本与发布记录

@envio-dev/hypersync-client 共发布 53 个版本,首次发布于 2023/11/29;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.5.0latest2026/10/3014 天前
1.4.12026/09/082 个月前
1.4.02026/06/085 个月前
1.3.02026/03/277 个月前
1.2.02026/03/277 个月前
1.1.02026/02/258 个月前

关于 @envio-dev/hypersync-client 的常见问题

@envio-dev/hypersync-client 是什么?

Envio 的超同步客户端

如何安装 @envio-dev/hypersync-client?

在项目目录运行 npm install @envio-dev/hypersync-client,或使用 pnpm add / yarn add / bun add。

@envio-dev/hypersync-client 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@envio-dev/hypersync-client 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@envio-dev/hypersync-client 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 10。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@envio-dev/hypersync-client 可以商用吗?

@envio-dev/hypersync-client 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@envio-dev/hypersync-client 的下载量有多少?

根据 npm 官方下载统计,@envio-dev/hypersync-client 在 2026/10/14 – 2026/11/12 这 30 天内被下载 43,086 次,日均约 1,436 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@envio-dev/hypersync-client 还在维护吗?

最新版本 1.5.0 发布于 2026/10/30(14 天前);至今共发布 53 个版本,其中过去 12 个月发布了 12 个;首次发布于 2023/11/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。