sovran
一个用于比特币钱包开发的 Monorepo,包含钱包逻辑、Nostr 客户端和文档。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:sovran。 它的用途是:一个用于比特币钱包开发的 Monorepo,包含钱包逻辑、Nostr 客户端和文档。 完整的 Skill 内容见:https://321skill.com/skills/sovran/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个集成 Nostr 社交功能的比特币钱包,参考 Sovran 项目的结构,帮我规划一下 Monorepo 的包划分和依赖管理策略。”,它会为你分析 Sovran 中 app、wallet、nostr 包的职责划分,并解释如何利用 Bun 工作区进行依赖管理和开发命令集成。或者,你可以说:“查看一下 Sovran 中 wallet 包是如何处理支付逻辑分类的”,AI 可以引导你阅读相关源码并解释其设计思路。
介绍
Sovran 是一个用于构建比特币钱包应用的 Monorepo 项目,旨在为开发者提供一个集成的开发环境。它解决了在开发包含支付逻辑、社交协议(Nostr)集成和文档的复杂移动应用时,需要管理多个独立仓库和依赖关系的痛点。
通过使用 Bun 工作区,Sovran 将核心应用(基于 Expo/React Native)、独立的钱包支付逻辑包(wallet)和类型安全的 Nostr 客户端助手包(nostr)组织在一起。开发者只需在根目录执行 bun install 即可安装所有依赖,并通过 bun run dev 启动应用,实现了依赖的直接链接和无缝开发体验。
这个项目非常适合正在开发基于 Cashu 协议的比特币钱包、需要集成 Nostr 社交功能,并希望保持代码模块化和开发效率的前端或全栈开发者。对于需要统一管理应用逻辑、数据层和文档的团队来说,这是一个理想的项目结构范例。
建议在开始前确保已安装 Bun 运行时。由于 wallet 和 nostr 包直接提供 TypeScript 源码(无构建步骤),在 IDE 中可以获得更好的类型提示和开发体验。注意,外部共享的模式包(@sovranbitcoin/schemas)需要从 GitHub Packages 解析,请确保 .npmrc 配置正确。
核心特点
与常见的单一钱包 SDK 不同,Sovran 提供了一个包含 UI 无关的钱包支付逻辑(wallet)和完整的 Nostr 数据层客户端(nostr)的完整 Monorepo 结构,两者都直接提供 TypeScript 源码,并与主应用(app)通过 Bun 工作区无缝集成,极大简化了涉及多协议集成的比特币应用开发流程。
注意事项
该项目主要面向比特币(尤其是 Cashu 协议)和 Nostr 生态的开发者,不适用于开发其他区块链或支付类型的应用。
常见问题
Sovran 钱包支持哪些比特币协议?
主要专注于 Cashu 协议,提供了相应的支付 UX 逻辑和离线建议功能。
Nostr 包是完整的客户端吗?
它是一套类型化的、UI 无关的客户端助手,用于连接 Nagg GraphQL/App-View API 和 Nostr 数据层,并非一个带界面的完整客户端。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/sovran/raw/index.md 读取 sovran 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/sovran/raw/index.md(查看排版版本)