Ethereum Antakshari

A toy implementation of Antakshari like game on the ethereum blockchain. The game works as follows: There is a judge J and n players a_1, a_2 ... a_n. At k-th turn player inputs a word w_k, such that w_k[w_k.len - 1] == w_{k-1}[0] and J determines if the word is new and valid. The game starts with a valid word set by the contract. The game ends when all but one player run out of lives, either by giving a wrong word or passing their turns.

This is the course project for the Introduction to Blockchains course at CMI by

• Arghyadip
• Arunava
• Harsh
• Namratha
• Paarth

Getting Started

1. Install Truffle
2. Install Ganache for a local auto-mining blockchain
   OR Use a Test Network for dev
   OR Use the Ethereum Mainnet
3. Install Node.js and Yarn v1
4. Clone the repository

   git clone https://github.com/arghyadipchak/eth-word-game
   

5. Navigate to the truffle directory
6. Setup truffle-config.js
7. Migrate solidity contracts and grab the contract address from the output

   truffle migrate
   

8. Navigate to the client directory
9. Install client dependencies

   yarn install
   

10. Put the contract address (from 7) as deployerAddress in src/lib/store.ts and as factAddress in scripts/judge.js
11. Set an account as the Judge, set it's public key as judgeAddress in src/lib/store.ts and it's private key as wallPrvtKey in scripts/judge.js
12. Run the judge

    node judge.js
    

If you wish to use a different set of dictionary words, populate the worddict.json with a sorted list of your words \

13. Serve the client

    yarn dev
    

    OR Build the client

    yarn build
    

    and serve it using a web server such as Nginx/Traefik

Project Report

The project report is available in the report directory