用途:诊断 bitcoin-auth 在客户端与服务器端的认证失败,包括令牌生成异常、签名验证错误及库集成问题,尤其针对 Sigma Auth 场景。
主要能力:验证令牌结构(以竖线分隔的五段格式 pubkey|scheme|timestamp|requestPath|signature);逐项校验公钥长度与前缀、scheme(bsm 或 brc77)、ISO8601 时间戳、请求路径与签名;通过 verifyAuthToken 检查签名,定位请求路径不一致、时间戳超出 timePad(默认 5 分钟)、body 哈希不匹配及编码差异(utf8、hex、base64)等问题。
必要用法:安装命令为 bun add bitcoin-auth,需 Node.js/Bun 运行时与 @bsv/sdk 对等依赖。使用 parseAuthToken 解析后逐段校验;验证时以服务器当前时间作为 timestamp,传入 requestPath、可选 body、timePad 和 bodyEncoding,新实现推荐 brc77 scheme。
适用场景:排查 invalid signature、invalid token、时间偏移、请求路径不匹配、body 哈希不符及 bsm/brc77 混淆等错误,也涵盖 Better Auth / Sigma 插件 403、CSRF 与回调 URL 问题。
限制:资料未提供收费、价格或效果信息;不要记录私钥或 WIF,诊断应使用测试密钥并清理日志。