Icon Linkfuels-rs

Icon Link Icon Link Icon Link Icon Link

Rust SDK for Fuel. It can be used for a variety of things, including but not limited to:

• Compiling, deploying, and testing Sway Icon Link contracts;
• Launching a local Fuel network;
• Crafting and signing transactions with hand-crafted scripts or contract calls;
• Generating type-safe Rust bindings of contract methods;
• And more, fuels-rs is still in active development.

Icon LinkDocumentation

See the fuels-rs book

Icon LinkFeatures

• Launch Fuel nodes
• Deploy contracts
• Interact with deployed contracts
• Type-safe Sway contracts bindings code generation
• Run Sway scripts
• CLI for common operations
• Local test wallets
• Wallet integration
• Events querying/monitoring

Icon LinkFAQ

Icon LinkWhat dependencies do I need?

• The latest stable Rust toolchain;
• forc and fuel-core binaries.

Icon LinkHow can I run the SDK tests?

First, build the test projects using forc:

forc build --path packages/fuels

Then you can run the SDK tests with:

cargo test

You can also run specific tests. The following example will run all integration tests in types.rs whose names contain in_vector and show their outputs:

cargo test --test types in_vector -- --show-output

Icon LinkHow to run WASM tests?

You need to have wasm32 as a target, if you don't already:

 rustup target add wasm32-unknown-unknown

You also need wasm-pack, if you don't already:

cargo install wasm-pack

Navigate to packages/wasm-tests and run wasm-pack test.

Icon LinkWhat to do if my tests are failing on master

Before doing anything else, try all these commands:

cargo clean
rm Cargo.lock
forc build --path packages/fuels
cargo test

Icon LinkWhy is the prefix fuels and not fuel?

In order to make the SDK for Fuel feel familiar with those coming from the ethers.js Icon Link ecosystem, this project opted for an s at the end. The fuels-* family of SDKs is inspired by The Ethers Project.

Icon LinkHow can I run the docs locally?

Install mdbook by running:

cargo install mdbook

Next, navigate to the docs folder and run the command below to start a local server and open a new tab in you browser.

mdbook serve --open

You can build the book by running:

mdbook build