Mithril Aggregator Node

THÔNG TIN

Đây là node của Mạng Mithril chịu trách nhiệm thu thập các chữ ký riêng lẻ từ Mithril Signers và tổng hợp chúng thành một đa chữ ký. Mithril Aggregator sử dụng khả năng này để cung cấp các ảnh chụp nhanh được chứng nhận về chuỗi khối Cardano .

TIP

• Để biết thêm thông tin về Mạng Mithril , vui lòng tham khảo trang Kiến trúc.

• Để biết thêm thông tin về Mithril Aggregator, vui lòng tham khảo trang Aggregator Node.

Tài nguyên

Node	Kho lưu trữ nguồn	Tài liệu Rust	Các gói Docker
Mithril Aggregator	↗️	↗️	↗️

Chuẩn bị

• Cài đặt chuỗi công cụ Rust được định cấu hình chính xác (phiên bản 1.62.0+).

• Cài đặt thư viện phát triển OpenSSL, ví dụ trên Ubuntu / Debian / Mint chạyapt install libssl-dev

Nguồn tải xuống

Tải xuống từ Github (HTTPS)

git clone https://github.com/input-output-hk/mithril.git

Hoặc (SSH)

git clone [email protected]:input-output-hk/mithril.git

Thay đổi thư mục

cd mithril/mithril-aggregator

Kiểm tra phát triển và xây dựng

Chạy thử nghiệm

make test

Tạo menu trợ giúp

make help

Tạo tài liệu Rust

make doc

Chạy ở chế độ gỡ lỗi với cấu hình mặc định

make debug

Phát hành bản dựng và chạy nhị phân

Xây dựng và chạy trong bản phát hành với cấu hình mặc định

make run

Hoặc, chỉ xây dựng trong bản phát hành

make build

Hiển thị menu trợ giúp

./mithril-aggregator --help

Bạn nên thấy

mithril-aggregator 
Node args

USAGE:
    mithril-aggregator [OPTIONS]

OPTIONS:
        --db-directory <DB_DIRECTORY>
            Directory to snapshot [default: /db]

    -h, --help
            Print help information

    -r, --run-mode <RUN_MODE>
            Run mode [default: dev]

        --server-ip <SERVER_IP>
            Server listening IP [default: 0.0.0.0]

        --server-port <SERVER_PORT>
            Server listening port [default: 8080]

        --snapshot-directory <SNAPSHOT_DIRECTORY>
            Directory to store snapshot Defaults to work folder [default: .]

    -v, --verbose
            Verbosity level

Chạy trong bản phát hành với cấu hình mặc định

./mithril-aggregator

Chạy trong bản phát hành với một chế độ cụ thể

./mithril-aggregator -r testnet

Chạy trong bản phát hành với cấu hình tùy chỉnh qua env vars

RUN_INTERVAL=60000 NETWORK=testnet ./mithril-aggregator

TIP

Nếu bạn muốn tìm hiểu sâu hơn, bạn có thể truy cập vào một số cấp độ nhật ký từ Mithril Aggregators:

• Thêm -vmột số nhật ký (CẢNH BÁO)

• Thêm -vvđể biết thêm nhật ký (INFO)

• Thêm -vvvđể có nhiều nhật ký hơn nữa (GỠ LỖI)

• Thêm -vvvvcho tất cả nhật ký (TRACE)

Xây dựng và chạy vùng chứa

Xây dựng hình ảnh Docker cục bộ

make docker-build

Chạy một vùng chứa Docker cục bộ

make docker-run

Thông số cấu hình

Các thông số cấu hình được đặt:

• Trong một tệp cấu hình (tùy thuộc vào tham số --run-mode). Nếu chế độ thời gian chạy là testnettệp được đặt trong ./conf/testnet.json.

• Giá trị có thể bị ghi đè bởi một biến môi trường có tên là tên tham số được viết hoa.

Đây là danh sách các tham số có sẵn:

Tham số	Dòng lệnh (dài)	Dòng lệnh (ngắn)	Biến môi trường	Sự mô tả	Giá trị mặc định	Thí dụ	Bắt buộc
server_ip	--server-ip	-	SERVER_IP	IP máy chủ đang nghe	0.0.0.0	-	✔️
server_port	--server-port	-	SERVER_PORT	Cổng máy chủ đang nghe	8080	-	✔️
verbose	--verbose	-v	VERBOSE	Mức độ chi tiết	-	Phân tích cú pháp từ số lần xuất hiện: -vcho Warning, -vvcho Info, -vvvcho Debugvà -vvvvchoTrace	✔️
run_mode	--run-mode	-r	RUN_MODE	Chế độ thời gian chạy	dev	-	✔️
db_directory	--db-directory	-	DB_DIRECTORY	Thư mục ảnh chụp nhanh từ Cardano Node	/db	-	✔️
snapshot_directory	--snapshot-directory	-	SNAPSHOT_DIRECTORY	Thư mục lưu trữ ảnh chụp nhanh cục bộ của Cardano Node	.	-	✔️
network	-	-	NETWORK	Mạng Cardano	-	testnethoặc mainnethoặcdevnet	✔️
network_magic	-	-	NETWORK_MAGIC	Cardano Network Magic number (cho testnetvà devnet)	-	1097911063hoặc42	-
protocol_parameters	-	-	PROTOCOL_PARAMETERS__K, PROTOCOL_PARAMETERS__MvàPROTOCOL_PARAMETERS__PHI_F	Thông số giao thức Mithril	-	{ k: 5, m: 100, phi_f: 0.65 }	✔️
snapshot_store_type	-	-	SNAPSHOT_STORE_TYPE	Loại cửa hàng ảnh chụp nhanh để sử dụng	-	gcphoặclocal	✔️
snapshot_uploader_type	-	-	SNAPSHOT_UPLOADER_TYPE	Loại trình tải lên ảnh chụp nhanh để sử dụng	-	gcphoặclocal	✔️
run_interval	-	-	RUN_INTERVAL	Khoảng thời gian giữa hai chu kỳ thời gian chạy tính bằng mili giây	-	60000	✔️
data_stores_directory	-	-	data_stores_directory	Thư mục lưu trữ dữ liệu trình tổng hợp (Chứng chỉ, Ảnh chụp nhanh, Tham số giao thức, ...)	-	./mithril-aggregator/stores	✔️
cardano_cli_path	-	-	CARDANO_CLI_PATH	Đường dẫn công cụ Cardano CLI	-	cardano-cli	✔️
cardano_node_socket_path	-	-	CARDANO_NODE_SOCKET_PATH	Đường dẫn của ổ cắm được sử dụng bởi công cụ Cardano CLI để giao tiếp với nút Cardano	-	/tmp/cardano.sock	✔️
url_snapshot_manifest	-	-	URL_SNAPSHOT_MANIFEST	Ảnh chụp nhanh vị trí kê khai	-	Chỉ nếu snapshot_store_typelà gcp, nếu không thì nó phải là ''	✔️