Xersha

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 graph
• Settlement Layer: Citrea testnet provides EVM compatibility with Bitcoin finality, enabling flexible smart contract logic while settlements ultimately anchor to Bitcoin
• Yield Layer: Contribution circles automatically generate yield through integrated lending protocols, with receipt tokens (xshCUSD/xshCBTC) representing member shares

Built 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.

Tech Stack

• Frontend: React with React Router 7 (Progressive Web App)
• Social Layer: Lens Protocol for feeds, posts, groups and social graph
• Smart Contracts: Deployed on Citrea testnet (Bitcoin's first ZK Rollup)
• Wallet Infrastructure: Dynamic.xyz and custom contracts for circles
• Authentication: Dynamic.xyz for social/email login
• Yield Generation: Mock lending protocol with receipt tokens
• Data 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 generation

External Dependencies

• Lens Protocol API + Grove for social features and content storage
• Dynamic.xyz for authentication
• Citrea testnet RPC endpoints
• Web3 libraries (wagmi/viem for direct contract calls)

Circle Types

Xersha supports three types of savings circles, each powered by its own smart contract:

1. Contribution Circles (YieldSavingsPool)

Purpose: Flexible collective savings with automatic yield generation

How it works:

• Members deposit any amount at any time (no fixed schedule)
• Funds are deposited into a yield-generating vault
• Members receive receipt tokens (xshCUSD or xshCBTC) representing their share
• Individual balances are tracked separately
• Members can withdraw their principal + earned yield at any time
• Optional savings goals can be set by the creator

Use cases: Emergency funds, vacation savings, group investment pools

1. Rotating Circles (ROSCAPool)

Purpose: Rotating Savings and Credit Association - structured savings with guaranteed lump sum payouts

How it works:

• Creator sets a fixed contribution amount (e.g., $50/month)
• Requires 3-10 members to start
• Each 30-day cycle, all members contribute the fixed amount
• One member receives the entire pot that cycle
• Payout order is randomly determined at the start (transparent on-chain)
• Continues until every member has received once
• No individual withdrawals allowed during the rotation

Use cases: Large purchases (down payments, electronics), debt consolidation, business startup capital

1. Fundraising Circles (DonationPool)

Purpose: Goal-based charitable giving or community fundraising

How it works:

• Creator sets a target amount, beneficiary address, and deadline
• Members donate any amount toward the goal
• If goal is reached by deadline, funds are released to beneficiary
• If goal is not met, all donors can claim refunds
• Publicly visible for broader participation beyond the circle
• Can be categorized (education, medical, community, etc.)

Use cases: Medical expenses, education costs, community projects, disaster relief