How fuellabs/fuels-rs works
fuels-rs is a Rust SDK for building applications on Fuel: it provides account and provider access, transaction construction, program deployment and calls, ABI/type support, and generated bindings. A typical workflow connects to a Fuel node, builds and signs a transaction, submits it, and parses the response; developers can also generate bindings from a contract ABI and launch local nodes for development. The graph combines documented product capabilities with relationships visible in sampled source and the source index; unsampled implementation details are not assumed.
Main entry points: provider.rs Node Provider · retryable_client.rs Retry Client · lib.rs Abigen Macro · transaction_builders.rs Transaction Builder
Components 26
Accounts and Access
- Node Provider
packages/fuels-accounts/src/provider.rs - Retry Client
packages/fuels-accounts/src/provider/retryable_client.rs - Provider Cache
packages/fuels-accounts/src/provider/cache.rs - Retry Policy
packages/fuels-accounts/src/provider/retry_util.rs - Coin Cache
packages/fuels-accounts/src/coin_cache.rs - Wallet and Signers
packages/fuels-accounts/src/wallet.rs
Core Types and Encoding
- ABI Encoder
packages/fuels-core/src/codec/abi_encoder.rs - ABI Decoder
packages/fuels-core/src/codec/abi_decoder.rs - Debug Decoder
packages/fuels-core/src/codec/abi_decoder/decode_as_debug_str.rs - ABI Logs
packages/fuels-core/src/codec/logs.rs - Tokenizable Types
packages/fuels-core/src/traits/tokenizable.rs - Transaction Builder
packages/fuels-core/src/types/transaction_builders.rs - Transaction Status
packages/fuels-core/src/types/tx_status.rs
Program Interaction
- Call Handler
packages/fuels-programs/src/calls/call_handler.rs - Receipt Parser
packages/fuels-programs/src/calls/receipt_parser.rs - Contract Storage
packages/fuels-programs/src/contract/storage.rs
Binding Generation
- Binding Generator
packages/fuels-code-gen/src/program_bindings/abigen/bindings/contract.rs - Resolved Types
packages/fuels-code-gen/src/program_bindings/resolved_type.rs - Abigen Macro
packages/fuels-macros/src/lib.rs - Macro Parsing
packages/fuels-macros/src/parse_utils.rs - Unique Names
packages/fuels-macros/src/parse_utils/unique_name_values.rs - Program Test Macro
packages/fuels-macros/src/setup_program_test/code_gen.rs
Local Development
- Local Node Service
packages/fuels-test-helpers/src/service.rs - Node Binary Service
packages/fuels-test-helpers/src/fuel_bin_service.rs
Other components
- SDK Developer
- Fuel Node
Connections 27
- SDK Developer → Node Provider: connects through
README.md - Node Provider → Retry Client: delegates requests
packages/fuels-accounts/src/provider.rs - Retry Client → Retry Policy: uses retry logic
packages/fuels-accounts/src/provider/retryable_client.rs - Retry Client → Fuel Node: queries node
- Node Provider → Provider Cache: uses cached client
packages/fuels-accounts/src/provider.rs - Node Provider → Coin Cache: checks coin cache
packages/fuels-accounts/src/provider.rs - SDK Developer → Wallet and Signers: crafts and signs
README.md - Wallet and Signers → Transaction Builder: signs transaction
- SDK Developer → Transaction Builder: builds transaction
README.md - Transaction Builder → Node Provider: estimates gas
packages/fuels-core/src/types/transaction_builders.rs - Node Provider → Fuel Node: submits transactions
- Node Provider → Transaction Status: tracks status
packages/fuels-accounts/src/provider.rs - SDK Developer → ABI Encoder: encodes values
- SDK Developer → ABI Decoder: decodes values
- ABI Decoder → Debug Decoder: formats decoded values
packages/fuels-core/src/codec/abi_decoder.rs - SDK Developer → Call Handler: calls contracts
README.md - Call Handler → Receipt Parser: parses receipts
- SDK Developer → Contract Storage: interacts with contracts
- SDK Developer → Abigen Macro: requests bindings
packages/fuels-macros/src/lib.rs - Abigen Macro → Binding Generator: generates bindings
packages/fuels-macros/src/lib.rs - Binding Generator → Resolved Types: resolves ABI types
- Abigen Macro → Macro Parsing: parses macro input
packages/fuels-macros/src/lib.rs - Macro Parsing → Unique Names: uses name validation
packages/fuels-macros/src/parse_utils.rs - SDK Developer → Program Test Macro: sets up program tests
- SDK Developer → Local Node Service: launches local node
README.md - Local Node Service → Node Binary Service: starts binary node
packages/fuels-test-helpers/src/service.rs - Node Binary Service → Fuel Node: launches node