CLI 参考

最后更新:2025-08-25

Kora 命令行界面的完整参考,包括命令和标志。

安装

cargo install kora-cli

基本用法

kora [OPTIONS]

常用 CLI 命令

命令描述
kora config validate验证配置文件(快速,无 RPC 调用)
kora config validate-with-rpc通过链上账户验证来验证配置
kora rpc start启动 RPC 服务器
kora rpc initialize-atas为所有支付代币初始化 ATA

Kora 标志

kora 命令后使用这些全局命令行标志来自定义 Kora 的行为:

标志描述默认值示例
--configKora 配置文件路径(TOML 格式)kora.tomlkora --config path/to/kora.toml
--rpc-urlSolana RPC 端点 URLhttp://127.0.0.1:8899kora --rpc-url https://api.devnet.solana.com
--help打印帮助信息-kora --help
--version打印版本信息-kora --version

RPC 服务器标志

使用这些标志配置 RPC 服务器(与 kora rpc start 一起使用):

标志描述默认值示例
--signers-config多签名者配置文件路径(TOML)必需*--signers-config signers.toml
--no-load-signer跳过签名者初始化false--no-load-signer
-p, --portRPC 请求的 HTTP 端口8080--port 3000
--logging-format日志输出格式(standardjsonstandard--logging-format json
--help打印帮助信息-kora rpc start --help

*除非使用 --no-load-signer,否则为必填项

ATA 初始化标志

使用以下标志配置 ATA 初始化(与 kora rpc initialize-atas 一起使用):

标志描述默认值示例
--signers-config多签名者配置文件的路径必填项*--signers-config signers.toml
--fee-payer-key用作费用支付方的签名者公钥(必须在 signers.toml 中)第一个签名者--fee-payer-key "pubkey123..."
--compute-unit-price优先费用(以微 lamport 为单位)--compute-unit-price 1000
--compute-unit-limit交易的计算单元限制--compute-unit-limit 200000
--chunk-size每笔交易创建的 ATA 数量--chunk-size 10

常见用法示例

启动 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

配置验证

# 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

validate-with-rpc 命令执行额外的链上验证:

  • 程序账户:验证所有允许的程序是否存在且可执行
  • 代币铸币:确认所有允许的代币作为有效的铸币账户存在
  • 支付代币:验证所有 SPL 支付代币是否为有效的铸币
  • 支付地址 ATA:检查支付地址是否拥有所有允许代币的 ATA
  • 账户类型:确保账户具有预期类型(程序 vs 铸币)

管理 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

环境变量

这些环境变量可以代替命令行标志使用:

变量描述对应标志
RPC_URLSolana RPC 端点--rpc-url

另请参阅

Is this page helpful?

Table of Contents

Edit Page

管理者

©️ 2026 Solana 基金会版权所有
取得联系