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

    Payload Signing

    User initiates payment via Xaman SDK, signing a cryptographically secure payload containing meeting parameters

  2. 2

    Ledger Validation

    Transaction submitted to XRP Ledger, validated in ~4 seconds with definitive proof-of-payment

  3. 3

    State Trigger

    Webhooks detect validated transaction, triggering post-payment workflows (calendar invites, notifications)

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

1

Connect Wallet

Link your XRP wallet via Xaman to authenticate and receive payments

2

Create Profile

Set your rate, meeting duration, and buffer time in your dashboard

3

List Availability

Configure your weekly schedule; Google Calendar integration available

4

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