# @envio-dev/hypersync-client

> HyperSync Client by Envio

Latest version **1.4.1** (published 2026-09-08) · MIT license · 0 weekly downloads

## Install

```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
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.4.1 |
| Published | 2026-09-08 |
| First published | 2023-11-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 10 |
| Dependencies | 0 |
| Unpacked size | 1.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 31 |
| Maintainers | jasoons, dzakh, mjyoung114, denhampreen |

## Links

- npm: https://www.npmjs.com/package/@envio-dev/hypersync-client
- Repository: https://github.com/enviodev/hypersync-client-node
- Homepage: https://github.com/enviodev/hypersync-client-node#readme
- Issues: https://github.com/enviodev/hypersync-client-node/issues
- npm.io page: https://npm.io/package/@envio-dev/hypersync-client

## Recent versions

- 1.4.1 (latest) — 2026-09-08
- 1.4.0 — 2026-06-08
- 1.3.0 — 2026-03-27
- 1.2.0 — 2026-03-27
- 1.1.0 — 2026-02-25
- 1.0.0 — 2026-01-30
- 0.7.2 — 2025-12-11
- 0.7.0-hyperindex-v2-compatible — 2025-12-02
- 0.7.1 — 2025-12-02
- 0.7.0 — 2025-11-26
- 0.7.0-internaltest.0 — 2025-11-26
- 0.6.7 — 2025-11-13
- 0.6.6 — 2025-09-04
- 0.6.5 — 2025-05-19
- 0.6.4 — 2025-05-16
- … 37 more at https://npm.io/package/@envio-dev/hypersync-client/versions

## README

# hypersync-client-node

[![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)

Node.js client for [Envio's](https://envio.dev) HyperSync. TypeScript-first, built on top of the Rust implementation via NAPI bindings for high-performance blockchain data access.

## What is HyperSync?

[HyperSync](https://docs.envio.dev/docs/HyperSync/overview) is Envio's high-performance blockchain data retrieval layer. It is a purpose-built alternative to JSON-RPC endpoints, offering up to 2000x faster data access across 70+ EVM-compatible networks and Fuel.

HyperSync lets you query logs, transactions, blocks, and traces with flexible filtering and field selection, returning only the data you need.

If you need a full indexing framework on top of HyperSync with GraphQL APIs and schema management, see [HyperIndex](https://github.com/enviodev/hyperindex).

## Features

- **TypeScript-first**: Full TypeScript types and IntelliSense support
- **High performance**: Built on a Rust core via NAPI bindings
- **Binary transport**: Optimized serialization to minimize bandwidth and maximize throughput
- **Flexible queries**: Filter logs, transactions, blocks, and traces
- **Field selection**: Choose exactly which fields to return
- **Preset queries**: Built-in helpers for common query patterns
- **Parquet export**: Stream data directly to Parquet files
- **Streaming**: Process large datasets without loading everything into memory
- **70+ networks**: Access any [HyperSync-supported network](https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks)

## Installation

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

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

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

## API Token

An API token is required to use HyperSync. [Get your token here](https://docs.envio.dev/docs/HyperSync/api-tokens), then set it as an environment variable:

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

## Quick Start

Fetch Transfer event logs from a USDT contract on Ethereum:

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

See the [examples directory](./examples) for more patterns including block data, wallet transactions, Parquet export, and real-time streaming.

## Connecting to Different Networks

Change the `url` to connect to any supported network:

```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!,
});
```

See the full list of [supported networks and URLs](https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks).

## What you can build

The Node.js client is a natural fit for JavaScript and TypeScript applications that need fast, direct access to blockchain data:

- **Real-time event monitoring**: Stream block heights and query events as they land, like this [Polymarket trade tracker](https://docs.envio.dev/blog/track-polymarket-trades-hypersync) built with the Node.js client
- **Blockchain data analytics**: Scan entire chain histories in seconds, not hours
- **ETL pipelines**: Extract on-chain data and export to Parquet for downstream processing
- **Block explorers**: Power responsive interfaces with comprehensive real-time data access
- **DeFi dashboards**: Query protocol events, pool data, and token transfers at scale
- **Cross-chain applications**: Query unified data across 70+ EVM chains from a single client

## Documentation

- [API Documentation](https://enviodev.github.io/hypersync-client-node/)
- [HyperSync Documentation](https://docs.envio.dev/docs/HyperSync/overview)
- [Query Reference](https://docs.envio.dev/docs/HyperSync/hypersync-query)
- [All Client Libraries](https://docs.envio.dev/docs/HyperSync/hypersync-clients) (Python, Rust, Go)
- [npm Package](https://www.npmjs.com/package/@envio-dev/hypersync-client)

## FAQ

**How does this compare to ethers.js or viem for data fetching?**
HyperSync retrieves data up to 2000x faster than traditional JSON-RPC. It is designed for bulk historical data access, not transaction signing or contract writes. Use HyperSync alongside ethers.js or viem for read-heavy applications.

**Do I need an API token?**
Yes. [Get one here](https://docs.envio.dev/docs/HyperSync/api-tokens).

**Which networks are supported?**
70+ EVM-compatible networks and Fuel. See the [full list](https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks).

**Can I export data to Parquet?**
Yes. See `examples/parquet-out` for an example of streaming data to a Parquet file.

**Does this work with Deno or Bun?**
The package targets Node.js via NAPI bindings. Bun is broadly compatible with Node.js native modules. Deno compatibility may vary.

**How is this different from the Rust client?**
This client is built on top of the [Rust client](https://github.com/enviodev/hypersync-client-rust) via NAPI bindings. It provides a TypeScript-first interface for JavaScript/Node.js developers. If you need the lowest-level access with the least overhead, use the Rust client directly.

**What is the difference between HyperSync and HyperIndex?**
HyperSync is the raw data access layer. Use it when you need direct access to blockchain data in your own pipeline. [HyperIndex](https://github.com/enviodev/hyperindex) is the full indexing framework built on top of HyperSync, with schema management, event handlers, and a GraphQL API.

## Support

- [Discord community](https://discord.com/invite/envio)
- [GitHub Issues](https://github.com/enviodev/hypersync-client-node/issues)
- [Documentation](https://docs.envio.dev/docs/HyperSync/overview)

---
_Source: https://npm.io/package/@envio-dev/hypersync-client · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._