如何用 fuels-rs 以自定义共识参数与创世币启动本地 Fuel 测试链【免费下载链接】fuels-rsFuel Network Rust SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-rs当你为合约或交易编写测试时默认启动的本地节点使用的是默认共识参数和随机生成的初始币。如果你的测试需要验证特定的交易限制如单交易最大 gas、最大输入数量或自定义费用参数并且要指定某个地址持有确定的创世币数量fuels-rsFuel Network Rust SDK提供了完整的操作路径通过fuels::test_helpers中的setup_test_provider()把自定义的ChainConfig包含共识参数和创世币一起交给一个短生命周期本地节点并拿回一个连接该节点的Provider。本文基于仓库内的 cookbook 文档 docs/src/cookbook/custom-chain.md 与对应示例 custom_chain 测试 编写。准备条件示例代码位于工作区成员 examples/cookbook其依赖声明如下可直接照抄到自己的项目fuels { version 0.77.0, features [default] } rand 0.8.5 tokio { version 1.34.0, features [full] }工作区 Cargo.toml 要求 Rust 工具链rust-version 1.93.0SDK 当前版本为0.77.0。启动本地节点有两种方式见 docs/src/connecting/short-lived.md在本机安装fuel-core节点二进制安装步骤参见 docs/src/getting-started.md 中指向的 Fuel 工具链安装指南或者启用fuel-core-libfeature把fuel-core作为库运行无需安装二进制fuels { version 0.77.0, features [fuel-core-lib] }。以下代码默认在#[tokio::test]中运行因为setup_test_provider是异步函数。第一步定义自定义共识参数ConsensusParameters由TxParameters、FeeParameters等子参数组成通过set_*方法写入。下面这段代码来自 cookbook 示例把单交易最大 gas 设为 1000、最大输入数设为 2、gas 价格因子设为 10use fuels::{ prelude::*, tx::{ConsensusParameters, FeeParameters, TxParameters}, }; let tx_params TxParameters::default() .with_max_gas_per_tx(1_000) .with_max_inputs(2); let fee_params FeeParameters::default().with_gas_price_factor(10); let mut consensus_parameters ConsensusParameters::default(); consensus_parameters.set_tx_params(tx_params); consensus_parameters.set_fee_params(fee_params); let chain_config ChainConfig { consensus_parameters, ..ChainConfig::default() };TxParameters和FeeParameters的其余字段保持默认值Default::default()后只覆盖了上述 builder 方法设置的字段ChainConfig除consensus_parameters外也全部取默认。第二步生成创世币并绑定到地址启动节点前先用setup_single_asset_coins造出创世币。它接收持有地址、资产 ID、币的数量和每枚币的数量返回VecCoin可直接传给setup_test_provider。示例中的持有者是一个随机生成的签名者let signer PrivateKeySigner::random(mut thread_rng()); let coins setup_single_asset_coins( signer.address(), Default::default(), DEFAULT_NUM_COINS, DEFAULT_COIN_AMOUNT, );其中资产 ID 传Default::default()即基础资产用于付 gasDEFAULT_NUM_COINS与DEFAULT_COIN_AMOUNT是fuels::test_helpers导出的常量定义在 packages/fuels-test-helpers/src/wallets_config.rsDEFAULT_NUM_COINS 1、DEFAULT_COIN_AMOUNT 1_000_000_000rand::thread_rng来自上面声明的rand依赖。如果需要多个资产或精确控制每种资产的币数与数量可以改用setup_multiple_assets_coins或setup_custom_assets_coins函数签名与说明见 packages/fuels-test-helpers/src/lib.rs。第三步启动节点并获取 Providersetup_test_provider的签名为pub async fn setup_test_provider( coins: VecCoin, messages: VecMessage, node_config: OptionNodeConfig, chain_config: OptionChainConfig, ) - ResultProvider第四个参数就是你前面构造的chain_config。节点行为由第三个参数NodeConfig控制默认值DbType::InMemory、utxo_validation: true、Trigger::Instant、silent: true等定义在 packages/fuels-test-helpers/src/node_types.rs一般测试场景直接取默认即可let node_config NodeConfig::default(); let _provider setup_test_provider(coins, vec![], Some(node_config), Some(chain_config)).await?;调用成功后Provider已连接到一个运行你自定义ChainConfig的本地节点节点进程随测试进程存活测试结束后由setup_test_provider内部持有的句柄一并释放源码中通过tokio::spawnpending()持有句柄直到 provider 侧生命周期结束见 packages/fuels-test-helpers/src/lib.rs。注意如果第四个参数传Nonesetup_test_provider会回退到一个内置的 testnet 配置——它把交易大小上限提到10_000_000、合约大小上限提到1_000_000。要精确控制共识参数时必须显式传入Some(chain_config)。验证共识参数与链配置确实生效仓库内的测试用例给出了两种核对方式可直接照搬方式一整份对比共识参数。调用provider.consensus_parameters()取回链上生效的参数与本地构造的ConsensusParameters直接相等比较见 test_setup_test_client_consensus_parameters_configlet retrieved_parameters provider.consensus_parameters().await?; assert_eq!(retrieved_parameters, consensus_parameters);方式二通过chain_info()抽查关键字段。如果ChainConfig里还设置了chain_name等字段可以用provider.chain_info()核对链名与具体参数值见 test_chain_config_and_consensus_parameterslet chain_info provider.chain_info().await?; assert_eq!(chain_info.name, chain_name); assert_eq!( chain_info.consensus_parameters.tx_params().max_inputs(), max_inputs );用cargo test运行测试若测试通过输出默认被隐藏需要查看println!输出时可加-- --nocapture见 docs/src/testing/basics.md。限制与注意事项该流程启动的是短生命周期、内存数据库的测试节点定位为合约/交易测试环境不是持久化部署方案。需要持久存储时可在NodeConfig中把database_type设为DbType::RocksDb(Some(path))并配合rocksdbfeature 使用见 docs/src/connecting/short-lived.md 与 examples/cookbook/src/lib.rs 中的create_or_use_rocksdb示例。示例中的数值1_000、2、10是 cookbook 演示用的配置值应按自己的测试目标替换本文档不承诺这些数值对真实网络有任何含义。ChainConfig、NodeConfig等类型来自fuel-core-chain-config/fuels-test-helpers字段含义以 packages/fuels-test-helpers/src/node_types.rs 中的定义为准不要凭字段名推断未在文档中说明的行为。完整参考实现docs/src/cookbook/custom-chain.md 对应的 custom_chain 测试以及参数验证测试所在的 packages/fuels-test-helpers/src/lib.rs。【免费下载链接】fuels-rsFuel Network Rust SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-rs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何用 fuels-rs 以自定义共识参数与创世币启动本地 Fuel 测试链【免费下载链接】fuels-rsFuel Network Rust SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-rs当你为合约或交易编写测试时默认启动的本地节点使用的是默认共识参数和随机生成的初始币。如果你的测试需要验证特定的交易限制如单交易最大 gas、最大输入数量或自定义费用参数并且要指定某个地址持有确定的创世币数量fuels-rsFuel Network Rust SDK提供了完整的操作路径通过fuels::test_helpers中的setup_test_provider()把自定义的ChainConfig包含共识参数和创世币一起交给一个短生命周期本地节点并拿回一个连接该节点的Provider。本文基于仓库内的 cookbook 文档 docs/src/cookbook/custom-chain.md 与对应示例 custom_chain 测试 编写。准备条件示例代码位于工作区成员 examples/cookbook其依赖声明如下可直接照抄到自己的项目fuels { version 0.77.0, features [default] } rand 0.8.5 tokio { version 1.34.0, features [full] }工作区 Cargo.toml 要求 Rust 工具链rust-version 1.93.0SDK 当前版本为0.77.0。启动本地节点有两种方式见 docs/src/connecting/short-lived.md在本机安装fuel-core节点二进制安装步骤参见 docs/src/getting-started.md 中指向的 Fuel 工具链安装指南或者启用fuel-core-libfeature把fuel-core作为库运行无需安装二进制fuels { version 0.77.0, features [fuel-core-lib] }。以下代码默认在#[tokio::test]中运行因为setup_test_provider是异步函数。第一步定义自定义共识参数ConsensusParameters由TxParameters、FeeParameters等子参数组成通过set_*方法写入。下面这段代码来自 cookbook 示例把单交易最大 gas 设为 1000、最大输入数设为 2、gas 价格因子设为 10use fuels::{ prelude::*, tx::{ConsensusParameters, FeeParameters, TxParameters}, }; let tx_params TxParameters::default() .with_max_gas_per_tx(1_000) .with_max_inputs(2); let fee_params FeeParameters::default().with_gas_price_factor(10); let mut consensus_parameters ConsensusParameters::default(); consensus_parameters.set_tx_params(tx_params); consensus_parameters.set_fee_params(fee_params); let chain_config ChainConfig { consensus_parameters, ..ChainConfig::default() };TxParameters和FeeParameters的其余字段保持默认值Default::default()后只覆盖了上述 builder 方法设置的字段ChainConfig除consensus_parameters外也全部取默认。第二步生成创世币并绑定到地址启动节点前先用setup_single_asset_coins造出创世币。它接收持有地址、资产 ID、币的数量和每枚币的数量返回VecCoin可直接传给setup_test_provider。示例中的持有者是一个随机生成的签名者let signer PrivateKeySigner::random(mut thread_rng()); let coins setup_single_asset_coins( signer.address(), Default::default(), DEFAULT_NUM_COINS, DEFAULT_COIN_AMOUNT, );其中资产 ID 传Default::default()即基础资产用于付 gasDEFAULT_NUM_COINS与DEFAULT_COIN_AMOUNT是fuels::test_helpers导出的常量定义在 packages/fuels-test-helpers/src/wallets_config.rsDEFAULT_NUM_COINS 1、DEFAULT_COIN_AMOUNT 1_000_000_000rand::thread_rng来自上面声明的rand依赖。如果需要多个资产或精确控制每种资产的币数与数量可以改用setup_multiple_assets_coins或setup_custom_assets_coins函数签名与说明见 packages/fuels-test-helpers/src/lib.rs。第三步启动节点并获取 Providersetup_test_provider的签名为pub async fn setup_test_provider( coins: VecCoin, messages: VecMessage, node_config: OptionNodeConfig, chain_config: OptionChainConfig, ) - ResultProvider第四个参数就是你前面构造的chain_config。节点行为由第三个参数NodeConfig控制默认值DbType::InMemory、utxo_validation: true、Trigger::Instant、silent: true等定义在 packages/fuels-test-helpers/src/node_types.rs一般测试场景直接取默认即可let node_config NodeConfig::default(); let _provider setup_test_provider(coins, vec![], Some(node_config), Some(chain_config)).await?;调用成功后Provider已连接到一个运行你自定义ChainConfig的本地节点节点进程随测试进程存活测试结束后由setup_test_provider内部持有的句柄一并释放源码中通过tokio::spawnpending()持有句柄直到 provider 侧生命周期结束见 packages/fuels-test-helpers/src/lib.rs。注意如果第四个参数传Nonesetup_test_provider会回退到一个内置的 testnet 配置——它把交易大小上限提到10_000_000、合约大小上限提到1_000_000。要精确控制共识参数时必须显式传入Some(chain_config)。验证共识参数与链配置确实生效仓库内的测试用例给出了两种核对方式可直接照搬方式一整份对比共识参数。调用provider.consensus_parameters()取回链上生效的参数与本地构造的ConsensusParameters直接相等比较见 test_setup_test_client_consensus_parameters_configlet retrieved_parameters provider.consensus_parameters().await?; assert_eq!(retrieved_parameters, consensus_parameters);方式二通过chain_info()抽查关键字段。如果ChainConfig里还设置了chain_name等字段可以用provider.chain_info()核对链名与具体参数值见 test_chain_config_and_consensus_parameterslet chain_info provider.chain_info().await?; assert_eq!(chain_info.name, chain_name); assert_eq!( chain_info.consensus_parameters.tx_params().max_inputs(), max_inputs );用cargo test运行测试若测试通过输出默认被隐藏需要查看println!输出时可加-- --nocapture见 docs/src/testing/basics.md。限制与注意事项该流程启动的是短生命周期、内存数据库的测试节点定位为合约/交易测试环境不是持久化部署方案。需要持久存储时可在NodeConfig中把database_type设为DbType::RocksDb(Some(path))并配合rocksdbfeature 使用见 docs/src/connecting/short-lived.md 与 examples/cookbook/src/lib.rs 中的create_or_use_rocksdb示例。示例中的数值1_000、2、10是 cookbook 演示用的配置值应按自己的测试目标替换本文档不承诺这些数值对真实网络有任何含义。ChainConfig、NodeConfig等类型来自fuel-core-chain-config/fuels-test-helpers字段含义以 packages/fuels-test-helpers/src/node_types.rs 中的定义为准不要凭字段名推断未在文档中说明的行为。完整参考实现docs/src/cookbook/custom-chain.md 对应的 custom_chain 测试以及参数验证测试所在的 packages/fuels-test-helpers/src/lib.rs。【免费下载链接】fuels-rsFuel Network Rust SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-rs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
