XRPeers Protocol
Enterprise-grade documentation for the dual-economy XRP ecosystem
Introduction
XRPeers is a professional meeting protocol built for the XRP Ledger. We connect experts with seekers through instant, peer-to-peer settlements, enabling professionals to monetize their expertise without platform fees.
Instant Settlement
4 second global payments
Non-Custodial
Funds never leave your wallet
Global Access
Borderless participation
Peer-to-Peer
Direct host-guest connections
Core Architecture
The Technology Stack
XRPeers utilizes a high-performance architecture designed for enterprise reliability:
Frontend
Next.js 14 with real-time state management and SSR optimization
Backend
Supabase real-time database with PostgreSQL
Payments
XRP Ledger with Xaman SDK integration
Authentication
Wallet-based with Supabase Auth
XRPL Transaction Lifecycle
The payment flow ensures secure, verifiable transactions:
- 1
Payload Signing
User initiates payment via Xaman SDK, signing a cryptographically secure payload containing meeting parameters
- 2
Ledger Validation
Transaction submitted to XRP Ledger, validated in ~4 seconds with definitive proof-of-payment
- 3
State Trigger
Webhooks detect validated transaction, triggering post-payment workflows (calendar invites, notifications)
- 4
Booking Confirmation
Host receives booking with verified payment proof, guest receives calendar invite
The Dual-Economy Model
XRPeers operates two interconnected economies that drive network growth:
XRP Calendar — Discovery Economy
A decentralized event aggregator where professionals showcase their expertise through live spaces, IRL events, and educational sessions.
$PEER Points System
Users earn $PEER tokens through verified interactions — attending events, participating in spaces, and engaging with hosts. This creates a reputation economy that rewards active participation.
XRPeers — Utility Economy
The core booking platform where hosts monetize their expertise through instant, frictionless paid meetings.
Pay-to-Meet Protocol
Host rates, durations, and buffer times are dynamically fetched from the database, ensuring accurate pricing at booking. Payments settle instantly — no chargebacks, no payment processor fees.
The Flywheel Effect
As hosts gain $PEER points from hosting events, they attract more bookings. As guests attend events and earn points, they become qualified leads for paid sessions. Each economy fuels the other.
Host Guide
Getting Started as a Host
Connect Wallet
Link your XRP wallet via Xaman to authenticate and receive payments
Create Profile
Set your rate, meeting duration, and buffer time in your dashboard
List Availability
Configure your weekly schedule; Google Calendar integration available
Start Earning
Receive instant payments in XRP when guests book meetings
Security & Data Integrity
Row Level Security (RLS)
All user and host data is protected through Supabase's Row Level Security policies. Each query is automatically scoped to the authenticated user, ensuring:
- Users can only view their own booking history
- Hosts can only modify their own profiles and availability
- Payment data is cryptographically isolated per-session
Server-Side Point Allocation
The $PEER points system uses Supabase RPC (Remote Procedure Call) to execute all point allocations server-side. This prevents client-side manipulation:
-- Server-side RPC function CREATE OR REPLACE FUNCTION increment_points( user_id UUID, amount INTEGER ) RETURNS void LANGUAGE plpgsql SECURITY DEFINER AS $$ BEGIN -- Atomic increment, no client-side math UPDATE profiles SET peer_points = peer_points + amount WHERE id = user_id; END; $$;
Protocol Roadmap
Automated Workflow
Upon successful transaction verification, the protocol automatically triggers:
Google Calendar Integration
Instant calendar invite sent to both parties with meeting details
Email Notifications
Confirmation emails with booking details and rescheduling links
XRP Payout Automation
Automatic conversion to fiat or remaining XRP wallet balance
Future Enhancements
- • Multi-currency support (USD, EUR, GBP)
- • Recurring booking automation
- • Host verification badges
- • Referral program with $PEER rewards