Sismo primary sources
Reviewed: 2026-05-10 UTC
Core protocol framing
- https://docs.sismo.io/
- Official docs home for Sismo’s identity-aggregation and privacy-preserving proof stack.
- https://github.com/sismo-core/sismo-docs
- Official documentation repository; useful as the first-party index for the docs corpus.
- https://raw.githubusercontent.com/sismo-core/sismo-docs/main/README.md
- Clearest single-page framing in this pass: Sismo describes itself as a sovereign identity aggregator plus crypto-native SSO that lets apps request zero-knowledge proofs over user data.
Data Vault and anonymous identity model
- https://raw.githubusercontent.com/sismo-core/sismo-docs/main/data-vault/what-is-the-data-vault.md
- Most useful source for the private/local vault model, supported data sources, commitment receipts, and app-specific
vaultIdidentifiers used for anonymous uniqueness.
- Most useful source for the private/local vault model, supported data sources, commitment receipts, and app-specific
- https://raw.githubusercontent.com/sismo-core/sismo-docs/main/data-vault/commitment-mapper.md
- Critical trust-model source: Sismo explicitly describes the Commitment Mapper as a trusted offchain service that verifies ownership proofs, stores account-to-commitment mappings, and signs receipts used in later proving schemes.
Data Groups and upstream eligibility design
- https://raw.githubusercontent.com/sismo-core/sismo-docs/main/data-groups/data-groups-and-creation.md
- Defines Data Groups as valued sets of data sources, explains Factory and Hub creation flows, and states that Merkle roots are published onchain as the source of truth for proof verification.
- https://github.com/sismo-core/sismo-hub
- Official repository for the group-generation and badge/app integration layer.
- https://raw.githubusercontent.com/sismo-core/sismo-hub/main/README.md
- Best source for how Sismo Hub organizes group generators, data providers, offchain group computation, badge metadata, and app-facing integrations.
Attestation and badge issuance layer
- https://github.com/sismo-core/sismo-badges
- Official contracts repository for the protocol’s attestation and badge layer.
- https://raw.githubusercontent.com/sismo-core/sismo-badges/main/README.md
- Summarizes the core contracts: AttestationsRegistry, Attester, and Badges, plus Hydra S1 attester implementations.
- https://raw.githubusercontent.com/sismo-core/sismo-badges/main/contracts/core/AttestationsRegistry.sol
- Strongest low-level source for issuer authorization, attestation recording/deletion, and the stateless ERC-1155 badge view over registry balances.
Supporting repos for trust-surface analysis
- https://github.com/sismo-core/sismo-commitment-mapper
- First-party repository handle for the Commitment Mapper service referenced in the docs.
Main takeaways from this pass
- Sismo’s analytically important split is between private account aggregation, trusted ownership translation, reusable eligibility-group construction, and governed attestation issuance.
- The
vaultIddesign is a strong comparison point against public identity registries because it gives apps anonymous uniqueness without requiring one globally public subject record. - The Commitment Mapper is not incidental infrastructure; it is a named trusted service in the official docs and therefore a central control surface.
- Sismo Hub shows that group design and data-provider selection sit upstream of badge minting and proof verification, so eligibility politics live before the ZK proof layer, not only inside it.
- The contracts make clear that badges are only the presentation layer: authorized attesters and registry governance remain the choke points underneath.