Practical overview
When it fits
Use the repository when developing Sismo Protocol contract logic, especially an attester or a registry-backed badge system; consult its linked documentation for the broader protocol and attester guidance.
Who it is for
- Solidity developers building or extending Sismo Protocol attesters.
- Developers exploring registry-backed attestations and non-transferable badge views.
- Teams prototyping proof-based attestation flows with Hydra S1 examples.
Documented uses
- Implement request verification and construct attestations in a custom attester.
- Use the registry and badge contracts as a pattern for recording and displaying attestations.
- Study Hydra S1 attesters that accept zero-knowledge proofs and use nullifiers.
- Install, compile, test, inspect storage layout, or deploy the contracts to a local chain.
Requirements & limits
The repository is public and specifies the MIT License.
- Registry writes depend on issuer authorization by governance.
- The Hydra S1 simple attester requires a zero-knowledge proof with the user request.
- The account-bound Hydra S1 variant allows users to update where the attestation is stored.
- The README documents local-chain deployment separately from its link to deployed contract addresses.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and compile the contract repository
Prepare the repository dependencies and compile its contracts with the documented commands.
Before you start
- A local development environment with Yarn available.
Steps
Run
yarnto install dependencies.Run
yarn compileto compile the contracts using Hardhat.
Expected outcome
The repository dependencies are installed and the contracts are compiled.
Guide limitations
- This covers setup and compilation only; it does not deploy contracts or verify a modified implementation.
Develop a custom attester
Add the required request-verification and attestation-construction logic to an attester inheriting the abstract contract.
Before you start
- The repository and its
core/Attester.solabstract contract. - A design for validating requests against proof data and constructing attestations.
Steps
Inherit
core/Attester.solin the new attester.Implement
_verifyRequest(request, proofData)to verify the user request against its proof.Implement
buildAttestations(request, proofData)to construct attestations from a verified request.Optionally implement
_beforeRecordAttestationsor_afterRecordAttestationshooks.
Expected outcome
A custom attester implementation with the required verification and attestation-construction functions.
Guide limitations
- The repository describes the implementation responsibilities but does not establish that a particular custom attester is correct or compatible with a deployment.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- sismo-core/sismo-badges · Official homepage title · retained in its source language

