Economic / Payment System

XRPL Payment Gateway

An XRPL payment gateway that keeps signing on the client and validation and broadcast on the server. DestinationTag-based matching and queue workers track XRP and issued-currency payments to final confirmation.

Role
Solo builder · architecture, implementation, and operations
Period
2025.11
Organization
Beatoz Labs
01 / Overview

An XRPL payment gateway that keeps signing on the client and validation and broadcast on the server. DestinationTag-based matching and queue workers track XRP and issued-currency payments to final confirmation.

DECISION / AThe problem

What made this system difficult?

Had to validate tx_blob server-side (destination/vault/amount/tag) while keeping keys on the client and reliably matching payments under a single receiving address.

DECISION / BThe response

How did the design respond?

Implemented tx_blob decoding/validation, deterministic DestinationTag generation derived from a payment identifier, and a BullMQ confirmation monitor that checks validated success (tesSUCCESS) and emits payment confirmation events.

03 / Technology
01NestJS02XRPL SDK03PostgreSQL04BullMQ05TypeORM06DDD
04 / Technical record

Overview

  • Solo-built XRPL payment gateway with a client-sign/server-broadcast model.
  • Supports payment matching via deterministic DestinationTag generation.

Key Flow

  1. Generate payment request + deterministic DestinationTag for matching
  2. Validate and decode client-signed tx_blob server-side, then broadcast
  3. Monitor confirmations via queue/worker and update payment state
05 / Project evidence
XRPL Payment Gateway project evidence
PROJECT VISUAL / CONCEPT IMAGE