Chaindoc logoChaindoc

更新日志

新功能上线、已有功能优化、未来规划预告。本页面记录 Chaindoc 的每一次版本发布，助你及时掌握集成更新。

v1.0.0 — 2025年12月

首个稳定版本。API 已可用于生产环境，两款 SDK 均提供完整的 TypeScript 支持，你现在阅读的文档也已正式上线。

新增功能

  • Server SDK (`@chaindoc_io/server-sdk`) — 适用于 Node.js 的 SDK，支持自动重试与完整类型定义
  • Embed SDK (`@chaindoc_io/embed-sdk`) — 前端签名组件，支持 React、Vue、Angular 及原生 JS。Gzip 后体积不到 10KB。
  • Webhooks — 实时事件通知，支持 HMAC SHA256 签名验证
  • 嵌入式签名流程 — 签署人在你的应用内完成签署，无需跳转外部页面
  • KYC 集成 — 通过 Sumsub 完成身份验证
  • 访问控制 — 基于角色和邮箱的权限管理，内置六种角色
  • 多链支持 — 文档 验证支持 Ethereum、Polygon、BSC 和 Arbitrum
  • 批量操作：支持上传和处理多份文档
  • 全文搜索：可跨文档搜索，支持标签和元数据筛选

API 变更

  • 新增速率限制，响应头包含 `X-RateLimit-*`
  • 400 错误响应中返回字段级验证错误信息
  • 所有列表端点支持分页
  • 新增健康检查端点 (`GET /health`) 用于监控
  • 控制面板可查看 API 密钥使用统计

SDK 亮点

  • 完整的 TypeScript 定义，每个方法和类型都支持 IntelliSense
  • 自动重试机制，支持指数退避（可配置）
  • Embed SDK 运行时零依赖
  • 兼容 React、Vue、Angular、Svelte 及原生 JS
  • 调试模式可将请求和响应输出到控制台

安全性

  • HMAC SHA256 webhook 签名验证
  • API 密钥轮换支持零停机更新
  • API 访问支持 IP 白名单
  • 控制面板支持双因素认证
  • 通过 SOC 2 Type II 认证。详见安全指南。

路线图 — 2026年Q2

以下功能正在开发中。暂无确切发布日期，但已在积极构建：

  • Python SDK，方便后端集成
  • PHP SDK
  • 移动端 SDK（iOS 和 Android）
  • 高级签名模板系统
  • 批量签名请求（同一文档可发送给数百位接收人）
  • 签署界面支持自定义品牌
  • 文档与签名数据分析仪表板

下一步