crypto-study-hyperithm

Yield Bearing Token Study

DeFi의 기반 인프라인 Yield Bearing Token에 대한 심층 분석 자료입니다.

📚 문서 구조

• src/ - mdbook 소스 파일
• slides.md - Marp 프레젠테이션
• staking.mmd / staking.svg - 스테이킹 수익 흐름도
• rebasing.mmd / rebasing.svg - 리베이싱 메커니즘 다이어그램

🛠️ 빌드 방법

Prerequisites

• Bun - JavaScript 런타임 및 패키지 매니저
• Chromium 브라우저 (Mermaid 다이어그램 렌더링용)

1. 의존성 설치

bun add @mermaid-js/mermaid-cli

2. Mermaid 다이어그램 렌더링

변경된 파일만 빌드 (권장):

./build-diagrams.sh

• 수정된 .mmd 파일만 감지하여 .svg로 변환
• 변경되지 않은 파일은 자동으로 스킵
• 빠른 빌드 시간

또는 개별 파일 빌드:

export PATH="$HOME/.bun/bin:$PATH"

# 스테이킹 다이어그램
PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser bunx mmdc -i staking.mmd -o staking.svg

# 리베이싱 다이어그램
PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser bunx mmdc -i rebasing.mmd -o rebasing.svg

3. 슬라이드 빌드

Marp CLI를 사용하여 Markdown을 HTML/PDF로 변환:

# HTML로 빌드
bunx @marp-team/marp-cli slides.md -o slides.html --watch

# PDF로 빌드
bunx @marp-team/marp-cli slides.md -o slides.pdf

# PPTX로 빌드
bunx @marp-team/marp-cli slides.md -o slides.pptx

4. mdbook 빌드 (문서)

# mdbook 설치 (처음 한 번)
bun add -g mdbook

# 문서 빌드
mdbook build

# 로컬 서버로 미리보기
mdbook serve

📁 파일 설명

slides.md

Marp 기반의 프레젠테이션 소스 파일입니다. 다음을 포함합니다:

• 섹션 인디케이터 (현재 섹션 표시)
• 스테이킹 수익 다이어그램 (SVG)
• 수익의 원천 상세 설명
• 핵심 DeFi 프로토콜 분석

staking.mmd / staking.svg

스테이킹 수익 흐름도를 나타내는 Mermaid 다이어그램:

• 보유자 → Lido → 검증자 → Ethereum 네트워크 → 수익 분배
• 색상으로 각 주체 구분

rebasing.mmd / rebasing.svg

리베이싱 토큰의 메커니즘을 보여주는 다이어그램:

• Day 0 vs Day 30 토큰 수량 변화
• 수익 발생 시 토큰 자동 증가

🎨 Marp 커스텀 스타일

slides.md 상단의 YAML frontmatter에서 스타일을 정의합니다:

style: |
  .section-indicator {
    position: absolute;
    top: 20px;
    right: 40px;
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    color: white;
    padding: 8px 20px;
    border-radius: 20px;
    font-size: 0.9em;
    font-weight: 600;
  }

📝 커밋 메시지 컨벤션

docs: 문서 내용 추가/수정
feat: 새로운 기능 추가
fix: 버그 수정
refactor: 코드 리팩토링
style: 스타일 변경

🔗 참고 자료

• Marp Documentation
• Mermaid.js
• mdbook Documentation
• Bun Documentation

📄 라이선스

이 프로젝트는 학습 목적으로 작성되었습니다.