Big 25에서의 COBOL

Source: Dev.to

💀 영감: 부동소수점 유령

Web3와 현대 SaaS 세계에서는 오래된 신들을 잊어버렸습니다. 우리는 JavaScript와 Python으로 금융 시스템을 구축하는데, 이 언어들은 IEEE 754 부동소수점 연산에 의존합니다. 표준 현대 환경에서는 이진 근사 오차 때문에 단순한 덧셈이 끔찍한 결과를 낳을 수 있습니다:

0.1 + 0.2 = 0.30000000000000004

$10,000,000 규모의 급여 계산에서는 이러한 “마이크로‑페니”가 누적됩니다. 전통적인 은행 세계에서는 이것이 감사 실패로 이어지고, 거래가 불변인 암호화폐 세계에서는 되돌릴 수 없는 재정 손실로 이어집니다.

우리는 스스로에게 물었습니다: “미래를 구하기 위해 죽은 것을 다시 살린다면 어떨까?”

⚡ 이것이 무엇인가

DarkLedger (이전 명칭 Ledger‑De‑Main)는 가장 오래되고 신뢰할 수 있는 금융 엔진(COBOL)과 최신, 가장 빠른 정산 레이어(Base L2)를 연결하는 “프랑켄슈타인” 아키텍처입니다.

• 핵심 급여 로직은 컴파일된 COBOL 바이너리에서 실행됩니다—전 세계 ATM 사용의 95 %를 구동하는 동일한 기술로, 100 % 십진 정밀도를 보장합니다.
• Python “신경계”가 블록체인에서 지급을 실행합니다.

🏗 구축 방법 (아키텍처)

두뇌: COBOL (레거시 코어)

우리는 Vibe Coding을 사용해 GnuCOBOL 프로그램을 생성했습니다. 이 구성 요소는 고정소수점 연산을 사용해 총액‑순액 로직을 처리합니다.

통화 값 (V)를 정수 (I)와 스케일 (10^2)로 저장하면:

[ V = \frac{I}{10^{2}} ]

이는 정확한 세금 계산을 보장합니다, 예를 들어:

[ \text{Net Pay} = (\text{Hours} \times \text{Rate}) - \lfloor \text{Gross} \times 0.15 \rfloor - \lfloor \text{Gross} \times 0.05 \rfloor ]

연결 고리: Python & Agent Hooks

가장 큰 도전은 고정폭 텍스트 파일을 기대하는 레거시 바이너리와 현대 JSON 기반 프론트엔드를 연결하는 것이었습니다. 우리는 Kiro Agent Hooks를 사용해 스티칭 과정을 자동화했습니다.

Hook 동작:
payroll.cbl이 저장될 때마다 Kiro는 DATA DIVISION을 파싱하고 바이트 위치(PIC X(10) 등)를 추출해 Python struct 파서를 자동 생성합니다.

인터페이스 명세

손: Base 위 정산

“두뇌”가 수학을 검증하면 “몸”(Python)이 Coinbase CDP SDK를 사용해 순액을 Base L2 네트워크의 USDC 거래로 변환합니다.

🧟‍♂️ 도전 과제 및 교훈

도전 1: 언어 장벽

COBOL은 JSON을 말하지 못하고 바이트만 말한다.

교훈: 현대의 사용 편의성 때문에 데이터 타입에 대해 게을러질 수 있습니다. 우리는 design.md에 정의된 엄격한 바이트‑레벨 계약을 만들어 Python이 메인프레임에 잘못된 데이터를 보내지 않도록 했습니다.

도전 2: 괴물 컨테이너화

클라우드에서 COBOL을 실행하는 것은 표준이 아닙니다.

교훈: 우리는 “시간 기계” 역할을 하는 맞춤형 Docker 컨테이너를 만들었습니다: 가벼운 Linux OS를 설치하고, GnuCOBOL 컴파일러 의존성을 가져와 빌드 시 레거시 코드를 컴파일한 뒤 FastAPI 서버를 띄워 요청을 청취합니다.

도전 3: “감사‑보증”

“대충 맞다”는 급여 계산에선 충분하지 않습니다. COBOL에서 Banker’s Rounding(COMPUTE ROUNDED)을 적용함으로써 표준 JavaScript 라이브러리가 무거운 의존성 없이 복제하기 어려운 정밀도를 달성했습니다.

🚀 사용법

컨테이너 실행

docker build -t ledger-de-main .

급여 실행

Retro‑Terminal UI로 이동해 배치 명령을 실행합니다:

RUN PAYROLL --BATCH 2025-10-31

시스템은 다음을 수행합니다:

1. 고정폭 input.dat 생성.
2. cobol/bin/payroll을 실행하는 서브프로세스 시작.
3. output.rpt 읽기.
4. Base에서 가스 없는 USDC 전송 실행.

📜 Kiro 구현 세부 사항

• 사양: requirements.md가 23‑바이트 입력 제약을 정의합니다.
• 제어: .kiro/steering/tech.md에 있는 “신성한 타임라인” 규칙은 COBOL 로직을 Python으로 리팩터링하는 것을 금지합니다.
• Hooks: 자동 바이너리 컴파일 및 Python 모델 업데이트.

💚 (그리고 🧟‍♂️)와 함께 Kiroween 2025를 위해 제작되었습니다.