燃料客户端

燃料客户端实现。

贡献

如果您有兴趣为Fuel做出贡献，请参阅我们的 CONTRIBUTING.md 文件，了解编码标准和审查流程。

在推送任何更改或创建pull request之前，请运行 source ci_checks.sh。

构建

系统要求

包括clang在内的几个系统要求。

MacOS

brew update
brew install cmake

Debian

apt update
apt install -y cmake pkg-config build-essential git clang libclang-dev

Arch

pacman -Syu --needed --noconfirm cmake gcc pkgconf git clang

Rust配置

您需要安装 wasm32-unknown-unknown 目标。

rustup target add wasm32-unknown-unknown

编译

我们建议使用 xtask 构建 fuel-core

cargo xtask build

这将运行 cargo build 以及任何其他自定义构建过程，例如为客户端重新生成GraphQL模式。

测试

可以使用 ci_checks.sh 脚本文件来运行所有 CI 检查，包括测试的运行。

source ci_checks.sh

脚本需要预先安装的工具。更多信息请运行

cat ci_checks.sh

运行

可以通过执行 fuel-core run 来启动服务。运行选项的列表可以通过 help 选项访问。

$ ./target/debug/fuel-core run --help

USAGE:
    fuel-core run [OPTIONS]

OPTIONS:
        --snapshot <SNAPSHOT>
          Snapshot from which to do (re)genesis. Defaults to local testnet configuration

          [env: SNAPSHOT=]
        ...

对于许多开发目的，拥有一个不会持久化的状态非常有用，可以将 db-type 选项设置为 in-memory，如下例所示。

示例

$ ./target/debug/fuel-core run --db-type in-memory
2023-06-13T12:45:22.860536Z  INFO fuel_core::cli::run: 230: Block production mode: Instant
2023-06-13T12:38:47.059783Z  INFO fuel_core::cli::run: 310: Fuel Core version v0.18.1
2023-06-13T12:38:47.078969Z  INFO new{name=fuel-core}:_commit_result{block_id=b1807ca9f2eec7e459b866ecf69b68679fc6b205a9a85c16bd4943d1bfc6fb2a height=0 tx_status=[]}: fuel_core_importer::importer: 231: Committed block
2023-06-13T12:38:47.097777Z  INFO new{name=fuel-core}: fuel_core::graphql_api::service: 208: Binding GraphQL provider to 127.0.0.1:4000

要禁用本地节点上的区块生产，设置 --poa-instant=false

示例

$ ./target/debug/fuel-core run --poa-instant=false
2023-06-13T12:44:12.857763Z  INFO fuel_core::cli::run: 232: Block production disabled

故障排除

发布

我们使用 publish-crates 动作来自动发布所有 crate。

如果您在发布时遇到问题，可以使用 act 在本地进行故障排除。

act release -s GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> -j publish-crates-check --container-architecture linux/amd64 --reuse

它需要 GitHubToken 来对 GitHub 进行请求。您可以使用 此 指令创建它。

过时数据库

如果您遇到以下错误

thread 'main' panicked at 'unable to open database: DatabaseError(Error { message: "Invalid argument: Column families not opened: column-11, column-10, column-9, column-8, column-7, column-6, column-5, column-4, column-3, column-2, column-1, column-0" })', fuel-core/src/main.rs:23:66

使用以下命令清除本地数据库： rm -rf ~/.fuel/db

文件描述符限制

在某些 macOS 版本中，默认的文件描述符限制相当低，这可能导致出现类似 Too many open files 或甚至在 RocksDB 遇到这些问题时 fatal runtime error: Rust cannot catch foreign exceptions 的 IO 错误。使用以下命令增加打开文件限制。请注意，这仅影响当前 shell 会话，因此考虑将其添加到 ~/.zshrc。

ulimit -n 10240

日志级别

该服务依赖于环境变量 RUST_LOG。更多详细信息，请检查 EnvFilter 示例 crate。

可以使用环境变量 HUMAN_LOGGING=false

调试指南

有关运行本地节点调试构建的概述，请参阅 调试指南。

Docker & Kubernetes

# Create Docker Image
docker build -t fuel-core . -f deployment/Dockerfile

# Delete Docker Image
docker image rm fuel-core

# Create Kubernetes Volume, Deployment & Service
kubectl create -f deployment/fuel-core.yml

# Delete Kubernetes Volume, Deployment & Service
kubectl delete -f deployment/fuel-core.yml

GraphQL 服务

客户端功能通过一个期望 GraphQL 查询的服务端点提供。

事务执行器

事务执行器目前执行即时区块生产。更改默认情况下持久化到 RocksDB。

• 服务端点： /v1/graphql
• 模式（在构建后可用）： crates/client/assets/schema.sdl

该服务期望一个定义为 submit 的变异，它接收一个 Transaction，以十六进制编码的二进制格式表示，如 此处 所述。

cURL 示例

此示例将执行一个表示以下序列的 ASM 脚本。

ADDI(0x10, RegId::ZERO, 0xca),
ADDI(0x11, RegId::ZERO, 0xba),
LOG(0x10, 0x11, RegId::ZERO, RegId::ZERO),
RET(RegId::ONE),

$ cargo run --bin fuel-core-client -- transaction submit \
"{\"Script\":{\"script_gas_limit\":1000000,\"policies\":{\"bits\":\"GasPrice\",\"values\":[0,0,0,0]},\"maturity\":0,\"script\":[80,64,0,202,80,68,0,186,51,65,16,0,36,4,0,0],\"script_data\":[],\"inputs\":[
{
  \"CoinSigned\": {
    \"utxo_id\": {
      \"tx_id\": \"c49d65de61cf04588a764b557d25cc6c6b4bc0d7429227e2a21e61c213b3a3e2\",
      \"output_index\": 0
    },
    \"owner\": \"f1e92c42b90934aa6372e30bc568a326f6e66a1a0288595e6e3fbd392a4f3e6e\",
    \"amount\": 10599410012256088338,
    \"asset_id\": \"2cafad611543e0265d89f1c2b60d9ebf5d56ad7e23d9827d6b522fd4d6e44bc3\",
    \"tx_pointer\": {
      \"block_height\": 0,
      \"tx_index\": 0
    },
    \"witness_index\": 0,
    \"maturity\": 0,
    \"predicate_gas_used\": null,
    \"predicate\": null,
    \"predicate_data\": null
  }
}],\"outputs\":[],\"witnesses\":[{
  \"data\": [
    150,31,98,51,6,239,255,243,45,35,182,26,129,152,46,95,45,211,114,58,51,64,129,194,97,14,181,70,190,37,106,223,170,174,221,230,87,239,67,224,100,137,25,249,193,14,184,195,15,85,156,82,91,78,91,80,126,168,215,170,139,48,19,5
  ]
}],\"receipts_root\":\"0x6114142d12e0f58cfb8c72c270cd0535944fb1ba763dce83c17e882c482224a2\"}}"

lib.rs:

Crate fuel-core-storage 包含存储类型、原语和表，这些类型和原语被 fuel-core 使用。此 crate 不包含实际的实现，它围绕 Database 工作，并由服务使用以提供默认实现。在此定义的原语被服务使用，但足以在 Database 已知时自定义逻辑。