XRPL Payment Gateway

1인 개발로 진행한 XRPL 결제 게이트웨이입니다. 클라이언트 서명(tx_blob)과 서버 브로드캐스트를 분리하고, DestinationTag 기반 자동 매칭을 제공합니다.

역할: 1인 개발 · 아키텍처, 구현, 운영 도구
기간: 2025.11
맥락: Beatoz Labs

01 / 핵심 요약

1인 개발로 진행한 XRPL 결제 게이트웨이입니다. 클라이언트 서명(tx_blob)과 서버 브로드캐스트를 분리하고, DestinationTag 기반 자동 매칭을 제공합니다.

DECISION / A시스템 과제

무엇이 시스템을 어렵게 만들었는가.

XRP(Native)와 Issued Currency 모두 지원하면서, 서명 키는 클라이언트에 두고 서버는 검증·전송·매칭을 안정적으로 수행해야 했습니다.

DECISION / B엔지니어링 해법

어떤 경계와 흐름으로 답했는가.

tx_blob 디코딩/검증(수신 주소·금액·DestinationTag) 후 브로드캐스트하고, Payment ID 기반 DestinationTag(결정론적 생성)로 자동 매칭을 구성했습니다. BullMQ 워커로 validated/tesSUCCESS 및 태그 일치를 확인해 결제 확정 이벤트를 발행하는 구조를 구현했습니다.

03 / 기술 필드

01NestJS02XRPL SDK03PostgreSQL04BullMQ05TypeORM06DDD

04 / 상세 기록

개요

1인 개발로 진행한 XRPL 결제 게이트웨이입니다.
클라이언트 서명(tx_blob)과 서버 브로드캐스트를 분리해 키를 서버에 두지 않는 구조를 채택했습니다.

핵심 흐름

1) 결제 요청 생성/매칭

결제 식별을 위한 DestinationTag를 결정적으로 생성해 자동 매칭에 활용합니다.

2) 클라이언트 서명 → 서버 검증/전송

서버는 tx_blob를 디코딩해 수신 주소/금액/태그 등 핵심 필드를 검증한 뒤 브로드캐스트합니다.

3) 컨펌 모니터링

큐/워커 기반으로 트랜잭션 컨펌을 추적하고 결제 상태를 갱신합니다.

운영 포인트

XRPL 특성상 상태 변화가 비동기이므로 컨펌 추적, 실패 케이스 처리, 재시도 정책을 분리해 운영 가능하게 구성했습니다.

05 / 실제 증거

ACTUAL PROJECT ASSET / NOT GENERATED