fisco-bcos-cli

Rust 版 FISCO BCOS 可交互式命令行工具。

安装

shell $ cargo install --force fisco-bcos-cli

此 crate 使用了 TASSL 来处理 TLS 连接，在 Linux 或 Macos 下无需做任何额外操作，其他环境下则需要指定以下环境变量：

• TASSL_LIB_PATH：lib 库加载路径。
• TASSL_INCLUDE_PATH：头文件检索路径。
• TASSL_LIB_KIND：lib 库类型，可用值为：static 或 dylib。

在 Linux 或 Macos 下，如果你已经编译好了 TASSL，也可以通过指定以上环境变量来缩短编译时间。

使用

shell $ cargo fisco-bcos-cli

执行上述命令，你将进入以下交互页面：

```shell Welcome to cli for FISCO BCOS. Type help to get help

> ```

输入 help，获取帮助信息：

```shell

help

1. Use setconfig function to initialize the environment(e.g., setconfig "./config/config.json")
2. Use the below functions to interact with the FISCO BCOS service: "getclientversion", "getblocknumber", "getpbftview", "getsealerlist", "getobserverlist", "getconsensusstatus", "getsyncstatus", "getpeers", "getgrouppeers", "getnodeidlist", "getgrouplist", "getblockbyhash", "getblockbynumber", "getblockheaderbyhash", "getblockheaderbynumber", "getblockhashbynumber", "gettransactionbyhash", "gettransactionbyblockhashandindex", "gettransactionbyblocknumberandindex", "gettransactionreceipt", "getpendingtransactions", "getpendingtxsize", "getcode", "gettotaltransactioncount", "call", "sendrawtransaction", "sendrawtransactionandgetproof", "deploy", "getsystemconfigbykey", "gettransactionbyhashwithproof", "gettransactionreceiptbyhashwithproof", "generategroup", "startgroup", "stopgroup", "removegroup", "recovergroup", "querygroupstatus", "getnodeinfo", "getbatchreceiptsbyblocknumberandrange", "getbatchreceiptsbyblockhashand_range"
3. Type help to get help
4. Type CTRL-C or CTRL-D to quit
5. Visit https://github.com/kkawakam/rustyline#actions to get more actions ```

在与 FISCO BCOS service 交互前，需先调用 set_config 来设置环境信息（配置信息详情参见：服务配置），比如：

```shell

set_config ./configs/config.json ```

而后便可调用 FISCO BCOS service 交互方法对链上数据进行交互，比如：

``` shell

getclientversion

Object({"Build Time": String("20210201 10:15:37"), "Build Type": String("Darwin/appleclang/RelWithDebInfo"), "Chain Id": String("1"), "FISCO-BCOS Version": String("2.7.2"), "Git Branch": String("HEAD"), "Git Commit Hash": String("4c8a5bbe44c19db8a002017ff9dbb16d3d28e9da"), "Supported Version": String("2.7.2")}) ```

FISCO BCOS service 交互方法参数信息参见：

• Web3 服务。

FISCO BCOS service 交互方法参数注意事项：

• 方法名与参数、参数与参数之间以空格分割（比如：call ./contracts/HelloWorldV4.abi 0x62195d0f77f66c445c4878b845f55d266875705d get ）。
• call、send_raw_transaction、send_raw_transaction_and_get_proof、deploy 等方法的签名最后一个参数为 Vec<Token>，在调用时直接将其拆分为多个参数，然后以空格分开即可（比如：send_raw_transaction ./contracts/HelloWorldV4.abi 0x62195d0f77f66c445c4878b845f55d266875705d set hello）。
• 因为参数之间以空格分割，因此如某个参数内部需要有空格，请使用双引号或单引号包裹（比如：send_raw_transaction ./contracts/HelloWorldV4.abi 0x62195d0f77f66c445c4878b845f55d266875705d set "hello world" 或 send_raw_transaction ./contracts/HelloWorldV4.abi 0x62195d0f77f66c445c4878b845f55d266875705d set 'hello world'）。

License

Apache-2.0