Smart contracts

Voting contract

getProcessLength(organizationAddress) : int
getProcessByIndex(organizationAddress, index): processId
getProcessMetadataById(organizationAddress, processId): processMetadata

Data structs

ProcessMetadata

censusUrl //Where is the census Merkle-tree
censusRoot //Merkle-root of census
votingOptions //string that has an inmutable reference to the voting options
startBlock
endBlock
voteEncryptionKeys
status
trustedGateways

VotingPackage

FranchiseProof
EncryptedVote
Nullifier
ProcessID

Modules

Indentity

getVotingPublicKey(): Public Key
getVotingPrivateKey: Private key

Franchise

getNullifier(privateKey, processId) : nullifierHash
generateProof(privateKey, censusProof, censusRoot, nullifier, processId, encryptedVoteHash) :franchiseProof

Census

getCensus()
getCensusProof(votingPublicKey)

Data

getExternalData(url)

Blockchain

getProcessById(): processMetadata
getOpenProcess(): [processIds]
getRegisterdRelays(): [relayPublicKeys]
batchExists(voteBatchHash): bool

Relay

generatePOW(votingPackage): powNonce
encryptVotingPackage(votingPakage, relayPublicKey)
sendVote(gatewayIP, votingPackage, powNonce)
getVotesBatchHashByNullifier(nullifier)

Vote

getOptions()
getEncryptedVote(selectedVoteOptions, voteEncryptionKeys)
getHash(encryptedVoteHash)
getVotingPackage(franchiseProof, processId, encryptedVote, nullifier) : votingPackage

Flow

Vote Manager

Blockchain --> getProcessById()
Vote --> getOptions()
<UI input>
Vote --> getEncryptedVote()
Vote --> getEncryptedVoteHash()
Identity --> getVotingKey()
Census --> getCensusProof() Data --> getExternalData()
Identity --> getVotingPrivateKey()
Franchise --> generateFranchiseProof()
Franchise --> getNullifier()
Relay --> generatePOW()
Vote --> getVotingPackage()
Blockchain --> getRegisterdRelays()
Relay --> encryptVotingPackage()
Relay --> sendVote()
Relay --> getVotesBatchHashByNullifier():votesBatchHash
Data --> getExternalData(voteBatchHash)
Blockchain --> batchExists(voteBatchHash)