Documentation

Complete technical documentation for the XRPeers protocol

Architecture Overview

XRPeers is a peer-to-peer meeting protocol built on the XRP Ledger. The system enables instant, trustless payments between hosts offering consultation services and guests seeking expertise.

Non-Custodial

Platform never holds user funds

Instant Settlement

Sub-4 second XRP Ledger confirmation

8% Protocol Fee

Transparent fee structure

Global Access

Anyone with an XRP wallet

System Components

Booking Engine

Manages slot availability, booking creation, and reservation state. Hosts define their availability windows and the system handles conflict resolution.

POST /api/bookings → Creates booking with destination tag

GET /api/availability/[hostId] → Returns available slots

DELETE /api/bookings/cancel → Cancels and refunds

Payment Processor

Handles XRP payments via Xaman SDK. Each booking generates a unique destination tag for payment matching. The system monitors the ledger for incoming payments.

• Destination Tags link payments to bookings

• WebSocket listener monitors central wallet

• Auto-confirms on ledger settlement

Gamification Layer

Tracks host reputation through reviews, ratings, and revenue metrics. Leaderboard rankings based on total earnings and session counts.

GET /api/gamification/leaderboard → Top hosts

POST /api/gamification/reviews → Submit review

GET /api/gamification/profile/[wallet] → User stats

Wallet Integration

Xaman (Xumm) SDK

XRPeers integrates exclusively with Xaman wallet for maximum security. The SDK handles:

  • Wallet connection via QR scan or deep link
  • Payment request generation with destination tags
  • Real-time payment confirmation via WebSocket
  • Transaction signing without exposing private keys

Data Flow

1

Guest selects time slot

Browser queries availability API for host

2

Booking created with destination tag

Server generates unique tag, reserves slot

3

Guest scans QR code or opens Xaman

Payment request with amount + destination tag

4

Payment confirmed on XRP Ledger

WebSocket detects tx, updates booking status

5

Confirmation sent to both parties

Email notification + dashboard update

API Reference

POST /api/bookings

Create new booking with payment info

GET /api/hosts

List all hosts

GET /api/gamification/leaderboard

Get top hosts by revenue

POST /api/payouts/claim

Claim earned revenue to wallet

Security

  • Non-Custodial: Platform never holds user funds. All payments go directly from guest to host wallet.
  • Destination Tags: Each booking gets a unique tag ensuring payments are correctly matched.
  • WebSocket Verification: Payments confirmed only after ledger settlement, not mempool.
  • No Private Keys: Xaman handles signing; platform never accesses user keys.