The only XRP wallet where your coins earn yield and stay ready to spend.
RippleFI is an Earn & Spend product for XRP holders, built for the Flare Summer Signal Hackathon - Track 1: Interoperable Asset Products.
Users bring XRP onto Flare as FXRP, deposit it into the RippleFI Vault, earn yield automatically, and keep the same balance liquid for everyday payments. No locking, fragmented balances, or complicated bridging flows.
Most XRP sits idle because earning yield usually means sacrificing liquidity or navigating unfamiliar DeFi workflows. RippleFI is designed to make productive XRP feel like a normal wallet balance:
XRP -> FXRP on Flare -> RippleFI Vault -> Earn yield + stay ready to spend
RippleFI is for:
- XRP holders who want their assets to work while remaining accessible.
- People who need to pay friends, merchants, or bills without unwinding a locked position.
- Merchants who want a simple way to accept XRP-backed payments.
Week 1: Foundation
The FXRP vault is deployed on Coston2 and the first connected-wallet dashboard is implemented locally.
- Official Flare Hardhat starter adapted for RippleFI
- Flare Coston2 configuration (
chainId: 114) - Flare periphery and OpenZeppelin dependencies
- Safe environment-variable template
- ERC-4626 deposit, share-accounting, and withdrawal logic
- Coston2 deployment
- Next.js wallet dashboard
- Vault tests and final frontend verification
The first milestone is intentionally focused:
- Build a security-conscious ERC-4626-style vault for FXRP.
- Deploy and verify the vault on Flare Testnet Coston2.
- Build a mobile-friendly Next.js dashboard.
- Connect a wallet and display FXRP and vault balances.
- Support FXRP deposits and withdrawals.
Smart Accounts, payment links, merchant tooling, and live yield strategies are planned for later milestones and are not part of the current build.
RippleFi/
|-- contracts/ Flare Hardhat project
| |-- contracts/
| | `-- RippleFIVault.sol FXRP vault implementation
| |-- scripts/ Deployment and operations
| |-- test/ Contract tests
| `-- hardhat.config.ts Coston2 configuration
`-- frontend/ Next.js connected-wallet dashboard
- Network: Flare Testnet Coston2
- Asset: FXRP through Flare FAssets
- Contracts: Solidity and ERC-4626-style share accounting
- Development: Hardhat and TypeScript
- Libraries: Flare periphery contracts, OpenZeppelin, Ethers
- Frontend: Next.js and TypeScript
| Property | Value |
|---|---|
| Network | Flare Testnet Coston2 |
| Chain ID | 114 |
| Currency | C2FLR |
| Public RPC | https://coston2-api.flare.network/ext/C/rpc |
| Explorer | https://coston2-explorer.flare.network |
- Node.js 20 or newer
- Corepack
- A dedicated testnet wallet for deployment
git clone https://github.com/onchaindc/RippleFi.git
cd RippleFi\contracts
corepack enable
corepack pnpm install
Copy-Item .env.example .env
corepack pnpm compileFor macOS or Linux, replace the environment-file command with:
cp .env.example .envThe repository contains a safe .env.example. Never commit a funded wallet's
private key.
| Variable | Required | Purpose |
|---|---|---|
PRIVATE_KEY |
Deployment only | Dedicated Coston2 test-wallet key |
FLARE_RPC_API_KEY |
No | Optional Flare tracer RPC access |
COSTON2_RPC_URL |
No | Custom Coston2 RPC override |
FLARE_EXPLORER_API_KEY |
No | Contract verification |
COSTON2_EXPLORER_URL |
No | Explorer override |
- ERC-4626-compatible asset and share accounting.
- Checks-effects-interactions and reentrancy protection.
- Explicit asset validation and conservative permissions.
- Comprehensive unit, edge-case, and Coston2 integration tests.
- No production private keys or important addresses committed to source.
- Flare Contract Registry usage where available instead of fragile hardcoding.
- FXRP vault
- Deposit and withdrawal flows
- Coston2 deployment
- Connected-wallet dashboard
- Real yield-strategy adapters
- Yield reporting
- Risk controls and strategy limits
- Smart Account flow
- Payment links
- Merchant checkout and receipts
- Liquid spending against the earning balance
MIT