sismo-badges 智能合约:把证明拆成登记、签发与徽章

sismo-badges 智能合约 项目概念

如果一枚链上徽章既想证明某种资格,又不允许被转手,它的智能合约要怎样安排职责?sismo-badges 是 Sismo Protocol 的合约仓库,README 将其描述为徽章铸造协议的合约集合,并把存证明、发证明、读证明拆给不同合约。下面按一次铸造请求的路径,梳理它公开的设计与取舍;文中社区发徽章的情节是假设场景,用于串联机制,不代表实测结果。

当社区想发一枚不可转让徽章,链上要记住什么

假设场景:一个链上学习社区想给完成课程的成员发一枚不可转让的徽章,用来证明“这个人学过这门课”,又不希望徽章被转卖。这个需求先要回答三个问题:证明存在哪里、由谁写入、谁能读取。sismo-badges 的做法是把职责拆开:登记处存证明,签发者验证请求并构造证明,徽章合约只读展示。README 说明该仓库包含 Sismo Protocol 的智能合约,并列出三个核心合约。这里的“证明”(attestation)可以理解为一条关于某个地址的链上声明,由被授权的签发者写入。上述社区需求是我的假设,用来串联后文,并非 README 中的案例,也未经过实测。

三个合约分工:登记处、签发者与只读徽章

README 把系统分成三个核心角色。AttestationsRegistry 是登记处,保存所有证明;它归治理所有,由治理授权或取消授权哪些签发者可以写入。Attester 是标准抽象合约,必须由签发者继承:签发者验证用户请求,构造将被登记处记录的证明。Badges 读取登记处,以 ERC1155 代币的形式提供对证明的视图,README 用“无状态、不可转让”来描述它。三者形成一条清晰的边界:写入权在登记处,验证与构造在签发者,展示在徽章合约。这种拆分让“谁能发”和“长什么样”不必写在同一份合约里,但也意味着接入方要同时理解三者的关系。

Attester 抽象合约把验证与构造拆成两步

要新增一种发放逻辑,README 的路径是继承 core/Attester.sol。开发者必须实现两个函数:_verifyRequest(request, proofData) 负责用用户提供的证明来校验请求,buildAttestations(request, proofData) 负责从已校验的请求构造出将要记录的证明。除此之外还有两个可选钩子,分别在记录证明之前和之后执行,供开发者插入额外逻辑。README 把 attesters/hydra-s1/HydraS1SimpleAttester.sol 称为实现这些函数的好例子。这里的“钩子”(hook)指合约在固定流程节点主动调用的扩展函数,让子类在不改动主流程的情况下加逻辑。这种接口形状把“判断请求是否可信”和“生成什么内容”分开,便于替换验证方案。

sismo-badges 一次铸造请求与本地开发各走哪条路径 机制示意

一次铸造请求与本地开发各走哪条路径

从一个请求的视角看,流程可以概括为:用户带着请求和证明数据调用某个签发者;签发者的 _verifyRequest 校验请求;buildAttestations 生成证明;随后由登记处记录,期间可触发前后钩子;徽章合约再从登记处读出结果。需要说明,这条顺序是根据 README 对三个合约与钩子的描述整理出的理解,不是实测得到的运行时序。开发侧,README 给出的命令包括 yarn 安装依赖、用 hardhat 编译(yarn compile)、yarn test 运行全部测试,以及 yarn storage-layout 打印存储布局。本地部署则要开两个终端,一个运行 yarn chain,另一个运行 yarn deploy:local。

零知识、nullifier 与账户绑定如何组合

两个现成签发者体现了不同的取舍。HydraS1SimpleAttester 使用 Hydra S1 证明方案与 nullifier 概念:用户必须随请求提供零知识证明,才能生成证明。这里的 nullifier 可以理解为一种防止同一资格被重复领取的标记。HydraS1AccountboundAttester 是前者的账户绑定版本,README 特别说明用户可以自行更新证明存放的位置,也就是徽章与账户的绑定关系可以迁移。徽章侧则坚持无状态与不可转让:合约不保管证明内容,只按登记处的数据给出 ERC1155 视图。这样的组合把“资格验证的复杂度”留在签发者,把“展示与转移限制”留在徽章层,代价是跨层排查问题更费周折。

哪些发放场景适合这套合约结构

按 README 的描述,这套结构适合需要“先验证资格、再发放不可转让凭证”的场景,例如假设中的课程结业徽章、社区贡献记录,或需要以零知识方式隐藏用户具体信息的资格发放。想复用现成零知识路径的团队,可以研究 HydraS1SimpleAttester;需要让用户迁移绑定位置的,则可看账户绑定版本。若团队已有自己的验证逻辑,则按抽象合约实现两个必需函数与可选钩子,再接入登记处。README 把 HydraS1SimpleAttester 称为实现这些函数的好例子。README 鼓励开发者把新签发者以 PR 形式提交到 /attester 目录。以上适配判断是基于接口形状的推断,README 未给出具体行业案例。

README 之外仍需确认的边界与风险

README 是一份仓库说明,不是安全评估报告。README 把协议完整概览指向外部文档。README 说明已部署合约地址可在外部文档页面找到。因此仅凭本页无法判断具体部署的参数与治理现状。仓库虽然提供了 yarn test 与存储布局脚本,但 README 未在页面内给出测试结果、审计结论或风险披露,这些方面尚待确认。另一个需要留意的点是签发者权限:登记处由治理授权写入者,一旦授权逻辑或治理本身出问题,影响面会落在证明记录层。此外,零知识证明方案涉及电路与证明系统,README 只给出名称与链接,未展开其假设与失效条件。上述风险点是基于文档边界的提醒,不代表已经发现漏洞。

接入前应该核对哪几件事

接入前可以先做几项核对:确认目标链上登记处的治理与授权状态,确认所选签发者的验证假设是否与自己的资格模型一致,确认徽章展示层是否需要自行封装读取逻辑。README 表示文档中提供了开发新签发者的指南,可作为实现细节的入口。它也把联系方式放在 Discord 与 Twitter,便于就设计问题提问。许可证方面,README 标注项目以 MIT 许可证分发,但使用前仍应自行核对依赖与部署合约的实际条款。最后要记住本文的边界:所有机制描述都来自文档,具体合约行为需要读者自行验证,尤其是治理权限与零知识证明方案的实际配置。

把证明的存储、签发与展示分开,是 sismo-badges 在 README 中呈现的主要结构;它是否适合你的场景,取决于你对治理、验证假设与展示层的核对结果。本文仅依据README资料整理,未独立实测。

参考来源

本文仅据固定版本 README 整理,未独立实测;仅作技术介绍,不构成安全审计或投资建议。

采集时间:2026-10-26T16:10:21.949Z;15867 Star 快照。首次发现;暂无可用的约24小时基线,日增长未知。

sismo-core/sismo-badges README · 09206e396ca2342a88f7eaa897d55783f019f759

GitHub 仓库及采集时元数据

标签 智能合约sismo-badges合约开发

本文基于公开媒体报道整理,仅作信息参考,不构成任何投资依据,内容以原文为准。

相关阅读

同分类「软件」的其他稿件

更多软件 →