Ship for review
Your repo is the proof. A reviewer should be able to install it, run it, connect a wallet, switch to a testnet, read contract state, send a transaction, and see the receipt state without asking you for help.
What must be visible
Do not hide the important Web3 parts inside a demo video only. Put them in code, UI text, and README screenshots or notes.
Your project should clearly use Wagmi 3, Viem 2, and TanStack Query. Wagmi is a React Hooks library for Ethereum, and current setup uses TanStack Query as a peer dependency, not a hidden internal detail.
Repo checklist
Do each one yourself, then tap it to tick it off. The ticks are only a checklist for you: they are not marked or scored.
0 of 5 done
README skeleton
Keep the README short, but make it runnable. Replace the placeholders with your actual contract and flow.
Project: Campus Voting Dapp
Stack
- React
- wagmi 3
- viem 2
- @tanstack/react-query
Supported network
- Sepolia
- Chain ID: 11155111
Run locally
1. npm install
2. cp .env.example .env
3. Add any required RPC or contract values
4. npm run dev
Contract
- Address: 0x...
- Read function used: getVoteCount
- Write function used: vote
User flow
1. Connect wallet
2. Switch to Sepolia if needed
3. Read current vote count
4. Review signing details shown in the UI
5. Confirm the transaction in wallet
6. See transaction hash while pending
7. See receipt after confirmation
Error handling shown
- User rejected request: 4001
- Wallet request already pending: -32002
Notes for reviewers
- No mainnet funds are needed
- Test with a Sepolia-funded walletCommon shipping mistake
Many teams build the flow but forget the reviewer experience. If the README does not say which chain, which contract, and which button to click, your good code may look broken.
Also avoid copying old Wagmi v1 tutorials into your final repo. This track expects Wagmi 3 with Viem 2 and TanStack Query configured in the app.
Use AI carefully
Ask an AI tool to review your README like a hackathon judge. Then check every suggestion against your actual code before you paste it.
Good prompt: “Read this README and tell me if a reviewer can run this Wagmi 3 dapp, connect a wallet, use Sepolia, send a transaction, and verify error handling. Do not invent features.”
Final test pass
Do each one yourself, then tap it to tick it off. The ticks are only a checklist for you: they are not marked or scored.
0 of 5 done
Do this now
Do each one yourself, then tap it to tick it off. The ticks are only a checklist for you: they are not marked or scored.
0 of 5 done