Sismo
Solidity smart contracts for Sismo's protocol that record and mint badge attestations.sismo-core/sismo-badges
- Stars
- 15.9k
- Forks
- 523
- Licence
- MIT
- Language
- TypeScript
- Last update
- 3.1 years ago
- Type
- Library
No commits in over a year — check for forks or alternatives before adopting.
What it is
This repository holds the Ethereum smart contracts behind the Sismo Protocol. A registry stores attestations, attesters are contracts that verify user requests and create those attestations, and a Badges contract shows the attestations as non-transferable ERC1155 tokens. The README describes it as a set of contracts rather than an app for end users.
- Compile the contracts with Hardhat and run the test suite
- Run a local chain and deploy the contracts to it for testing
- Write a new attester by inheriting core/Attester.sol and implementing its verification and attestation-building functions
- Inspect the included HydraS1SimpleAttester as a worked example
Great for
- Developers building or auditing Ethereum contracts for the Sismo attestation system
- Teams that want to write a new attester by inheriting the Attester abstract contract
- Engineers studying how zero-knowledge proof based attestations are recorded on-chain
Not ideal for
- People looking for a finished end-user app, since the README covers contracts only and not a user interface
- Developers without Solidity or Ethereum experience, because the work assumes smart contract concepts
- Anyone needing current activity, since the last push date shown is 2023-10-03
How to get it
- 1
Clone and build from source
You'll need: Git · Node.js · Yarn
Install dependencies
yarnCompile contracts
yarn compileRun tests
yarn test - 2
Run it
- Clone the repository from GitHub.
- Run yarn to install dependencies.
- Run yarn compile to compile the contracts with Hardhat.
- Run yarn test to launch the test suite.
- 3
Get the most out of it
- Use yarn storage-layout to print the storage layout of the contracts
- Run yarn chain in one terminal and yarn deploy:local in another to deploy to a local chain
- Follow the attesters guide in the Sismo documentation to build a custom attester
- Check the deployed contract addresses page in the Sismo docs for live deployments
Downloads
Strengths
- MIT licensed, so the code can be reused with few restrictions
- Clear split between the registry, the attester base contract, and the badge view
- Includes ready-made attesters and a documented way to add new ones
Trade-offs
- The README is short and relies on external docs for the protocol and attester guide
- Last push shown is October 2023, so maintenance status is unclear
- Requires familiarity with Solidity, Hardhat, and zero-knowledge proofs to use meaningfully
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| sismo-badges (this) | 15.9k | Library | advanced | 3.1 years ago | Developers building or auditing Ethereum contracts for the Sismo attestation system |
| openzeppelin-contracts | 27.3k | Library | intermediate | 4 days ago | Developers writing Solidity smart contracts who need standard tokens or permission systems |
| truffle | 13.9k | Dev tool | intermediate | 2.5 years ago | Developers maintaining existing Truffle-based Ethereum projects |
| ccxt | 44.7k | Library | intermediate | 4 days ago | Developers building trading bots or algorithmic trading software |
| full-blockchain-solidity-course-py | 11.2k | Learning resource | beginner | 2.6 years ago | Beginners who want a structured path into Solidity and smart contracts |
| shardeum | 31.2k | Other | advanced | 1.1 years ago | Developers building or testing EVM-compatible decentralized apps who want a local test network |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.