unicity-sphere/sphere-sdk

解决的问题

Sphere SDK 为与 Unicity 状态转换网络交互提供了一个模块化的 TypeScript 工具包。它简化了管理数字钱包、执行认证令牌转账以及处理去中心化消息传递的复杂过程，使开发者无需从零构建底层基础设施，即可将支付和身份功能集成到浏览器或 Node.js 应用程序中。

工作原理

该 SDK 使用分层提供者模型，将核心钱包功能与支付传输层分离。它结合了基础层（处理存储、身份和基于 Nostr 的消息传递）与特定的 wallet-api 传输层，后者负责实际的资金流动。虽然密钥保持在客户端本地以确保安全，但代币库存由服务器端管理。系统通过“引擎认证”转账和持久化的意图系统，确保即使在网络崩溃或证明不明确的情况下也能防止双重支付，保障支付安全。

适用人群

专为使用 TypeScript 构建去中心化应用（dApps）、数字钱包或集成支付平台的开发者设计，适用于需要安全、抗崩溃的代币转账和去中心化身份管理的场景。

主要亮点

• 抗崩溃支付：使用持久化的服务器端意图和邮箱投递系统，确保转账完成且不会重复支付。
• 混合托管：私钥保留在用户本地，同时利用服务器端库存管理以提高效率。
• 多地址支持：实现 BIP32/BIP44 HD 钱包派生，可从单个种子管理多个地址。
• 去中心化消息传递：集成 Nostr（NIP-17 和 NIP-29），支持直接消息、群聊和昵称发布。
• 模块化架构：可交换的提供者层使 SDK 能够在不同环境（浏览器、Node.js）和自定义网络配置中运行。