Kibo

Daily micro-savings on Celo.
Deposit cUSD every day, build your streak, earn rewards at milestones.

---

What it does

Kibo turns saving into a streak game:

Action	Result
Deposit 0.01 to 1 cUSD	Streak +1, 20h cooldown starts
Hit day 7, 14, 21...	Claim milestone reward from shared pool
Miss a day	Streak resets (shields absorb 1 miss)
Reach 30 / 90 / 180 / 365 days	Earn Bronze, Silver, Gold, Diamond badge
Broke your streak?	Pay a small recovery fee to restore it
Invite a friend	Earn 5% of their first deposit
Sponsor a friend	Pay their daily deposit for them
Set a savings goal	On-chain target with live progress bar

---

Features

• Streak system — 20h cooldown, milestone rewards every 7 days, escalating tiers
• Streak shields — up to 3 miss-absorbers earned at milestones
• Streak recovery — pay brokenStreak x 0.01 cUSD (capped at 0.1) to restore
• Badge system — Bronze (30d), Silver (90d), Gold (180d), Diamond (365d), stored on-chain
• Savings goal — set a cUSD target, track progress with a live bar
• Referral system — 5% of referee's first deposit credited to referrer, claimable anytime
• Sponsor deposit — depositFor(address) pays a friend's daily deposit
• Leaderboard — top 20 savers by streak, read directly from contract
• Non-custodial — funds sit in contract, withdrawable anytime

---

Contract

Network	Celo Mainnet (chainId 42220)
Kibo	0xb103Ef63431753317BeFb1AAfCB7C6E0e0fbCe12
cUSD	0x765DE816845861e75A25fCA122bb6898B8B1282a

---

Stack

sc/           Solidity 0.8.20, Hardhat, deployed to Celo mainnet
frontend/     Next.js 16, React 19, wagmi v2, viem, shadcn/ui, Tailwind CSS
kibo-sdk/     Framework-agnostic TypeScript SDK

---

Quick start

# Install all workspaces
yarn

# Run the frontend locally
cd frontend
yarn dev

Open http://localhost:3000 and connect any injected wallet.

Environment

cp .env.example .env

NEXT_PUBLIC_KIBO_ADDRESS=0xb103Ef63431753317BeFb1AAfCB7C6E0e0fbCe12
PRIVATE_KEY=           # only needed for deploy
CELOSCAN_API_KEY=      # only needed for verify

Contract deploy

# Testnet (Celo Sepolia)
yarn deploy:celoSepolia

# Mainnet
yarn deploy:celo

# Verify on Celoscan
yarn verify:celo

---

SDK

npm install kibo-sdk

import { getUser, deposit, depositFor, setGoal, recoverStreak, claimReferralReward } from "kibo-sdk";

// Read
const user = await getUser("0xYourAddress");
console.log(user.streak);         // current streak (days)
console.log(user.badge);          // Badge: None / Bronze / Silver / Gold / Diamond
console.log(user.brokenStreak);   // recoverable broken streak
console.log(user.rewardsClaimed); // total cUSD claimed (bigint, 18 decimals)

// Write — pass a viem WalletClient
await deposit(walletClient);
await deposit(walletClient, parseUnits("0.05", 18), referrerAddr);
await depositFor(walletClient, friendAddr);
await setGoal(walletClient, parseUnits("10", 18));
await recoverStreak(walletClient);
await claimReferralReward(walletClient);

---

Reward tiers

Milestone	Reward
Day 7	0.005 cUSD
Day 14+	0.012 cUSD
Day 35+	0.025 cUSD

Rewards come from a shared pool funded by a 0.5% fee on each deposit.

---

Project structure

kibo/
├── sc/
│   ├── contracts/Kibo.sol       # Main savings contract
│   ├── deploy/                  # Hardhat deploy scripts
│   └── hardhat.config.ts
├── frontend/
│   ├── app/page.tsx             # Full UI (home, leaderboard, info tabs)
│   ├── components/ui/           # shadcn/ui components
│   ├── hooks/useKibo.ts         # wagmi hook for all contract interactions
│   └── lib/kibo-abi.ts          # ABI + contract addresses
└── kibo-sdk/
    └── src/index.ts             # Framework-agnostic TS SDK

---

License

MIT