@arca-network/sdk

中文文档
2.15.0发布于 2026/11/01SEE LICENSE IN LICENSETypeScriptCommonJS近 30 天下载 1713

Arca 平台的脚本 SDK 类型

中文使用文档
文档目录8 节
  1. 构建
  2. Dev (监视模式)
  3. 干净
  4. 所需资源
  5. WebSocket 支持
  6. 权益 & P&L 图表
  7. 行动等待恢复
  8. 钱包行刑候选人(2026-09-30)

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

用于Arca平台的TypeScript SDK.

构建

从 repo 根 :

pnpm run sdk:build

或直接:

cd sdk/typescript
pnpm run build

Dev (监视模式)

pnpm run sdk:dev

干净

pnpm run sdk:clean

所需资源

  • 节点.js 20+

WebSocket 支持

SDK使用WebSocket进行实时操作跟踪. 节点.js 22+提供了一个本土全球 WebSocket; 在Node.js 20–21上, SDK 自动倒回捆绑的 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。 。 。 .

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 共发布 48 个版本,首次发布于 2026/06/06;过去 12 个月发布了 48 个版本。

版本发布日期距今
2.15.0latest2026/11/018 天前
2.14.02026/10/3110 天前
2.13.02026/10/2911 天前
2.12.12026/10/2912 天前
2.12.02026/10/2812 天前
2.11.02026/10/1822 天前

关于 @arca-network/sdk 的常见问题

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