[가이드] Mint 관리하기

Mint 관리하기 #

이 문서는 Mint 검색, 변경 불가능한 토큰 주소 확인, 회계와 참여 내역 조회, Owner의 규칙·재고·수령 주소·차단 목록·권한 관리를 설명합니다.

Mint 목록 열기

관리 화면은 전체 E2E 테스트를 통과한 BSC Testnet Mint 예시입니다. 실제 작업 전에는 운영 Mint의 네트워크와 전체 컨트랙트 주소를 반드시 확인하세요.

1. Mint 찾기 #

Mint 목록, 검색과 필터

목록에는 다음 기능이 있습니다.

  • 전체 Mint / 내 Mint: 후자는 연결 지갑이 생성한 Mint만 표시;
  • 토큰 주소 또는 Mint 컨트랙트 주소 검색;
  • 재고 방식과 상태 필터;
  • 비율, 사용 가능 재고, 모금액, 참여자와 일정 상태 카드.

목록은 선택 체인의 Factory를 읽습니다. 보이지 않으면 오른쪽 위 네트워크를 확인한 후 전체 Mint 주소로 검색하세요.

2. 상세 정보와 토큰 주소 #

Mint 통계와 온체인 설정

상단에는 Mint 주소, 상태, 총 모금액, 배포 토큰, 참여자 수와 누적 Owner 순수익이 표시됩니다. Mint 설정에는 다음이 포함됩니다.

  • 토큰 주소;
  • Owner와 Pending Owner;
  • 수익 수령 주소와 Inventory Wallet;
  • 생성 시간, 재고 방식과 결제 방식;
  • 교환 비율, 일정, 공급 한도, 거래 한도와 사용자 한도.

토큰 주소는 생성 후 변경할 수 없습니다. 읽기 전용으로 표시되고 편집 항목이 없습니다. 다른 토큰을 사용하려면 새 Mint를 생성하고 새 Mint 주소만 공식 진입점으로 공개하세요.

공개 설정은 누구나 볼 수 있습니다. Owner 또는 고정 Inventory Wallet만 각 권한에 맞는 관리 작업을 볼 수 있습니다.

3. 회계, 재고와 참여자 #

  • 누적 Owner 순수익: 수령 주소로 이미 즉시 전송된 합계;
  • 현재 재고: Portal 잔액 또는 Owner 지갑 잔액과 승인 한도로 사용할 수 있는 수량;
  • 참여자: 주소별 네이티브 코인 지불, 토큰 수령과 Mint 횟수;
  • 연결 지갑 한도: 해당 지갑의 사용량과 남은 한도.

과금 방식이 커미션이라면 Owner 순수익은 실제 사용 금액에서 커미션을 뺀 값입니다. 규칙에 따라 환불된 초과액은 실제 사용 금액에 포함되지 않습니다.

4. Owner 관리자 패널 #

규칙, 정산, 권한과 재고 관리

운영 규칙 #

  • Mint 일시정지 또는 재개;
  • 교환 비율 변경;
  • 이미 배포한 토큰보다 낮지 않게 공급 한도 설정/해제;
  • 거래당 Mint 한도 설정/해제;
  • 사용자 누적 지불 또는 수령 한도 설정/해제.

비율이나 한도를 변경하기 전 Mint를 일시정지하고 사용자에게 알린 뒤 거래 해시를 저장하고 검증 후 다시 여는 것을 권장합니다.

수령 주소와 일정 #

  • 이후 Mint 순수익을 받을 주소 변경;
  • 시작/종료 일정 설정 또는 일정 없음으로 복원.

수령 주소를 바꿔도 이미 전송된 자금은 회수되지 않습니다. 전체 새 주소를 확인하세요.

주소와 권한 #

  • 차단 주소를 개별 또는 일괄 추가/삭제;
  • Owner 권한을 2단계로 이전: 현재 Owner가 시작하고 새 주소가 같은 네트워크에서 수락.

