HighRun Token 관리자 사용 가이드

색상	의미	가스비	해당 기능
빨간색	위험 / 되돌리기 어려움	발생 (유료)	일시정지, 역할 부여, 역할 회수, 토큰 소각, 블랙리스트 추가
파란색	일반 실행	발생 (유료)	정상화, 락업 설정/연장/감소/해제, 토큰 전송, 일괄 전송, 만료 락업 제거, 블랙리스트 해제
노란색 (Safe)	멀티시그 제안	없음 (무료)	Safe를 통한 제안/승인 단계 (실행 단계에서만 가스비 발생)
회색	조회 전용	없음 (무료)	상태 새로고침, 락업 조회, 블랙리스트 조회, 잔액 조회, 미리보기, 행 추가

1. 이 가이드에 대하여

이 안내서는 HighRun Token(HighRun 토큰)을 관리하시는 분들을 위해 만들어졌습니다.

HighRun Token은 인터넷 위에서 사용하는 디지털 화폐(토큰)입니다. 이 관리자 도구를 통해 토큰을 보내거나, 특정 사람의 토큰을 일정 기간 동안 못 보내게 잠그거나(락업), 특정 주소를 블랙리스트에 등록하거나, 토큰을 없애거나(소각), 관리 권한을 다른 사람에게 주는 등의 작업을 할 수 있습니다.

HighRun Token 기본 정보

토큰 이름: Hynex Token
토큰 약자: HighRun
전체 발행량: 1,000,000,000 HighRun (10억 개)
사용하는 네트워크: Ethereum 메인넷 (체인 번호: 1)
테스트 네트워크: Sepolia 테스트넷 (체인 번호: 11155111)

Safe (멀티시그) 지갑 연동

HighRun Token은 Safe (구 Gnosis Safe) 멀티시그 지갑으로 운영됩니다. 멀티시그란 중요한 작업을 실행할 때 여러 명의 승인(서명)이 필요한 보안 방식입니다. ADMIN 작업과 MANAGER 작업 모두 Safe를 통해 제안 → 승인 → 실행 절차를 거칩니다. 자세한 내용은 Safe 멀티시그 완전 가이드를 참고하세요.

2. 지갑이란?

지갑(Wallet)은 내 토큰을 보관하고 관리하는 디지털 통장이라고 생각하시면 됩니다. 이 가이드에서 나오는 모든 기능은 "지갑"을 연결한 상태에서 사용합니다.

지갑 주소는 통장 번호와 같습니다. 0x로 시작하는 42자리 숫자와 영문 조합입니다.
비밀 복구 문구(12개 단어)는 통장 비밀번호(도장)와 같습니다. 잃어버리면 지갑 안의 토큰을 영원히 찾을 수 없습니다.
지갑 주소는 다른 사람에게 알려줘도 되지만, 비밀 복구 문구는 절대로 누구에게도 알려주면 안 됩니다.

절대 주의!

비밀 복구 문구(12개 단어)를 다른 사람에게 알려주면 그 사람이 내 토큰을 모두 가져갈 수 있습니다. 어떤 상황에서도 절대 알려주지 마세요. 공식 관리자라고 하면서 물어보는 경우도 사기입니다.

주소 입력 시 주의사항

지갑 주소는 반드시 0x로 시작하는 42자리여야 합니다.
0x0000000000000000000000000000000000000000 (빈 주소)는 사용할 수 없습니다. 시스템이 자동으로 거부합니다.
주소를 입력할 때 복사+붙여넣기를 사용하세요. 직접 타이핑하면 오타가 날 수 있습니다.

3. 준비물

관리자 도구를 사용하려면 아래 2가지가 필요합니다.

준비물	설명
MetaMask (메타마스크)	인터넷 브라우저(크롬, 브레이브 등)에 설치하는 전자 지갑 프로그램입니다. 이 지갑이 있어야 토큰을 보내거나 관리할 수 있습니다. MetaMask 공식 사이트에서 설치하기
ETH (수수료)	토큰을 보내거나 설정을 바꿀 때마다 약간의 수수료가 들어갑니다. 이 수수료를 내기 위해 ETH(이더)가 필요합니다. 수수료는 네트워크 혼잡도에 따라 달라지며, 보통 수백 원~수천 원 수준입니다. ETH는 업비트, 빗썸 등 거래소에서 구매할 수 있습니다.

수수료(가스비)란?

블록체인에서 어떤 작업을 하면 그 작업을 처리해주는 사람들(컴퓨터들)에게 약간의 비용을 내야 합니다. 이것을 "수수료" 또는 "가스비"라고 부릅니다. 택시를 타면 택시비를 내는 것과 비슷합니다. 단순히 정보를 확인하는 것(조회)은 수수료가 들지 않지만, 토큰을 보내거나 설정을 바꾸는 것은 수수료가 듭니다.

HighRun 관리자 대시보드는 관리자, 운영자, Safe 서명자 지갑만 접속할 수 있습니다. 권한이 없는 지갑으로는 접속이 불가능합니다.

로그인 절차 (4단계)

