rusty-cryptix 딥다이브
— Rust로 다시 건조한 BlockDAG 암호화폐 풀노드

1프로젝트 한줄 요약

이 레포가 무엇을 하는 물건인가.

"암호화폐 하나"는 사실 소프트웨어 한 덩어리다. 수천 대의 컴퓨터가 똑같은 프로그램을 돌리면서 "누가 얼마를 가졌나"라는 장부 하나에 합의하는 것 — 그 프로그램이 풀노드이고, rusty-cryptix는 Cryptix 네트워크용 풀노드의 레퍼런스 구현(reference implementation, 기준이 되는 공식 구현)이다. 기존 Cryptix는 Go로 짠 레거시 노드(cryptixd, Golang)를 썼는데, 이 저장소는 그것을 메모리 안전성과 성능이 강한 Rust로 통째로 대체하는 것을 목표로 한다.

토대가 중요하다. rusty-cryptix는 rusty-kaspa(Kaspa 코인의 Rust 노드)에서 포크(fork, 코드를 복제해 갈라져 나옴)되어, Kaspa의 핵심 자료구조인 BlockDAG와 GhostDAG 합의를 그대로 물려받았다. 그 위에 Cryptix만의 독자 기능 네 가지 — 매트릭스 기반 PoW 해시, 합의층에 박은 온체인 토큰/DEX(코드명 Atomic), 서명된 사기방지 밴리스트(AntiFraud), 고속 마이크로블록 릴레이(HFA) — 를 얹었다.

2왜 주목받는가

트렌딩 이유 · 경쟁 대비 장점.

이 저장소가 TrendShift 라이브 멘션에 뜬 직접적 계기는 v0.17.1 "Atomic Hardfork" 릴리스다. 합의층에 토큰과 탈중앙 거래소(DEX)를 직접 박아 넣는 큰 변경이 X(트위터)에서 회자되며 노출됐다. 정직하게 짚자면 이 레포는 GitHub 별은 아직 적은(★3) 작은 프로젝트이고, 아키텍처의 큰 뼈대는 Kaspa(rusty-kaspa)에서 물려받았다. 그럼에도 학습 대상으로는 가치가 크다 — 실제로 돌아가는 BlockDAG 노드의 전체 구조를 Rust로 한 채 통째로 읽을 수 있기 때문이다.

기술적으로 눈여겨볼 차별점은 네 가지다. ① Rust 전면 재작성(Go 레거시 → 메모리 안전 + 동시성), ② BlockDAG + GhostDAG(단일 체인의 처리량 한계 돌파), ③ 자체 매트릭스 heavy-hash PoW(전용 채굴기 ASIC에 저항), ④ 합의층 내장 토큰/AMM DEX(별도 스마트컨트랙트 없이 노드가 직접 토큰·유동성풀을 처리).

3기술 스택 전체 지도

언어·합의·저장·통신·암호 한눈에.

순수 시스템 소프트웨어라 '프론트엔드/백엔드'보다 레이어별 역할로 보는 게 맞다. 전부 Rust 한 언어로 짜여 있고(98%), 외부 의존성은 블록체인 노드의 정석 조합이다.

4아키텍처 심화 분석

블록 하나가 들어오면 어디서 어디로 흐르는가.

먼저 독수리 시점으로 전체 그림을 보자. 중심에는 노드 데몬 cryptixd가 있고, 그 주위를 네 덩어리가 둘러싼다 — P2P(바깥 노드와 대화), 합의 파이프라인(블록을 단계별로 검증), 저장소(RocksDB), RPC(지갑·채굴기 같은 클라이언트 창구). 인덱스(UTXO·Atomic)와 멤풀·채굴이 그 사이에 끼어 돈다.

이제 대표 흐름 한 줄기를 입구부터 출구까지 따라가 보자 — 코드의 5%가 일의 95%를 한다. 가장 흔한 사건은 "새 블록이 도착했다"이다.

