SuperAPI AI 工具集

tokenpass

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:TokenPass 是个人身份服务器,用于实现比特币背书(Bitcoin-backed)的认证,可自建 OAuth 提供方,进行加密签名、加密解密与 BAP(Bitcoin Attestation Protocol)身份管理。

主要能力:由两部分组成——TokenPass Server(钱包管理、签名、加密的 REST API,端口 21000,API 前缀 /api/)与 TokenPass Desktop(带系统托盘、可自动启动的 Electron 应用)。API 覆盖钱包管理(register、login、logout、status、export)、访问令牌(auth,过期选项 once/1h/1d/1w/1m/forever,作用域 sign、encrypt、decrypt、read_profile、write_profile、read_state、write_state、fund、transfer)、加密操作(sign 使用 BSM 格式、encrypt 使用 ECIES)与身份管理(profile 的读取与更新)。

使用方式:服务端安装执行 git clone https://github.com/b-open-io/tokenpass-server、cd tokenpass-server、bun install、bun dev,运行于 http://localhost:21000。桌面端从 GitHub Releases 下载对应平台安装包(macOS arm64/x64 dmg、Windows setup.exe、Linux AppImage)。认证流程为:首次用 POST /api/register 创建钱包,再用 POST /api/login 解锁,然后 POST /api/auth 获取访问令牌,调用时在 Authorization 头中直接放令牌(无 Bearer 前缀)。数据存于 ~/.tokenpass/(seed.db、keys.db、state.db)。可通过 TOKENPASS_ORIGIN_WHITELIST 配置 CORS 白名单。React 集成使用 @sigma-auth/better-auth-plugin 客户端,可自动探测本地 TokenPass 并回退到云端 iframe 签名器,处理 PKCE OAuth 流程。

适用场景:需要自托管身份与签名服务的开发者,以及希望本地管理比特币密钥、为应用提供签名与加密能力的场景。

限制:资料未提供收费、价格、性能与平台兼容性等更多信息;具体 API 细节与集成示例需参考其 references 文档与官方仓库。