标签：submit label too ref type 延迟 d3d oss balance
我们提供了一个命令行界面（CLI）客户端来与区块链进行交互。
本文档中的所有命令均假定：
git 已安装在您的系统上。yum或者apt-get安装在Linux系统上。在这个例子中，我们将下载必要的Libra组件并在两个用户之间执行一个事务：Alice和Bob。
执行以下步骤将事务提交到Libra testnet上的验证程序节点：
git clone https://github.com/libra/libra.git
要设置Libra Core，请切换到libra目录并运行安装脚本以安装依赖项，如下所示：
cd libra
./scripts/dev_setup.sh
安装脚本执行以下操作：
如果设置失败，请参阅故障排除
要连接到Libra testnet上运行的验证器节点，请运行客户端，如下所示。
./scripts/cli/start_cli_testnet.sh
此命令使用货物（Rust的包管理器）构建和运行客户端，并将客户端连接到testnet上的验证器节点。
客户端连接到testnet上的节点后，您将看到以下输出。要随时退出客户端，请使用该quit命令。
usage: <command> <args>
Use the following commands:
account | a
Account operations
query | q
Query operations
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)] Suffix ‘b‘ is for blocking.
Transfer coins from account to another.
help | h
Prints this help
quit | q!
Exit this client
Please, input commands:
libra%
如果在构建客户端和连接到testnet时遇到问题，请参阅故障排除。
注意：如果要在系统上本地运行验证程序节点，请按照运行本地验证程序节点中的说明进行操作。创建帐户，铸币和执行交易的说明与testnet上的节点相同。
将客户端连接到testnet后，可以运行CLI命令来创建新帐户。我们将引导您为两个用户创建帐户（让我们称他们为Alice和Bob）。
一个天秤座％的命令行提示符表明您天秤座CLI客户端运行。要查看该account命令的帮助信息，请输入“account”，如下所示：
libra% account
usage: account <arg>
Use the following args for this command:
create | c
Create an account. Returns reference ID to use in other operations
list | la
Print all accounts that were created or loaded
recover | r <file path>
Recover Libra wallet from the file path
write | w <file name>
Save Libra wallet mnemonic recovery seed to disk
mint | mintb | m | mb <receiver account> <number of coins>
Mint coins to the account. Suffix ‘b‘ is for blocking
请注意，使用CLI创建帐户不会更新区块链，只会创建本地密钥对。
要创建Alice的帐户，请输入以下命令：
libra% account create
成功输出示例：
>> Creating/retrieving next account from wallet
Created/retrieved account #0 address 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8
＃0是Alice帐户的索引，十六进制字符串是Alice帐户的地址。索引只是引用Alice帐户的一种方式。帐户索引是本地CLI索引，可以在其他CLI命令中使用，以便用户方便地引用他们创建的帐户。该指数对区块链毫无意义。只有当通过铸币将任何一笔钱添加到Alice的账户时，才会在区块链上创建Alice的账户，或者通过来自另一个用户的转账将钱转移到Alice的账户。请注意，您也可以在CLI命令中使用十六进制地址。帐户索引只是帐户地址的便利包装。
要创建Bob的帐户，请重复帐户创建命令：
libra% account create
成功输出示例：
>> Creating/retrieving next account from wallet
Created/retrieved account #1 address 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7
＃1是Bob帐户的索引，十六进制字符串是Bob帐户的地址。有关索引的更多详细信息，请参阅创建Alice的帐户。
要列出您创建的帐户，请输入以下命令：
libra% account list
成功输出示例：
User account index: 0, address: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8, sequence number: 0
User account index: 1, address: 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7, sequence number: 0
帐户的序列号表示从该帐户发送的交易数。每次从该帐户发送的事务被执行并存储在区块链中时，它会递增。要了解更多信息，请参阅序列号。
在testnet上创建和添加硬币是通过Faucet完成的。水龙头是一种与testnet一起运行的服务。此服务仅用于为testnet创建硬币，并且不存在主网。它创造了没有现实世界价值的天秤座。假设您已经创建了Alice和Bob的帐户，分别为索引0和索引1，您可以按照以下步骤将Libra添加到两个帐户。
要使Libra成为薄荷并添加到Alice的帐户，请输入以下命令：
libra% account mint 0 110
一个成功的帐户mint命令也将在区块链上创建Alice的帐户。
成功输出示例：
>> Minting coins
Mint request submitted
请注意，提交请求时，这意味着它已成功添加到mempool（testnet上的验证程序节点）。它并不一定意味着它将成功完成。稍后，我们将查询帐户余额以确认铸币是否成功。
如果您的帐户mint命令未成功提交您的请求，请参阅 故障排除
要使Libra成为薄荷并添加到Bob的帐户，请输入以下命令：
libra% account mint 1 52
成功输出示例：
>> Minting coins
Mint request submitted
如果您的帐户mint命令未成功提交您的请求，请参阅 故障排除
要检查Alice帐户中的余额，请输入以下命令：
libra% query balance 0
成功输出示例：
Balance is: 110
要检查Bob帐户中的余额，请输入以下命令：
libra% query balance 1
成功输出示例：
Balance is: 52
在我们提交交易以将Libra从Alice的账户转移到Bob的账户之前，我们将查询每个账户的序列号。这将有助于我们了解执行事务如何更改每个帐户的序列号。
libra% query sequence 0
>> Getting current sequence number
Sequence number is: 0
libra% query sequence 1
>> Getting current sequence number
Sequence number is: 0
在query sequence 0，0是Alice的帐户的索引。Alice和Bob的帐户的序列号为0表示到目前为止尚未执行Alice或Bob的帐户中的任何交易。
要提交交易以将10个天秤座从Alice的帐户转移到Bob的帐户，请输入以下命令：
libra% transfer 0 1 10
成功输出示例：
>> Transferring
Transaction submitted to validator
To query for transaction status, run: query txn_acc_seq 0 0 <fetch_events=true|false>
您可以使用命令query txn_acc_seq 0 0 true（按帐户和序列号进行交易）来检索有关您刚刚提交的交易的信息。第一个参数是发件人帐户的本地索引，第二个参数是帐户的序列号。要查看此命令的示例输出，请参阅示例输出。
您刚刚将您的事务提交到testnet上的验证器节点，它已包含在验证器的mempool中。这并不一定意味着您的交易已被执行。理论上，如果系统运行缓慢或过载，则需要一些时间才能看到结果，您可能需要通过查询帐户多次检查。要查询索引为0的帐户，可以使用命令 query account_state 0.“预期输出”显示在“ 样本输出”部分中
阻止传输命令：您可以使用transferb命令（如下所示）而不是transfer命令。transferb只有在将事务提交到区块链后，才会提交事务并返回到客户端提示。一个例子如下所示：
libra% transferb 0 1 10
有关从提交到执行和存储的事务生命周期的理解，请参阅事务的生命周期。
libra% query sequence 0
>> Getting current sequence number
Sequence number is: 1
libra% query sequence 1
>> Getting current sequence number
Sequence number is: 0
Alice的帐号（索引0）的序号为1表示到目前为止已经从Alice的帐户发送了一个交易。Bob的帐户（索引1）的序列号为0表示到目前为止尚未从Bob的帐户发送任何交易。每次从帐户发送交易时，序列号都会增加1。
要检查两个帐户中的最终余额，请像在此步骤中一样，再次查询每个帐户的余额。如果您的交易（转账）成功执行，您应该在Alice的账户中看到100个Libra，在Bob的账户中看到62个Libra。
libra% query balance 0
Balance is: 100
libra% query balance 1
Balance is: 62
您已成功在Libra testnet上执行了您的交易，并将10个Libra从Alice的账户转移到了Bob的账户！
rustup update从您的libra目录运行。protoc至3.6.0或更高版本。./scripts/dev_setup.sh如果您遇到构建失败，请尝试从libra目录中删除货物锁定文件：
rm Cargo.lock如果您的客户端没有连接到testnet：
./scripts/cli/start_cli_testnet.sh如果您在testnet上连接的验证程序节点不可用，您将收到“服务器不可用”消息，如下所示：
libra% account mint 0 110
>> Minting coins
[ERROR] Error minting coins: Server unavailable, please retry and/or check **if** host passed to the client is running
如果您在提交交易后未更新余额，请稍等片刻再次查询余额。如果区块链正在经历非常大量的交易，则可能会有延迟。如果您的余额仍未更新，请再次尝试铸造。
要检查帐户是否存在，请查询帐户状态。对于索引为0的帐户，请输入以下内容：
libra% query account_state 0
如果testnet验证器节点（您的客户端已连接到）不可用或您与testnet的连接已超时，您将看到此错误：
libra% transfer 0 1 10
>> Transferring
[ERROR] Failed to perform transaction: Server unavailable, please retry and/or check if host passed to the client is running
要解决传输错误：
query account_state 0quit或退出客户端q!，然后重新运行以下命令以连接到testnet：
./scripts/cli/start_cli_testnet.sh 从libra目录此示例将使用帐户和序列号查询单个事务的详细信息。
libra% query txn_acc_seq 0 0 true
>> Getting committed transaction by account and sequence number
Committed transaction: SignedTransaction {
{ raw_txn: RawTransaction {
sender: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8,
sequence_number: 0,
payload: {,
transaction: peer_to_peer_transaction,
args: [
{ADDRESS: 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7},
{U64: 10000000},
]
},
max_gas_amount: 10000,
gas_unit_price: 0,
expiration_time: 1560466424s,
},
public_key: 55af3fe3f28550a2f1e5ebf073ef193feda44344d94c463b48be202aa0b3255d,
signature: Signature( R: CompressedEdwardsY: [210, 23, 214, 62, 228, 179, 64, 147, 81, 159, 180, 138, 100, 211, 111, 139, 178, 148, 81, 1, 240, 135, 148, 145, 104, 234, 227, 239, 198, 153, 13, 199], s: Scalar{
bytes: [203, 76, 105, 49, 64, 130, 162, 81, 22, 237, 159, 26, 80, 181, 111, 94, 84, 6, 152, 126, 181, 192, 62, 103, 130, 94, 246, 174, 139, 214, 3, 15],
} ),
}
}
Events:
ContractEvent { access_path: AccessPath { address: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8, type: Resource, hash: "217da6c6b3e19f1825cfb2676daecce3bf3de03cf26647c78df00b371b25cc97", suffix: "/sent_events_count/" } , index: 0, event_data: AccountEvent { account: 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7, amount: 10000000 } }
ContractEvent { access_path: AccessPath { address: 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7, type: Resource, hash: "217da6c6b3e19f1825cfb2676daecce3bf3de03cf26647c78df00b371b25cc97", suffix: "/received_events_count/" } , index: 0, event_data: AccountEvent { account: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8, amount: 10000000 } }
请注意，交易金额以微数字显示。
在以下示例中，我们将从参考索引0处的帐户查询“已发送”事件。您将注意到，因为我们从此帐户发送了一个事务，所以只有一个事件。还返回当前状态的证明，以便可以执行不会丢失任何事件的验证 - 这在查询未返回“限制”事件时完成。
libra% query event 0 sent 0 true 10
>> Getting events by account and event type.
EventWithProof {
transaction_version: 3,
event_index: 0,
event: ContractEvent { access_path: AccessPath { address: e7460e02058b36d28e8eef03f0834c605d3d6c57455b8ec9c3f0a3c8b89f248b, type: Resource, hash: "217da6c6b3e19f1825cfb2676daecce3bf3de03cf26647c78df00b371b25cc97", suffix: "/sent_events_count/" } , index: 0, event_data: AccountEvent { account: 46efbad798a739c088e0e98dd9d592c27c7eb45ba1f8ccbdfc00bd4d7f2947f3, amount: 10000000 } },
proof: EventProof { ledger_info_to_transaction_info_proof: AccumulatorProof { siblings: [HashValue(62570ae9a994bcb20c03c055667a4966fa50d0f17867dd5819465072fd2c58ba), HashValue(cce2cf325714511e7d04fa5b48babacd5af943198e6c1ac3bdd39c53c87cb84c)] }, transaction_info: TransactionInfo { signed_transaction_hash: HashValue(69bed01473e0a64140d96e46f594bc4b463e88e244b694e962b7e19fde17f30d), state_root_hash: HashValue(5809605d5eed94c73e57f615190c165b11c5e26873012285cc6b131e0817c430), event_root_hash: HashValue(645df3dee8f53a0d018449392b8e9da814d258da7346cf64cd96824f914e68f9), gas_used: 0 }, transaction_info_to_event_proof: AccumulatorProof { siblings: [HashValue(5d0e2ebf0952f0989cb5b38b2a9b52a09e8d804e893cb99bf9fa2c74ab304bb1)] } }
}
Last event state: Some(
AccountStateWithProof {
version: 3,
blob: Some(
AccountStateBlob {
Raw: 0x010000002100000001217da6c6b3e19f1825cfb2676daecce3bf3de03cf26647c78df00b371b25cc974400000020000000e7460e02058b36d28e8eef03f0834c605d3d6c57455b8ec9c3f0a3c8b89f248b00e1f50500000000000000000000000001000000000000000100000000000000
Decoded: Ok(
AccountResource {
balance: 100000000,
sequence_number: 1,
authentication_key: 0xe7460e02058b36d28e8eef03f0834c605d3d6c57455b8ec9c3f0a3c8b89f248b,
sent_events_count: 1,
received_events_count: 0,
},
)
},
),
proof: AccountStateProof {
ledger_info_to_transaction_info_proof: AccumulatorProof {
siblings: [
HashValue(62570ae9a994bcb20c03c055667a4966fa50d0f17867dd5819465072fd2c58ba),
HashValue(cce2cf325714511e7d04fa5b48babacd5af943198e6c1ac3bdd39c53c87cb84c),
],
},
transaction_info: TransactionInfo {
signed_transaction_hash: HashValue(69bed01473e0a64140d96e46f594bc4b463e88e244b694e962b7e19fde17f30d),
state_root_hash: HashValue(5809605d5eed94c73e57f615190c165b11c5e26873012285cc6b131e0817c430),
event_root_hash: HashValue(645df3dee8f53a0d018449392b8e9da814d258da7346cf64cd96824f914e68f9),
gas_used: 0,
},
transaction_info_to_account_proof: SparseMerkleProof {
leaf: Some(
(
HashValue(c0fbd63b0ae4abfe57c8f24f912f164ba0537741e948a65f00d3fae0f9373981),
HashValue(fc45057fd64606c7ca40256b48fbe486660930bfef1a9e941cafcae380c25871),
),
),
siblings: [
HashValue(4136803b3ba779bb2c1daae7360f3f839e6fef16ae742590a6698b350a5fc376),
HashValue(5350415253455f4d45524b4c455f504c414345484f4c4445525f484153480000),
HashValue(a9a6bda22dd6ee78ddd3a42da152b9bd39797b7da738e9d6023f407741810378),
],
},
},
},
)
在此示例中，我们将查询单个帐户的状态。
libra% query account_state 0
>> Getting latest account state
Latest account state is:
Account: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8
State: Some(
AccountStateBlob {
Raw: 0x010000002100000001217da6c6b3e19f1825cfb2676daecce3bf3de03cf26647c78df00b371b25cc9744000000200000003ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a800e1f50500000000000000000000000001000000000000000100000000000000
Decoded: Ok(
AccountResource {
balance: 100000000,
sequence_number: 1,
authentication_key: 0x3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8,
sent_events_count: 1,
received_events_count: 0,
},
)
},
)
Blockchain Version: 3
要在您的计算机上本地启动验证程序节点并创建您自己的本地区块链网络（未连接到Libra testnet），请确保已按照Setup Libra Core中的说明运行构建脚本，切换到Libra Core存储库的根目录，并运行libra_swarm如下所示：
$ cd ~/libra
$ cargo run -p libra_swarm -- -s
-p libra_swarm - 使货物运行libra_swarm包，该包启动由一个节点组成的本地区块链。
-s option启动本地客户端以连接到本地区块链。
要查看启动节点和连接Libra Blockchain的其他选项，请运行：
$ cargo run -p libra_swarm -- -h
货运命令可能需要一些时间才能运行。如果此命令的执行完成且没有错误，则系统上正在运行Libra CLI客户端实例和Libra验证器节点。成功执行后，您应该看到包含CLI客户端菜单和libra%提示的输出。
一旦你执行你的第一个交易，你可以参考文档事务的寿命为：
Libra国内开发者微信交流群:
不能入群请加管理微信，拉你进群=>
标签：submit label too ref type 延迟 d3d oss balance
原文地址：https://www.cnblogs.com/x-poior/p/11216424.html
