# @arca-network/sdk 中文文档

规范地址：https://npmcn.com/package/%40arca-network/sdk/

版本：2\.15\.0
npm 元数据更新时间：2026-11-01T06:40:07.010Z
中文译文更新时间：2026-11-09T21:50:40.717Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40arca-network/sdk
原文对照：https://npmcn.com/package/%40arca-network/sdk/?lang=original
项目主页：https://github.com/arcaresearch/arca-typescript-sdk#readme
源码仓库：https://github.com/arcaresearch/arca-typescript-sdk

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

- 包体积（解压后）：2 MB，116 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2026-06-06T03:11:14.805Z
- 最新版本发布：2026-11-01T06:40:06.778Z
- 近 30 天下载量：1713（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

Arca 平台的脚本 SDK 类型

## 安装

```sh
npm install @arca-network/sdk
```

也可以使用：`pnpm add @arca-network/sdk`、`yarn add @arca-network/sdk`、`bun add @arca-network/sdk`

## README

# @arca-network/sdk (TypeScript) (中文(简体) )

用于Arca平台的TypeScript SDK.

## 构建

从 repo 根 :

```bash
pnpm run sdk:build
```

或直接:

```bash
cd sdk/typescript
pnpm run build
```

## Dev (监视模式)

```bash
pnpm run sdk:dev
```

## 干净

```bash
pnpm run sdk:clean
```

## 所需资源

-   节点.js 20+

### WebSocket 支持

SDK使用WebSocket进行实时操作跟踪. 节点.js 22+提供了一个本土全球 `WebSocket`; 在Node.js 20–21上, SDK 自动倒回捆绑的 [`ws`](https://github.com/websockets/ws) 软件包。 不需要额外的设置.

### 权益 & P&L 图表

使用下面的图表 API 。 服务器是包括开桶的每一个点的单一真理源;SDK从不合成"现在"点,也从不使缓存在5%的减速heuristic上失效. 每一点都带有明确的 `status` 旗帜( n)`'sealed' | 'open' | 'carried' | 'incomplete'`制作者必须获得荣誉.

-   **`getEquityHistory({ path, from, to, points?, kind?, objectId? })`** - 获取 `/objects/aggregate/history` 使用 `target`编号 :`kind` 并规范当前对稳定 SDK 形状的反应.
-   **`getPnlHistory({ path, from, to, points?, anchor?, kind?, objectId? })`** - 获取 `/objects/pnl/history` 使用 `target`编号 :`kind`; P&L 由服务器从同一快照行中导出内出. 使用 `anchor: 'equity'` 以接收经调整的流量 `valueUsd`,其中存款/转账会转移基线,而不是绘制时间跨度.
-   **`watchEquityChart({ path, from, to, points?, kind?, objectId?, exchange? })`** - 组合 `getEquityHistory` 包含实时聚合更新,并在相隔后重排历史.
-   **`watchPnlChart({ path, from, to, points?, anchor?, kind?, objectId?, exchange? })`** – P&L 图表的同流模式.

分辨率选择与后端共享( S)`pickResolution` 从 `'@arca-network/sdk'`); 选择一个 `points` 预算 — 服务器选择运行 。 当所选的 rung 保留被超过请求窗口时, 响应包含 `resolutionRequested` 以表示升入哪个组.

导出类型 : `EquityChartStream`, (中文(简体) ), `PnlChartStream`, (中文(简体) ), `EquityHistoryResponse`, (中文(简体) ), `PnlHistoryResponse`, (中文(简体) ), `EquityPoint`, (中文(简体) ), `PnlPoint`, (中文(简体) ), `EquityChartUpdate`, (中文(简体) ), `PnlChartUpdate`, (中文(简体) ), `Resolution`。 。 。 .

```ts
const chart = await arca.watchEquityChart({
  path: '/users/alice/',
  from: oneDayAgoIso,
  to: nowIso,
  points: 500,
});
chart.onUpdate(({ response }) => {
  for (const p of response.points) {
    // p.status: 'sealed' | 'open' | 'carried' | 'incomplete'
    // p.equityUsd: string
  }
});
```

## 行动等待恢复

`waitForOperation` 在获得订阅前先听。 启动和实际 流间隙、重校正或操作通知很少要求更新, 阅读操作前相关确认. 失败的确认 或阅读每次恢复最多三次尝试; 健康等待手术 留在溪流上,不定期阅读。 终端推力可以在 承认或即刻恢复。 暂停等待并保存 原始操作身份; 它从未提交替换操作 .

初始或缓冲的订阅快照中的终端操作在读取 HTTP 之前解决了等待, 包括输入失败/ 过期的结果 。 套接字旋转要求更新替换连接的操作证据;其pong只确定运输准备状态. Stale快照请求ID和不相关的操作ID无法解决等待. 验证快照操作与所有直播服务员共享,包括结果缓冲,而另一个呼叫员刷新了相同的根表;每个服务员仍然只接受其原始操作ID.

## 钱包行刑候选人(2026-09-30)

钱包行动提案、经核实的提供者钱包和存款链接快递 意向和主人同意阿尔卡。 Arca拥有执行权, 源保留权, 煤气/非煤气管理和安置;建筑商不经营扫荡工人. 添加剂钱包 `accounting` 信封包括警犬来源、现金、, 在一个承诺位置交易和转口资金。 保留无效金额 和完整性/新鲜度;仅限监护权 `totals` 保留其早先的含义.

去揭发 `StreamFundingV9WalletsWithTransport`; 类型脚本曝光 `streamFundingV9Wallets`双方均使用有限度的缓冲并等待消费者 在确认职位之前。 心跳显示只有连接健康. 从上一个长期应用的位置重新连接,保留先前的统一 钱被困在不完全/不完全的框架中。 钱包突变为单发; 使用原始操作/请求身份解决不确定的结果. 保存链接接受可选 `maxCashMicro` 财务报告和审定财务报表 `maxDepositMicro` 产品盖; 入院时保留了部分存款,其余部分留在源头. 这一来源尚未公布;没有暗示部署的Wallet平等.

## 常见问题

### @arca-network/sdk 是什么？

Arca 平台的脚本 SDK 类型

### 如何安装 @arca-network/sdk？

在项目目录运行 npm install @arca-network/sdk，或使用 pnpm add / yarn add / bun add。

### @arca-network/sdk 支持 TypeScript 吗？

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

### @arca-network/sdk 支持 ESM 还是 CommonJS？

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

### @arca-network/sdk 需要什么版本的 Node\.js？

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

### @arca-network/sdk 可以商用吗？

@arca-network/sdk 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @arca-network/sdk 的下载量有多少？

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

### @arca-network/sdk 还在维护吗？

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