1단계: 네트워크 선택
로그인 화면에서 사용할 네트워크를 선택합니다.
"Ethereum Mainnet" (실제 운영) 또는 "Sepolia Testnet" (테스트용) 중 하나를 클릭하세요.
선택하면 버튼이 활성화되고 아래에 "선택됨"이라고 표시됩니다.
2단계: 지갑 연결
네트워크를 선택하면 "지갑 연결 (MetaMask)" 버튼이 활성화됩니다.
버튼을 클릭하면 MetaMask 팝업이 뜹니다. "연결"을 눌러주세요.
네트워크 전환 팝업이 뜨면 "승인"을 눌러주세요.
3단계: 권한 확인 (자동)
시스템이 자동으로 연결된 지갑의 권한을 확인합니다.
ADMIN(관리자), MANAGER(운영자), Safe 서명자 중 하나라도 해당되면 통과합니다.
"권한 확인 완료! 대시보드로 이동합니다..." 라는 메시지가 나타납니다.
4단계: 대시보드 입장
권한이 확인되면 자동으로 관리자 대시보드로 이동합니다.
지갑 정보, 토큰 잔액, 권한 레벨 등이 자동으로 표시됩니다.

권한이 없는 지갑으로 연결하면?

"이 지갑은 관리자/운영자/서명자 권한이 없습니다"라는 메시지가 나타나고, 대시보드에 입장할 수 없습니다. 관리 권한이 있는 지갑으로 다시 연결해주세요.

로그인 후 지갑 연결이 해제되면?

대시보드를 사용하는 도중에 MetaMask에서 지갑 연결을 해제하거나, 다른 계정으로 변경하면 자동으로 로그인 화면으로 돌아갑니다. 보안을 위해 다시 로그인해야 합니다.

사용 가이드 페이지도 보호됩니다

이 사용 가이드 페이지도 관리자 전용입니다. 대시보드에서 로그인한 상태에서만 접근할 수 있습니다. 대시보드에서 "사용 가이드" 버튼을 클릭하면 새 탭에서 이 페이지가 열립니다.

5. 처음 시작하기 (초기 설정)

처음 사용하시는 분은 아래 순서대로 천천히 따라 해 주세요.

MetaMask(메타마스크) 설치하기
컴퓨터에서 크롬 브라우저를 열고, 주소창에 metamask.io 를 입력해서 접속합니다.
화면에 보이는 "Download"(다운로드) 버튼을 눌러 설치합니다.
설치가 끝나면 화면 안내에 따라 비밀번호를 만들고, 비밀 복구 문구(영어 단어 12개)가 나오면 반드시 종이에 적어서 안전한 곳에 보관하세요. 이 12개 단어를 잃어버리면 지갑을 복구할 수 없습니다.
수수료용 ETH 준비하기
토큰을 보내거나 설정을 바꿀 때 소액의 수수료가 필요합니다. 이 수수료는 ETH(이더)로 냅니다.
거래소(업비트, 빗썸, 바이낸스 등)에서 ETH를 소량 구매한 뒤, MetaMask 지갑 주소로 보내세요.
중요: 출금할 때 반드시 "Ethereum 네트워크 (ERC-20)"를 선택해야 합니다.
0.01 ETH 이상이면 여러 번 거래할 수 있습니다.
관리자 웹사이트 접속하기
전달받은 관리자 웹사이트 주소(링크)를 크롬 브라우저 주소창에 입력하거나, 링크를 클릭하여 접속합니다.
"HighRun 관리자 시스템"이라는 로그인 화면이 나타나면 정상입니다.
네트워크 선택 후 지갑 연결
로그인 화면에서 사용할 네트워크(Ethereum Mainnet 또는 Sepolia Testnet)를 먼저 선택합니다.
그 다음 "지갑 연결 (MetaMask)" 버튼을 클릭합니다.
MetaMask 팝업 창이 뜨면 "연결"과 "승인"을 눌러주세요.
시스템이 자동으로 권한을 확인한 뒤 대시보드로 이동합니다.

여기까지 하면 준비 완료!

이제 대시보드의 각 항목을 눌러서 토큰 전송, 잠금 설정, 블랙리스트 관리 등 모든 기능을 사용할 수 있습니다.

6. 메타마스크에 HighRun 토큰 추가하기

메타마스크에 HighRun 토큰을 추가하면, 지갑에서 HighRun 잔액을 바로 확인할 수 있습니다. 추가하지 않아도 토큰은 보유하고 있지만, 메타마스크 화면에 표시되지 않아 불편할 수 있습니다.

방법 1: 대시보드에서 자동 추가 (가장 쉬움)

관리자 대시보드에 접속하고 지갑을 연결합니다.
상단의 "메타마스크에 HighRun 토큰 추가" 노란색 버튼을 클릭합니다.
메타마스크 팝업이 뜨면 "토큰 추가" 버튼을 눌러 승인합니다.
메타마스크 자산 목록에 HighRun가 표시되면 완료입니다.

방법 2: 메타마스크에서 직접 추가

대시보드를 사용할 수 없는 경우, 메타마스크에서 직접 토큰을 추가할 수 있습니다.

메타마스크를 열고 Ethereum Mainnet에 연결되어 있는지 확인합니다.
하단의 "토큰 가져오기(Import tokens)"를 클릭합니다.
"사용자 정의 토큰(Custom token)" 탭을 선택합니다.
아래 정보를 입력합니다:

