unicity-sphere/sphere-sdk

解決的問題

Sphere SDK 提供模組化的 TypeScript 工具包，用於與 Unicity 狀態轉移網路互動。它簡化了管理數位錢包、執行認證代幣轉帳以及處理去中心化訊息傳遞的複雜流程，讓開發者無需從零開始建構基礎架構，即可將支付與身分功能整合至瀏覽器或 Node.js 應用程式中。

運作方式

SDK 使用分層提供者模型，將核心錢包功能與支付傳輸層分離。它結合基礎層（處理儲存、身分與基於 Nostr 的訊息傳遞）與特定的 wallet-api 傳輸層，後者負責實際資金移動。雖然金鑰保留在客戶端本地以確保安全，但代幣庫存則由伺服器端管理。系統透過「引擎認證」轉帳與持久化意圖系統，確保即使在網路崩潰或證明不確定的情況下，也能防止重複支付，保障支付安全。

適用對象

專為使用 TypeScript 建構去中心化應用（dApps）、數位錢包或整合支付平台的開發者設計，適用於需要安全、抗崩潰代幣轉帳與去中心化身分管理的場景。

主要特色

• 抗崩潰支付：使用持久化的伺服器端意圖與郵件箱投遞系統，確保轉帳完成且不會重複支付。
• 混合託管：私鑰保留在使用者本地，同時利用伺服器端庫存管理以提升效率。
• 多地址支援：實作 BIP32/BIP44 HD 錢包衍生，可從單一種子管理多個位址。
• 去中心化訊息傳遞：整合 Nostr（NIP-17 與 NIP-29），支援直接訊息、群組聊天與暱稱發布。
• 模組化架構：可交換的提供者層使 SDK 能在不同環境（瀏覽器、Node.js）與自訂網路設定中運作。