Vocdoni primary sources
Reviewed: 2026-05-10 UTC
Core protocol framing
- https://vocdoni.io/
- Official site and product surface for Vocdoni.
- https://developer.vocdoni.io/
- Official developer portal and source-of-truth docs hub.
- https://raw.githubusercontent.com/vocdoni/developer-portal/main/README.md
- Confirms the developer portal is the source-of-truth for technical documentation under the Vocdoni umbrella.
Protocol architecture and control surfaces
- https://raw.githubusercontent.com/vocdoni/developer-portal/main/docs/protocol/index.md
- Best single source for protocol architecture in this pass.
- Used to confirm that Vocdoni splits governance infrastructure across Vochain, gateways, IPFS storage, multiple census origins, and configurable election / vote modes.
- Especially important for the claims that gateways compute results and serve census proofs, while Vochain anchors election state.
Node and validator surface
- https://raw.githubusercontent.com/vocdoni/vocdoni-node/main/README.md
- Best source for the current operator model.
- Used to confirm gateway vs miner modes, resource assumptions, and the selective validator-admission process.
- Most analytically useful detail: validator upgrades are manual and handled via the team, which makes current consensus participation meaningfully permissioned.
Client and organizer workflow
- https://raw.githubusercontent.com/vocdoni/vocdoni-sdk/main/README.md
- Used to confirm account creation, faucet-based bootstrapping, election creation, signer expectations, and the organizer-facing role of VOC tokens.
- Helpful for understanding that voter participation can be gasless while election creation still sits inside the native token control plane.
Main takeaways from this pass
- Vocdoni’s main reusable primitive is not “online voting” in the abstract, but a modular election stack that separates state settlement, result publication, voter-eligibility definition, and metadata storage.
- The protocol’s strongest analytical contribution is its census modularity: weighted Merkle, indexed Merkle for zk flows, credential-service-provider flows, and token-based censuses all sit behind a common election backend.
- The biggest hidden control surfaces are current validator admission, gateway/indexer operation, and organizer-side election-configuration choices such as dynamic census, anonymity, encryption, and interruptibility.
- Vocdoni is therefore a useful comparison class for governance systems that treat voting as a front-end problem, because it makes the backend authority layers much more visible.