This repository is the primary implementation of the Sway programming language and its toolchain, targeting the Fuel blockchain. It contains a full compiler pipeline (lexer, parser, AST, semantic analysis, IR with optimization passes, and code generation for the FuelVM), a package manager CLI (`forc`), a language server (`sway-lsp`), a code formatter (`swayfmt`), a debugger (`forc-debug`), a documentation generator (`forc-doc`), and a migration tool (`forc-migrate`). The standard library (`sway-lib-std`) provides essential blockchain primitives (assets, storage, crypto, etc.). The architecture is modular, with separate crates for the AST (`sway-ast`), IR (`sway-ir`), parsing (`sway-parse`), core compiler logic (`sway-core`), and error handling (`sway-error`). In production, developers use `forc` to build, test, and deploy Sway smart contracts, scripts, and predicates to the Fuel network. The LSP provides IDE features like completions, go-to-definition, and inlay hints. The formatter ensures consistent code style. The debugger enables step-through debugging of on-chain logic. The compiler supports multiple backends (FuelVM primary, EVM experimental) and includes advanced optimizations such as constant folding, dead code elimination, common subexpression elimination, and register allocation. Key entry points include `forc/src/main.rs` (CLI dispatcher), `sway-core/src/lib.rs` (compiler core), `sway-lsp/src/server.rs` (LSP server), and `swayfmt/src/lib.rs` (formatter). External dependencies include the Fuel protocol libraries (`fuel-core`, `fuel-vm`, `fuels-rs`), IPFS for package resolution, and standard Rust ecosystem crates. The repository is production-grade with extensive end-to-end tests, benchmarking infrastructure, and CI workflows.
Fuel Core is a production-grade Rust implementation of the Fuel blockchain node, serving as the execution layer for a modular rollup ecosystem. It operates as a full node with block production (PoA consensus via Redis leader lease), transaction pool, upgradable WASM-based execution, P2P networking (libp2p with gossipsub and request-response), an Ethereum relayer bridge, and a comprehensive GraphQL API for queries and transactions. The system uses a service-oriented architecture with clear port/adapter boundaries, allowing each subsystem (sync, compression, gas pricing, tx status management, etc.) to be independently tested and swapped. Key data flows include transaction submission through GraphQL or P2P gossip, verification by the txpool, inclusion in blocks by the producer, execution by the upgradable executor, and persistence to RocksDB. The codebase demonstrates high craftsmanship with clean abstractions, extensive integration and property-based testing, and a strong focus on performance and observability (Prometheus metrics, structured tracing). While it is primarily an application, it also includes research-grade components such as gas price algorithms (V0 and V1 with PD controllers) and block compression schemes.
This repository is the official TypeScript SDK for the Fuel Network blockchain, structured as a monorepo using pnpm and Turbo. It provides a comprehensive suite of libraries for wallet management, transaction construction, smart contract interaction (contracts, predicates, scripts), and code generation from Sway ABIs. The codebase includes a CLI tool (`fuels`) for project scaffolding, building, deploying, and running local test nodes. It supports both Node.js and browser environments, evidenced by dual build configurations and React-based dApp templates. The architecture relies heavily on generated GraphQL operations and external binary dependencies (`forc`, `fuel-core`) which are managed internally via installation scripts.