# fuellabs/fuels-rs architecture

> Architecture diagram of the GitHub repository fuellabs/fuels-rs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fuellabs/fuels-rs
- Repository: https://github.com/fuellabs/fuels-rs

## Overview

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: [`packages/fuels-accounts/src/provider.rs`](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider.rs) (Node Provider), [`packages/fuels-accounts/src/provider/retryable_client.rs`](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/retryable_client.rs) (Retry Client), [`packages/fuels-macros/src/lib.rs`](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/lib.rs) (Abigen Macro), [`packages/fuels-core/src/types/transaction_builders.rs`](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/types/transaction_builders.rs) (Transaction Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and Access"]
  node_provider["Node Provider<br/>[provider.rs]"]
  node_retry["Retry Client"]
  node_provider_cache["Provider Cache<br/>[cache.rs]"]
  node_retry_policy["Retry Policy<br/>[retry_util.rs]"]
  node_coin_cache["Coin Cache<br/>[coin_cache.rs]"]
  node_wallet_signers["Wallet and Signers<br/>[wallet.rs]"]
end

subgraph group_core["Core Types and Encoding"]
  node_abi_encoder["ABI Encoder<br/>[abi_encoder.rs]"]
  node_abi_decoder["ABI Decoder<br/>[abi_decoder.rs]"]
  node_debug_decode["Debug Decoder"]
  node_abi_logs["ABI Logs<br/>[logs.rs]"]
  node_tokenizable["Tokenizable Types<br/>[tokenizable.rs]"]
  node_transaction_builder["Transaction Builder"]
  node_transaction_status["Transaction Status<br/>[tx_status.rs]"]
end

subgraph group_programs["Program Interaction"]
  node_call_handler["Call Handler<br/>[call_handler.rs]"]
  node_receipt_parser["Receipt Parser<br/>[receipt_parser.rs]"]
  node_contract_storage["Contract Storage<br/>[storage.rs]"]
end

subgraph group_generation["Binding Generation"]
  node_binding_codegen["Binding Generator<br/>[contract.rs]"]
  node_resolved_types["Resolved Types<br/>[resolved_type.rs]"]
  node_abigen_macro["Abigen Macro<br/>[lib.rs]"]
  node_macro_parsing["Macro Parsing<br/>[parse_utils.rs]"]
  node_unique_names["Unique Names"]
  node_program_test_macro["Program Test Macro<br/>[code_gen.rs]"]
end

subgraph group_local["Local Development"]
  node_local_service["Local Node Service<br/>[service.rs]"]
  node_binary_service["Node Binary Service"]
end

node_developer(("SDK Developer"))
node_fuel_node["Fuel Node"]

node_developer -->|"connects through"| node_provider
node_provider -->|"delegates requests"| node_retry
node_retry -->|"uses retry logic"| node_retry_policy
node_retry -.->|"queries node"| node_fuel_node
node_provider -->|"uses cached client"| node_provider_cache
node_provider -->|"checks coin cache"| node_coin_cache
node_developer -->|"crafts and signs"| node_wallet_signers
node_wallet_signers -.->|"signs transaction"| node_transaction_builder
node_developer -->|"builds transaction"| node_transaction_builder
node_transaction_builder -->|"estimates gas"| node_provider
node_provider -.->|"submits transactions"| node_fuel_node
node_provider -->|"tracks status"| node_transaction_status
node_developer -.->|"encodes values"| node_abi_encoder
node_developer -.->|"decodes values"| node_abi_decoder
node_abi_decoder -->|"formats decoded values"| node_debug_decode
node_developer -->|"calls contracts"| node_call_handler
node_call_handler -.->|"parses receipts"| node_receipt_parser
node_developer -.->|"interacts with contracts"| node_contract_storage
node_developer -->|"requests bindings"| node_abigen_macro
node_abigen_macro -->|"generates bindings"| node_binding_codegen
node_binding_codegen -.->|"resolves ABI types"| node_resolved_types
node_abigen_macro -->|"parses macro input"| node_macro_parsing
node_macro_parsing -->|"uses name validation"| node_unique_names
node_developer -->|"sets up program tests"| node_program_test_macro
node_developer -->|"launches local node"| node_local_service
node_local_service -->|"starts binary node"| node_binary_service
node_binary_service -.->|"launches node"| node_fuel_node

click node_provider "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider.rs"
click node_retry "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/retryable_client.rs"
click node_provider_cache "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/cache.rs"
click node_retry_policy "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/retry_util.rs"
click node_coin_cache "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/coin_cache.rs"
click node_wallet_signers "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/wallet.rs"
click node_abi_encoder "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_encoder.rs"
click node_abi_decoder "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_decoder.rs"
click node_debug_decode "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_decoder/decode_as_debug_str.rs"
click node_abi_logs "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/logs.rs"
click node_tokenizable "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/traits/tokenizable.rs"
click node_transaction_builder "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/types/transaction_builders.rs"
click node_transaction_status "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/types/tx_status.rs"
click node_call_handler "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/calls/call_handler.rs"
click node_receipt_parser "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/calls/receipt_parser.rs"
click node_contract_storage "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/contract/storage.rs"
click node_binding_codegen "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-code-gen/src/program_bindings/abigen/bindings/contract.rs"
click node_resolved_types "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-code-gen/src/program_bindings/resolved_type.rs"
click node_abigen_macro "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/lib.rs"
click node_macro_parsing "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/parse_utils.rs"
click node_unique_names "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/parse_utils/unique_name_values.rs"
click node_program_test_macro "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/setup_program_test/code_gen.rs"
click node_local_service "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-test-helpers/src/service.rs"
click node_binary_service "https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-test-helpers/src/fuel_bin_service.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_provider,node_retry,node_provider_cache,node_retry_policy,node_coin_cache,node_wallet_signers toneBlue
class node_abi_encoder,node_abi_decoder,node_debug_decode,node_abi_logs,node_tokenizable,node_transaction_builder,node_transaction_status toneAmber
class node_call_handler,node_receipt_parser,node_contract_storage toneMint
class node_binding_codegen,node_resolved_types,node_abigen_macro,node_macro_parsing,node_unique_names,node_program_test_macro toneRose
class node_local_service,node_binary_service,node_developer,node_fuel_node toneIndigo
```

## Components

### Accounts and Access

- [Node Provider](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider.rs): `packages/fuels-accounts/src/provider.rs`
- [Retry Client](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/retryable_client.rs): `packages/fuels-accounts/src/provider/retryable_client.rs`
- [Provider Cache](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/cache.rs): `packages/fuels-accounts/src/provider/cache.rs`
- [Retry Policy](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/provider/retry_util.rs): `packages/fuels-accounts/src/provider/retry_util.rs`
- [Coin Cache](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/coin_cache.rs): `packages/fuels-accounts/src/coin_cache.rs`
- [Wallet and Signers](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-accounts/src/wallet.rs): `packages/fuels-accounts/src/wallet.rs`

### Core Types and Encoding

- [ABI Encoder](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_encoder.rs): `packages/fuels-core/src/codec/abi_encoder.rs`
- [ABI Decoder](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_decoder.rs): `packages/fuels-core/src/codec/abi_decoder.rs`
- [Debug Decoder](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/abi_decoder/decode_as_debug_str.rs): `packages/fuels-core/src/codec/abi_decoder/decode_as_debug_str.rs`
- [ABI Logs](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/codec/logs.rs): `packages/fuels-core/src/codec/logs.rs`
- [Tokenizable Types](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/traits/tokenizable.rs): `packages/fuels-core/src/traits/tokenizable.rs`
- [Transaction Builder](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/types/transaction_builders.rs): `packages/fuels-core/src/types/transaction_builders.rs`
- [Transaction Status](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-core/src/types/tx_status.rs): `packages/fuels-core/src/types/tx_status.rs`

### Program Interaction

- [Call Handler](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/calls/call_handler.rs): `packages/fuels-programs/src/calls/call_handler.rs`
- [Receipt Parser](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/calls/receipt_parser.rs): `packages/fuels-programs/src/calls/receipt_parser.rs`
- [Contract Storage](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-programs/src/contract/storage.rs): `packages/fuels-programs/src/contract/storage.rs`

### Binding Generation

- [Binding Generator](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-code-gen/src/program_bindings/abigen/bindings/contract.rs): `packages/fuels-code-gen/src/program_bindings/abigen/bindings/contract.rs`
- [Resolved Types](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-code-gen/src/program_bindings/resolved_type.rs): `packages/fuels-code-gen/src/program_bindings/resolved_type.rs`
- [Abigen Macro](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/lib.rs): `packages/fuels-macros/src/lib.rs`
- [Macro Parsing](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/parse_utils.rs): `packages/fuels-macros/src/parse_utils.rs`
- [Unique Names](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/parse_utils/unique_name_values.rs): `packages/fuels-macros/src/parse_utils/unique_name_values.rs`
- [Program Test Macro](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-macros/src/setup_program_test/code_gen.rs): `packages/fuels-macros/src/setup_program_test/code_gen.rs`

### Local Development

- [Local Node Service](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-test-helpers/src/service.rs): `packages/fuels-test-helpers/src/service.rs`
- [Node Binary Service](https://github.com/fuellabs/fuels-rs/blob/master/packages/fuels-test-helpers/src/fuel_bin_service.rs): `packages/fuels-test-helpers/src/fuel_bin_service.rs`

### Other components

- **SDK Developer**
- **Fuel Node**

## Connections

- SDK Developer → Node Provider: connects through (evidence: `README.md`)
- Node Provider → Retry Client: delegates requests (evidence: `packages/fuels-accounts/src/provider.rs`)
- Retry Client → Retry Policy: uses retry logic (evidence: `packages/fuels-accounts/src/provider/retryable_client.rs`)
- Retry Client → Fuel Node: queries node
- Node Provider → Provider Cache: uses cached client (evidence: `packages/fuels-accounts/src/provider.rs`)
- Node Provider → Coin Cache: checks coin cache (evidence: `packages/fuels-accounts/src/provider.rs`)
- SDK Developer → Wallet and Signers: crafts and signs (evidence: `README.md`)
- Wallet and Signers → Transaction Builder: signs transaction
- SDK Developer → Transaction Builder: builds transaction (evidence: `README.md`)
- Transaction Builder → Node Provider: estimates gas (evidence: `packages/fuels-core/src/types/transaction_builders.rs`)
- Node Provider → Fuel Node: submits transactions
- Node Provider → Transaction Status: tracks status (evidence: `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 (evidence: `packages/fuels-core/src/codec/abi_decoder.rs`)
- SDK Developer → Call Handler: calls contracts (evidence: `README.md`)
- Call Handler → Receipt Parser: parses receipts
- SDK Developer → Contract Storage: interacts with contracts
- SDK Developer → Abigen Macro: requests bindings (evidence: `packages/fuels-macros/src/lib.rs`)
- Abigen Macro → Binding Generator: generates bindings (evidence: `packages/fuels-macros/src/lib.rs`)
- Binding Generator → Resolved Types: resolves ABI types
- Abigen Macro → Macro Parsing: parses macro input (evidence: `packages/fuels-macros/src/lib.rs`)
- Macro Parsing → Unique Names: uses name validation (evidence: `packages/fuels-macros/src/parse_utils.rs`)
- SDK Developer → Program Test Macro: sets up program tests
- SDK Developer → Local Node Service: launches local node (evidence: `README.md`)
- Local Node Service → Node Binary Service: starts binary node (evidence: `packages/fuels-test-helpers/src/service.rs`)
- Node Binary Service → Fuel Node: launches node
