Sphere SDK:Unicity 钱包开发库
id:unicity-sphere/sphere-sdk ·
· 目录记录
项目概述
面向Unicity钱包和应用开发者的模块化TypeScript SDK,涵盖身份/密钥、支付、请求、市场意图与消息。它与Sphere前端是两个仓库、两个许可判断;当前README明确支付库存由服务端持有,即使密钥留本地也不能宣传完全自托管资产。
原项目介绍
忠实中文 / 作者自述整理
作者介绍它是Unicity状态转换网络的钱包操作SDK。文档将支付归wallet-api vertical,Nostr只用于消息/用户名;支持浏览器和Node提供者,并分别给ConnectClient/ConnectHost。
短摘 / 原文
A modular TypeScript SDK for Unicity wallet operations
出处:https://github.com/unicity-sphere/sphere-sdk/blob/HEAD/README.md
is_self_report:True
quote_provenance:local_selected_or_legacy_text_match_not_complete_source_verification
quote_verification_caveat:便签/重建摘录自身可能含同一句;字面命中不是独立原文认证;非重建选段也非完整原文/固定版本
当前具体详情(详情待补)
待补原因:保留既有文稿/README内容,但尚未按pt780u具体描述标准逐项复核,不自动计完成;不表示既有内容全部无效。
做什么
面向Unicity钱包和应用开发者的模块化TypeScript SDK,涵盖身份/密钥、支付、请求、市场意图与消息。它与Sphere前端是两个仓库、两个许可判断;当前README明确支付库存由服务端持有,即使密钥留本地也不能宣传完全自托管资产。
谁会用
钱包用户与钱包/dApp开发者
用户画像依据
按项目定位概括的可能用户,非新增作者确认
解决的问题(编辑归纳)
未写/未核(null)
文档化使用场景(编辑归纳)
未写/未核(null)
主要能力与用途
作者文档能力包括BIP39/BIP32派生、可选seed密码保护、代币转移、支付请求、意图公告、Nostr私信/群聊和dApp钱包连接。不是挖矿/收益工具。Node默认钱包文件、浏览器IndexedDB;支付的持久状态与密钥存储是不同信任边界。
如何使用 / 既有稿流程
{
"business_flow_from_existing_study": "输入网络、钱包身份、接收对象和金额 → provider/配置校验 → 建持久intent并用transferId追踪 → token engine认证 → mailbox投递。文档区分delivered与confirmed+deliveryPending:后者是花费已认证、收件投递待续,不是应重付的失败。某些抛错也可能已提交/部分完成,应该沿同一intent核对/续收敛而非生成新付款;这是作者设计描述,不是本研究执行指导或已证明的exactly-once。余额不足/无效收件人/网络与金额校验等另有干净失败分类,具体实现未验证。",
"deployment_from_existing_study": "作者列浏览器包、Node>=22加WebSocket依赖;独立CLI尚未npm发布且依赖本地相对路径,不可照旧名假定可装。钱包种子与网络服务必须自行安全管理。本研究不安装/生成钱包/签名,未验证服务费、gas或endpoint可靠性,不转录README里的样例key。"
}用法证据状态
existing_study_reuse_not_new_verification
公开限制
重大文档告警:不传password时seed为明文;README称密码模式用CryptoJS AES-256-CBC及EVP_BytesToKey(MD5单次),快速KDF对短密码离线猜测保护弱;派生路径、支付日志等不被该密码保护。文档还承认JSON/legacy导入后会不带密码存种子、没有后加/改密码接口。本研究未核源码,不能独立认定缺陷已修/具体版本受影响,更不执行修复或提供攻击步骤。
根README provider/支付结果/失败恢复与Wallet Security章节分析;未读钱包实现、加密代码或测试运行。所有安全问题均为文档自述,不作实证漏洞报告。
未核实 / 来源缺口
未写/未核(null)
许可讨论
spdx_snapshot
MIT
discussion_zh
本SDK README声明MIT;这不覆盖另一个sphere前端README“Private project”授权边界,也不授权所有后端/服务和依赖。未读SDK LICENSE全文,不能用SDK许可替前端补授权。
strict_open_source_verified
False
完成评估
status
details_pending
count_as_completed
False
reason_zh
保留既有文稿/README内容,但尚未按pt780u具体描述标准逐项复核,不自动计完成;不表示既有内容全部无效。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
assistant_itemwise_content_reviewed
False
human_reviewed
False
assessment_recorded_cst
2026-11-17T08:58:55.997284+08:00
来源
https://github.com/unicity-sphere/sphere-sdk/blob/HEAD/README.md
{ "path": "README.md" }
研究层级与范围
{
"tier": "L_existing154_study_reuse",
"status": "existing_study_overview_reused_not_new_research",
"new_source_read_this_phase": false,
"json_path": "research/projects/unicity-sphere--sphere-sdk.json(数据包相对路径,不是站点 URL)",
"markdown_path": "research/projects/unicity-sphere--sphere-sdk.md(数据包相对路径,不是站点 URL)",
"legacy_quote_provenance": "local_selected_or_legacy_text_match_not_complete_source_verification",
"editorial_erratum": null,
"source_code_claim": "无新增源码实证"
}