Crowny Today 체인 앵커링 (1단계: 순차적 PC 블록체인 노드화)

개요

사장님 로드맵 "순차적으로 PC에 블록체인서버화" 1단계로, Crowny Today(today.crowny.org, 맥 소스 /Users/ef/crowny-today/) 데이터를 크라우니체인에 앵커링(머클루트 기록)하고 맥을 체인 노드로 활용하도록 구현했다.

실태 판정: (a) 기존 크라우니코인 체인 재사용 (신규 노드 신설 안함)

근거: /Users/ef/crowny-chain/서버/크라우니코인.한선의 POST /api/mine(437~567행 부근)이 miner + data(임의 문자열 페이로드)를 받아 SHA256(height:prevHash:data:miner) 블록해시를 계산하고 WAL에 영속화한다. 즉 코인 전용 구조가 아니라 임의 데이터 페이로드 기록을 이미 지원한다. (참고: POST /api/tx는 mempool 큐잉만 하고 해시/txid를 즉시 돌려주지 않아 앵커 용도로는 /api/mine이 적합.)

이 맥이 이미 크라우니코인(:9729)·스테이킹(:9603) 서버를 구동 중이므로, 별도 today-chain 노드/포트 신설 없이도 "PC=블록체인 노드" 요건이 충족된다. 따라서 STEP2-4의 (b) 분기(신규 노드)는 불필요로 판정, 미구현.

구현 파일

