StarkLotto

StarkLotto is a decentralized lottery game built on Starknet, designed to offer secure and efficient transactions on the blockchain. It leverages Cairo technology and a modular architecture in TypeScript for a fluid and innovative experience.

▶️ Watch the Hackathon Video

---

🌐 Testnet Version:
👉 https://starklotto-eta.vercel.app/

🚀 Features

• Decentralized lottery with smart contracts on Cairo.
• User interface developed with TypeScript and modern web technologies.
• Integration with Starknet wallets.
• Transparency and verifiability in the generation of winning numbers.

📜 Prerequisites

Before you begin, make sure you have the following requirements installed:

Compatible versions

• Starknet-devnet - v0.4.0
• Scarb - v2.11.4
• Snforge - v0.41.0
• Cairo - v2.11.4
• Rpc - v0.8.0

🔧 Installation

Follow these steps to set up and run the project:

1️⃣ Clone the repository

git clone https://github.com/FutureMindsTeam/starklotto.git
cd starklotto

📌 Note: If you wish to contribute, please create a branch off of Dev before committing changes.

  git checkout -b feature/your-branch Dev

2️⃣ Install dependencies

Install the project dependencies with:

  yarn install

3️⃣ Start the local network

yarn chain

4️⃣ Deploy the contracts

yarn deploy

5️⃣ Start the web application

yarn start

Next, open your browser and visit: http://localhost:3000

⚡ Usage

1️⃣ Compile and deploy the smart contract

Compile the contracts written in Cairo:

cd contracts
scarb build

📝 Contributions

If you want to contribute, follow these steps:

1. Fork the repository.
2. Create a branch off of Dev:

git checkout -b feature/new-feature Dev

3. Make your changes and commit:

git commit -m "Description of change"

4. Push your changes to your fork:

git push origin feature/new-feature

5. Open a Pull Request to the Dev branch.

🤝 Contact

If you have questions or want to contribute, you can contact us at:

• Discord: FutureMinds Community
• X: @futureminds_7
• Telegram Group: Starklotto Contributors This repo prefer yarn as package manager.

Commands:

Command	Description
format:check	(Read only) Batch checks for format inconsistencies for the nextjs and snfoundry codebase
next:check-types	Compile typscript project
next:lint	Runs next lint
prepare	Install husky's git hooks
usage	Show this text

CLI Smart Contracts

Command	Description
compile	Compiles contracts.
test	Runs snfoundry tests
chain	Starts the local blockchain network.
deploy	Deploys contract to the configured network discarding previous deployments.
deploy:no-reset	Deploys contract to the configured network without discarding previous deployments.
verify	Verify Smart Contracts with Walnut

CLI Frontend

Command	Description
start	Starts the frontend server
test:nextjs	Runs the nextjs tests
vercel	Deploys app to vercel
vercel:yolo	Force deploy app to vercel (ignoring errors)