Ajora 🎉

Save 0.10 cUSD a day, keep every cent, and win real stablecoin in the daily draw — then spray free tickets on your friends like it's an owambe.

Ajora is a no-loss prize-linked savings game built as a MiniPay Mini App on Celo. It digitizes the continent's most-trusted money ritual — the rotating savings group (Ajo / Esusu / Chama / Susu) — and makes the organizer impossible: the smart contract holds the funds, so nobody can run away with the money.

• Principal is always returned in full (no-loss). Only the bonus — the jara — is at stake.
• No upfront deposit to start: new users get a sponsor-funded welcome ticket and can win on day one.
• Every action is genuinely on-chain — saving, picking, spraying, claiming.
• Rewards are funded by real revenue (yield + sponsors + rake), not new deposits. Not a Ponzi.

The name blends Ajo (the trusted savings circle) with jara (the free bonus you always keep). "Ajora" also means "deep" in Wolaita — a deep pool of savings.

📄 Full design + technical spec: AJORA_SPEC.md 🎲 Draw randomness — scheme & how to verify any draw yourself: contracts/RANDOMNESS.md

---

Monorepo layout

ajora/
├── AJORA_SPEC.md        # Full product & technical specification
├── contracts/           # Solidity smart contracts (Foundry)
│   ├── src/             # PotVault, DrawManager, SprayFaucet, CrewRegistry, ...
│   ├── test/            # Foundry tests
│   └── script/          # Deployment scripts
├── app/                 # MiniPay Mini App frontend (Next.js + TypeScript + Tailwind)
├── indexer/             # Ponder indexer — events → tables + read APIs
├── push/                # Web Push backend — draw results + streak-at-risk nudges
├── metrics/             # Committed growth-metrics rollups
├── tools/               # Post-deploy automation helpers
└── .github/workflows/   # CI/CD, keepers, static analysis

Architecture

┌──────────┐    contribute/pick/spray/claim    ┌────────────┐
│  MiniPay │ ──────────────────────────────→   │ Contracts  │
│  browser │ ←──────────────────────────────   │ (on-chain) │
└──────────+    tx receipts + events           └─────┬──────┘
      │                                               │ events
      │                                               ▼
      │                                       ┌──────────────┐
      │  NEXT_PUBLIC_* addresses              │   Indexer    │
      │  (app/.env.local)                     │  (Ponder)     │
      │                                       │  port 42069   │
      │                                       │               │
      │                                       │  /leaderboard │
      │                                       │  /users/:addr │
      │                                       │  /periods/:id │
      │                                       │  /crews/:id   │
      │                                       │  /flags       │
      │                                       │  /notify/*    │
      │                                       │  /metrics/    │
      │                                       └──┬───────────┘
      │                                          │
      │  /notify/draw/:id                         │  /notify/at-risk
      │  /notify/unclaimed                        │  /notify/unclaimed
      │                                          ▼
      │                                  ┌──────────────┐
      │  PushSubscription                │  Push service │
      │  ──────────────────────────→     │  (Web Push)   │
      │                                  │  port 42070   │
      │  ── Push notification (won/lost) │               │
      │                                  └──────────────┘
      │
      │                              ┌──────────┐
      │  ── Keeper cron (GH Actions) │ Keepers   │
      │     commit/reveal draws      │           │
      │     harvest yield            │  tick.mjs │
      │     sweep unclaimed          │  extras   │
      │     vest referrals           │           │
      │     watchdog (dead-man's sw) │           │
      │                              └──────────┘

Quickstart

Contracts (Foundry)

git clone --recursive https://github.com/menawar/ajora.git   # --recursive pulls forge-std
cd ajora/contracts
forge build
forge test -vvv

If you cloned without --recursive:

git submodule update --init --recursive

App (mini-app frontend)

cd app
npm install
npm run dev     # expects contracts/.env with NEXT_PUBLIC_* variables

See app/README.md for the full setup.

Indexer

cd indexer
npm install
npm run dev     # starts on port 42069; requires an RPC URL for Celo

See indexer/README.md.

Push service

cd push
npm install
npm run vapid   # generate VAPID keys once, add to .env
npm start       # starts on port 42070

See push/README.md.

Key docs

Doc	What it covers
AJORA_SPEC.md	Full product & technical specification, §1–§18
contracts/DEPLOYMENT.md	Deploy runbook, env vars, post-deploy checklist
contracts/RANDOMNESS.md	Draw commit-reveal scheme + how to verify any draw
contracts/THREAT-MODEL.md	Adversary model, attack trees, accepted risks
contracts/SECURITY-TRIAGE.md	Slither/Mythril findings triage, hardening controls
contracts/INCIDENT-PLAYBOOK.md	Pause drill, severity levels, comms templates

Roadmap (Proof of Ship, 4 weeks)

Week	Focus
1	PotVault core loop (contribute / claim / welcome ticket) on Alfajores testnet
2	Draw + streaks + spray + crews → Celo mainnet (capped)
3	Yield adapter, sponsors, leaderboards, growth
4	Anti-sybil hardening, analytics, demo, submit

See AJORA_SPEC.md §15 for the detailed plan.

Deployments

Celo mainnet (chain 42220) — wired core, sources verified (Sourcify exact match)

Live core: core_v5, deployed 2026-07-07.

Contract	Address
PotVault	0x0A9f549C0Fc859b0925c7dcB5F8A55d4020c1415
StreakSBT	0x9aC488Bc0Ba3cF7F2552c61d6F9BbA949961d974
SprayFaucet	0x117cEa08fD62220506FD7621C548a627373B2DFc
DrawManager	0xacB78C0DdAA33C660010dE76b842A54b613156B4
CrewRegistry	0x73F0770aea05298579252dFf193df0454C0B5A8a

Stablecoin: cUSD · min contribution / ticket value: 0.10 cUSD · full details + superseded cores: contracts/deployments/celo-mainnet.json · runbook: contracts/DEPLOYMENT.md

License

MIT