본문으로 건너뛰기

수이(SUI)

수이 지갑 구조​

수이 지갑은 다음과 같이 구성되어 있습니다.

  • 대표주소
  • 수수료주소
  • 자식주소

TIP 중앙화 지갑일 경우, 집금 시 수수료주소에서 수수료(SUI)가 차감됩니다. 출금 시에는 수수료 대납 기능을 사용하는 경우에만 수수료주소에서 수수료가 차감됩니다.





입금​

입금 상태​

외부에서 보낸 자산이 대표주소에 도착하면 옥텟은 이를 입금으로 인식합니다. 외부에서 자산을 보냈으나 대표주소에 도착하지 않았다면 해당 트랜잭션은 인식되지 않습니다. 따라서 입금 트랜잭션에는 실패(FAILED) 상태가 없습니다.

상태명내용
FINALIZED입금이 완료된 상태




집금​

집금은 중앙화 지갑에서만 가능합니다.


집금 과정​

자식주소에 보관된 자산은 집금을 요청하기 전까지는 대표주소로 이동하지 않습니다. 따라서 대표주소의 잔액이 부족하지 않도록 주기적으로 집금을 진행해야 합니다.

특정 자산의 집금을 요청하면 모든 자식주소에 보관된 자산이 대표주소로 이동합니다. 이때 자식주소 당 트랜잭션이 1개씩 발생합니다. 예를 들어 자식주소 10개에 SUI가 보관되어 있다면 총 10개의 트랜잭션이 발생하게 됩니다.

이때, 집금할 자산이 예상 수수료보다 작을 경우 집금이 진행되지 않습니다. 집금 진행 과정은 다음과 같습니다.

  1. 집금을 요청합니다.
  2. 집금을 실행할 자식주소 별 트랜잭션을 생성합니다.
  3. 최적 수수료를 계산한 뒤 트랜잭션을 전파합니다.
  4. 트랜잭션이 블록에 반영되면 집금이 완료됩니다.


집금 수수료​

집금 수수료는 수이 수수료 대납 기능을 이용하여 수수료주소에서 차감됩니다. 따라서 집금을 진행하기 전 수수료주소에 잔액이 부족하지 않도록 수이(SUI)를 채워두어야 합니다.

수수료주소의 잔액이 부족하다면 최대로 생성할 수 있는 트랜잭션만큼만 집금이 진행됩니다. 예를 들어 10개의 자식주소에서 집금이 진행되어야 하는데, 수수료주소에 5개의 트랜잭션만 발생시킬 수 있는 잔액이 있다면, 5개의 주소만 집금이 진행되고 나머지 주소는 집금이 진행되지 않습니다.



집금 상태​

집금 상태는 집금 과정에 따라 4가지로 구분됩니다. 자식주소에 보관된 자산은 집금 대기(AWAITING_GATHERING) 상태입니다.

집금을 요청하여 집금 트랜잭션이 생성되면 자산의 상태가 집금 중(GATHERING)으로 변경됩니다. 해당 트랜잭션이 블록에 포함되면 자산의 상태가 집금 완료(COMPLETED) 처리되며 집금이 완료됩니다.

집금을 시도했으나 트랜잭션이 실패한 경우 자산의 상태가 집금 실패(GATHERING_FAILED) 처리됩니다. 집금 실패 상태인 자산은 다시 집금 대상에 포함됩니다. 집금을 시도했으나 수수료가 부족하여 트랜잭션이 생성되지 못한 경우 집금 대기(AWAITING_GATHERING) 상태로 남게 됩니다.

상태명내용
AWAITING_GATHERING집금 대기 중
GATHERING집금 트랜잭션 생성
COMPLETED집금 트랜잭션 완료
GATHERING_FAILED집금 트랜잭션 실패






출금​

출금 상태​

입금과는 달리 출금은 트랜잭션이 블록에 포함된 즉시 출금 완료(FINALIZED) 처리됩니다.

상태명내용
AWAITING_DECISION출금 승인 대기 중인 상태
REJECTED출금이 거절된 상태
AWAITING_WITHDRAWAL출금이 승인되어 출금 대기 중인 상태
PENDING출금 트랜잭션이 생성된 상태
FINALIZED출금 트랜잭션이 블록에 포함된 상태
FAILED출금 트랜잭션이 실패한 상태




잔액 조회 기준​

주소 잔액 조회 API를 호출하면 특정 주소에 보관된 자산의 잔액을 확인할 수 있습니다. 이때 조회되는 잔액은 총 잔액(Total Balance)과 사용 가능 잔액(Liquid Balance)으로 나누어집니다.

  • 총 잔액은 confirmation이 1 이상인 모든 자산을 의미합니다.
  • 사용 가능 잔액은 finalized 상태인 자산만 계산합니다. 자식주소의 사용 가능 잔액은 집금 가능한 자산을 의미하며, 대표주소의 사용 가능 잔액은 출금 가능한 자산을 의미합니다.



수수료​

수이는 예상 수수료 산식이 제공되지 않습니다.