Product/2026.02.06/8 min read

큐브 지갑으로 보상 흐름 만들기

앱 안에서 미션, 소비, 환불, 거래 내역을 다룰 수 있는 큐브 지갑의 첫 구조를 만든 기록입니다.

CubeRewardWallet

Code notes

코드에서 확인한 구현 포인트

배포 기준 2026.02.06

관련 파일

apps/web/app/api/cubes/wallet/route.tsapps/web/app/api/cubes/grant/route.tsapps/web/app/api/cubes/spend/route.tsapps/web/app/api/cubes/refund/route.tsapps/web/lib/cubes.ts

구현 메모

큐브 기능은 wallet, grant, spend, refund, transactions API로 나뉘어 보상 흐름을 세밀하게 추적한다.

wallet API는 없던 지갑을 보장한 뒤 응답을 만들고, transactions API는 최신 거래를 제한된 개수로 가져온다.

보상 시스템은 악용 방지가 중요하므로 세부 검증 규칙은 공개하지 않고 책임 분리만 기록했다.

보상은 숫자보다 흐름이 중요하다

큐브는 Tangly 안에서 사용자의 행동을 보상하는 단위다. 하지만 보상 기능은 잔액만 보여준다고 끝나지 않는다.

어떤 행동으로 큐브를 받았는지, 어디에 사용했는지, 문제가 생기면 어떻게 되돌릴 수 있는지가 함께 필요하다. 그래서 지갑, 지급, 사용, 환불, 거래 내역을 하나의 흐름으로 만들었다.

신뢰를 위한 거래 내역

보상 시스템에서 가장 중요한 것은 사용자가 자신의 잔액을 믿는 것이다. 잔액이 바뀌었는데 이유를 알 수 없으면 기능 전체가 불안해진다.

거래 내역은 단순 기록이 아니라 신뢰 장치다. 큐브가 늘고 줄어든 이유를 사용자가 확인할 수 있어야 한다.

조심해야 할 부분

보상 시스템은 악용 가능성을 항상 염두에 둬야 한다. 이 글에서는 세부 검증 방식이나 내부 규칙은 공개하지 않지만, 원칙은 분명하다. 지급과 사용은 추적 가능해야 하고, 예외 상황은 되돌릴 수 있어야 한다.