오류 사례

Mint Error Cases / Burn Error Cases

이 페이지에서는 은행 대시보드에서 자주 발생하는 발행(Mint)·소각(Burn) 오류 케이스를 실무 기준으로 해석하는 방법을 설명합니다.

“에러가 떴을 때 무엇부터 보면 되는지”에 집중합니다.

---

먼저 기억해야 할 한 가지

오류 = 시스템 고장이 아닙니다. 대부분의 오류는 정상적인 정책 차단입니다.

KSC SaaS는 실행 이전에 정책 위반을 막기 위해 의도적으로 오류를 반환합니다.

---

1. Mint Error Cases (발행 오류)

Case 1. “발행 가능 한도 부족”

의미

• 승인 담보 대비 발행 가능 잔여 한도가 부족한 상태

자주 발생하는 상황

• 입금은 되었으나 신탁사 승인 전

• 이미 발행된 수량이 많음

확인 순서

1. 승인 담보 금액

2. 현재 총 발행량

3. 잔여 발행 가능 한도

👉 해결 방법: 👉 신탁사 승인 대기 또는 추가 담보 승인 필요

---

Case 2. “담보 승인 미완료”

의미

• 입금은 확인되었으나

• 담보로 승인되지 않은 상태

확인 포인트

• Pending Collateral 존재 여부

• 승인 요청 상태

👉 은행에서 조치할 수 있는 오류가 아닙니다. 👉 신탁사 승인 완료 후 자동 해결됩니다.

---

Case 3. “일시적 시스템 오류”

의미

• 네트워크 지연

• 일시적인 API 오류

• 재배포 중 요청

특징

• 동일 요청을 다시 시도하면 성공하는 경우 많음

• 반복적으로 발생하지 않음

👉 즉시 재시도하지 말고 👉 잠시 후 상태 재확인 권장

---

2. Burn Error Cases (소각 오류)

Case 1. “소각 가능 수량 부족”

의미

• 소각 요청 금액이

• 현재 유통 중인 잔액을 초과

자주 발생하는 원인

• 잔액 단위 오해 (최소 단위 vs 표시 단위)

• 이미 소각된 수량 포함 계산

확인 포인트

• 실제 유통 잔액

• 단위(6 decimals 기준) 일치 여부

---

Case 2. “금액 형식 오류”

의미

• 요청 금액이 정책상 허용되지 않는 형식

자주 발생하는 예

• 소수점 단위 중복 처리

• 문자열/숫자 타입 혼합

👉 시스템 로그 확인 후 👉 운영팀에 공유하면 빠르게 해결됩니다.

---

3. 오류 발생 시 실무 대응 가이드

오류가 발생했을 때 다음 순서로 대응하시면 됩니다.

1. 오류 메시지 확인

2. 담보·한도 상태 확인

3. 동일 오류 반복 여부 확인

4. TxHash 또는 Request ID 확보

5. 운영팀/기술팀 공유

👉 무작정 재시도는 피하세요.

---

4. 은행 실무자에게 드리는 팁

• 오류는 “차단 장치”입니다.

• 시스템이 멈춘 것이 아닙니다.

• 대부분 상태 변화로 해결됩니다.

---

요약

• 발행 오류의 대부분은 한도·담보 이슈

• 소각 오류는 잔액·단위 이슈가 많음

• 오류는 정책 보호 수단

• 원인 확인 후 대응