/Users/ef/crowny-today/체인/앵커.한선 — data/*.psv 스냅샷 SHA256 해시 → 파일순서 무관 머클루트 계산 → POST http://127.0.0.1:9729/api/mine으로 체인 기록 → 로컬 앵커영수증.psv(txid|date|merkle) append. 자체시험 10건 내장(PASS 10/10).

/Users/ef/crowny-today/체인/앵커영수증.psv — 앵커 영수증 로그 (txid|date|merkle, append-only)

/Users/ef/crowny-today/체인/앵커.sh — 컴파일+실행+VPS 영수증 POST 래퍼. LaunchAgent 트리거용.

/Users/ef/crowny-today/서버.한선 — 기존 파일에 라우트 추가:

GET /api/chain/verify?date= — 당일 데이터 재해시 vs 저장된 영수증 merkle 대조 → {ok,date,anchored,match,txid,merkle} (3진: 1=true, -1=false)

POST /api/chain/receipt (헤더 X-Worker-Token, 기존 /api/ai/result 패턴 그대로 재사용) — 맥 워커가 앵커 완료 후 영수증을 (VPS 배포본) 서버에 전달

관련 헬퍼 함수: _체인대상파일들, _체인최소값인덱스, _체인제외복사, _체인배열복사, _체인머클루트, _체인현재머클루트, _체인영수증조회, _처리체인검증, _처리체인영수증저장

~/Library/LaunchAgents/org.crowny.today-anchor.plist — 매일 23:50 앵커.sh 실행(StartCalendarInterval, 상주 아님)

백업: /Users/ef/crowny-today/서버.toau.bak-체인추가전-20260718 (배포 전 toau 보존)

이식(라즈베리파이 등) 경로 분기

서버.한선의 기존 /opt/today/HOME.txt 존재 판정 패턴을 그대로 재사용:

• 앵커.한선/앵커.sh 모두 /opt/today/HOME.txt 유무로 /Users/ef/crowny-today/체인/* ↔ /opt/today/체인/* 경로 자동 전환.
• 향후 라즈베리파이 등 새 장비는 해당 경로에 HOME.txt만 두면 동일 코드로 이식 가능.

검증 증거 (실측)

1) 자체시험 (앵커.한선, 시험전용 모드)

=== 앵커.한선 자체시험 ===
  [PASS] SHA256 같은입력 같은해시
  [PASS] SHA256 다른입력 다른해시
  [PASS] 파일해시 재계산 동일
  [PASS] 파일내용 변경시 해시 변경 감지
  [PASS] 머클루트 파일순서 무관 동일값
  [PASS] 머클루트 내용변경시 값 변경
  [PASS] 페이로드에 type 필드 포함
  [PASS] 페이로드에 merkle 필드 포함
  [PASS] 블록해시 파서 정상추출
  [PASS] 없는 파일도 크래시없이 처리
=== 결과: PASS 10 / FAIL 0 ===

2) 실제 앵커 실행 (라이브 크라우니코인 :9729에 실제 기록)

앵커 결과: ok=1 txid=0397c74304ad2405900c5c4c4f592bfd4915a08fbf1fc264501b1b7b0cb0192e merkle=2df1ba2fed5c640936f4ebce4f05f892735cdf589adb004554e88f40a355a27b date=2026-07-18
응답원문: {"height":245,"hash":"0397c74304ad2405900c5c4c4f592bfd4915a08fbf1fc264501b1b7b0cb0192e","miner":"today-anchor","reward":27}

3) 데이터 1건 추가 후 재앵커 → 머클루트 변경 확인

할일.psv에 테스트 행 1개 추가 후 재계산:

merkle: 2df1ba2f... → db87f0e6fe4779da7165f394faf51a83edd49193008eaa522a280485bc6adbb7  (변경됨, 확인)

(테스트 행은 검증 후 원복)

4) /api/chain/verify 실측 응답

$ curl -s "http://localhost:9604/api/chain/verify?date=2026-07-18"
{"ok":true,"date":"2026-07-18","anchored":1,"match":1,"txid":"3b6c9ecaf91b6a725b26d00bba7265b961a70d15b6d4706dd4efdb164252fa6d","merkle":"2df1ba2fed5c640936f4ebce4f05f892735cdf589adb004554e88f40a355a27b"}

5) 변조 시뮬레이션 → match:false 검출

응원.psv에 임의 행 추가:

{"ok":true,"date":"2026-07-18","anchored":1,"match":-1,"txid":"...","merkle":"717837b8be1a6990c4ee2760e7f5c7e1df2cc75a16c54feadc8faeb027e2964b"}

(원복 후 재검증하면 match:1로 복귀 확인)

6) receipt API 인증 게이트

$ curl -s -X POST http://localhost:9604/api/chain/receipt -d '{...}'          # 토큰 없음
{"ok":false,"error":"워커 토큰 불일치"}
$ curl -s -X POST .../api/chain/receipt -H "X-Worker-Token: ct-worker-9604-a17f3c2e" -d '{...}'
{"ok":true}

7) 기존 서비스 회귀 확인 (GET 헬스체크만, 상태변경 없음)

:9729  {"status":"ok","server":"크라우니코인","port":9729}
:9603  {"ok":1,"status":"ok","server":"스테이킹","port":9603,"nodeId":"staking-4930","version":"1.1.0"}
:9604  {"ok":true,"service":"crowny-today","version":"1.0.0"}

8) 앵커.sh 전체 파이프라인 실행 (컴파일→실행→VPS 영수증 POST)

[2026-07-18 10:33:56] === 앵커 실행 시작 ===
[2026-07-18 10:33:56] 실행 출력: 앵커 결과: ok=1 txid=062d514a... merkle=2df1ba2f... date=2026-07-18
[2026-07-18 10:33:56] 영수증 POST 응답: {"ok":true}
[2026-07-18 10:33:56] === 앵커 실행 종료 (txid=062d514a...) ===

크라우니코드 학습

• lookup/search: 사전 조회 시 today-chain 앵커 관련 기존 패턴 없음 (MISS)
• learn add: 2건 등록 (today체인앵커_머클루트순서무관계산, today체인검증_verify_api)
• 크라우니코드: lookup HIT 0건 / MISS 2건 / learn 추가 2건

잔여 이슈

1. VPS_URL 로컬-동일 파일 중복기록: 맥에서 VPS_URL=http://127.0.0.1:9604(기본값)로 테스트하면 앵커.한선의 로컬 영수증 저장과 앵커.sh의 receipt POST가 같은 로컬 파일에 2번 append됨(중복 행). 실제 VPS 배포 시(별도 /opt/today/체인/앵커영수증.psv) 문제 없음 — 맥은 원본 1행, VPS는 릴레이 사본 1행으로 정상 분리. 로컬 단독 테스트 시에만 발생하는 정상 동작이며 별도 정리 불필요.
2. /api/mine 채굴 보상: 앵커 1회 = 실제 코인 채굴 1회(보상 27 CRN 발행)와 동일 부작용 발생. 코인 총공급량에 소폭 영향 있음 — 크라우니코인.한선의 기존 채굴 로직을 그대로 재사용한 결과이며 사양대로 동작함. 향후 "채굴 보상 없는 순수 앵커 전용 API"가 필요하면 크라우니코인.한선에 무보상 /api/anchor 라우트 추가 검토.
3. VPS 실배포 미검증: 배포.conf의 실제 VPS(root@1.234.20.240)에는 이번 세션에서 SSH 접속·배포를 하지 않았음(요청 범위가 로컬 재현 검증까지). VPS에 새 서버.toau/앵커.한선을 반영하려면 기존 배포.sh 절차를 따라야 함.
4. LaunchAgent 스케줄 최초 실행 미관측: org.crowny.today-anchor는 매일 23:50 실행이라 이번 세션에선 자동 트리거를 직접 관측하지 못함(수동 실행으로 파이프라인은 검증 완료).

메인세션 수리·최종확증 (2026-07-18)

• 에이전트 구현 후 라이브 3결함 수리: ①앵커.sh VPS_URL이 정지된 맥 로컬 기본값→https://today.crowny.org ②앵커가 맥 구데이터 해시→앵커 전 VPS data rsync 스냅샷(미러=백업 겸용) ③VPS /opt/today/체인 디렉토리 부재로 영수증 append 조용한 실패→mkdir
• 자기무효화 수리: 머클 대상에서 세션.psv 제외(로그인마다 변동), 누락됐던 프로젝트/프로젝트항목/프로필 추가(서버·앵커 양쪽 동일 유지 필수)
• 배포.sh 가드 재수리: grep substring이 today-worker/anchor에 오매칭→awk 정확 매칭(맥 서버 되살림 차단)
• 최종 실측: txid=2e6bef85… 앵커→영수증 ok→verify anchored:1 match:1, 신규 로그인 후에도 match:1 유지