Repo brief: FuelLabs/fuel-core

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T00:40:29.318Z · commit add100d30d21

Verdict

Mixed — Evidence incomplete — review before adopting

• Last commit 1d ago
• 14 active contributors
• Distributed ownership (top contributor 22% of recent commits)
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

A Rust implementation of a full node for the Fuel v2 blockchain protocol. It provides consensus, transaction execution, block production, and P2P networking to participate in or validate the Fuel network. Core capability: runs the Fuel VM to execute contracts and maintain blockchain state across Ignition (mainnet), Testnet, and Devnet networks. Monorepo structured as a Cargo workspace: bin/ contains binaries (fuel-core node, keygen, e2e-test-client); crates/ holds reusable libraries (database, services, executor, p2p, consensus_module with bft/poa submodules); benches/ contains gas-cost and throughput benchmarks; tests/ for integration testing. Core node logic in bin/fuel-core/, execution…

Start here

Read these in order:

• benches/benches/utils.rs — Foundation: doesn't import anything internally and is imported by 4 other files. Read first to learn the vocabulary.
• crates/client/src/schema.rs — Foundation: imported by 2, no internal dependencies of its own.
• crates/fuel-core/src/database.rs — Built on the foundation; imported by 2 downstream files.
• benches/benches/block_target_gas_set/mod.rs — Built on the foundation; imported by 1 downstream file.
• benches/benches/vm_set/mod.rs — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/FuelLabs/fuel-core.git
cd fuel-core
rustup target add wasm32-unknown-unknown
cargo xtask build

System deps: On macOS run brew install cmake; on Debian run apt install -y cmake pkg-config build-essential git clang libclang-dev; on Arch run pacman -Syu --needed --noconfirm cmake gcc pkgconf git clang.

Daily commands:

For development:

cargo xtask build

For a local network:

make build

Then follow docs at https://docs.fuel.network/docs/node-operator/fuel-ignition/local-node/. For CI validation run:

source ci_checks.sh

Key cautions & unknowns

• Scorecard: default branch unprotected (0/10)
• Could not verify license from the available repository evidence
• Workspace resolver set to '2' to isolate dev-dependencies from production builds — do not downgrade. BUSL-1.1 license has a 4-year grace period before GPL conversion; verify commercial use restrictions.…
• License evidence is incomplete or ambiguous.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.