Document

PULSE에서 Document 관리는 토큰과 관련된 중요 문서의 무결성을 블록체인으로 보장하는 시스템입니다.
이 가이드에서는 Document 시스템의 특징과 문서 등록 방법을 안내합니다.

🤔 Document 관리란?

Document 관리는 토큰증권과 관련된 법적 문서, 공시 자료, 계약서 등의 해시값을 블록체인에 기록하여 투명성과 신뢰성을 확보하는 시스템입니다.

💡 쉬운 이해를 위한 비유

공증사무소에서 중요한 계약서를 공증받아 보관하는 것과 유사합니다. 원본 문서의 진위를 확인할 수 있는 공증서가 있는 것처럼, PULSE Document 시스템도 문서의 해시값을 블록체인에 저장하여 문서의 무결성을 보장합니다.

📋 Document 시스템의 핵심 기능

기능	설명	활용 사례
무결성 보장	문서 해시값을 블록체인에 기록하여 변조 방지	계약서, 공시문서 진위 확인
체계적 관리	토큰별로 관련 문서를 분류 관리	발행설명서, 정관, 감사보고서
투명한 공개	투자자들이 언제든지 관련 문서 해시 확인 가능	공시 의무 이행, 정보 제공

🛡️ 블록체인 기반 무결성

해시값 저장 방식

PULSE는 문서 원본이 아닌 해시값만 블록체인에 기록합니다:

📄 원본 문서 → 🔐 SHA-256 해시 계산 → ⛓️ 블록체인에 (문서명 + 해시) 기록

구분	설명
원본 파일	PULSE 서버로 전송·저장되지 않음 (사용자가 직접 보관)
해시값	브라우저에서 SHA-256 계산 후 온체인에 영구 기록
검증 과정	원본 → 해시 재계산 → 온체인 해시와 비교

🔍 문서 검증 프로세스

1️⃣ 원본 문서 확보 → 2️⃣ SHA-256 해시 계산 → 3️⃣ 온체인 해시와 비교 → 4️⃣ 일치 여부 확인

📚 문서 유형별 분류

필수 문서 (토큰증권 발행 시)(예시)

문서 유형	설명	법적 근거
발행설명서	토큰증권의 상세 내용 및 조건	자본시장법
정관/약관	발행사의 기본 규정	상법
감사보고서	재무상태 및 경영성과	외감법
사업보고서	사업 현황 및 전망	자본시장법

선택 문서 (필요 시 등록)

문서 유형	설명	활용 목적
계약서	주요 계약 관련 문서	투자자 정보 제공
공지사항	중요 공시 및 안내	투명한 정보 공개
기술문서	기술적 상세 내용	기술 투자 판단 자료

🚀 문서 등록하기

토큰과 관련된 중요 문서를 등록할 수 있습니다.

1️⃣ 문서 관리 메뉴 접근

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

2️⃣ 문서 파일 선택 및 등록

파일찾기 버튼으로 문서 파일을 선택하면 브라우저가 SHA-256 해시를 계산하고, 문서명과 해시를 온체인에 등록합니다.

📏 제약 사항

파일을 선택하면 파일명과 SHA-256 해시가 자동으로 채워집니다.

파일명은 32자를 초과할 수 없습니다.

파일이 업로드되지 않고 해시만 계산되므로 확장자·용량 제한은 없습니다.

💡 파일 네이밍 가이드라인

✅ 권장: 발행설명서_v2.0, 정관_2024, 감사보고서_2023
❌ 지양: document1, 파일, test

3️⃣ 등록 완료 및 문서 리스트 확인

등록이 완료되면, 등록된 문서가 하단 리스트에 추가됩니다.

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

📄 문서명: 등록된 문서 이름

🔐 해시값: 온체인에 기록된 문서 해시값 (무결성 검증용)

🔌 Document API

기능	메서드 · 경로
문서 목록 조회	`GET /main/v1/tokens/{tokenSymbol}/documents`
문서 단건 조회	`GET /main/v1/tokens/{tokenSymbol}/documents/{docName}`
문서 등록	`POST /main/v1/tokens/{tokenSymbol}/documents`
문서 삭제	`DELETE /main/v1/tokens/{tokenSymbol}/documents/{docName}`

요청·응답 필드(문서명, URI, docHash 등)와 상세 스펙은 API Reference → Token Document 를 참고하세요. 인증 방식은 API Key 가이드를 참고하세요.

📊 문서 관리 모범 사례

권장사항

✅ 명확한 파일명: 문서 내용을 쉽게 알 수 있는 이름 사용

✅ 버전 관리: 문서 수정 시 파일명에 버전 번호 포함

✅ 정기적 업데이트: 최신 정보를 반영한 문서로 주기적 갱신

주의사항

⚠️ 개인정보 포함 금지: 투자자 개인정보가 포함된 문서 등록 금지

⚠️ 중복 방지: 동일한 내용의 문서 중복 등록 방지

🚀 다음 단계

단계	설명
⚙️ Operator 관리	문서 접근 권한과 토큰 관리 권한 연계
📦 Partition 관리	파티션별 관련 문서 분류 관리
🔒 LOCKER 관리	토큰 동결 및 잠금 관리

🤔 Document 관리란?#

💡 쉬운 이해를 위한 비유#

📋 Document 시스템의 핵심 기능#

🛡️ 블록체인 기반 무결성#

해시값 저장 방식#

🔍 문서 검증 프로세스#

📚 문서 유형별 분류#

필수 문서 (토큰증권 발행 시)(예시)#

선택 문서 (필요 시 등록)#

🚀 문서 등록하기#

1️⃣ 문서 관리 메뉴 접근#

2️⃣ 문서 파일 선택 및 등록#

📏 제약 사항#

💡 파일 네이밍 가이드라인#

3️⃣ 등록 완료 및 문서 리스트 확인#

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

🔌 Document API#

📊 문서 관리 모범 사례#

권장사항#

주의사항#

🚀 다음 단계#