# @envio-dev/hypersync-client 中文文档

规范地址：https://npmcn.com/package/%40envio-dev/hypersync-client/

版本：1\.5\.0
npm 元数据更新时间：2026-10-30T08:32:23.156Z
中文译文更新时间：2026-11-13T18:50:47.381Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40envio-dev/hypersync-client
原文对照：https://npmcn.com/package/%40envio-dev/hypersync-client/?lang=original
项目主页：https://github.com/enviodev/hypersync-client-node#readme
源码仓库：https://github.com/enviodev/hypersync-client-node

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，140 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 10
- 运行依赖：0 个
- 首次发布：2023-11-29T02:03:55.086Z
- 最新版本发布：2026-10-30T08:32:22.750Z
- 近 30 天下载量：43086（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 12 个）

## 中文简介

Envio 的超同步客户端

## 安装

```sh
npm install @envio-dev/hypersync-client
```

也可以使用：`pnpm add @envio-dev/hypersync-client`、`yarn add @envio-dev/hypersync-client`、`bun add @envio-dev/hypersync-client`

## README

# 超同步客户端节点

[![npm](https://img.shields.io/npm/v/@envio-dev/hypersync-client)](https://www.npmjs.com/package/@envio-dev/hypersync-client) [![npm downloads](https://img.shields.io/npm/dm/@envio-dev/hypersync-client)](https://www.npmjs.com/package/@envio-dev/hypersync-client) [![Discord](https://img.shields.io/badge/Discord-Join%20Chat-7289da?logo=discord&logoColor=white)](https://discord.com/invite/envio)

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

## 什么是超同步吗?

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

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

如果您需要在 HyperSync 上方与 GraphQL API 和 chema 管理设置一个完整的索引框架,请参见 [超索引](https://github.com/enviodev/hyperindex)。 。 。 .

## 特征

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

## 安装

```bash
# 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令牌. [把你的信物拿来](https://docs.envio.dev/docs/HyperSync/api-tokens),然后设置为环境变量:

```bash
export ENVIO_API_TOKEN="your-token-here"
```

## 快速启动

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

```typescript
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();
```

见 [示例目录](https://npmcn.com/package/%40envio-dev/hypersync-client/examples) 用于更多模式,包括块数据、钱包交易、Parquet导出和实时流出.

## 连接到不同的网络

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

```typescript
// 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](https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks)。 。 。 .

## 你能建造的东西

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

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

## 文档

-   [API 文档](https://enviodev.github.io/hypersync-client-node/)
-   [超同步文档](https://docs.envio.dev/docs/HyperSync/overview)
-   [查询引用](https://docs.envio.dev/docs/HyperSync/hypersync-query)
-   [所有客户端图书馆](https://docs.envio.dev/docs/HyperSync/hypersync-clients) (平通,罗通,去也
-   [npm 软件包](https://www.npmjs.com/package/@envio-dev/hypersync-client)

## 财务问题

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

**我需要一个API代币吗?** 对. [拿一个来](https://docs.envio.dev/docs/HyperSync/api-tokens)。 。 。 .

**支持哪些网络?** 70+ EVM相容网络和燃料. 见 [完整列表](https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks)。 。 。 .

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

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

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

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

## 支助

-   [Discord 社区](https://discord.com/invite/envio)
-   [GitHub 问题](https://github.com/enviodev/hypersync-client-node/issues)
-   [文档](https://docs.envio.dev/docs/HyperSync/overview)

## 常见问题

### @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 和提交记录判断。