Codemod 통한 Anchor IDL 마이그레이션 공수 95% 자동화 및 시간 90% 단축

Context

Anchor v0.30의 IDL 스펙 전면 재설계로 인한 기존 v0 기반 프로그램들의 호환성 결여 발생. 수동 마이그레이션 시 발생하는 높은 오류 가능성과 막대한 공수로 인해 개발팀의 최신 버전 업데이트가 지연되는 병목 현상 초래.

Technical Solution

• Deterministic Transformation 설계를 통한 9가지 핵심 필드 변환 로직 구현
• jssg 런타임 기반의 AST 분석을 활용해 JSON 구조를 v1 포맷으로 정밀하게 재구성
• codemod:ast-grep 기반의 파일 선택과 'isMut' 문자열 검색을 통한 사전 필터링으로 모노레포 내 처리 속도 최적화
• SHA-256 기반의 Discriminator 생성을 위한 Anchor 툴체인 의존성을 분리하여 프레임워크 독립적인 Node.js 라이브러리로 설계
• Idempotency 보장 구조를 통해 중복 실행 시에도 데이터 무결성을 유지하는 No-op 메커니즘 적용

Impact

• 전체 마이그레이션 공정의 약 95%를 자동화하여 수동 개입 최소화
• IDL당 마이그레이션 소요 시간을 기존 2~4시간에서 약 15분으로 대폭 단축
• Marinade Finance 실제 프로그램 검증 결과, 47개 계정 필드 및 16개 명령어의 오탐 없는 성공적 변환 달성