Settlement Witness
本地验证SAR v0.1结算收据签名
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Settlement Witness。 它的用途是:本地验证SAR v0.1结算收据签名 完整的 Skill 内容见:https://321skill.com/skills/settlement-witness-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我验证一下这个结算收据文件 receipt.json 的签名是否有效',它会读取文件,自动按RFC 8785规范化JSON内容,然后用内置的Ed25519公钥(需预先配置)校验签名,返回'验证通过,签名有效'或'验证失败,签名不匹配'的结果,并附上简要的校验过程说明。
介绍
结算收据签名验证是金融交易和清算场景中常见的需求,但手动完成Ed25519签名校验和RFC 8785 JSON规范化既繁琐又容易出错。这个Skill提供一个开箱即用的本地验证能力,让你无需深入密码学细节,即可快速确认收据的完整性和来源可信度。
使用方式非常简单:将接收到的SAR v0.1格式结算收据文件(通常是JSON文本)提供给该Skill,它会自动解析、按RFC 8785规范对JSON进行标准化,然后使用Ed25519公钥对签名进行校验,最终返回“验证通过”或“验证失败”的明确结果。整个过程在本地完成,不依赖外部网络服务。
适合金融科技开发者、量化交易系统运营人员、结算对账工程师以及需要离线验证收据真实性的审计人员。如果你负责维护交易后处理系统、运行加密货币结算节点,或者需要定期核查对账文件的签名,这个工具能显著提升效率和准确性。
使用建议:确保收据文件严格遵循SAR v0.1协议规范,公钥需提前从可信渠道获取并妥善保管。该工具仅验证签名有效性,不验证收据内容的业务逻辑是否正确。建议在自动化流水线中集成该Skill,例如在接收到结算文件后自动触发验证。
核心特点
与通用签名验证工具(如OpenSSL或Python cryptography库)相比,该Skill内置了RFC 8785 JSON规范化处理,自动解决JSON字段顺序、空白字符等导致的签名不匹配问题,无需手动调整序列化逻辑,开箱即用。
注意事项
不适用于验证非SAR v0.1格式的签名(如XML签名、其他JSON规范化标准的签名),也不支持远程签名验证或证书链验证。
常见问题
如何安装这个Skill?
通过MCP客户端执行命令:mcp install settlement-witness,或按照项目README中的指引进行安装。
收据文件需要什么格式?
必须是符合SAR v0.1协议的JSON文本文件,包含signature字段和对应的公钥标识。具体字段定义请参考SAR v0.1规范文档。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/settlement-witness-x/raw/index.md 读取 Settlement Witness 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/settlement-witness-x/raw/index.md(查看排版版本)