最后更新: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 的行为:
| 标志 | 描述 | 默认值 | 示例 |
|---|---|---|---|
--config | Kora 配置文件路径(TOML 格式) | kora.toml | kora --config path/to/kora.toml |
--rpc-url | Solana RPC 端点 URL | http://127.0.0.1:8899 | kora --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, --port | RPC 请求的 HTTP 端口 | 8080 | --port 3000 |
--logging-format | 日志输出格式(standard 或 json) | standard | --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 settingskora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml# Start with custom port and configkora --config path/to/kora.toml rpc start \--signers-config path/to/signers.toml \--port 8080 \--logging-format json# Start for testing without signerskora --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 checkskora --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/signerskora rpc initialize-atas --signers-config signers.toml# Initialize with custom fee payer and prioritykora rpc initialize-atas \--signers-config signers.toml \--fee-payer-key "7xKXtg2CW87d3HEQ2BpKHpcPKBhpKGQPPRQJyccVLow9" \--compute-unit-price 1000 \--chunk-size 10
环境变量
这些环境变量可以代替命令行标志使用:
| 变量 | 描述 | 对应标志 |
|---|---|---|
RPC_URL | Solana RPC 端点 | --rpc-url |
另请参阅
Is this page helpful?