핵심은 ②와 ④다. ②에서 이 블록이 규칙대로 만들어졌나(작업증명을 진짜 했나, 난이도가 맞나, 그래프상 위치가 정당한가)를 따지고, ④에서 방금 추가된 블록까지 포함해 전체 순서를 다시 정한다. 엣지 케이스(가지치기 증명·재동기화·고아 처리)는 여기선 생략 — 그 5%는 pruning_proof·sync 쪽에 따로 있다.

이 프로젝트 특유의 관례 하나: 합의 모듈은 "매니저 + 스토어" 모양을 반복한다. 예를 들어 GhostDAG 로직은 데이터 저장을 직접 하지 않고, 제네릭(generic, 어떤 저장소든 끼울 수 있게 타입을 비워둔 설계) 인자로 받는다.

// consensus/src/processes/ghostdag/protocol.rs — 저장소를 타입 인자로 받는 매니저
GhostdagManager<T: GhostdagStoreReader,
                S: RelationsStoreReader,
                U: ReachabilityService,
                V: HeaderStoreReader> { genesis_hash, k, ... }
// k = '몇 단계 떨어진 블록까지 한 묶음으로 볼까'의 기준값 (레거시 기본 18, 지금은 BPS에 따라 동적)

덕분에 같은 합의 코드를 실제 RocksDB로도, 테스트용 메모리 저장소로도, 시뮬레이터(simpa)로도 똑같이 돌릴 수 있다. "로직과 저장을 분리한다"는 게 이 코드베이스를 읽는 첫 열쇠다.

5디렉토리 구조 해부

62개 크레이트, 어디부터 봐야 하나.

크레이트(crate, Rust의 패키지 단위)가 62개라 처음엔 압도적이지만, 역할별로 묶으면 10덩어리다. ★ 표시한 곳이 핵심이고, 나머지는 그 핵심을 받쳐주는 부품이라 보면 된다.

6학습 포인트 (기술별)

이 레포에서 배울 만한 것 + 어느 파일을 펴면 되는지.

예컨대 노드를 띄우고 합의 단계 로그만 자세히 보고 싶다면, 로그 레벨을 서브시스템별로 켤 수 있다:

# consensus 모듈만 trace로 — 블록 처리 파이프라인이 줄줄이 찍힌다
cargo run --bin cryptixd -- --loglevel info,consensus=trace,cryptix_core=trace

7시스템 요구사항

빌드하고 돌리려면 무엇이 필요한가.

순수 소프트웨어지만, RocksDB와 WASM용 secp256k1을 컴파일하느라 C/C++ 툴체인(clang/LLVM)이 필요한 게 함정이다. 빌드 전 아래를 갖춰야 한다.

8직접 해볼 수 있는 실습 과제

읽기만 하지 말고 손에 익히는 단계.

git clone https://github.com/cryptix-network/rusty-cryptix && cd rusty-cryptix
cargo run --release --bin cryptixd -- --testnet --utxoindex

cd cli
cargo run --release   # Rusty Cryptix Wallet 터미널 인터페이스

# 1000블록, 전파지연 2초, 초당 8블록, 블록당 거래 최대 200개
cargo run --release --bin simpa -- -t=200 -d=2 -b=8 -n=1000

9관련 기술 심화 학습 로드맵

한 주씩 따라가는 6주 계획.

10핵심 키워드 사전

본문에 나온 용어 빠른 참조.

11참고 링크

• GitHub 저장소: cryptix-network/rusty-cryptix
• 릴리스(v0.17.1 Atomic Hardfork 등): /releases
• 레거시 Go 노드: cryptix-network/cryptixd
• 뿌리가 된 코드베이스(Kaspa): kaspanet/rusty-kaspa
• BlockDAG 합의 논문: PHANTOM / GHOSTDAG (eprint 2018/104)
• WASM/RPC 프레임워크: workflow-rs · 직렬화 Borsh