토큰 계약 주소: 대시보드 또는 관리자에게 전달받은 HighRun 컨트랙트 주소 (0x...)
토큰 기호: HighRun (주소 입력 시 자동 입력됨)
토큰 소수 자릿수: 18 (주소 입력 시 자동 입력됨)
"다음(Next)"을 누른 뒤 "토큰 가져오기(Import tokens)"를 클릭합니다.

참고

토큰을 추가하는 것은 "표시"만 하는 것이므로, 가스비가 들지 않습니다 (무료).
한번 추가하면 다시 추가할 필요 없이 계속 표시됩니다.

7. 역할(권한) 시스템

HighRun Token에는 2가지 종류의 관리 권한이 있습니다. 회사에서 "사장님"과 "담당자"가 할 수 있는 일이 다른 것과 비슷합니다.

역할 이름	쉬운 이름	할 수 있는 일
DEFAULT_ADMIN_ROLE	전체 관리자 (ADMIN)	- 모든 거래를 일시정지시키거나 다시 풀기 - 다른 사람에게 관리 권한을 주거나 빼기 - 컨트랙트 업그레이드 (가장 높은 권한입니다)
MANAGER_ROLE	매니저 (관리 담당자)	- 토큰 잠금(락업) 설정/연장/감소/해제/정리 - 블랙리스트 추가/해제 (락업과 블랙리스트 관련 작업을 담당합니다)

대시보드 상단 "권한 레벨"에 표시되는 값

ADMIN + 매니저 — 두 가지 권한을 모두 보유
ADMIN (관리자) — ADMIN 권한만 보유
매니저 (MANAGER) — 매니저 권한만 보유
Safe 서명자 (Admin) / Safe 서명자 (Manager) — Safe 멀티시그 서명자
일반 사용자 — 관리 권한 없음 (전송, 소각만 가능)

8. Safe 멀티시그 완전 가이드

Safe란 무엇인가요?

Safe(구 Gnosis Safe)는 여러 사람이 함께 관리하는 지갑입니다. 미리 정해진 인원 중 일정 수 이상이 동의(서명)해야만 실행됩니다.

예를 들어 "2-of-3" Safe라면, 3명의 서명자 중 2명 이상이 동의해야 트랜잭션이 실행됩니다.

아래 섹션 9~17에서 "Safe 멀티시그"라고 표시된 기능은 모두 이 절차를 거칩니다. 반대로 "단일 서명"이라고 표시된 기능은 Safe 없이 내 지갑에서 바로 실행됩니다.

HighRun에서 Safe가 사용되는 곳

역할	Safe 용도	관리 기능
ADMIN Safe	최고 관리자 지갑	일시정지/정상화, 역할 부여/회수, 업그레이드
MANAGER Safe	운영 매니저 지갑	블랙리스트 등록/해제, 락업 설정/연장/감소/해제

Safe 사용 흐름 (3단계)

제안 (Propose)
서명자 중 1명이 대시보드에서 기능을 실행합니다. MetaMask에서 서명 요청이 나타나면 승인합니다. 이 단계에서는 블록체인에 아무 일도 일어나지 않습니다. 가스비도 들지 않습니다.
승인 (Approve)
다른 서명자가 대시보드의 "Safe 대기 트랜잭션 (서명칸)" 섹션에서 대기 중인 트랜잭션을 확인합니다. "승인 (서명)" 버튼을 클릭하고 MetaMask에서 서명합니다. 가스비가 들지 않습니다. 필요한 서명 수에 도달할 때까지 반복합니다.
실행 (Execute)
필요 서명 수에 도달하면 "블록체인에 실행" 버튼이 나타납니다. 이 단계에서만 블록체인에 기록되고, 가스비가 발생합니다. 실행한 사람의 지갑에서 가스비가 차감됩니다.

대시보드에서 Safe 상태 확인하기

위치	표시 내용
지갑 정보 → Admin Safe 서명자 / Manager Safe 서명자	현재 연결된 지갑이 어느 Safe의 서명자인지 표시됩니다.
지갑 정보 → 권한 레벨	"Safe 서명자 (Manager)" 등으로 표시됩니다.
Safe 대기 트랜잭션 (서명칸) 섹션	Safe 서명자일 때만 나타납니다. 대기 중인 트랜잭션 목록, 서명 현황, 승인/실행 버튼이 표시됩니다.
Safe 실행 내역 섹션	실행 완료된 Safe 트랜잭션 기록입니다. 최근 20건까지 표시됩니다.

서명칸 테이블 상세

항목	설명
역할	Admin(빨간색) 또는 Manager(파란색). 어느 Safe의 트랜잭션인지 표시.
내용	어떤 작업인지 한국어로 표시 (예: "블랙리스트 등록: 0xABC...")
서명	현재 서명 수 / 필요 서명 수 (예: 1/2)
작업	"승인 (서명)" — 서명이 아직 부족할 때 "블록체인에 실행" — 서명이 충분히 모였을 때 "내 승인 완료" — 이미 서명 완료한 상태

가스비 안내

제안 (1단계): 가스비 없음. 서명만 하면 됩니다.

승인 (2단계): 가스비 없음. 서명만 하면 됩니다.

