로컬 개발 경로 세 가지를 진입 장벽이 낮은 순서로 정리했습니다. 어느 경로든 bitcoin-cli나 아무 JSON-RPC 클라이언트로 호출할 수 있는 TensorCash JSON-RPC가 준비됩니다. 아래 모든 내용의 기준이 되는 실행 가능한 명세는 bcore 기능 테스트 스위트이며, 각 워크스루는 그 바탕이 된 테스트로 연결됩니다.
Core 단독 · docker compose · 기능 테스트
검증 모드
TensorCash는 블록 수락 과정에 외부 검증 단계를 추가합니다. -validationapi는 이 단계를 처리할 백엔드를 선택하며, 로컬 실행에서 가장 중요한 선택입니다. GPU가 필요한지, 검증자 프로세스가 필요한지, 둘 다 필요 없는지가 이 값으로 정해집니다.
플래그
설명
사용 시점
-validationapi=real
기본값입니다. 노드-검증자 간 ZMQ PUSH/PULL 채널을 통해 FlatBuffers로 외부 검증자와 통신합니다. 프로덕션 설정입니다.
실제 검증자 프로세스가 필요합니다. 메인넷, 테스트넷, 그리고 실제 모델 재실행을 검증하는 모든 regtest 실행에서 사용합니다.
-validationapi=mock
프로세스 내에서 결정론적으로 동작합니다. 모의 백엔드는 미리 정해 둔 Quick, Full, Model 응답을 위한 RPC 세 개(validationmockdefault, validationmockclear, validationmockrequests)를 제공하며, -mockval-default-* 시작 플래그를 쓰면 모든 검증 결과를 스크립트로 지정할 수 있습니다.
기능 테스트 스위트의 기본값입니다. 검증자나 실제 추론 없이 체인 로직을 구동할 때 알맞은 선택입니다.
-validationapi=desktop
하이브리드입니다. Quick 검사는 프로세스 내에서 실행되고, Full과 Model은 로컬 HTTPS 검증자(기본 데스크톱 바이너리)로 전송됩니다. ZMQ 브로커가 필요 없습니다.
별도의 검증자 서비스를 운영하지 않고 실제 Quick 및 Smell 검사를 거치고 싶은 단일 머신 데모.
체인 로직을 처음 살펴본다면 mock을 쓰면 됩니다. 이 페이지의 나머지 부분은 따로 언급하지 않는 한 모의 모드를 가정합니다.
경로 A · 모의 검증을 사용하는 Core 단독
가장 간단한 방법입니다. C++ 데몬 하나면 되며, docker도 GPU도 디스크의 모델 파일도 필요 없습니다. 이 페이지의 모든 워크스루를 따라 하기에 충분합니다.
1. 데몬 빌드
services/core-node/bcore/에서 Bitcoin Core 빌드 안내를 따르세요. TensorCash 코드는 업스트림과 같은 CMake 타깃으로 빌드되며, 별도 플래그는 없습니다.
2. regtest 노드 시작
이 플래그들은 test_framework/test_tensorcash.py가 모든 기능 테스트에 넘기는 값과 같으므로, 거기서 실행되는 것은 여기서도 실행됩니다. 기본 모의 응답이 green으로 고정되어 있어 블록 수락 결과가 결정론적입니다.
데몬을 빌드하고 나면(경로 A, 1단계) 테스트 러너가 일회용 노드를 대신 띄워 줍니다. 직접 만져 볼 데몬보다, 그대로 가져다 쓸 수 있는 검증된 실행 순서가 필요할 때 유용합니다.
cd services/core-node/bcore
# Single test
build/test/functional/test_runner.py feature_model_registration.py
# All TensorCash-specific tests
build/test/functional/test_runner.py 'feature_model_*' 'feature_asset*' 'feature_fairsign_*'
# All tests, parallelised
build/test/functional/test_runner.py --jobs=$(nproc)
TensorCash 테스트는 인터페이스별로 묶여 있습니다: 모델 라이프사이클, 네이티브 자산, fair-sign 어댑터, 코버넌트 레포 지갑. 각각은 처음부터 끝까지 읽을 수 있는 독립된 시나리오이며, 아래 워크스루는 가장 대표적인 테스트를 가리킵니다.
워크스루
경로 A의 모의 노드를 대상으로 한 짧은 시퀀스 세 가지입니다. 각각은 개요이며, 링크된 기능 테스트가 완전하고 실행 가능한 시나리오입니다.
TensorCash 전용 기능입니다. 모델은 예치금을 에스크로에 넣고, N번의 커밋에 걸쳐 Quick 및 Model 검증 성공을 모은 뒤, 검증 기간이 끝나면 registered 상태로 전환되는 방식으로 등록됩니다. -validationapi=mock을 쓰면 실제 검증자나 GPU 없이 모든 단계를 RPC로 진행할 수 있습니다. 여기서는 개요만 다루며, 전체 시나리오는 링크된 테스트에 있습니다.
TensorCash 전용 기능입니다. registerasset은 예치금(bond) 출력과 ICU 출력을 만들고, 발행자 등록 TLV를 첨부해 브로드캐스트하는 상위 수준 지갑 RPC입니다. 한 번 컨펌되면 ID나 티커로 자산을 조회할 수 있습니다. 전체 라이프사이클(민팅, 전송, 소각)은 링크된 테스트에 있습니다.