CeloSaver

CeloSaver is a stablecoin savings application built for Celo MiniPay. It tracks deposits into a vault and maintains on-chain streaks to help users build a consistent savings habit.

Features

• Deposits of cUSD into the CeloSaverVault with immediate liquidity.
• Streak tracking to monitor daily deposits.
• A simplified interface intended for mobile wallet users.
• Design based on glassmorphic principles with basic animations.

Live on Celo Mainnet

• Vault Contract: 0x4bA6398eb0ee5fdC7b45e7DE3F042d27090FB72E
• cUSD Token: 0x765DE816845861e75A25fCA122bb6898B8B1282a

Developer SDK (NPM)

The logic for CeloSaver is available as an NPM package for integration into other Celo applications.

npm install @cryptoflops/celo-saver

Usage

import { useCeloSaver } from '@cryptoflops/celo-saver';

const { deposit, vaultBalance, streak } = useCeloSaver();

Local Development & MiniPay Testing

1. Clone the repository.
2. Run npm install
3. Run npm run dev

Testing in MiniPay (Developer Mode)

To test this application natively inside the Opera MiniPay wallet:

1. Expose your local dev server using ngrok: ngrok http 3000
2. Open Opera Mini on your Android device and navigate to MiniPay.
3. Tap the settings icon and enable "Developer Mode".
4. Enter your ngrok URL in the test app input field.
5. The application will implicitly auto-connect to the MiniPay injected provider without showing the "Connect Wallet" CTA.

Proof-of-Ship Analytics

This repository implements on-chain metrics and user event tracking (mocked via src/utils/analytics.ts for this submission scope) to fulfill the Celo Proof-of-Ship requirements. Logged events include deposit_initiated and preset_selected.

License

MIT