byeol. 사용 가이드
User Guide

📖 퀀텀별 도구 사용 가이드

양자 시뮬레이터 콘솔, 양자통신(QKD) 실험실, estEL One, 그리고 API까지 — 처음 오신 연구자·학생을 위한 안내서입니다. 모든 도구는 무료이며 회원가입이 필요 없습니다.

1. 양자 시뮬레이터 콘솔 (/quantum)

경로(엔진) 4종 — 회로 특성에 맞게 선택하거나, estEL One(자동)에 맡기세요:

경로규모게이트언제
스테빌라이저n≤2,048H S X Y Z CX클리퍼드 회로·대규모 얽힘·GHZ
상태벡터(정확)n≤20+T TDG SDG CZ CCX PH(임의각)정밀 진폭·비클리퍼드 알고리즘
MPS 텐서망n≤1,024T 포함 · 2큐는 인접 CX/CZ/SWAP저얽힘 대형 + 정밀 게이트
estEL One(자동)전부회로를 분석해 위 셋 중 자동 선택

게이트 문법: 한 줄에 하나 — H 0 · CX 0 1 · T 2 · PH 0 45(0번 큐비트에 45° 위상) · CCX 0 1 2(토폴리).
시드: 모든 실행이 시드를 반환합니다 — 같은 시드를 넣으면 측정 결과까지 비트단위로 재현(논문·감사용).
상태 보기: 스테빌라이저 행(n≤32) 또는 큐비트별 P(1)·MPS 트렁케이션 오차를 측정 전에 보여줍니다.

2. 양자통신 실험실 (/qcomm · EN)

BB84(준비-측정) / BBM92(얽힘 기반) 키분배를 실엔진에서 끝까지 수행합니다 — 체질 → 오류추정 → 캐스케이드 오류정정 → 프라이버시 증폭 → 최종 비밀키.
· 즉석 테스트: N·도청자·잡음을 정해 실행 — QBER > 11%면 도청 판정(BB84 보안증명 임계).
· 실험 선언·공유: 조건을 고정해 이름 붙이면 공유 URL이 생기고, 동료·학생이 같은 조건으로 재현 테스트 — 실행 이력이 누적됩니다.
· 수업 활용 예: ① 도청 없이 QBER 0% 확인 ② Eve 투입 → 25% 관측 ③ 잡음 5%와 도청을 구분해보기 ④ 같은 시드로 재현해 결정론 확인.

3. estEL One (/estel)

티어를 고를 필요 없는 엔트리 제품 — 회로를 던지면 정밀 게이트·큐비트 수를 분석해 16Q(정확)/48Q/2000Q/MPS로 자동 전환하고, 어떤 엔진이 왜 선택됐는지 배지로 알려줍니다. 랜딩의 라이브 데모에서 바로 체험할 수 있습니다.

4. API 레퍼런스 (연구실 자동화용)

## 양자 회로 실행 (mode: stab | sv | mps | auto) curl -X POST https://byeol.crowny.org/api/quantum/run \ -d 'n=2&shots=50&mode=auto&seed=42' \ --data-urlencode 'gates=[["H",0],["CX",0,1]]' # → { tier, seed, counts:{"00":25,"11":25}, rows, runMs, ... } ## QKD 실행 (protocol: bb84 | bbm92) curl -X POST https://byeol.crowny.org/api/qcomm/run \ -d 'n=1024&eve=0&noise=5&protocol=bb84&seed=42' # → { result:{ qber, verdict, seed, pipeline:{ ecCorrected, finalLen, finalKeyHex } } } ## 실험 선언 → 공유 URL curl -X POST https://byeol.crowny.org/api/qcomm/declare \ --data-urlencode 'name=도청검출-N512' --data-urlencode 'author=홍길동' \ -d 'n=512&eve=1&noise=0&protocol=bb84' # → { id, share:"/qcomm?exp=<id>" }

레이트리밋: 회로 실행 12/분 · QKD 10/분 · 선언 6/시간 (IP당). 시드는 1~18자리 양의 정수 — 생략하면 서버가 생성해 응답에 동봉합니다.

5. 물리 배경 · 근거

스테빌라이저 형식론(Aaronson-Gottesman 태블로, crownyc VM opcode 914~917 네이티브) · 상태벡터 정확 시뮬(n≤20) · MPS 텐서망(야코비 SVD + 4상 트렁케이션, opcode 918~922). 실측 근거와 개발 과정은 /quantum 페이지에, QKD 물리 검증은 /qcomm에 전부 공개되어 있습니다. 질문·피드백은 방명록이나 별메신저로 — 한별QC에 바로 전달됩니다.