@enbox/dwn-clients

中文文档
0.4.40发布于 2026/11/12Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2521

客户端库和用于通信的共享类型 DWN 服务器。 。 。 .

中文使用文档
文档目录7 节
  1. 包含什么
  2. 运输客户
  3. JSON-RPC 软件公司
  4. 共享类型
  5. 公用事业
  6. 使用量
  7. 许可证

@enbox/dwn-客户端

客户端库和用于通信的共享类型 DWN 服务器。 。 。 .

包含什么

运输客户

导出说明
HttpDwnRpcClientDWN JSON- RPC 端点的 HTTP 客户端
WebSocketDwnRpcClientDWN JSON- RPC 有订阅的 WebSocket 客户端
EnboxRpcClientTransport multixer — 使用连接的集合WebSocket来进行捆绑控制和小字节备份的复制流量
HttpEnboxRpcClient拥有 D Does RPC 支持的 HTTP 客户端
WebSocketEnboxRpcClient拥有 Dods RPC 支持的 WebSocket 客户端
DwnRegistrarDWN 租户登记的HTTP客户端(工作挑战防流)

JSON-RPC 软件公司

导出说明
createJsonRpcRequestJSON- RPC 2.0 请求对象的工厂
createJsonRpcSuccessResponseJSON-RPC成功对策工厂
createJsonRpcErrorResponseJSON-RPC 错误反应工厂
JsonRpcSocketJSON-RPC 信件的持续 WebSocket 包装

共享类型

两者所使用的类型 @enbox/dwn-server (服务器端)和客户端:

类型说明
ServerInfo满 /info 端点响应形状
ProofOfWorkChallengeModelGET /registration/proof-of-work 回应
RegistrationData租户登记数据did + 键 termsOfServiceHash(中文(简体) )
RegistrationRequestPOST /registration 请求正文
JsonRpcRequest 编号 : JsonRpcResponseJSON-RPC 2.0 信封
DwnRpcRequest 编号 : DwnRpcResponseDWN 特定的区域和技术合作请求/答复

公用事业

导出说明
concatenateUrl以精确的一个加入一个基础 URL 和路径段 /
DwnServerInfoCacheMemory模拟缓存 ServerInfo 带 TTL

使用量

import { EnboxRpcClient } from '@enbox/dwn-clients';

const rpc = new EnboxRpcClient();

// Send a DWN request over HTTP
const response = await rpc.sendDwnRequest({
  dwnUrl    : 'https://dwn.example.com',
  targetDid : 'did:dht:abc123',
  message   : recordsWriteMessage,
  data      : dataStream,
});

// Get server info
const info = await rpc.getServerInfo('https://dwn.example.com');
console.log(info.registrationRequirements); // ['proof-of-work-sha256-v0', 'terms-of-service']

// Register a tenant
import { DwnRegistrar } from '@enbox/dwn-clients';
await DwnRegistrar.registerTenant('https://dwn.example.com', 'did:dht:abc123');

许可证

阿帕奇 - 2.0

版本与发布记录

@enbox/dwn-clients 共发布 61 个版本,首次发布于 2026/02/20;过去 12 个月发布了 61 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.40latest2026/11/121 天前
0.4.392026/11/077 天前
0.4.382026/11/0113 天前
0.4.372026/10/2322 天前
0.4.362026/10/2124 天前
0.4.352026/09/181 个月前

关于 @enbox/dwn-clients 的常见问题

@enbox/dwn-clients 是什么?

客户端库和用于通信的共享类型 DWN 服务器。 。 。 .

如何安装 @enbox/dwn-clients?

在项目目录运行 npm install @enbox/dwn-clients,或使用 pnpm add / yarn add / bun add。

@enbox/dwn-clients 支持 TypeScript 吗?

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

@enbox/dwn-clients 支持 ESM 还是 CommonJS?

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

@enbox/dwn-clients 可以商用吗?

@enbox/dwn-clients 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@enbox/dwn-clients 的下载量有多少?

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

@enbox/dwn-clients 还在维护吗?

最新版本 0.4.40 发布于 2026/11/12(1 天前);至今共发布 61 个版本,其中过去 12 个月发布了 61 个;首次发布于 2026/02/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。