ENKO
< 작업 목록으로
HASH: 0x0003...2025.11

XRPL Payment Gateway

Payment System

시스템 설명

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

기술 스택

NestJSXRPL SDKPostgreSQLBullMQTypeORMDDD
XRPL Payment Gateway
ROLE: SOLO_DEVELOPERDOMAIN: BLOCKCHAIN
!

문제도전 과제

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

✓

해결해결 방식

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

구현 범위

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

증빙 자료

공개 가능한 증빙 자료가 등록되지 않았습니다.

기술 상세

개요

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

핵심 흐름

1) 결제 요청 생성/매칭

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

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

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

3) 컨펌 모니터링

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

운영 포인트

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