Operator

PULSE에서 Operator는 토큰을 관리할 수 있는 특별한 권한을 가진 주소입니다.
이 가이드에서는 Operator의 역할과 OP 주소 등록 방법을 안내합니다.

🤔 Operator란?

Operator는 토큰 발행사나 유통사가 토큰을 효율적으로 관리하기 위해 특별한 권한을 부여받은 주소입니다.

💡 쉬운 이해를 위한 비유

은행 계좌 소유자가 은행에게 특정 권한을 위임하는 것과 유사합니다. 계좌 소유자의 승인 하에 은행이 필요한 업무를 대신 처리할 수 있는 것처럼, Operator도 토큰 소유자를 대신해 다양한 토큰 관리 업무를 수행합니다.

🔧 Operator의 실제 권한

Operator 주소는 다음과 같은 제한된 권한들을 보유합니다:

권한	설명	사용 사례
토큰 전송	승인된 토큰 이체 처리	투자자간 거래, 배정 처리
SWAP 실행	ST/DT 토큰 간 교환 처리	거래 체결 및 결제
잔액 조회	토큰 보유 현황 및 상태 확인	투자자별 보유량 모니터링
전송 가능 여부 확인	토큰 이체 조건 검증	KYC, 파티션 상태 확인

👥 권한(Role) 체계

PULSE는 ERC-1400 표준 기반의 역할 기반 접근 제어(RBAC)로 역할을 명확히 분리합니다. 최상위 ADMIN_ROLE이 다른 모든 역할의 부여·회수를 관리합니다.

Role	담당자	주요 권한
ADMIN_ROLE ⭐	토큰 관리자	모든 역할의 부여·회수
ISSUER (발행자)	토큰 발행회사	토큰 발행/소각
Operator (운영자)	발행사/유통사	토큰 전송 및 Swap, 잔액 조회
Controller (컨트롤러)	계좌관리기관	강제 전송, 토큰 동결, 토큰 압류
LOCKER	발행사/유통사/SWAP 컨트랙트	토큰 Lock/Unlock, 거래 증거금 관리
KSD Operator	KSD(예탁결제원)	KSD 전용 오퍼레이터 작업
Swap Master	SWAP 컨트랙트	TokenSwap 운영

역할의 부여·회수는 최상위 ADMIN_ROLE을 통해서만 이뤄지며, PULSE가 관리합니다. 회원사는 권한 요청으로 신청합니다.

❓ 토큰 발행 후 자동으로 등록되는 OP 주소

SWAP 컨트랙트 자동 등록

토큰을 처음 발행(배포)하면 SWAP 컨트랙트 주소가 자동으로 등록됩니다.

🤔 왜 자동으로 등록될까요?

SWAP 거래 시 토큰 이동 권한이 필요하기 때문입니다:

상황	설명
거래 체결 시	SWAP 컨트랙트가 투자자들의 ST/DT 토큰을 직접 이동시켜야 함
즉시 실행	권한이 없으면 거래 체결이 불가능
안전한 거래	사전에 권한을 부여받아 안전하고 빠른 거래 처리

📋 자동 등록되는 주소 정보

SWAP 컨트랙트: Operator + LOCKER + Swap Master 세 역할에 등록

KYC Operator: Operator 역할에 등록

관리: PULSE 시스템에서 자동 관리

🚀 OP 주소 등록하기 (권한 요청 흐름)

회원사는 직접 온체인에 등록하지 않고 권한 요청을 생성합니다. 요청을 제출하면 PULSE가 검토·승인 후 온체인에 반영합니다.

1️⃣ 권한 요청 생성

좌측 메뉴 권한 요청 또는 토큰 상세 → 오퍼레이터 탭에서 등록할 0x EOA 주소를 입력해 요청합니다.

📝 입력 시 주의사항

✅ 올바른 형식: 0x로 시작하는 40자리 16진수 주소

✅ EOA 주소: 개인키로 제어 가능한 외부 소유 계정

주소 형식 예시:

0x742d35Cc6634C0532925a3b8d78dE30BEd85a7E0

2️⃣ 요청 처리 및 반영

요청은 권한 요청 화면에서 진행 상태(대기 → 완료)를 확인할 수 있습니다. PULSE의 검토·서명이 완료되면 온체인에 반영됩니다.

🔌 Operator API

단일 관리자(ADMIN)로 운영하는 토큰은 파트너 API로 직접 Operator를 등록/해제할 수 있습니다.

기능	메서드 · 경로
Operator 등록	`POST /main/v1/administration/operator`
Operator 해제	`DELETE /main/v1/administration/operator`
Operator 키 조회	`GET /main/v1/operator`

요청·응답 필드와 상세 스펙은 API Reference → Operator 를 참고하세요. 인증 방식은 API Key 가이드를 참고하세요.

🛡️ OP 주소 보안 관리

권장사항

✅ 안전한 키 관리: Operator 주소의 개인키를 안전하게 보관

✅ 권한 최소화: 필요한 권한만 부여하여 보안 리스크 최소화

✅ 정기적 검토: 등록된 OP 주소들을 주기적으로 점검

주의사항

⚠️ 개인키 분실 금지: Operator 권한을 잃을 수 있음

⚠️ 무분별한 권한 부여 금지: 보안상 위험할 수 있음

🚀 다음 단계

단계	설명
📦 파티션 관리	토큰 상태별 파티션 설정
📄 문서 관리	토큰 관련 공시문서 등록
🔒 LOCKER 관리	토큰 동결 및 잠금 관리

🤔 Operator란?#

💡 쉬운 이해를 위한 비유#

🔧 Operator의 실제 권한#

👥 권한(Role) 체계#

❓ 토큰 발행 후 자동으로 등록되는 OP 주소#

SWAP 컨트랙트 자동 등록#

🤔 왜 자동으로 등록될까요?#

📋 자동 등록되는 주소 정보#

🚀 OP 주소 등록하기 (권한 요청 흐름)#

1️⃣ 권한 요청 생성#

📝 입력 시 주의사항#

2️⃣ 요청 처리 및 반영#

🔌 Operator API#

🛡️ OP 주소 보안 관리#

권장사항#

주의사항#

🚀 다음 단계#