용어집

용어	정의
Account	고객 또는 사업자 uid와 연결되는 잔액 소유 단위
USER	고객 지갑 계정 유형
BUSINESS	가맹점 또는 운영 결제 계정 유형
Deposit Address	계정에 할당된 네트워크별 입금 주소
Asset Type	USDT·ETH 같은 사용자 관점의 경제적 자산
Network	Ethereum Sepolia 같은 블록체인 환경
Asset	특정 네트워크에 배포된 자산 유형
Atomic / Raw Unit	자산의 최소 정수 단위
Balance	계정·자산의 사용 가능·예약 현황
Ledger	확정된 잔액 변동의 append-only 원장
Internal Transfer	외부 체인 전송 없이 OOLIN 계정 사이에서 이동하는 거래
External Withdrawal	외부 블록체인 주소로 보내는 비동기 출금
client_request_id	결과 복구에 사용하는 고객사 생성 고유 식별자
Cursor	증분 동기화의 마지막 처리 ID
HMAC	요청 내용을 인증하는 keyed hash
Nonce	replay를 방지하는 요청별 고유 값

필드별 정의는 API Reference에서 확인하십시오.

관계 요약

하나의 uid는 하나 이상의 Account와 연결될 수 있습니다. Account는 잔액과 입금 주소를 소유합니다. 입금 주소는 네트워크별이고 잔액은 일반적으로 자산 유형별입니다. 입금·내부이체·출금은 업무 레코드이며 확정된 회계 효과는 불변 Ledger 항목입니다. Cursor는 동기화 checkpoint이며 거래 상태가 아닙니다.

개념을 분리하면 네트워크 주소를 지갑 자체로 저장하거나, 현재 잔액을 거래 이력으로 사용하거나, 목록 cursor가 진행 중 레코드의 완료를 증명한다고 해석하는 오류를 방지할 수 있습니다.