arcium-election

KO | EN

gitlite — search

#python #hacktoberfest #react #go #rust #deep-learning #macos #nodejs #awesome #cli #awesome-list #security #pytorch #ios

arcium-election

(★ 15)

Arcium voting example

arcium-election 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Private Elections on Solana with Arcium

![Tests](https://github.com/quiknode-labs/arcium-election/actions/workflows/test.yml/badge.svg?branch=main)

Based on the https://github.com/arcium-hq/examples 'voting' app with a significant number of fixes:

## Main Changes from Upstream

- Replaced legacy web3.js with Solana Kit
- Fixed race conditions in tests
- Improved CI/CD with GitHub Actions
- Better error handling and validation
- Consistent naming conventions throughout (poll authority, choice, vote_counts). Avoid re-using the word 'vote' in multiple contexts.
- Program ID is now read from IDL instead of hardcoded
- Comprehensive test coverage with multiple users
- Build and dependency management improvements
- Better documentation and code comments

## Watch the Video

[![Private transactions on Solana with Arcium](https://img.youtube.com/vi/X3Y6sL7A8O0/maxresdefault.jpg)](https://www.youtube.com/watch?v=X3Y6sL7A8O0)

## To Run

Prerequisites:

- Install Arcium
- Install Docker: https://docs.docker.com/desktop/setup/install/mac-install/
- Start Docker desktop app (if you get `docker daemon not running` you haven't started Docker desktop app)

Run `npm test`. That script will:

- Set the correct Anchor version (0.32.1) if avm is available
- Unset RUSTUP_TOOLCHAIN to use Rust 1.92.0 (from rust-toolchain.toml)
- Kill any running Solana validator and remove test ledger for clean state
- Build the program and generate Codama client
- Run `arcium test` to test with Arcium 0.6.6

## How the Election program works, and how Arcium works

This is all explained beautifully in the video (see below), but also it's nice to have things written down:

### Creating a new Poll (creating a Solana PDA with an encrypted value)

- `create_poll` (`programs/election/src/handlers/create_poll.rs`) - creates the poll PDA, initializing the poll (programs/election/src/state/poll.rs) with its regular values, but leaving `vote_counts` empty. Create poll then uses `queue_computation` to invoke...
- `create_poll` (`encrypted-ixs/src/lib.rs`) to create the initial encrypted value of `vote_counts` (i.e, `[0, 0, 0]`, encrypted), which will be received by...
- `create_poll_callback` - receives the encrypted `[0, 0, 0]` and saves them to the `vote_counts`

### Voting (sending instructions with encrypted values and manipulating encrypted data)

- Clients get a `sharedSecret` (`tests/helpers.ts`) they can use to encrypt values they sent to instruction handlers
- Client invoke the instruction handlers like normal (using Anchor JS or a Codama client - see `tests/election.ts`) specifying the encrypted value as their `choice` and specifying the address of the `poll`
- `vote` (`programs/election/src/handlers/vote.rs`) gets the `choice` and the current value of `vote_counts` from the `poll` and then uses `queue_computation` to invoke...
- `vote` (`encrypted-ixs/src/lib.rs`) which decrypts the `choice` and the current value of `vote_counts`, increments the choice in `vote_counts`, and encrypts the new `vote_counts`, which will be received by...
- `vote_callback` (`programs/election/src/handlers/vote.rs`) which saves the new `vote_counts` to the `poll`

### Revealing the final result

- Only the poll authority can call `reveal_result` (`programs/election/src/handlers/reveal_result.rs`) to decrypt and reveal the vote tallies. The handler uses `queue_computation` to invoke...
- `reveal_result` (`encrypted-ixs/src/lib.rs`) which decrypts the `vote_counts`, compares all three vote counts, and returns the winning option (0, 1, or 2), which will be received by...
- `reveal_result_callback` (`programs/election/src/handlers/reveal_result.rs`) which emits a `RevealResultEvent` with the winning option. We could instead save the winning option to a PDA, log it, or do whatever else we want.

### Oh and by the way

Since we have 3 encrypted instruction handlers in `encrypted-ixs/src/lib.rs`, we have 3 matching Solana instruction handlers to deploy the compiled code to Solana PDAs - these are called `init_create_poll_comp_def`, `init_vote_comp_def`, and `init_reveal_result_comp_def`. These are called once when deploying our program, see the `before` hook in `tests/election.ts`.

arcium-election

arcium-election 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

arcium-election

arcium-election 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README