실행 (3단계): 가스비 발생! 실행 버튼을 누르는 사람의 지갑에서 ETH가 차감됩니다.

자주 묻는 질문 (Safe 관련)

Q: 제안한 사람이 바로 실행할 수 있나요?

아니요. 임계값이 2 이상이면 반드시 다른 서명자의 추가 승인이 필요합니다.

Q: 실행 가스비는 누가 내나요?

"실행" 버튼을 클릭하는 사람의 MetaMask(개인 지갑)에서 ETH가 차감됩니다. Safe 지갑의 ETH가 아닙니다.

Q: 잘못된 제안이 올라왔을 때는?

다른 서명자들이 승인하지 않으면 됩니다. 서명이 모이지 않으면 절대 실행되지 않습니다.

9. 역할 관리 (역할 주기/빼기)

버튼 색상: 빨간색 (위험) | 서명 방식: Safe 멀티시그 (ADMIN Safe) | 필요 권한: ADMIN | 가스비: 실행 시 발생

ADMIN 권한을 가진 사람만 다른 사람에게 권한을 주거나 뺄 수 있습니다. Safe 멀티시그를 통해 여러 명의 서명이 필요합니다.

권한 주기 (역할 부여)

대시보드에서 "권한 관리 (Role Management)" 항목을 눌러서 엽니다.
"역할 부여" 부분에서, 부여할 역할을 선택합니다:
- "매니저 (MANAGER) - 락업/블랙리스트 관리"
- "ADMIN (관리자) - 주의!"
아래 입력칸에 권한을 줄 사람의 지갑 주소를 입력합니다 (0x로 시작하는 42자리 주소).
"역할 부여" 버튼을 누릅니다.
확인 팝업이 뜨면 내용을 읽고 "확인"을 누릅니다.
MetaMask 서명 요청이 뜨면 "서명"을 눌러주세요. Safe를 통해 제안됩니다.

권한 빼기 (역할 회수)

같은 "권한 관리" 항목에서 "역할 회수" 부분을 찾습니다.
빼고 싶은 권한을 선택하고, 대상 지갑 주소를 입력합니다.
"역할 회수" 버튼을 누르고 확인합니다.

매우 중요한 경고!

자기 자신의 ADMIN 권한도 빼버릴 수 있으니 조심하세요!
마지막 남은 ADMIN의 권한을 빼버리면, 다시는 아무도 권한을 관리할 수 없게 됩니다. 이것은 되돌릴 수 없습니다!
ADMIN은 "ADMIN (관리자) - 주의!" 선택 시 빨간색 경고가 나타납니다. 반드시 읽어주세요.

10. 토큰 정보 확인

대시보드에서 "컨트랙트 상태" 항목을 눌러서 열면, 현재 토큰의 기본 정보를 확인할 수 있습니다. "상태 새로고침" 버튼을 누르면 최신 정보로 업데이트됩니다.

확인 항목	설명
토큰명 / 심볼	Hynex Token / HighRun
총 발행량	현재 남아있는 전체 토큰 수 (소각하면 줄어듭니다)
일시정지 여부	"정상" 또는 "일시정지 상태"로 표시
내 권한	현재 연결된 지갑의 역할이 표시됩니다

또한 아래쪽의 "토큰 정보 조회" 항목에서 다른 사람의 지갑 주소를 입력해서 그 사람이 가진 HighRun 수량을 확인할 수 있습니다. 수수료가 들지 않습니다 (무료).

11. 토큰 보내기 (전송)

버튼 색상: 파란색 (일반) | 서명 방식: 단일 서명 (내 지갑에서 직접) | 필요 권한: 누구나 (토큰 보유자) | 가스비: 발생

내가 가진 HighRun 토큰을 다른 사람의 지갑으로 보내는 기능입니다. Safe 멀티시그 없이 내 지갑에서 직접 실행됩니다.

대시보드에서 "토큰 전송" 항목을 눌러서 엽니다.
"받는 주소" 입력칸에 받을 사람의 지갑 주소를 입력합니다.
"전송 수량" 입력칸에 보낼 수량을 입력합니다. 숫자 그대로 전송됩니다 (100 입력 = 100개 전송). 소수점도 가능합니다 (0.5 = 반 개).
"전송" 버튼을 누릅니다.
확인 팝업에서 주소와 수량을 꼼꼼히 확인하고 "확인 및 실행"을 누릅니다.
MetaMask 팝업이 뜨면 "확인"을 눌러 승인합니다.

알아두세요

잠금(락업)된 토큰은 보낼 수 없습니다. 잠금되지 않은 수량만 보낼 수 있습니다.
블랙리스트에 등록된 주소에서는 전송할 수 없고, 블랙리스트 주소로 전송할 수도 없습니다.
보낸 토큰은 되돌릴 수 없으니, 주소와 수량을 꼭 확인하세요.
자기 자신에게는 전송할 수 없습니다.
토큰이 일시정지 상태이면 전송이 차단됩니다.

12. 한꺼번에 보내기 (일괄 전송)

버튼 색상: 파란색 (일반) | 서명 방식: 단일 서명 (내 지갑에서 직접) | 필요 권한: 누구나 (토큰 보유자) | 가스비: 발생

