Partition

PULSE에서 Partition(파티션) 은 토큰을 상태별로 분리 관리할 수 있는 핵심 기능입니다.
이 가이드에서는 Partition의 개념과 등록/수정 방법을 안내합니다.

🤔 Partition이란?

Partition은 같은 토큰이지만 서로 다른 조건과 규칙을 적용할 수 있도록 토큰을 구역별로 분리하는 시스템입니다.

💡 쉬운 이해를 위한 비유

아파트 단지를 구역별로 나누어 관리하는 것과 유사합니다. 같은 아파트 단지지만 A동, B동, C동으로 나누어 각각 다른 관리 규칙을 적용할 수 있는 것처럼, Partition도 토큰을 용도별로 분리하여 각기 다른 규제나 조건을 적용할 수 있습니다.

📋 Partition의 주요 기능

Partition 시스템을 통해 다음과 같은 토큰 상태 관리가 가능합니다:

기능	설명	활용 사례
상태별 분리	토큰의 생애주기에 따른 구분 관리	초기 → 유통 → 사고 파티션
조건별 관리	파티션별 서로 다른 거래 조건 적용	VIP 투자자용, 기관 투자자용
리스크 격리	문제 발생 시 해당 파티션만 격리	분쟁 토큰, 동결 계좌 분리
기간별 제한	파티션별 유효 기간(락업) 설정	락업 기간, 상장 준비 기간

🔄 표준 파티션 생애주기

PULSE는 토큰증권의 표준적인 생애주기에 맞춰 파티션 구조를 제공합니다:

1️⃣ 초기 파티션

🏭 발행사 → 📤 투자자 배정

용도: 토큰 최초 발행 및 투자자 배정

특징: 발행사에서 각 투자자에게 배정 작업 수행

제한: 아직 거래소 거래 불가

2️⃣ 유통 파티션

📈 거래소 상장 → 🔄 자유 거래

용도: 거래소에서 자유로운 매매 가능

특징: 투자자 간 자유로운 거래 허용

조건: 상장 승인 후 초기 → 유통 파티션 이동

3️⃣ 사고 파티션

⚠️ 문제 발생 → 🔒 격리 보관

용도: 분쟁, 사고 계좌 등 예외 상황 관리

특징: 문제 해결 시까지 거래 중단

관리: 계좌관리기관 및 규제기관 권한

📅 기본 파티션 정보

토큰 배포 시 기본 파티션들이 자동으로 생성됩니다. ST와 DT의 구성이 다릅니다.

ST (Security Token) — 3개

파티션명	유효기간	용도	수정 가능
초기	영구	토큰 발행 및 배정	❌
유통	영구	거래소 거래	❌
사고	영구	예외 상황 관리	❌

DT (Deposit Token) — 2개

파티션명	유효기간	용도	수정 가능
유통	영구	결제·거래	❌
사고	영구	예외 상황 관리	❌

💡 알림: 기본 파티션들은 PULSE 시스템 운영을 위해 필수로 유지됩니다. (파티션 삭제 기능은 제공되지 않습니다.)

🚀 추가 파티션 등록하기

비즈니스 요구사항에 따라 사용자 정의 파티션을 추가로 생성할 수 있습니다.

1️⃣ 파티션 관리 메뉴 접근

발행이 완료된 토큰을 선택한 후, 상단 메뉴에서 파티션 탭을 클릭합니다.

2️⃣ 파티션 정보 입력 및 등록

파티션명과 종료일(락업 만료일) 을 입력한 후 등록 버튼을 클릭합니다.

📝 입력 항목 설명

파티션명: 구분하기 쉬운 고유한 이름 (예: VIP투자자, 기관전용)

종료일: 파티션 락업 유효 종료 날짜

💡 파티션 네이밍 가이드라인

✅ 권장: VIP투자자, 기관전용, 락업30일, 상장준비
❌ 지양: test, temp, 123, 파티션1

3️⃣ 파티션 리스트 확인

등록이 완료되면 전체 파티션 목록에서 새로 추가된 파티션을 확인할 수 있습니다.

📋 리스트에서 확인 가능한 정보

파티션명: 등록된 파티션 이름

유효기간: 종료일(락업 만료일)

관리: 수정 버튼 (사용자 정의 파티션만)

✏️ 파티션 정보 수정하기

사용자가 생성한 사용자 정의 파티션의 종료일을 수정할 수 있습니다.

⚠️ 주의: 기본 파티션(초기, 유통, 사고)은 수정 대상이 아니며, 새로 추가한 사용자 정의 파티션만 수정합니다.

🔧 수정 가능한 항목

✅ 종료일: 파티션 락업 유효 종료 날짜 변경 가능

❌ 파티션명: 생성 후 변경 불가

❌ 시작일: 생성 후 변경 불가

💡 수정 시 고려사항

종료일을 과거 날짜로 설정하면 파티션 락업이 즉시 만료됩니다

이미 해당 파티션에 토큰이 할당된 경우 신중하게 수정하세요

🔄 파티션 간 토큰 이동

Operator 권한을 통해 파티션 간 토큰 이동이 가능합니다:

이동 프로세스

📦 초기 파티션 → 📈 유통 파티션 (상장 시)
📈 유통 파티션 → ⚠️ 사고 파티션 (문제 발생 시)
⚠️ 사고 파티션 → 📈 유통 파티션 (문제 해결 시)

🔌 Partition API

기능	메서드 · 경로
파티션 목록 조회	`GET /main/v1/tokens/{tokenSymbol}/partitions`
파티션 생성	`POST /main/v1/tokens/{tokenSymbol}/partitions`
파티션 수정	`PUT /main/v1/tokens/{tokenSymbol}/partitions`
파티션 총 공급량 조회	`GET /main/v1/tokens/{tokenSymbol}/partitions/{partition}/supply`

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

🛡️ 파티션 관리 모범 사례

권장사항

✅ 명확한 네이밍: 파티션 용도를 명확히 알 수 있는 이름 사용

✅ 적절한 기간 설정: 비즈니스 일정에 맞는 유효기간 설정

✅ 정기적 검토: 파티션 사용 현황을 주기적으로 점검

주의사항

⚠️ 무분별한 생성 금지: 너무 많은 파티션은 관리 복잡성 증가

⚠️ 토큰 할당 후 수정 주의: 이미 토큰이 할당된 파티션 수정 시 신중 판단

🚀 다음 단계

단계	설명
⚙️ Operator 관리	파티션별 토큰 관리 권한 설정
📄 문서 관리	파티션별 관련 문서 등록
🔒 LOCKER 관리	파티션별 토큰 동결 관리

🤔 Partition이란?#

💡 쉬운 이해를 위한 비유#

📋 Partition의 주요 기능#

🔄 표준 파티션 생애주기#

1️⃣ 초기 파티션#

2️⃣ 유통 파티션#

3️⃣ 사고 파티션#

📅 기본 파티션 정보#

🚀 추가 파티션 등록하기#

1️⃣ 파티션 관리 메뉴 접근#

2️⃣ 파티션 정보 입력 및 등록#

📝 입력 항목 설명#

💡 파티션 네이밍 가이드라인#

3️⃣ 파티션 리스트 확인#

📋 리스트에서 확인 가능한 정보#

✏️ 파티션 정보 수정하기#

🔧 수정 가능한 항목#

💡 수정 시 고려사항#

🔄 파티션 간 토큰 이동#

이동 프로세스#

🔌 Partition API#

🛡️ 파티션 관리 모범 사례#

권장사항#

주의사항#

🚀 다음 단계#