custody
지갑 보관 서비스
고객 키 파일을 들고 있는 서버입니다. 화면 서버와 분리되어 있습니다.
이 프로젝트에서
서비스 1개, /vault 볼륨 1개, replica 1개입니다. 공개 주소가 없습니다. 지갑 발급이 지금 중심이고, 실행과 서명을 붙여도 서비스를 하나 더 만들지 않습니다.
GLOSSARY · 용어
용어사전
이 지갑에서 돈이 움직이는 말만 모읍니다. 대화나 문서에 새 전문 용어가 나오면 여기에 추가합니다. 웹에서 흔히 쓰는 말은 넣지 않습니다.
화면 흐름은 스토리보드, 프로세스 경계는 아키텍처, 빠뜨리면 안 되는 확인은 주요확인사항입니다. 여기는 말의 뜻만 둡니다.
용어
시드
seed · 복구 구문
지갑을 다시 만들 수 있는 영어 단어 묶음입니다. 서명 키는 이 단어에서 나옵니다.
이 프로젝트에서
신규 지갑은 영어 24단어 하나입니다. custody의 /vault 계정 금고에는 그 단어와 뿌리 시드를 넣지 않고, 거기서 만든 자식 키만 암호화해 둡니다. 고객 API와 DB는 암호문만 중계하고, 단어는 신청한 브라우저에서 확인한 뒤에만 보여 줍니다.
signer
서명 프로세스
저장된 서명 원문으로 거래에 서명하는 별도 프로세스입니다.
이 프로젝트에서
custody 안에서만 돕니다. 고객 앱과 관리자 화면은 키를 들지 않고 서명하지 않습니다.
observer
관측 worker
체인에서 잔액을 읽어 증거로 남기는 프로세스입니다. 돈을 보내지 않습니다.
이 프로젝트에서
실행 큐와 signer가 없습니다. 일별 시세 키도 여기만 둡니다. 앱을 다시 배포해도 잔액이 따라오지 않을 수 있습니다.
cutoverReady
운영 인수 완료
프로세스가 살아 있다는 뜻이 아닙니다. 실제 전환과 인수가 끝났는지를 가릅니다.
이 프로젝트에서
/health는 프로세스가 응답하는지만 봅니다. /ready는 아직 cutoverReady=false로 503입니다.
customer_trades
체결 원장
고객이 누르거나 예약한 행동이 아니라, 실제로 체결된 거래만 담는 기록입니다.
이 프로젝트에서
주문 방식과 네트워크가 달라도 체결은 같은 원장입니다. 같은 트랜잭션이라고 행을 합치지 않습니다.
미관측 잔액
아직 체인에서 확인하지 못한 잔액입니다. 0이 아닙니다.
이 프로젝트에서
빈 값으로 둡니다. 화면이나 합계를 맞추려고 0으로 채우지 않습니다.
daily_display_rates
일별 표시 종가
화면에 보여줄 때 쓰는 하루 종가입니다. 주문 가격이 아닙니다.
이 프로젝트에서
저장된 CoinGecko UTC 종가만 씁니다. 거래일 종가와 지금 시점의 최근 확정 종가를 구분하고, 없는 날은 임의 환율로 채우지 않습니다.
Manifest
Solana에서 쓰는 지정가 주문 장소입니다.
이 프로젝트에서
매수 주문이 끝났다고 브릿지나 다음 스왑이 자동으로 시작되지 않습니다. 견적 실패와 체결은 다른 기록입니다.
브릿지
한 네트워크에 있는 자산을 다른 네트워크로 옮기는 일입니다. 매도가 아닙니다.
이 프로젝트에서
도착 네트워크에서 받기 전에는 끝난 것이 아닙니다. 브릿지 자체로 매도 손익을 만들지 않고, 취득 원가는 이어집니다.
원금 · 가스 · 수수료
서로 다른 세 종류의 돈입니다.
이 프로젝트에서
원금은 거래하는 자산, 가스는 그 네트워크의 SOL 또는 ETH, 앱 수수료는 USDT입니다. 하나를 다른 단위로 섞어 합치지 않습니다.
서명 원문
wire
보내기 전에 저장하는, 실제로 서명할 내용입니다.
이 프로젝트에서
송신 전에 저장합니다. 응답이 없으면 실패, 환불, 재송신, 예약 해제로 단정하지 않습니다.
tombstone
나중에 사라진 회원, 지갑, 거래를 지우지 않고 남기는 표식입니다.
이 프로젝트에서
v1 이력에서 이후 스냅샷에 없는 대상도 삭제하지 않습니다. 계정을 합치거나 잔액을 만들어 메우지 않습니다.