여러 사람에게 한 번에 토큰을 보내는 기능입니다. Safe 멀티시그 없이 내 지갑에서 직접 실행됩니다.

사용 방법

대시보드에서 "일괄 전송 (Batch Transfer)" 항목을 눌러서 열면, 줄마다 입력칸이 보입니다.

각 줄의 왼쪽 칸에 받을 사람의 지갑 주소를, 오른쪽 칸에 보낼 수량을 입력합니다.
수량은 실제 HighRun 개수입니다 (100 = 100개, 소수점 가능).
처음에 10줄이 보입니다. 줄이 더 필요하면 "행 추가" 버튼을 눌러 추가합니다.
한 번에 최대 500명까지 보낼 수 있습니다.
입력이 끝나면 "미리보기" 버튼을 눌러 입력 내용이 맞는지 확인하세요.
확인 후 "일괄 전송 실행" 버튼을 누르면 전송됩니다.

주의사항

권한에 상관없이 토큰을 가진 사람이면 누구나 일괄 전송을 사용할 수 있습니다.
블랙리스트 주소가 포함되면 전체 전송이 실패합니다.
대량으로 보내기 전에 소량(2~3명)으로 먼저 시험해 보세요.

13. 블랙리스트 관리

등록 버튼 색상: 빨간색 (위험) | 해제 버튼 색상: 파란색 (일반) | 조회: 회색 (무료)
서명 방식: Safe 멀티시그 (MANAGER Safe) | 필요 권한: 매니저 (MANAGER) | 가스비: 등록/해제 시 발생, 조회 무료

블랙리스트란?

블랙리스트에 등록된 주소는 아래 모든 활동이 차단됩니다:

토큰을 보내거나 받을 수 없습니다
토큰 사용 허가(approve)를 할 수 없습니다
투표 위임이 차단되고, 기존 위임도 해제됩니다
투표권이 0으로 표시됩니다

매니저(MANAGER) 권한을 가진 사람만 블랙리스트 관련 작업을 할 수 있습니다. Safe 멀티시그 서명이 필요합니다.

13-1. 블랙리스트에 추가하기

대시보드에서 "블랙리스트 관리" 항목을 엽니다.
"블랙리스트 등록" 부분에서 주소를 입력합니다.
"블랙리스트 등록" 버튼(빨간색)을 누릅니다.
확인 팝업과 MetaMask 서명 요청에서 승인합니다.

13-2. 블랙리스트에서 해제하기

"블랙리스트 해제" 부분에서 주소를 입력합니다.
"블랙리스트 해제" 버튼(파란색)을 누릅니다.
확인 팝업과 MetaMask 서명 요청에서 승인합니다.

13-3. 블랙리스트 조회하기

"블랙리스트 조회" 항목에서 주소를 입력하고 "조회" 버튼을 누르면 해당 주소의 블랙리스트 등록 여부가 표시됩니다. 수수료 없이 무료입니다.

기능	하는 일	필요 권한	수수료
블랙리스트 등록	주소의 모든 토큰 활동 차단	매니저 (MANAGER)	있음
블랙리스트 해제	차단 해제, 정상 활동 가능	매니저 (MANAGER)	있음
블랙리스트 조회	등록 여부 확인	누구나	무료

14. 토큰 잠금 (락업) 관리

버튼 색상: 파란색 (일반) | 서명 방식: Safe 멀티시그 (MANAGER Safe) | 필요 권한: 매니저 (MANAGER) | 가스비: 발생

락업(잠금)이란?

특정 주소가 가진 HighRun 토큰 중 원하는 만큼을 정해진 기간 동안 보내지 못하게 잠그는 기능입니다.

매니저(MANAGER) 권한을 가진 사람만 잠금 관련 작업을 할 수 있습니다. Safe 멀티시그 서명이 필요합니다.

가장 중요한 내용: 이미 잠금이 걸린 주소에는 새 잠금을 설정할 수 없습니다!

활성 상태인 락업이 있는 주소에 새 락업을 설정하면 오류가 발생합니다 (ActiveLockupExists).

기존 락업 기간이 만료될 때까지 기다리거나
"수량 감소"에서 0을 입력하여 기존 락업을 제거한 뒤 새로 설정하세요.

14-1. 새 잠금 설정하기

대시보드에서 "Lockup 관리" → "새 락업 설정" 부분을 엽니다.

"락업할 주소"에 잠금 대상의 지갑 주소를 입력합니다.
"시간 (분 단위)"에 잠글 기간을 분 단위 정수로 입력합니다 (아래 변환표 참고).
"수량 (HighRun)"에 잠글 토큰 수량을 입력합니다 (소수점 가능. 예: 100.5).
"락업 설정" 버튼을 누르고 확인합니다.

잠금 수량은 보유량을 초과할 수 없습니다!

해당 주소가 가진 토큰보다 많은 수량을 잠그려고 하면 오류가 발생합니다 (InsufficientBalance).

예시

김철수에게 잠금이 없는 상태
→ 주소 입력, 43200분, 5,000 HighRun 입력 후 실행
→ 최종 결과: 5,000 HighRun가 30일(43,200분)간 잠금

14-2. 잠금 기간 늘리기

이미 잠금이 설정된 사람의 잠금 기간을 더 늘리는 기능입니다. 잠금 수량은 바뀌지 않고, 기간만 추가됩니다.

