This repository contains my implementation of Zero-Knowledge Sudoku, Wordle, and Trivia games using both Aleo and Noir. They are not 100% complete and are not fully tested. But they are at least playable and demonstrate the potential of using both Aleo and Noir to build simple games.
Video walkthroughs:
Disclaimer: These videos are more for the purpose of explaining to my future self what my code is doing. If you want you can watch these videos at your own benefit 🙂.
- cd
noir
npm install
- Open a new terminal in
noir
and runnpx hardhat node
npm run deploy
to deploy verifier contracts to local node.- Take a note of the addresses the contracts deployed to and set that in
frontend/src/constant.ts
.
- Take a note of the addresses the contracts deployed to and set that in
- Follow https://developer.aleo.org/testnet/getting_started/deploy_execute to setup a local node in development mode till step 4
- Note: The snarkOS commit hash I used is 8cfa1657746bcdc372207f788f093b3060aac350
- To deploy
sudoku.aleo
:cd aleo/sudoku && leo build
export PRIVATE_KEY=<PRIVATE_KEY>
- Run
snarkos developer deploy sudoku.aleo --private-key $PRIVATE_KEY --query "http://localhost:3030" --path "build/" \ --broadcast "http://localhost:3030/testnet3/transaction/broadcast" --fee 600000 \ --record <Record_that_you_just_transferred_credits_to>
- To deploy
wordle.aleo
:cd aleo/wordle && leo build
export PRIVATE_KEY=<PRIVATE_KEY>
- Run
snarkos developer deploy wordle.aleo --private-key $PRIVATE_KEY --query "http://localhost:3030" --path "build/" \ --broadcast "http://localhost:3030/testnet3/transaction/broadcast" --fee 600000 \ --record <Record_that_you_just_transferred_credits_to>
- To deploy
trivia.aleo
:cd aleo/trivia && leo build
export PRIVATE_KEY=<PRIVATE_KEY>
- Run
snarkos developer deploy trivia.aleo --private-key $PRIVATE_KEY --query "http://localhost:3030" --path "build/" \ --broadcast "http://localhost:3030/testnet3/transaction/broadcast" --fee 600000 \ --record <Record_that_you_just_transferred_credits_to>
- Open a new terminal
- cd
backend
npm install
npm run dev
- Open a new terminal
- cd
frontend/
npm install
npm run start
- cd
noir
npm run test-sudoku
npm run test-wordle
npm run test-trivial
- Testing noir circuits individually works. But if you test them all at once with
npx hardhat test
some might fail. - When minting sudoku NFT, in case you run in to errors like "Nonce too high. Expected nonce to be 0 but got 2. Note that transactions can't be queued when automining," check this out: https://medium.com/@thelasthash/solved-nonce-too-high-error-with-metamask-and-hardhat-adc66f092cd
- Sudoku Noir code is modified from https://github.com/guipublic/crypdoku
- Wordle frontend code is modified from https://github.com/iamshaunjp/React-Wordle/tree/lesson-15