Rust SDK For FISCO BCOS 2.7.0+
toml
[dependencies]
fisco-bcos-service = "0.3"
此 crate 使用了 TASSL 来处理 TLS 连接，在 Linux 或 Macos 下无需做任何额外操作，其他环境下则需要指定以下环境变量：
TASSL_LIB_PATH：lib 库加载路径。TASSL_INCLUDE_PATH：头文件检索路径。TASSL_LIB_KIND：lib 库类型，可用值为：static 或 dylib。在 Linux 或 Macos 下，如果你已经编译好了 TASSL，也可以通过指定以上环境变量来缩短编译时间。
配置文件为包含以下信息的 json 文件：
json
{
"service_type": "rpc",
"node": {
"host": "127.0.0.1",
"port": 8545
},
"account": "./accounts/alice.pem",
"contract": {
"solc": "./bin/solc-0.4.25",
"source": "./contracts",
"output": "./contracts/.output"
},
"authentication": {
"ca_cert": "./authentication/gm/gmca.crt",
"sign_cert": "./authentication/gm/gmsdk.crt",
"sign_key": "./authentication/gm/gmsdk.key",
"enc_key": "./authentication/gm/gmensdk.key",
"enc_cert": "./authentication/gm/gmensdk.crt"
},
"sm_crypto": false,
"group_id": 1,
"chain_id": 1,
"timeout_seconds": 10
}
每一项的解释如下：
service_type：服务类型，可用值为：rpc 或 channel。
node：服务节点信息，包含以下属性：
host：服务节点主机地址。port：服务节点端口号。account：用户证书文件路径（仅支持 pem 格式）。
contract：合约相关配置，包含以下属性：
solc：Solidity 编译器所在路径。source：Solidity 合约源文件所在路径。output：Solidity 合约编译后的 abi 及 bin 文件输出目录（该目录需自行创建）。authentication：节点验证配置信息（仅在 service_type 为 channel 时设置），包含以下属性：
ca_cert：CA 证书文件路径。sign_cert：签名证书文件路径。sign_key：签名密钥文件路径。enc_key：enc 密钥文件路径（非国密模式下无需设置）。enc_cert：enc 证书文件路径（非国密模式下无需设置）。sm_crypto：交易签名是否使用国密。
group_id：组 ID。chain_id：链 ID。timeout_seconds： 网络过期时间（单位为秒）。注：配置项中 account、contract、authentication 中的路径如果使用相对路径，它的参考路径为该配置文件所在路径。
Web3Service 是对 FISCO BCOS JSON-RPC 的封装。
```rust use fiscobcosservice::createweb3service;
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfile_path).unwrap(); ```
接口列表：
get_client_versionget_block_numberget_pbft_viewget_sealer_listget_observer_listget_consensus_statusget_sync_statusget_peersget_group_peersget_node_id_listget_group_listget_block_by_hashget_block_by_numberget_block_header_by_hashget_block_header_by_numberget_block_hash_by_numberget_transaction_by_hashget_transaction_by_block_hash_and_indexget_transaction_by_block_number_and_indexget_transaction_receiptget_pending_transactionsget_pending_tx_sizeget_codeget_total_transaction_countget_system_config_by_keycallsend_raw_transactionsend_raw_transaction_and_get_proofdeploycompileget_transaction_by_hash_with_proofget_transaction_receipt_by_hash_with_proofgenerate_groupstart_groupstop_groupremove_grouprecover_groupquery_group_statusget_node_infoget_batch_receipts_by_block_number_and_rangeget_batch_receipts_by_block_hash_and_range接口将 FISCO BCOS JSON-RPC 返回的 error 属性转换成了 fisco_bcos_service::web3::service_error::ServiceError::FiscoBcosError 异常并返回，包含以下属性：
除 call 的返回值结构与相关 JSON-RPC 方法不一致外，其余接口的返回值结构参见 FISCO BCOS JSON-RPC 中相关方法返回值中的 result 属性。
调用 call、send_raw_transaction、send_raw_transaction_and_get_proof、deploy 之前，请确保相关合约的 abi 及 bin 文件已存放在配置属性 contract.output 中的指定目录下，你可点击以下链接 download_solc.sh 下载编译器后自行编译，也可调用 compile 接口编译。
deploy 的返回值结构如下所示：
json
{
"status": "0x0",
"transactionHash": "0x31ad4fd454fbe72557cbcb55bde067cfcd80fa43e9d97bdf2c13d2007f066370",
"contractAddress": "0x62195d0f77f66c445c4878b845f55d266875705d"
}
接口中的 Token 实为 ethabi::token::Token，具体使用参见 ethabi token，在使用过程中无需安装 ethabi 依赖，只需引用 fisco_bcos_service::ethabi::token::Token 即可。
SystemConfigService 是对预编译合约 SystemConfigPrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, precompiled::systemconfigservice::SystemConfigService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let systemconfigservice = SystemConfigService::new(&web3service); ```
接口列表：
set_value_by_key以上接口的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
TableCRUDService 是对预编译合约 TableFactory 及 CRUDPrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, precompiled::tablecrudservice::TableCRUDService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let tablecrudservice = TableCRUDService::new(&web3service); ```
接口列表：
create_tableinsertremoveselectupdatedesc接口 create_table、insert、remove、update 的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
接口 select 会将返回值由 string 转换成 Vec<serde_json::Value> 格式。
接口 desc 返回 (String, Vec<String>) 类型，其中第一个值为主键字段，第二个值为普通字段列表。
通过 SQLService ，我们可以以 SQL 语句的方式来操作 TableCRUDService 相关接口。
```rust use fiscobcosservice::{ createweb3service, sql_service::SQLService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let sqlservice = SQLService::new(&web3_service); ```
接口列表：
executeCREATE TABLE 语句中，将忽略指定的字段类型，并且通过指定 PRIMARY KEY（有且仅有一个）来设置表单的 key 字段。
INSERT 语句中，必须设置 key 字段的值。SELECT 语句中，不支持联表查询。SELECT、UPDATE、DELETE 语句中，where 语句中必须指定 key 字段的值，多个语句之间仅支持 AND 操作（比如 name = "Tom" and age = "18"），单个条件仅支持 =、!=、>、<、>=、<= 操作，条件的值必须为字面值。ConsensusService 是对预编译合约 ConsensusPrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, precompiled::consensus_service::ConsensusService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let consensusservice = ConsensusService::new(&web3_service); ```
接口列表：
add_sealeradd_observerremove以上接口的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
CNSService 是对预编译合约 CNSPrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, cns_service::CNSService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let cnsservice = CNSService::new(&web3_service); ```
接口列表：
insertselect_by_nameselect_by_name_and_versionget_contract_address接口 insert 的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
接口 select_by_name 与 select_by_name_and_version 会将返回值由 string 转换成 serde_json::Value 格式。
接口 get_contract_address 会将返回值由 address 转换成 String 格式。
PermissionService 是对预编译合约 PermissionPrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, permission_service::PermissionService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let permissionservice = PermissionService::new(&web3_service); ```
接口列表：
insertremovequery_by_namegrant_writerevoke_writequery_permission接口 insert、remove、grant_write、 revoke_write 的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
接口 query_by_name 与 query_permission 会将返回值由 string 转换成 serde_json::Value 格式。
ContractLifeCycleService 是对预编译合约 ContractLifeCyclePrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, contractlifecycle_service::ContractLifeCycleService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let contractlifecycleservice = ContractLifeCycleService::new(&web3_service); ```
接口列表：
freezeunfreezegrant_managerget_statuslist_manager接口 freeze、unfreeze、grant_manager 的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
接口 get_status 的返回值为 (i32, String)，其中如果 i32 的值小于 0，将返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常。
接口 list_manager 的返回值为 (i32, Vec<String>)，其中如果 i32 的值小于 0，将返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常。
ChainGovernanceService 是对预编译合约 ChainGovernancePrecompiled 的封装。
```rust use fiscobcosservice::{ createweb3service, chaingovernanceservice::ChainGovernanceService, };
let configfilepath = "./configs/config.json"; let web3service = createweb3service(configfilepath).unwrap(); let chaingovernanceservice = ChainGovernanceService::new(&web3service); ```
接口列表：
grant_committee_memberrevoke_committee_memberlist_committee_membersquery_committee_member_weightupdate_committee_member_weightquery_votes_of_memberquery_votes_of_thresholdupdate_thresholdquery_thresholdgrant_operatorrevoke_operatorlist_operatorsfreeze_accountunfreeze_accountget_account_status接口 grant_committee_member、revoke_committee_member、update_committee_member_weight、update_threshold、query_threshold、grant_operator、revoke_operator、freeze_account、unfreeze_account 的返回值如果大于等于 0，返回此值，否则返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常，包含以下属性：
接口 query_committee_member_weight 的返回值为 (bool, i32)，其中如果 i32 的值小于 0，将返回 fisco_bcos_service::precompiled::precompiled_service::PrecompiledServiceError 异常。
接口 list_committee_members、query_votes_of_member、query_votes_of_threshold、list_operators 会将返回值由 string 转换成 serde_json::Value 格式。