예시

홍길동의 현재 잠금: 1,000 HighRun, 만료일 4월 1일
→ 10080분(7일) 입력 후 실행
→ 최종 결과: 만료일 4월 8일 (7일 연장됨, 수량은 그대로)

이미 만료된 락업은 연장할 수 없습니다. "새 잠금 설정"으로 처음부터 다시 잠금을 만들어야 합니다.

14-3. 잠금 수량 줄이기 (수량 감소)

"빼기"가 아니라 "새 값으로 바꾸기"입니다!

입력하는 숫자가 "빼는 양"이 아니라 "새로 설정할 양"입니다. 예를 들어 현재 1,000 HighRun가 잠겨있고 700을 입력하면, 잠금이 700 HighRun로 변경됩니다 (300이 빠지는 게 아닙니다). 0을 입력하면 잠금이 완전히 풀립니다.

예시

현재 잠금: 1,000 HighRun
→ 새로운 수량에 700 입력 후 실행
→ 최종 결과: 잠금 수량이 700 HighRun로 변경 (1000에서 700으로 교체)

14-4. 잠금 일부 풀어주기 (부분 해제)

이 기능은 "빼기" 방식입니다!

위의 "수량 감소"와 다르게, 입력한 수량만큼 기존 잠금에서 빼줍니다.

예시

현재 잠금: 1,000 HighRun
→ 해제할 수량에 300 입력 후 실행
→ 최종 결과: 잠금 수량이 700 HighRun로 줄어듦 (1,000 - 300 = 700)

"수량 감소"와 "부분 해제"의 차이 (매우 중요!)

버튼	숫자의 의미	현재 1,000에서 700을 입력하면?
수량 감소	"새로 잠글 수량"	잠금이 700이 됨 (교체)
부분 해제	"풀어줄 수량"	잠금이 300이 됨 (빼기)

14-5. 만료된 잠금 정리하기

이 기능은 꼭 하지 않아도 됩니다!

잠금 기간이 끝나면 자동으로 효력이 사라집니다. 이 기능은 만료된 정보를 깔끔하게 지우는 "청소" 기능일 뿐입니다.

잠금 시간 변환표

잠금 기간은 "분" 단위로 입력해야 합니다.

기간	입력할 숫자 (분)
1시간	60
12시간	720
1일 (하루)	1,440
1주일 (7일)	10,080
1개월 (30일)	43,200
3개월 (90일)	129,600
6개월 (180일)	259,200
1년 (365일)	525,600
2년 (730일)	1,051,200

잠금 기능 한눈에 보기

버튼	하는 일	작동 방식
락업 설정	토큰을 잠급니다	활성 락업 불가 — 기존 활성 락업이 있으면 오류 발생
락업 연장	잠금 기간을 늘립니다	기간 추가 — 수량은 그대로, 만료일만 늘어남
수량 감소	잠금 수량을 줄입니다	새 값으로 교체 — 입력한 숫자가 새 잠금 수량 (빼기 아님!)
부분 해제	잠금의 일부를 풀어줍니다	빼기 — 입력한 숫자만큼 차감 (유일한 빼기 방식!)
만료 제거	만료된 잠금 정보를 삭제	선택사항 — 안 해도 됨, 단순 정리 용도

15. 토큰 잠금 조회

대시보드에서 "Lockup 조회" 항목에서 주소를 입력하고 "조회" 버튼을 누르면 잠금 상태를 확인할 수 있습니다. 수수료 없이 무료입니다.

확인할 수 있는 정보	설명
잠금된 수량	현재 잠겨 있어서 보낼 수 없는 토큰 수량
잠금 만료 시간	잠금이 풀리는 날짜와 시간
사용 가능 잔액	전체 보유량 중 잠금되지 않아 자유롭게 보낼 수 있는 수량

16. 토큰 소각

버튼 색상: 빨간색 (위험) | 서명 방식: 단일 서명 (내 지갑에서 직접) | 필요 권한: 누구나 (자기 토큰만) | 가스비: 발생

소각이란 토큰을 영구적으로 없애버리는 것입니다. Safe 멀티시그 없이 내 지갑에서 직접 실행됩니다.

오직 자기 자신의 토큰만 소각할 수 있습니다 (다른 사람 것은 소각 불가).
소각하면 전체 토큰 발행량도 그만큼 줄어듭니다.
소각된 토큰은 어떤 방법으로도 절대 되돌릴 수 없습니다!
잠금(락업)된 토큰은 소각할 수 없습니다. 잠금되지 않은 수량만 소각 가능합니다.
토큰이 일시정지 상태이면 소각이 차단됩니다.

소각 전 반드시 확인하세요!

확인 팝업에서 "위험을 이해했습니다, 실행" 버튼을 눌러야 실행됩니다. 수량을 여러 번 확인하세요.

17. 일시정지 / 정상화

일시정지 버튼: 빨간색 (위험) | 정상화 버튼: 파란색 (일반)
서명 방식: Safe 멀티시그 (ADMIN Safe) | 필요 권한: ADMIN | 가스비: 실행 시 발생

