Xersha

Problem Statement

Xersha transforms how friend groups save money by combining social feeds with collective crypto savings, supporting everything from vacation funds (flexible contributions) to investment clubs (rotating payouts) to community fundraisers (goal-based giving).Built as a Progressive Web App optimized for mobile experiences, Xersha delivers an app-like interface best viewed on mobile devices. The platform is built on Lens Protocol for social identity and group management, leveraging the existing social graph to create trusted savings circles. Each circle is powered by custom smart contracts deployed on Citrea (Bitcoin's first ZK Rollup), ensuring transparent on-chain settlement while benefiting from Bitcoin's security.The architecture integrates three key innovations:Social Layer: Lens Protocol groups serve as the foundation for circles, with feeds, posts, and member management handled through the decentralized social graphSettlement Layer: Citrea testnet provides EVM compatibility with Bitcoin finality, enabling flexible smart contract logic while settlements ultimately anchor to BitcoinYield Layer: Contribution circles automatically generate yield through integrated lending protocols, with receipt tokens (xshCUSD/xshCBTC) representing member sharesBuilt for the growing segment of social-first users who prefer exploring new financial tools with their trusted circles. By making DeFi social and Bitcoin-settled, we're turning financial growth from a solo journey into a shared adventure with cryptographic guarantees.

Solution

Tech StackFrontend: React with React Router 7 (Progressive Web App)Social Layer: Lens Protocol for feeds, posts, groups and social graphSmart Contracts: Deployed on Citrea testnet (Bitcoin's first ZK Rollup)Wallet Infrastructure: Dynamic.xyz and custom contracts for circlesAuthentication: Dynamic.xyz for social/email loginYield Generation: Mock lending protocol with receipt tokensData Querying: Direct RPC calls (no indexer needed for MVP)System Architecture[User] → [React PWA] → [Dynamic.xyz Auth] ↓ [Lens Protocol] ← Social features (Grove for content) ↓ [Smart Contracts on Citrea] ↓ [Mock Protocol] ← Yield generationExternal DependenciesLens Protocol API + Grove for social features and content storageDynamic.xyz for authenticationCitrea testnet RPC endpointsWeb3 libraries (wagmi/viem for direct contract calls)Circle TypesXersha supports three types of savings circles, each powered by its own smart contract:Contribution Circles (YieldSavingsPool)Purpose: Flexible collective savings with automatic yield generationHow it works:Members deposit any amount at any time (no fixed schedule)Funds are deposited into a yield-generating vaultMembers receive receipt tokens (xshCUSD or xshCBTC) representing their shareIndividual balances are tracked separatelyMembers can withdraw their principal + earned yield at any timeOptional savings goals can be set by the creatorUse cases: Emergency funds, vacation savings, group investment poolsRotating Circles (ROSCAPool)Purpose: Rotating Savings and Credit Association - structured savings with guaranteed lump sum payoutsHow it works:Creator sets a fixed contribution amount (e.g., $50/month)Requires 3-10 members to startEach 30-day cycle, all members contribute the fixed amountOne member receives the entire pot that cyclePayout order is randomly determined at the start (transparent on-chain)Continues until every member has received onceNo individual withdrawals allowed during the rotationUse cases: Large purchases (down payments, electronics), debt consolidation, business startup capitalFundraising Circles (DonationPool)Purpose: Goal-based charitable giving or community fundraisingHow it works:Creator sets a target amount, beneficiary address, and deadlineMembers donate any amount toward the goalIf goal is reached by deadline, funds are released to beneficiaryIf goal is not met, all donors can claim refundsPublicly visible for broader participation beyond the circleCan be categorized (education, medical, community, etc.)Use cases: Medical expenses, education costs, community projects, disaster relief