Pending Owner가 수락할 때까지 기존 Owner 지갑을 유지하세요.

5. 재고 관리 #

Owner 지갑에 보관 #

토큰은 고정 Inventory Wallet에 남습니다. 최대 승인, 승인 취소 또는 안내 워크플로를 통한 Mint 컨트랙트 재고 전환을 할 수 있습니다. 사용 가능 재고는 잔액과 승인 한도 모두에 제한되며 하나라도 부족하면 Mint가 실패합니다. Owner 권한을 이전해도 Inventory Wallet은 자동으로 바뀌지 않습니다.

Mint 컨트랙트에 보관 #

Portal이 토큰을 보유합니다. ERC-20 재고 추가, 안전 조건을 만족한 남은 재고 회수, Owner 지갑 방식으로의 순차 전환을 할 수 있습니다.

재고 회수나 방식 전환 전에 Mint를 일시정지하고 공개 캠페인이 진행 중이 아닌지 확인한 뒤 페이지의 선행 단계를 순서대로 완료하세요.

6. 참여자 흐름 #

Owner가 아닌 지갑은 상세 페이지에서 지불액을 입력할 수 있습니다. UI는 슬리피지 보호를 위해 minUnits와 10분 deadline을 사용합니다. Mint 주소로 네이티브 코인을 직접 보내도 작동하지만 UI 슬리피지 보호는 없습니다.

공개 전 다른 지갑으로 상태, 일정, 한도, 재고, 토큰 수령, 순수익, 커미션, 환불과 참여 내역을 확인하세요. Owner는 자기 Mint에 참여할 수 없습니다.

7. 관리 거래를 안전하게 제출하기 #

모든 설정은 “현재 값 확인 → 새 값 입력 → 최종 확인 → 지갑 서명 → 온체인 확인” 순서입니다. 재고 방식 전환과 Owner 이전 같은 다단계 작업은 이미 온체인에서 충족된 단계를 자동으로 건너뜁니다.

  1. 네트워크와 전체 Mint 주소 확인;
  2. 현재 값과 예상 결과 비교;
  3. 지갑 창의 대상 컨트랙트와 금액 확인;
  4. 한 번에 한 거래만 보내고 확인 대기;
  5. 해시를 저장하고 상세 페이지를 새로고침해 상태 확인.

로딩 표시가 남아 있다는 이유만으로 같은 거래를 다시 보내지 마세요.

8. 정기 점검 #

상태, 토큰 주소, 수령 지갑, 비율과 한도, 재고와 승인, 커미션, 차단 목록, Owner/Pending Owner, 공식 Mint 링크를 정기적으로 확인하세요.

9. 자주 묻는 문제 #

  • 관리자 패널이 없음: 연결 지갑이 Owner가 아니거나 네트워크/Mint 주소가 잘못되었습니다. Inventory Wallet에는 재고 작업만 표시됩니다.
  • 토큰 주소를 편집할 수 없음: 사용자 참여 후 자산 교체를 막는 불변 설정입니다. 다른 토큰은 새 Mint가 필요합니다.
  • Active인데 거래 실패: 재고, 승인, 일시정지, 일정, 거래/사용자 한도, 공급 한도, 차단 목록과 영수증 오류를 확인합니다.
  • 수령 주소 변경 후 과거 자금이 이동하지 않음: 정상입니다. 순수익은 각 Mint에서 즉시 전송되며 변경은 이후 거래에만 적용됩니다.
  • 새 Owner에 권한이 없음: 올바른 네트워크에서 같은 Mint를 열고 Owner 권한 수락을 완료해야 합니다.
  • 재고 전환이 멈춤: 페이지 순서대로 일시정지, 승인, 예치 또는 회수를 완료하고 실패 원인을 확인한 뒤 재시도합니다.
  • 화면과 탐색기가 잠시 다름: 몇 블록 기다린 뒤 새로고침하고 Mint 주소와 거래 해시를 보관하세요.