DAT JavaScript / TypeScript 库
GitHub npm安装
bash
bash
bash
快速开始
此完整流程从 CMS 获取证书,创建包含 JSON 数据的 DAT,并进行验证。
typescript
分步说明
1. 连接 CMS
签发服务使用完整证书令牌。启动时立即同步,可防止在证书可用前签发。
typescript
2. 签发 DAT
此示例将公开 JSON 放入 plain,将受保护的用户信息作为 JSON 放入 secure。
typescript
3. 验证 DAT
parse 检查有效期和签名,然后解密 secure。只使用验证成功后返回的载荷。
typescript
关键函数
| 函数 | 用途 |
|---|---|
syncOrThrow() | 立即同步证书。 |
issue(plain, secure) | 异步创建 DAT 字符串。 |
parse(dat) | 验证 DAT 并返回 DatPayload。 |
lastError() | 返回最后一个同步错误。 |
数据区域
plain: 已签名但未加密的字节。secure: 加密字节。payload: 仅在parse成功后才可信任。
JSON 之外的选项
示例使用常见的 JSON。为加快处理,二进制数据可避免 JSON 序列化和解析,同时减少数据大小。
将简单值存为文本,或将 Protobuf、MessagePack 等二进制格式的结构化数据放入 plain 和 secure。
typescript
传入 Uint8Array 或 ArrayBuffer,通过 plainBytes 和 secureBytes 取回原始字节。
仅验证服务
不签发 DAT 的服务使用仅验证选项和仅验证令牌,且只调用 parse。
关闭与错误
关闭时调用 stop() 清理定时器和进行中的请求。
使用错误代码和重试分类,而不是错误消息。