Web3 Engineering Assignment

Thank you for your interest in joining the SX engineering team!

This document is just a quick test to see where your coding and problem solving skills are with something related to dApp development. It’s designed to be straightforward and not take too much of your time.

Since a lot of this position will involve integrating with Solidity contracts, we've created a task that, in some capacity, represents the tooling you'll be working with on a day-to-day basis with us.

Background

"Blind" voting on a public blockchain takes some thought. All data is public so without any extra tricks it's trivial to see who voted what and which side is likely to win. This can greatly bias voters and lead to inefficient decisions.

One way to mitigate this is to use a "commit-reveal" scheme. In such a scheme, eligible voters commit Hash(x + secret) in some "commit period" where x is their vote choice. For simplicitly, suppose x is either 0 or 1 and the "+" operator means concatenation. So for example, a user might commit a vote "Hash(0~mysuperbigsecret)". We call this the "commitment".

After the "commit period", voters can reveal their vote by supplying (x + secret), and their Hash(x + secret). This would be "0~mysuperbigsecret" and "Hash(0~mysuperbigsecret)" respectively, in this case. Using the fact that hash collisions are impossible using a cryptographic hash function, we can cryptographically prove that a user committed to a particular vote by computing the hash of (x + secret) and comparing it with the supplied commitment.

Using this technique, it's now impossible to know what a given user committed to before the revealing period unless they told you their secret beforehand, grealty improving the effectiveness of the vote.

The task

We've written a simple implementation of a commit-reveal vote scheme in Solidity in CommitReveal.sol. Our ask is for you to write a very simple script to wrap it and make it easy for users to participate in the vote.

The Solidity implementation we wrote is very simple: it has only two choices, "YES" and "NO", the commit phase lasts 2 minutes, and users can vote multiple times. It's based on the blog written by Karl Floresch which we encourage you to check out here if you're looking for more background. For this simple assignment, there will be only one voter (you).

Requirements

Using any framework you'd like, please make a linear script that interacts with the contract. In a real implementation, we would have many different voters and a requirement that a voter can only vote once, but this is just a dummy example. Here are the functional requirements:

• If the blockchain is in the commit phrase, the user should be able to see the two choices they can vote for, "YES" (choice1 in CommitReveal.sol) and "NO" (choice2 in CommitReveal.sol) and commit a vote. A user can run this as many times as they want, provided they use a different secret each time. Behind the scenes it should be map "YES" and "NO" to the appropriate "1" or "2"
• If the blockchain is in the reveal phase, the user should be able to reveal a vote by supplying their secret and their vote. A user can run this as many times as they want, provided they reveal a different commit each time.
• If all votes have been revealed, the program should output
  • The winner of the vote
  • How many votes were cast

Things you don't have to do:

• Publish this as an NPM package
• Write any further tests for the contracts or exhaustive tests for your script. The script just needs to work.
• Add any functionality for "switching" between accounts. A user can vote multiple times with different secrets and that is totally fine.
• Deploy this on any public blockchain. Use a local blockchain such as hardhat (running npm run deploy will deploy locally provided that you have npx hardhat node running).

For interacting with the contracts, we recommend ethers.js although you can use any framework you'd like.

Setup

First, install the dependencies. You'll need a local Ethereum blockchain to deploy the contracts and run the contract tests if you want. We recommend hardhat.

Other notes

• We've already written the deploy script (see deploy.ts) and there are some helper npm scripts in package.json in case you don't want to install hardhat globally.
• The test folder includes some example code to interact with the contracts if you need some hints. You don't have to use ethers and hardhat to interact with the contracts as mentioned above.
• To help with transitioning from the commit phase to the reveal phase, we've provided some example code in the test folder. Ethers has a special command called evm_increaseTime which can artifically set the next block's timestamp. Alternatively you can just wait. Just remember that once you go forward in time you can't go back. You'll need to restart your local chain to do that.

All you have to do is write your script.

What we're looking for

We're interested in your coding style, your familarity with developer tooling for smart contracts or your ability to learn the tooling, and your JavaScript/TypeScript proficiency.

How to complete this challenge

Fork this repo, and make your new repo private. Write your code in a sub-folder in this repo, and edit this README to include instructions on how to use your script. Feel free to change anything in the repo except for the CommitReveal.sol contract.

Send [email protected] the private GitHub link when you're done. Additionally, please give @dankostiuk access.

Good luck!