A decentralized bill splitting application built on Celo for MiniPay integration.
Netsplit is a decentralized bill splitting application built on the Celo blockchain with MiniPay integration. It allows users to create groups, add expenses, split bills in various ways, and settle debts using Celo's stablecoins (cUSD, cEUR, cREAL).
The app provides a seamless experience for managing shared expenses among friends, roommates, or any group that needs to split costs. With multi-currency support and integration with the MiniPay wallet, users can easily track and settle debts in their preferred currency.
Netsplit offers a comprehensive set of features for bill splitting and expense management:
-
Group Management
- Create and manage expense groups
- Add members to groups via email
- Track group expenses and balances
-
Expense Splitting
- Equal splits: divide expenses equally among group members
- Custom splits: specify exact amounts for each member
- Percentage splits: allocate expenses by percentage
-
Multi-Currency Support
- Support for Celo stablecoins (cUSD, cEUR, cREAL)
- Currency conversion using Mento Protocol rates
- Set individual currency preferences
-
Balance Tracking
- View overall group balances
- See detailed breakdown of who owes what
- Track payment history
-
Payment Integration
- Pay directly through MiniPay wallet
- Support for web3 wallet connections
- Transaction history and confirmation
Netsplit is built using modern web technologies and blockchain tools:
- Celo - Mobile-first blockchain platform
- React.js - Frontend framework
- Next.js - React framework for production
- Viem - TypeScript interface for Ethereum
- Tailwind CSS - Utility-first CSS framework
- Mento Protocol - For currency exchange rates
- Node.js (v20 or higher)
- Git (v2.38 or higher)
- A MiniPay wallet or other web3 wallet
-
Clone the repository
git clone https://github.com/fionaaboud/minipay-template.git cd minipay-template -
Install dependencies
yarn # or npm install -
Set up environment variables
cp packages/react-app/.env.template packages/react-app/.env
Then add your WalletConnect Cloud Project ID to the .env file
-
Start the development server
cd packages/react-app yarn dev # or npm run dev
-
Open http://localhost:3000 in your browser
- Navigate to the Netsplit app
- Click "Create Group"
- Enter a group name and add members by email
- Your group is now ready for expense tracking
- Open a group
- Click "Add Expense"
- Enter expense details (title, amount, currency)
- Select who paid and how to split the expense
- Save the expense
- Open a group
- Click "Balances" to see an overview
- View detailed breakdowns of who owes what
- Click on individual balances for more details
- Navigate to the balance details
- Click "Pay" next to the amount you owe
- Confirm the payment through your connected wallet
- The balance will update automatically
Netsplit supports multiple currencies through the Mento Protocol:
- cUSD (Celo Dollar): The default currency for all balances
- cEUR (Celo Euro): European currency option
- cREAL (Celo Brazilian Real): Brazilian currency option
Users can:
- Enter expenses in any supported currency
- Set their preferred currency for display
- Pay in any supported currency
All balances are standardized in cUSD for consistency, with conversion rates provided by the Mento Protocol.
Netsplit is designed to work seamlessly with MiniPay, Opera's wallet built on Celo:
- Automatic Detection: The app detects when it's running inside MiniPay
- Simplified Authentication: Uses MiniPay's built-in wallet connection
- Streamlined Payments: Direct integration for settling debts
To use Netsplit with MiniPay:
- Install the MiniPay app
- Open the Netsplit app URL in MiniPay
- The app will automatically connect to your MiniPay wallet
Distributed under the MIT License. See LICENSE.txt for more information.