| id | title |
|---|---|
libra-cli |
Libra CLI 命令指南 |
本指南介绍如何使用Libra命令行界面客户端（CLI）与Libra 区块链进行交互。 CLI作为交互式shell调用。 它提供了创建帐户，铸币，资产交易和查询区块链的基本命令。 您可以使用CLI客户端通过指定节点的主机名与testnet上的验证器节点，本地Libra 区块链或远程区块链进行交互。
有三种方法可以调用Libra CLI客户端。
要通过CLI连接到testnet，可以使用便捷脚本来调用CLI，而无需指定参数。 要调用它，请切换到libra目录并运行:
./scripts/cli/start_cli_testnet.sh要启动本地Libra网络并生成连接到此本地网络的CLI客户端，请运行：
cargo run -p libra_swarm -- -s
-s 选项使CLI在本地Libra网络启动后运行。 请注意，这可能需要几分钟才能构建然后启动。
要调用CLI客户端并自行配置，请运行：
cargo run -p client --bin client -- [OPTIONS] --host <host> --validator_set_file <validator_set_file>
运行CLI客户端命令以连接到任一Libra网络的选项包括：
-m | --faucet_key_file_path— 生成的faucet帐户密钥对的路径。 faucet帐户可用于铸币。 如果未通过，将为您生成一个新的密钥对，并将其放在临时目录中。 要手动生成密钥对，请使用：cargo run -p generate_keypair -- -o <output_file_path>.-f | --faucet_server— 操作faucet服务的主机。如果没有传递，这将从host参数派生。-a | —-host— CLI要连接的目标主机。-p | -—port— 目标Libra 区块链的公共端口供客户端连接，默认值为30307。-n | --mnemonic_file— T他提供加载用户帐户地址/密钥生成的助记词的文件位置。 如果未通过，则libra_wallet将在当前目录中生成新的助记词文件。-s | --validator_set_file— 用于加载受信任验证程序配置的文件位置。 它用于验证验证器查询响应中的验证器签名。 该文件至少应包含客户端信任的所有验证器的公钥 — 通常应该是网络上的所有验证器。 要连接到testnet，请使用 'libra/scripts/cli/trusted_peers.config.toml'. 可以通过libra-config为本地测试生成:cargo run --bin libra-config但首选方法是使用libra-swarm来运行本地网络。
使用前面提到的三个命令中的任何一个启动后，可以使用以下CLI命令：
major_command subcommand [options]
如果仅输入主命令，它将显示该命令的帮助信息。 主命令可以是以下任何一种：
create | c — 使用私钥/公钥对创建随机帐户。 帐户信息仅保存在内存中。 创建的帐户不会保存到链中。
Usage:
create|c
list | la — 输出显示已创建或加载的所有帐户。
Usage:
list|la
recover | r <file_path> — 恢复所有帐户，已写入一个文件通过 account write 命令恢复。
Usage:
recover|r <file_path>
Arguments:
file_path - File path from which to load mnemonic recover seed. Must have been written via `account write`
write | w <file path> — 将Libra钱包助记词恢复种子保存到磁盘。 这将允许通过 account recover 命令恢复账户。
Usage:
write|w <file_path>
Arguments:
file_path - File path at which to save the mnemonic recovery seed to disk.
<mint | m> | <mintb| mb> — 铸币或者添加币到帐户。 后缀'b'用于块标记，如果指定了块（使用后缀'b'），CLI将查询链，直到交易完成/可用。 其他子“块”命令也是如此。
Usage:
mint|mint|m|b <receiver_account_ref_id>|<receiver_account_address> <number_of_coins>
Arguments:
receiver_account_ref_id | receiver_account_address - The receiver account to mint the coins to.
If the receiver account does not exist, it will be created first.
Either receiver_account_address or receiver_account_ref_id (an internal index of
the account in the CLI client) can be used to specify receiver account (identical to
other commands). If gas is being charged, the account that sent this mint transaction
(currently preloaded genesis account) pays for the gas.
number_of_coins - The number of coins to be minted to the receiver account.
Usage:
transfer|transferb|t|tb <sender_account_address>|<sender_account_ref_id> <receiver_account_address>|<receiver_account_ref_id> <number_of_coins> [gas_unit_price (default=0)] [max_gas_amount (default 10000)]
Arguments:
sender_account_address | sender_account_ref_id - The account from which this transfer transaction
is sent. The sender account pays for the gas.
receive_account_address | receiver_account_ref_id - The account to which this transaction sends coins.
If the receiver account does not exist, it will be created first. The sender will pay for
gas required for both account creation and coin transfer.
number_of_coins - The number of coins transferred to receiver account.
gas_unit_price - The unit price to pay for gas.
max_gas_amount - Max units of gas user is willing to pay for this transaction.
balance | b — 获取帐户的当前余额
Usage:
balance | b <account_ref_id>|<account_address>
Arguments:
account_ref_id | account_address - The account to query balance for.
sequence | s — 获取帐户的当前序列号。
Usage:
sequence | s <account_ref_id>|<account_address> [reset_sequence_number=true|false]
Arguments:
account_ref_id | account_address - The account to get current/latest sequence number.
reset_sequence_number - If the sequence number known locally by the CLI differs from the
value known on chain, this will reset the local sequence number to to on-chain
value. This is useful when a user encounters an invalid sequence number error.
account_state | as — 获取帐户的最新状态。
Usage:
account_state | as <account_ref_id>|<account_address>
Arguments:
account_ref_id | account_address - The account to query latest state.
txn_acc_seq | ts — 按帐户和序列号获取已提交的交易。
Usage:
txn_acc_seq | ts <account_ref_id>|<account_address> <sequence_number> <fetch_events=true|false>
Arguments:
account_ref_id | account_address - The account to query committed transaction.
sequence_number - The sequence number of committed transaction.
fetch_events - Set to true to fetch events emitted by this transaction.
txn_range | tr — 按范围获取提交的交易。
Usage:
txn_range | tr <start_version> <limit> <fetch_events=true|false>
Arguments:
start_version - The version to query the transaction from.
limit - The maximum number of transactions to query.
fetch_events - Set to true to fetch events emitted by each transaction.
event | ev — 通过帐户和路径获取事件。
Usage:
event | ev <account_ref_id>|<account_address> <sent|received> <start_sequence_number> <ascending=true|false> <limit>
Arguments:
account_ref_id | account_address - The account to query events from.
sent | received - Fetch sent or received events for this account.
Note that this will later evolve into selecting any event path.
start_sequence_number - The sequence number of events to query starting from.
ascending - The direction of query from start_sequence_number.
limit - The maximum number of events to query.
quit | q! — 退出CLI。 不需要子命令.
help | h — 显示输出帮助。 不需要子命令。.
CLI提供的帐户创建会生成本地密钥对，但区块链上不会创建任何内容。 要在区块链上创建帐户：
- 将币交易到您要创建的地址。 如果收件人帐户不存在，将首先创建收件人帐户，然后交易币。 发送方支付创建帐户和转账的费用。
- 发送铸币、交易币到帐户。 如果该帐户不存在，将首先创建该帐户，并且稍后将铸币。 与其他交易不同，不存在的账户本身可以请求铸币交易。 对于测试网，没有明确限制帐户可以铸造的硬币数量。 它旨在允许用户创建币以在testnet上进行实验。