Decentralized 24-hour ICP lottery on the Internet Computer.
WinCanister runs transparent daily rounds on-chain: users deposit ICP to a canister account ID, entries are credited automatically, and winners are drawn with ICP-native randomness when the timer ends. The protocol keeps 1% treasury and pays 99% to the top three winners (60% / 25% / 15%).
| Dashboard | win-canister-gamma.vercel.app |
| Repository | github.com/prasangapokharel/WinCanister |
| Canister | ulahq-iyaaa-aaaao-bbcoq-cai |
| Network | IC Mainnet |
- Address-based deposits — send ICP from any wallet (NNS, Plug, etc.); no wallet connect required on the UI
- Automatic entry crediting — canister polls the ICP index for incoming transfers
- 24h rounds — live countdown, pool stats, and activity feed
- Verifiable payouts — winner addresses and ledger transaction IDs recorded on-chain
- Upgrade-safe — stable memory migrations for rounds, entries, winners, and treasury
flowchart TB
subgraph Users
W[ICP Wallet]
end
subgraph Frontend["Next.js Dashboard"]
UI[WinCanister UI]
Agent[IC Agent / Candid]
end
subgraph Canister["WinCanister Motoko Canister"]
API[api/v1 Controllers]
SVC[services]
REPO[repositories]
STORE[(stable storage)]
API --> SVC --> REPO --> STORE
end
subgraph IC["Internet Computer"]
IDX[ICP Index]
LED[ICP Ledger]
RND[raw_rand]
end
W -->|ICP transfer to account ID| LED
UI --> Agent -->|query / update calls| API
SVC -->|poll incoming transfers| IDX
SVC -->|treasury & prize payouts| LED
SVC -->|winner selection| RND
LED -->|deposit detected| IDX
flowchart LR
subgraph Presentation
C1[LotteryController]
C2[RoundController]
C3[WinnerController]
C4[HealthController]
end
subgraph Business
LS[LotteryService]
RS[RoundService]
ES[EntryService]
DS[DepositService]
WS[WinnerService]
PS[PrizeService]
TS[TreasuryService]
end
subgraph Data
RR[RoundRepository]
ER[EntryRepository]
AR[AddressEntryRepository]
WR[WinnerRepository]
PR[PayoutRepository]
end
subgraph Persistence
SM[StableStorage + migrations]
end
C1 & C2 & C3 & C4 --> LS & RS & ES & DS & WS
LS & RS & ES & DS & WS --> PS & TS
PS & TS --> RR & ER & AR & WR & PR --> SM
| Layer | Path | Responsibility |
|---|---|---|
| Controllers | src/api/v1/ |
Thin Candid endpoints — validate input, call services, map responses |
| Services | src/services/ |
Business rules: rounds, entries, deposits, draws, treasury, payouts |
| Repositories | src/repositories/ |
Read/write domain data — no business logic |
| Storage | src/storage/ |
Stable memory maps and upgrade-safe persistence |
| Ledger | src/ledger/ |
ICP ledger transfers and index polling |
| Frontend | frontend/ |
Next.js dashboard — pool stats, countdown, deposit QR, live feed |
sequenceDiagram
participant User as User Wallet
participant Ledger as ICP Ledger
participant Index as ICP Index
participant Canister as WinCanister
participant UI as Dashboard
User->>Ledger: Send ≥ 1 ICP to canister account ID
Note over Canister: Timer / manual sync every 30s
Canister->>Index: Fetch incoming transfers
Index-->>Canister: New transfer list
Canister->>Canister: Credit AddressEntry, update pool
UI->>Canister: Poll round state
Canister-->>UI: Participants, pool, countdown
| Place | Share |
|---|---|
| Winner 1 | 60% of prize pool |
| Winner 2 | 25% of prize pool |
| Winner 3 | 15% of prize pool |
| Protocol treasury | 1% of total pool |
git clone git@github.com:prasangapokharel/WinCanister.git
cd WinCanister
cd frontend && npm ci && cp .env.example .env.local && cd ..DFX_NETWORK=ic bash scripts/build-lottery.shcd frontend
npm run devOpen http://localhost:3000.
cd frontend
npm run dev # development server
npm run build # production build
npm run typecheck # TypeScript check
npm run lint # ESLintDFX_NETWORK=ic bash scripts/build-lottery.sh
dfx canister install <CANISTER_ID> --network ic \
--wasm .mops/.build/lottery.wasm --mode upgrade --wasm-memory-persistence keep
dfx canister call <CANISTER_ID> processIncomingDeposits --network icSee scripts/deploy-mainnet.sh and scripts/verify-mainnet.sh for helper flows.
The Next.js app lives in frontend/, not the repo root. Vercel must use that folder or you will get 404 NOT_FOUND.
- Open your project on vercel.com → Settings → General
- Find Root Directory → click Edit
- Set it to
frontend→ Save - Go to Deployments → ⋯ on the latest deploy → Redeploy
- Import WinCanister from GitHub
- Root Directory =
frontend - Framework = Next.js (auto-detected after step 2)
- Add environment variables:
| Variable | Value |
|---|---|
NEXT_PUBLIC_LOTTERY_CANISTER_ID |
ulahq-iyaaa-aaaao-bbcoq-cai |
NEXT_PUBLIC_IC_HOST |
https://icp0.io |
- Click Deploy
Production URL will look like https://win-canister-gamma.vercel.app (not the long preview URL).
| Variable | Description |
|---|---|
NEXT_PUBLIC_LOTTERY_CANISTER_ID |
Lottery canister principal |
NEXT_PUBLIC_DFX_NETWORK |
Set to local for local replica |
NEXT_PUBLIC_IC_HOST |
IC HTTP endpoint (default https://icp0.io) |
WinCanister/
├── src/
│ ├── api/v1/ # Candid controllers
│ ├── services/ # Business logic
│ ├── repositories/ # Data access
│ ├── storage/ # Stable memory
│ ├── ledger/ # ICP ledger + index clients
│ ├── migrations/ # Upgrade migrations
│ └── main.mo # Canister entrypoint
├── frontend/ # Next.js dashboard
├── docs/strcuture/motok/ # Motoko code + deploy guides
├── scripts/ # Build & deploy helpers
├── dfx.json
└── mops.toml
| Guide | Path |
|---|---|
| Index | docs/strcuture/motok/README.md |
| Code (architecture, features, migrations, tests) | docs/strcuture/motok/code-guide/ |
| Deploy (build, mainnet, upgrade, Vercel) | docs/strcuture/motok/deploy-guide/ |
Contributions are welcome! Please read CONTRIBUTING.md before opening a pull request.
- Fork the repo
- Create a feature branch (
git checkout -b feat/my-change) - Run frontend checks (
npm run typecheck,npm run lint,npm run build) - Open a PR with a clear description
Apache-2.0 — see LICENSE.