XRPL Payment Gateway

Economic / Payment System

XRPL Payment Gateway

Solo-built XRPL payment gateway using a client-sign/server-broadcast model (tx_blob), supporting XRP and issued currencies with deterministic DestinationTag matching.

Role
Solo builder · architecture, implementation, and operational tooling
Period
2025.11
Context
Beatoz Labs
01 / Executive summary

Solo-built XRPL payment gateway using a client-sign/server-broadcast model (tx_blob), supporting XRP and issued currencies with deterministic DestinationTag matching.

DECISION / ASystem challenge

What made the 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 / BEngineering response

How boundaries and flows answered it.

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 field
01NestJS02XRPL SDK03PostgreSQL04BullMQ05TypeORM06DDD
04 / Detailed 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 / Factual evidence
XRPL Payment Gateway project evidence
ACTUAL PROJECT ASSET / NOT GENERATED