Tài liệu tham khảo CLI

Cập nhật lần cuối: 2025-08-25

Tài liệu tham khảo đầy đủ cho giao diện dòng lệnh Kora, bao gồm các lệnh và cờ.

Cài đặt

cargo install kora-cli

Cách sử dụng cơ bản

kora [OPTIONS]

Các lệnh CLI thông dụng

Lệnh	Mô tả
`kora config validate`	Xác thực tệp cấu hình (nhanh, không gọi RPC)
`kora config validate-with-rpc`	Xác thực cấu hình với xác minh tài khoản on-chain
`kora rpc start`	Khởi động máy chủ RPC
`kora rpc initialize-atas`	Khởi tạo ATA cho tất cả token thanh toán

Cờ Kora

Tùy chỉnh hành vi của Kora với các cờ dòng lệnh toàn cục sau lệnh kora:

Cờ	Mô tả	Mặc định	Ví dụ
`--config`	Đường dẫn đến tệp cấu hình Kora (định dạng TOML)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	URL điểm cuối Solana RPC	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	In thông tin trợ giúp	-	`kora --help`
`--version`	In thông tin phiên bản	-	`kora --version`

Cờ máy chủ RPC

Cấu hình máy chủ RPC với các cờ sau (sử dụng cùng kora rpc start):

Cờ	Mô tả	Mặc định	Ví dụ
`--signers-config`	Đường dẫn đến tệp cấu hình đa người ký (TOML)	Bắt buộc*	`--signers-config signers.toml`
`--no-load-signer`	Bỏ qua khởi tạo người ký	`false`	`--no-load-signer`
`-p`, `--port`	Cổng HTTP cho các yêu cầu RPC	`8080`	`--port 3000`
`--logging-format`	Định dạng đầu ra cho log (`standard` hoặc `json`)	`standard`	`--logging-format json`
`--help`	In thông tin trợ giúp	-	`kora rpc start --help`

*Bắt buộc trừ khi sử dụng --no-load-signer

Cờ Khởi Tạo ATA

Cấu hình khởi tạo ATA với các cờ sau (sử dụng với kora rpc initialize-atas):

Cờ	Mô tả	Mặc định	Ví dụ
`--signers-config`	Đường dẫn đến tệp cấu hình đa chữ ký	Bắt buộc*	`--signers-config signers.toml`
`--fee-payer-key`	Khóa công khai của người ký để sử dụng làm người trả phí (phải có trong signers.toml)	Người ký đầu tiên	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	Phí ưu tiên tính bằng micro-lamport	Không có	`--compute-unit-price 1000`
`--compute-unit-limit`	Giới hạn đơn vị tính toán cho các giao dịch	Không có	`--compute-unit-limit 200000`
`--chunk-size`	Số lượng ATA tạo mỗi giao dịch	Không có	`--chunk-size 10`

Ví Dụ Sử Dụng Thông Dụng

Khởi Động Máy Chủ RPC

# Basic start with default settings
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Start with custom port and config
kora --config path/to/kora.toml rpc start \
  --signers-config path/to/signers.toml \
  --port 8080 \
  --logging-format json

# Start for testing without signers
kora --config path/to/kora.toml rpc start --no-load-signer

Xác Thực Cấu Hình

# Quick validation (offline)
kora --config path/to/kora.toml config validate

# Thorough validation with RPC checks
kora --config path/to/kora.toml --rpc-url https://api.mainnet-beta.solana.com \
  config validate-with-rpc

Lệnh validate-with-rpc thực hiện xác minh bổ sung trên chuỗi:

Tài khoản chương trình: Xác minh tất cả các chương trình được phép tồn tại và có thể thực thi
Mint token: Xác nhận tất cả các token được phép tồn tại dưới dạng tài khoản mint hợp lệ
Token thanh toán: Xác thực tất cả các token SPL được thanh toán là mint hợp lệ
ATA địa chỉ thanh toán: Kiểm tra xem địa chỉ thanh toán có ATA cho tất cả các token được phép hay không
Loại tài khoản: Đảm bảo các tài khoản có loại dự kiến (chương trình so với mint)

Quản Lý ATA

# Initialize ATAs for payment address/signers
kora rpc initialize-atas --signers-config signers.toml

# Initialize with custom fee payer and priority
kora rpc initialize-atas \
  --signers-config signers.toml \
  --fee-payer-key "7xKXtg2CW87d3HEQ2BpKHpcPKBhpKGQPPRQJyccVLow9" \
  --compute-unit-price 1000 \
  --chunk-size 10

Biến Môi Trường

Các biến môi trường sau có thể được sử dụng thay cho các cờ dòng lệnh:

Biến	Mô tả	Tương Đương Cờ
`RPC_URL`	Điểm cuối RPC Solana	`--rpc-url`

Xem Thêm

Hướng Dẫn Vận Hành - Tổng quan về vận hành Kora
Hướng Dẫn Cấu Hình - Các tùy chọn cấu hình chi tiết
Hướng Dẫn Người Ký - Các loại người ký và cấu hình
Hướng Dẫn Xác Thực - Thiết lập xác thực API
Hướng Dẫn Bắt Đầu Nhanh - Bắt đầu với Kora

Mục lục