ADMIN 권한을 가진 사람만 사용할 수 있는 기능입니다. 대시보드의 "컨트랙트 상태" 항목 아래쪽 "빠른 제어" 부분에 있습니다. Safe 멀티시그를 통해 여러 명의 서명이 필요합니다.

기능	설명
일시정지 (빨간색 버튼)	모든 HighRun 토큰 전송이 즉시 중단됩니다. "정상화" 버튼을 누르기 전까지 누구도 HighRun를 보내거나 받을 수 없습니다. 비상 상황(해킹 의심 등)에서만 사용하세요.
정상화 (파란색 버튼)	일시정지 상태를 해제하여 모든 사용자가 다시 HighRun를 보내고 받을 수 있게 합니다.

주의

일시정지 중에도 잠금 설정, 블랙리스트 관리, 역할 관리 등의 관리 기능은 사용할 수 있습니다.

18. 자주 묻는 질문 (오류 해결)

수량 입력 시 주의사항

수량은 반드시 일반 숫자로 입력하세요. 예: 1000000
1e6 같은 과학적 표기법은 사용할 수 없습니다. 시스템이 자동으로 거부합니다.
소수점 이하 최대 18자리까지 가능합니다.

문제: 로그인 화면에서 "이 지갑은 관리자/운영자/서명자 권한이 없습니다"라고 나와요

해결: 연결한 지갑에 ADMIN, MANAGER, 또는 Safe 서명자 권한이 없다는 뜻입니다. 관리 권한이 있는 다른 지갑으로 MetaMask에서 계정을 전환한 뒤 다시 연결하세요. 권한은 ADMIN이 부여합니다.

문제: 사용 가이드 페이지에서 "접근이 제한되었습니다"라고 나와요

해결: 사용 가이드도 관리자 전용 페이지입니다. 먼저 대시보드(index.html)에서 로그인한 뒤, 대시보드 상단의 "사용 가이드" 버튼을 클릭하여 접속하세요.

문제: 대시보드를 쓰다가 갑자기 로그인 화면으로 돌아갔어요

해결: MetaMask에서 지갑 연결이 해제되었거나, 다른 계정으로 전환된 경우 자동으로 로그인 화면으로 돌아갑니다. 보안을 위한 정상 동작입니다. 다시 로그인해주세요.

문제: "이 네트워크에 HighRun 컨트랙트가 설정되지 않았습니다"라고 나와요

해결: 선택한 네트워크에 컨트랙트 주소가 아직 등록되지 않은 상태입니다. 관리자에게 문의하거나, 올바른 네트워크를 선택해주세요.

문제: "ActiveLockupExists" 오류가 나와요

해결: 이미 활성 상태인 락업이 있는 주소에 새 락업을 설정하려고 할 때 나오는 오류입니다. "수량 감소"에서 0을 입력하여 기존 락업을 먼저 제거하거나, 기존 락업이 만료될 때까지 기다린 뒤 다시 시도하세요.

문제: "BlacklistedAccount" 또는 "BlacklistedRecipient" 오류가 나와요

해결: 블랙리스트에 등록된 주소가 관련된 경우 나오는 오류입니다. "블랙리스트 조회"로 해당 주소의 상태를 확인하세요.

문제: "BlacklistNoChange" 오류가 나와요

해결: 이미 같은 상태로 변경하려고 할 때 나오는 오류입니다. 예: 이미 블랙리스트인 주소를 다시 추가하거나, 블랙리스트가 아닌 주소를 해제하려 한 경우.

문제: "LockupExpired" 오류가 나와요

해결: 이미 만료된 잠금을 연장하려고 할 때 나오는 오류입니다. "새 락업 설정"으로 처음부터 다시 잠금을 만들어야 합니다.

문제: "NoLockupExists" 오류가 나와요

해결: 해당 주소에 설정된 락업이 없거나 이미 제거된 상태에서 연장/감소/해제/정리를 시도할 때 나오는 오류입니다. "락업 조회"로 해당 주소의 잠금 상태를 먼저 확인하세요.

문제: "InsufficientBalance" 오류가 나와요

해결: 잠금하려는 수량이 해당 주소의 보유량보다 많거나, 전송하려는 수량이 사용 가능 잔액보다 많을 때 나오는 오류입니다. "토큰 잔액 조회"와 "사용 가능 잔액 조회"로 먼저 확인하세요.

문제: "OnlyDecrease" 오류가 나와요

해결: "수량 감소" 기능에서 현재 잠금 수량보다 큰 값을 입력하면 나오는 오류입니다. 현재 잠금 수량보다 작거나 같은 값을 입력해야 합니다. (0 = 전체 해제)

문제: "EnforcedPause" 오류가 나와요

해결: 토큰이 일시정지 상태일 때 전송, 소각 등을 시도하면 나오는 오류입니다. ADMIN이 "정상화" 버튼으로 일시정지를 해제한 뒤 다시 시도하세요.

문제: "가스 추정에 실패했습니다"라고 나와요

해결: 여러 원인이 가능합니다:

입력한 값이 잘못되었을 수 있습니다 (주소, 수량 등을 다시 확인).
해당 기능을 사용할 권한이 없을 수 있습니다.
수수료를 낼 ETH가 부족할 수 있습니다.
블랙리스트된 주소가 관련되어 있을 수 있습니다.
활성 락업이 있는 주소에 새 락업을 설정하려 했을 수 있습니다.

