# @bloxwap/hyperliquid 中文文档

规范地址：https://npmcn.com/package/%40bloxwap/hyperliquid/

版本：0\.7\.0
npm 元数据更新时间：2026-10-23T16:29:44.591Z
中文译文更新时间：2026-11-08T08:12:51.964Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bloxwap/hyperliquid
原文对照：https://npmcn.com/package/%40bloxwap/hyperliquid/?lang=original
项目主页：https://bloxwap.github.io/hyperliquid/
源码仓库：https://github.com/bloxwap/hyperliquid

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

- 包体积（解压后）：2.7 MB，659 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：3 个
- 首次发布：2026-07-27T11:11:46.872Z
- 最新版本发布：2026-10-23T16:29:44.007Z
- 近 30 天下载量：2638（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

爆破快取 TypeScript 超液态 SDK.

## 安装

```sh
npm install @bloxwap/hyperliquid
```

也可以使用：`pnpm add @bloxwap/hyperliquid`、`yarn add @bloxwap/hyperliquid`、`bun add @bloxwap/hyperliquid`

## README

![Hyperliquid](https://raw.githubusercontent.com/bloxwap/hyperliquid/main/.github/hyperliquid-dark.svg)  
**快速打字符 [超液态 SDK](https://bloxwap.github.io/hyperliquid/docs/)**

[![npm version](https://img.shields.io/npm/v/@bloxwap/hyperliquid?color=blue&style=flat-square)](https://www.npmjs.com/package/@bloxwap/hyperliquid) [![npm downloads](https://img.shields.io/npm/dm/@bloxwap/hyperliquid.svg?style=flat-square)](https://www.npmjs.com/package/@bloxwap/hyperliquid) [![Codecov coverage](https://img.shields.io/codecov/c/github/bloxwap/hyperliquid?branch=main&style=flat-square)](https://codecov.io/gh/bloxwap/hyperliquid) [![Bundle size](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdeno.bundlejs.com%2F%3Fq%3D%40bloxwap%2Fhyperliquid%26config%3D%257B%2522esbuild%2522%253A%257B%2522external%2522%253A%255B%2522viem%2522%252C%2522tiny-secp256k1%2522%252C%2522hash-wasm%2522%255D%257D%257D&query=%24.size.compressedSize&label=minzipped+size&style=flat-square&color=blue)](https://bundlejs.com/?q=@bloxwap/hyperliquid&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22viem%22%2C%22tiny-secp256k1%22%2C%22hash-wasm%22%5D%7D%7D)

## 特征

-   **类型**:源代码为100% TypeScript.
-   **已测试**:良好的代码覆盖范围和类型相关性.
-   **最小依赖性**:几个小的可信赖的依赖关系.
-   **跨环境支助**: 与所有主要JS运行时间相兼容.
-   **难分**: 易于使用 [维姆](https://github.com/wevm/viem) 当地(私人钥匙)或JSON-RPC (浏览器钱包).

## 文档

浏览 [SDK 文档](https://bloxwap.github.io/hyperliquid/docs/) 安装、客户、运输、签署、, 公用事业和导游.

文档使用 [福马多克](https://www.fumadocs.dev/) 并在 GitHub Pages 上托管。 它的Markdown源 生活在 `apps/docs/content/docs/` 输入 [仓库](https://github.com/bloxwap/hyperliquid)。 。 。 .

## 安装

### 1.3.3+号舱

```sh
bun add @bloxwap/hyperliquid
```

### 节点.js 22.12+ / 反应土著 0.86+

```sh
npm i @bloxwap/hyperliquid
```

### 小时

```sh
pnpm add @bloxwap/hyperliquid
```

### 雅伦

```sh
yarn add @bloxwap/hyperliquid
```

> 本地反应需要多填充器 `fastAssetCtxs` 订阅和低于0.86的版本——见 [文档](https://bloxwap.github.io/hyperliquid/docs/)。 。 。 .

## 快速示例

### 读取

```ts
// 1. Import module
import { HttpTransport, InfoClient } from "@bloxwap/hyperliquid";

// 2. Set up client with transport
const transport = new HttpTransport();
const info = new InfoClient({ transport });

// 3. Query data

// Retrieve mids for all coins
const mids = await info.allMids();

// Retrieve a user's open orders
const openOrders = await info.openOrders({ user: "0x..." });

// L2 book snapshot
const book = await info.l2Book({ coin: "BTC" });
```

### 贸易

```ts
// 1. Import modules
import { ExchangeClient, HttpTransport } from "@bloxwap/hyperliquid";
import { privateKeyToAccount } from "viem/accounts";

// 2. Set up client with wallet and transport
const wallet = privateKeyToAccount("0x...");

const transport = new HttpTransport();
const exchange = new ExchangeClient({ transport, wallet });

// 3. Execute an action

// Place an order
const result = await exchange.order({
  orders: [{
    a: 0,
    b: true,
    p: "95000",
    s: "0.01",
    r: false,
    t: { limit: { tif: "Gtc" } },
  }],
  grouping: "na",
});

// Update leverage
await exchange.updateLeverage({ asset: 0, isCross: true, leverage: 5 });

// Initiate a withdrawal request
await exchange.withdraw3({ destination: "0x...", amount: "1" });
```

对于低纬度接点,将原始的私钥串传递为 `wallet`: 然后客户端用 WASM secp256k1 签名 : 默认,带有一个纯-JS倒置, WASM 无法装入(在节点24上每顺序为~274至~104 μs,~155至~102 μs) (bun 1.4) (中文(简体) ). 安装可选选项 `hash-wasm` 用于环境keccak加速的软件包。 信得过的人也可以通过 `{ skipValidation: true }`见 [低纬度配方](https://bloxwap.github.io/hyperliquid/docs/signing/#low-latency-recipe-bots--hft)。 。 。 .

### 订阅

```ts
// 1. Import module
import { SubscriptionClient, WebSocketTransport } from "@bloxwap/hyperliquid";

// 2. Set up client with transport
const transport = new WebSocketTransport();
const subs = new SubscriptionClient({ transport });

// 3. Subscribe to events

// Subscribe to mids for all coins
await subs.allMids((data) => {
  console.log(data);
});

// Subscribe to user's open orders
await subs.openOrders({ user: "0x..." }, (data) => {
  console.log(data);
});

// Subscribe to L2 book snapshot
await subs.l2Book({ coin: "ETH" }, (data) => {
  console.log(data);
});
```

> \[尖叫声\]
> 
> -   **从不硬码私钥** 或将他们投入其中。 从环境变量或秘密中装入 存储( Bun 自动装入本地 `.env`,它在这个repo中被赋予了".
> -   对于交易的bots,更喜欢超液态 **代理钱包** (API 钱包) 覆盖主账户密钥: 代理密钥可以 贸易但不能退出,并且可以不旋转主密钥而取消.
> -   见 [签名](https://bloxwap.github.io/hyperliquid/docs/signing/) 用于钱包、签名和非纸币的操作.

## 常见问题

### @bloxwap/hyperliquid 是什么？

爆破快取 TypeScript 超液态 SDK\.

### 如何安装 @bloxwap/hyperliquid？

在项目目录运行 npm install @bloxwap/hyperliquid，或使用 pnpm add / yarn add / bun add。

### @bloxwap/hyperliquid 支持 TypeScript 吗？

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

### @bloxwap/hyperliquid 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bloxwap/hyperliquid 需要什么版本的 Node\.js？

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

### @bloxwap/hyperliquid 可以商用吗？

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

### @bloxwap/hyperliquid 的下载量有多少？

根据 npm 官方下载统计，@bloxwap/hyperliquid 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,638 次，日均约 88 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bloxwap/hyperliquid 还在维护吗？

最新版本 0\.7\.0 发布于 2026/10/24（15 天前）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2026/07/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。