Ba hướng phát triển cục bộ, sắp xếp theo mức độ phức tạp. Hướng nào cũng cho bạn một JSON-RPC TensorCash để gọi bằng bitcoin-cli hoặc bất kỳ client JSON-RPC nào. Mọi nội dung bên dưới đều lấy bộ kiểm thử chức năng của bcore làm đặc tả chuẩn, có thể thực thi, và mỗi hướng dẫn đều liên kết tới test làm cơ sở cho nó.
Chỉ Core · docker compose · kiểm thử chức năng
Chế độ kiểm chứng
TensorCash thêm một bước kiểm chứng bên ngoài vào quá trình chấp nhận khối. -validationapi chọn backend phục vụ bước này, và đó là lựa chọn quan trọng nhất khi chạy cục bộ: nó quyết định bạn cần GPU, cần tiến trình verifier, hay không cần gì cả.
Cờ
Là gì
Khi nào dùng
-validationapi=real
Mặc định. Giao tiếp với một verifier bên ngoài qua kênh ZMQ PUSH/PULL từ node tới verifier, dùng FlatBuffers. Đây là thiết lập production.
Cần một tiến trình verifier thật. Dùng trên mainnet, testnet và mọi lần chạy regtest có replay mô hình thật.
-validationapi=mock
Chạy trong tiến trình và tất định. Backend giả lập cung cấp ba RPC (validationmockdefault, validationmockclear, validationmockrequests) cho các phản hồi Quick, Full và Model dựng sẵn; với các cờ khởi động -mockval-default-*, mọi kết quả kiểm chứng đều có thể lập trình trước.
Mặc định của bộ kiểm thử chức năng. Lựa chọn phù hợp để vận hành logic chuỗi mà không cần verifier hay suy luận thật.
-validationapi=desktop
Kết hợp. Kiểm tra Quick chạy ngay trong tiến trình; Full và Model được gửi tới một verifier HTTPS cục bộ (binary desktop mặc định). Không cần ZMQ broker.
Bản demo trên một máy muốn có lượt kiểm tra Quick và Smell thật mà không phải vận hành một dịch vụ verifier riêng.
Để làm quen với logic chuỗi, mock là lựa chọn đúng. Phần còn lại của trang này mặc định dùng nó, trừ khi có ghi chú khác.
Hướng A · chỉ Core, với xác thực giả lập
Ít trở ngại nhất. Một daemon C++ duy nhất: không docker, không GPU, không tệp mô hình trên đĩa. Đủ cho mọi hướng dẫn trên trang này.
1. Build daemon
Làm theo hướng dẫn build của Bitcoin Core với thư mục services/core-node/bcore/. Mã TensorCash build dưới cùng target CMake với upstream; không có cờ riêng.
2. Khởi động một node regtest
Các cờ này giống hệt những gì test_framework/test_tensorcash.py truyền cho mọi functional test, nên thứ gì chạy được ở đó cũng chạy được ở đây. Phản hồi giả lập mặc định được cố định ở kết quả xanh, nên việc chấp nhận khối là tất định.
Xác thực dùng tệp cookie tại $HOME/.tensorcash-regtest/regtest/.cookie, được bitcoin-cli tự động đọc khi bạn truyền -datadir. Cổng RPC là cổng regtest mặc định của upstream, 18443.
Khi xác thực giả lập là chưa đủ: một tiến trình verifier thật, một mô hình thật phục vụ suy luận, và miner API được kết nối sẵn. Thư mục gốc của repository có script khởi chạy cho Mac và cho Linux có CUDA.
Trên Apple silicon, trình khởi chạy tải một bản build llama.cpp và dựng toàn bộ stack compose core-node + miner-api + verification-api:
Tệp compose bind các cổng host 8333 (P2P), 8050 (REST API core-node) và 7067 (ZMQ). Verifier phục vụ REST API Verifier trên cổng container riêng của nó.
Hướng C · chạy bộ kiểm thử chức năng
Khi daemon đã được build (Hướng A, bước 1), trình chạy test sẽ khởi động các node dùng một lần cho bạn. Hữu ích khi bạn muốn sao chép một trình tự đã được kiểm chứng là chạy đúng, thay vì tự mò mẫm với daemon.
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)
Các test của TensorCash được nhóm theo giao diện: vòng đời mô hình, tài sản nguyên bản, fair-sign adaptor và ví repo dùng covenant. Mỗi test là một kịch bản độc lập có thể đọc từ đầu đến cuối; các hướng dẫn bên dưới trỏ tới những test tiêu biểu nhất.
Hướng dẫn từng bước
Ba trình tự ngắn chạy trên node giả lập từ Hướng A. Mỗi trình tự chỉ là phác thảo; functional test được liên kết là kịch bản đầy đủ, có thể thực thi.
Dành riêng cho TensorCash. Một mô hình được đăng ký bằng cách ký quỹ một khoản đặt cọc, thu thập các lượt kiểm chứng Quick và Model thành công qua N commit, rồi chuyển sang registered khi cửa sổ kiểm chứng đóng lại. Với -validationapi=mock, bạn có thể điều khiển mọi bước bằng RPC, không cần verifier hay GPU thật. Đây chỉ là phác thảo; test được liên kết là kịch bản đầy đủ.
Dành riêng cho TensorCash. registerasset là RPC ví cấp cao: nó tạo các output đặt cọc và ICU, gắn TLV đăng ký của tổ chức phát hành rồi phát sóng. Sau một xác nhận, có thể truy vấn tài sản theo id hoặc ticker. Toàn bộ vòng đời (mint, chuyển, burn) nằm trong test được liên kết.