문제: "AccessControl: account ... is missing role ..." 오류가 나와요

해결: 현재 지갑에 해당 기능을 사용할 권한이 없다는 뜻입니다. ADMIN 권한을 가진 사람에게 필요한 권한을 요청하세요.

문제: MetaMask 팝업이 안 떠요

해결: 브라우저 오른쪽 위에 있는 MetaMask 여우 아이콘을 클릭해 보세요. 팝업이 숨겨져 있을 수 있습니다. 그래도 안 되면 브라우저를 새로고침(F5)한 뒤 다시 시도하세요.

문제: "서명 제출 불가: ..." 메시지가 나와요

해결: Safe 멀티시그 제안 전에 시스템이 자동으로 조건을 검증합니다. 메시지 내용을 자세히 읽어보면 원인이 표시됩니다. 예: "Safe 지갑에 MANAGER 권한이 없습니다", "이미 활성 락업이 존재합니다" 등. 조건을 맞춘 뒤 다시 시도하세요.

19. 보안 주의사항

토큰을 안전하게 관리하기 위해 꼭 지켜주세요.

반드시 지켜야 할 보안 수칙

비밀 복구 문구(12개 단어)를 절대 누구에게도 알려주지 마세요.
관리자라고 하면서 물어보는 경우도 100% 사기입니다.
ADMIN 권한은 꼭 필요한 사람에게만 주세요.
ADMIN 권한이 있으면 토큰의 모든 것을 관리할 수 있습니다.
매니저 권한도 필요한 사람에게만 주고, 주기적으로 확인하세요.
큰 금액을 처리하기 전에 소량으로 먼저 시험해 보세요.
지갑 주소를 입력할 때 반드시 다시 한번 확인하세요.
주소가 한 글자라도 틀리면 토큰을 잃어버릴 수 있습니다.
마지막 남은 ADMIN의 권한을 빼지 않도록 조심하세요.
한번 빼면 다시는 권한을 관리할 수 없게 됩니다.
공용 컴퓨터에서는 사용하지 마세요.
반드시 본인만 사용하는 컴퓨터에서 관리 작업을 하세요.
사용 후에는 MetaMask에서 지갑 연결을 해제하세요.
MetaMask → 연결된 사이트 → 연결 해제를 권장합니다.

20. Ethereum 네트워크 정보

보통은 로그인 시 자동으로 설정되므로 아래 정보를 직접 입력할 필요는 없습니다.

메인넷 (실제 운영)

항목	내용
네트워크 이름	Ethereum Mainnet
체인 ID	1
수수료 화폐	ETH (이더)
용도	실제 운영 (진짜 돈이 오가는 네트워크)
ETH 구매 방법	업비트, 빗썸, 바이낸스 등 거래소에서 구매
블록 탐색기	etherscan.io

테스트넷 (테스트용)

항목	내용
네트워크 이름	Sepolia Testnet
체인 ID	11155111
수수료 화폐	Sepolia ETH (테스트용, 실제 가치 없음)
용도	테스트 및 개발 (실제 돈이 오가지 않는 네트워크)
블록 탐색기	sepolia.etherscan.io

블록 탐색기(Etherscan)란?

블록체인에서 일어난 모든 거래를 누구나 확인할 수 있는 사이트입니다. 토큰을 보냈는데 잘 갔는지 확인하고 싶을 때 사용합니다. 대시보드의 "Etherscan 바로가기" 섹션에서 바로 접속할 수 있습니다.

21. 메인넷 사용 시 중요 사항

이 시스템은 실제 운영 환경(메인넷)입니다!

모든 작업은 진짜입니다. "연습 모드"가 없습니다. 테스트가 필요하면 Sepolia 테스트넷에서 먼저 시험하세요.
한번 한 일은 되돌릴 수 없습니다. 보낸 토큰, 소각한 토큰 등은 블록체인에 영구 기록됩니다.
수수료(ETH)가 실제로 들어갑니다. 최소 0.01 ETH 이상을 지갑에 넣어두시면 여러 번 사용할 수 있습니다.
큰 금액을 다루기 전에 반드시 소량으로 시험하세요.

전체 기능 요약

기능	누가 할 수 있나요?	수수료	실행 방식
일시정지 / 정상화	ADMIN만	있음	Safe 멀티시그
역할 주기 / 빼기	ADMIN만	있음	Safe 멀티시그
블랙리스트 추가/해제	매니저만	있음	Safe 멀티시그
블랙리스트 조회	누구나	무료	직접 조회
잠금(락업) 설정/연장/줄이기/풀기	매니저만	있음	Safe 멀티시그
잠금(락업) 정보 조회	누구나	무료	직접 조회
토큰 보내기 (전송)	토큰을 가진 사람	있음	단일 서명 (직접)
한꺼번에 보내기 (일괄 전송)	토큰을 가진 사람	있음	단일 서명 (직접)
토큰 소각	토큰을 가진 사람 (자기 것만)	있음	단일 서명 (직접)
토큰 잔액 조회	누구나	무료	직접 조회

궁금한 점이 있으시면 개발팀에 문의해 주세요.

관리자 대시보드로 돌아가기