HyperSync Client Libraries
HyperSync provides powerful client libraries that enable you to integrate high-performance blockchain data access into your applications. These libraries handle the communication with HyperSync servers, data serialization/deserialization, and provide convenient APIs for querying blockchain data.
Quick Links
Client | Resources |
---|---|
Node.js | 📝 API Docs · 📦 NPM · 💻 GitHub · 🧪 Examples |
Python | 📦 PyPI · 💻 GitHub · 🧪 Examples |
Rust | 📦 Crates.io · 📝 API Docs · 💻 GitHub · 🧪 Examples |
Go (community) | 💻 GitHub · 🧪 Examples |
API Tokens | 🔑 Get Tokens |
Client Overview
All HyperSync clients share these key features:
- High Performance: Built on a common Rust foundation for maximum efficiency
- Optimized Transport: Uses binary formats to minimize bandwidth and maximize throughput
- Consistent Experience: Similar APIs across all language implementations
- Automatic Pagination: Handles large data sets efficiently
- Event Decoding: Parses binary event data into structured formats
Choose the client that best matches your application's technology stack:
Feature | Node.js | Python | Rust | Go |
---|---|---|---|---|
Async Support | ✅ | ✅ | ✅ | ✅ |
Typing | TypeScript | Type Hints | Native | Native |
Data Formats | JSON, Parquet | JSON, Parquet, CSV | JSON, Parquet | JSON, Parquet |
Memory Efficiency | Good | Better | Best | Better |
Installation | npm | pip | cargo | go get |
Node.js Client
The Node.js client provides a TypeScript-first experience for JavaScript developers.
Installation
# Using npm
npm install @envio-dev/hypersync-client
# Using yarn
yarn add @envio-dev/hypersync-client
# Using pnpm
pnpm add @envio-dev/hypersync-client
Python Client
The Python client provides a Pythonic interface with full type hinting support.
Installation
pip install hypersync
Rust Client
The Rust client provides the most efficient and direct access to HyperSync, with all the safety and performance benefits of Rust.
Installation
Add the following to your Cargo.toml
:
[dependencies]
hypersync-client = "0.1"
tokio = { version = "1", features = ["full"] }
Go Client
The Go client is community maintained and marked as work-in-progress. For production use, you may want to test thoroughly or consider the officially supported clients.
The Go client provides a native Go interface for accessing HyperSync, with support for streaming and decoding blockchain data.
Installation
go get github.com/enviodev/hypersync-client-go
Using API Tokens
You'll need an API token to use any HyperSync client. Get your token here.
All HyperSync clients require an API token for authentication. Tokens are used to manage access and usage limits.
To get an API token:
- Visit Envio
- Register or sign in with your github account
- Navigate to the API Tokens section
- Create a new token
For detailed instructions, see our API Tokens guide.
Client Selection Guide
Choose the client that best fits your use case:
Choose when: You're building JavaScript/TypeScript applications or if your team is most comfortable with the JavaScript ecosystem.
Choose when: You're doing data science work, need integration with pandas/numpy, or if your team prefers Python's simplicity.
Choose when: You need maximum performance, are doing systems programming, or building performance-critical applications.
Choose when: You're working in a Go ecosystem and want native integration with Go applications. Note that this client is community maintained.
Additional Resources
Support
Need help getting started or have questions about our clients? Connect with our community: