Repository navigation
Releases: argotorg/fe
Release list
v26.4.1
Changelog
26.4.1 (2026-09-30)
Bugfixes
- The borrow checker no longer misses moves and borrows of compile-time constant values. Moving a constant non-
Copyvalue twice, matching the same value by value twice, or reading a local while amutborrow of it is live is now rejected, as it already was for runtime values. Passing an unannotated string literal to a genericownparameter more than once is no longer reported as a move conflict. (#1649) - A
mut selfmethod that uses aStorageMaporStorageBytesfield is no longer rejected with a borrow conflict when called on a contract field whose struct has other fields, for example from arecvhandler. (#1659)
v26.4.0
Changelog
26.4.0 (2026-09-30)
Features
- Added experimental host-native executable builds for standalone Fe files on
x86-64 Linux and AArch64 macOS. Build Fe with thecraneliftfeature and pass
--backend nativeto produce an executable frompub fn main() -> i32. (#1549) - Track ownership and borrows through tuples, structs, arrays, pointer aliases, and helper calls with a structural borrow checker. Borrow information is preserved when references are returned inside aggregates, so overlapping live borrows are rejected after tuple destructuring as well as after a direct return. (#1557)
- Validate generic calls' ownership and borrow requirements when their concrete trait implementations are selected. Checks that depend on an unresolved implementation remain explicitly pending; executable calls without a concrete implementation or a compiler-provided effect contract are rejected. (#1557)
- Extended the experimental native backend to whole workspaces, including dependencies.
fe test --backend nativeruns tests as native executables, andstd::ioprovides character input and output through the host. (#1565) - Native programs can receive process arguments by declaring
pub fn main(argc: i32, argv: **u8) -> i32and reading them through the bounds-checkedstd::native::Args.std::native::cpu_clock_ticksreturns the process CPU time. (#1566) - Added
std::native::ByteBuffer, an explicitly owned heap byte buffer for native programs with fallible growth that keeps existing data, zero initialization, overlap-safe copying and an explicitrelease. (#1580) - Const functions can take immutable trait providers through
usesand supply them withwith, including forwarding through generic const functions, calls to const trait methods, andrefborrows of a provider such asref selfmethod calls. Mutable effects, type-keyed (storage) effects and extern functions with effects are rejected. (#1582) - Const functions can borrow their own locals and parameters with
mutandref, so helpers that update a value in place, or take amutargument, now evaluate at compile time. Returning a borrow of a local from the function that owns it is rejected during evaluation. (#1582) - Add
core::text::concat_slicefor runtime-length string slices andTextBuilderfor incremental byte-preserving text construction, also available throughstd::text. - Add
std::evm::checksum_addressfor ERC-55 checksummed address formatting. Expand regression coverage of the existingcore::num::isqrtacross power-of-two and maximum-square boundaries. - Add
std::evm::cloneshelpers for ERC-1167 initcode, CREATE/CREATE2 deployment and deterministic address prediction. - Add overflow-safe EIP-150 gas-budget admission and Call::call_with_min_gas, with a caller reserve, prepaid input memory and no automatic returndata copy.
- Added
Call::try_call_intoandCall::try_static_into, which copy at most the capacity of a caller-provided buffer so oversized returndata cannot force a large copy, plusCall::send_valuefor plain value transfers andCall::try_call_rawfor forwarding raw calldata.Call::static,Call::try_staticandAddress::staticnow only need a read-onlyCalleffect. Addedstd::evm::erc165with OpenZeppelinERC165Checkersemantics andAddress::from_word_truncate. - Added
core::num::leading_zerosandcore::num::trailing_zerosforu256. Both return 256 for zero.leading_zeroscompiles to the EVMCLZinstruction (EIP-7939) and to a branch-free bit search for native targets; both functions are also available in constant evaluation. - Added
core::panic_code(code), which reverts with the SolidityPanic(uint256)payload, and thecore::panics::PANIC_*constants (re-exported fromstd::evm::panic). Out-of-boundscore::ptraccesses now revert withPanic(0x32)instead ofINVALID. On native targets the call traps. - Added
core::text(re-exported asstd::text) withconcat,decimal,hex,hex_upperandbase64for buildingDynStringvalues, plusDynString::slice,DynString::from_word_prefix,DynString::zeroedandEqforBytesandDynString. - Added
std::evm::SolSlotfor Solidity storage layouts at runtime slots:read/writeaccess a packed state variable at a byte offset without touching its neighbours (forbool,Address, all integer widths includingsol::Int24etc., andFixedBytes<N>), andread_bytes/read_string/write_bytes/write_stringuse Solidity'sbytes/stringstorage layout. Also addedstd::evm::SolMapping, which derivesmappingslots like Solidity for a runtime root, including nested mappings. Custom-width Solidity ints now implementStorageKey. - Added
std::evm::keccak_words([..])for hashing a fixed list of words andstd::evm::create2_address(deployer, salt, init_code_hash).keccak_packedandencode_packednow write each value directly at its packed width instead of going through thePackedbuilder, which makes them about four times cheaper, and custom-width Solidity ints (sol::Int24etc.) now implementEncodePacked. - Added
std::evm::merklefor keccak Merkle proofs:verify,process_proofandhash_pair_sortedmatch OpenZeppelin'sMerkleProoffor sorted-pair trees, andverify_indexed/process_indexed_proofcheck positional proofs where bitiof the leaf index picks the side at leveli(as in Seaport bulk order signatures). Proofs are read in place from aMemSlice<u256>or a decodedbytes32[]/uint256[](DynArray<Bytes32>/DynArray<u256>). - Added full-precision
mul_div,mul_div_ceil,checked_mul_div,checked_mul_div_ceilandfull_multocore::num. They computea * b / dwith a 512-bit intermediate product, so results are exact whenever the quotient fits in au256.mul_divandmul_div_ceilfail like checked arithmetic (division by zero, or overflow when the quotient does not fit), and thechecked_variants returnNoneinstead.addmodandmulmodare now available ascore::num::addmodandcore::num::mulmodtoo;std::evm::addmodandstd::evm::mulmodremain available. - Added non-reverting token helpers that return a classified
std::evm::TokenCalloutcome (Ok,Reverted,BadReturn,NoCode) so callers can raise their own errors:erc20::try_transfer,try_transfer_fromandtry_approve(Solady/OpenZeppelin semantics, bounded 32-byte returndata copy), plus the newstd::evm::erc721::try_transfer_fromandstd::evm::erc1155::try_safe_transfer_from/try_safe_batch_transfer_from.erc721::check_on_receivedclassifies anonERC721Receivedhook as aReceiverCheck(Accepted,WrongMagic,BadReturn,Reverted,NoCode). - Fields and array elements reached through a temporary pointer, such as
f().valueor(*f()).items[i], can now be assigned, compound-assigned and borrowed withreformut, just like those reached through a pointer variable.
Bugfixes
-
Fix resolution and validation of default type and const arguments, including dependent defaults in generic function and method calls.
Fix compiler panics and incorrect trait dispatch when using functions and enum variant constructors as values. (#1535)
-
Fix copying arrays returned from functions so that modifying a copy no longer changes the original array. This also fixes copies of nested arrays while preserving explicit reference semantics. (#1555)
-
Allow generic constants to contain array repeats with symbolic lengths and indices and use them in branches, enum matches, casts, and type-level expressions. Evaluation now preserves bounds checks, operand failures, and assertion diagnostics through specialization. (#1556)
-
Preserve native
refandmutreferences' addresses, layouts, and aliasing when storing them in pointer slots or aggregate fields and returning them through helpers. Mutations through a stored reference continue to affect the original referent, including when helpers allocate memory while the reference is live. (#1557) -
Fix internal compiler errors in native-reference slot assignments, valid compound assignments, and Copy reads from reference-returning calls. Invalid mutations through shared references and mutable field borrows through immutable owned receivers now produce source diagnostics. (#1557)
-
Reserve
StorageMap's complete hashing buffer before invoking custom key encoders, preventing allocations during encoding from overwriting the key. CustomStorageKeyimplementations must now provideencoded_len(self) -> u256and makewrite_keyreturn()instead of the encoded length. (#1557) -
Reject uses of moved non-Copy values through pointers, including pointers returned by calls and projections into their fields or array elements. Also reject native-reference loads from uninitialized or byte-overwritten slots: typed stores can initialize a reference slot, while zeroing or copying raw bytes cannot establish a valid reference. (#1557)
-
Account for persistent and transient state access during external calls, including callbacks. Live state borrows now conflict with
CALL,DELEGATECALL,CREATE, andCREATE2;STATICCALLconflicts with mutable state borrows while allowing shared state borrows. ([#1557](https://g...
v26.3.0
Changelog
26.3 (2026-09-16)
Features
-
Support
==and!=for fixed-size arrays whose elements implementEq. (#528) -
Support
==and!=for tuples of up to six elements whose types implementEq, including the empty tuple. (#748) -
Added PC-accurate debug information.
fe dev trace emitcompiles a
standalone Fe file or a whole ingot and writes a validated stream of typed
compiler facts (JSONL) that links EVM bytecode instructions through the
backend and MIR to source spans where attribution can be proven, and
fe dev debug emit --format ethdebug
projects that stream into a Fe-specific experimental instruction/source artifact
with optional attribution details containing origin/confidence information.
The CLI prints a per-program attribution summary without requiring that extra
file. Each emitted instruction is classified as source-mapped, ambiguous,
synthetic, or unmapped, and only a unique exact mapping in the recorded graph
carries source context. This does not establish exhaustive contributing origins
or transformation history. Compatibility with stock ethdebug consumers is not
established; neither the artifact nor the optional attribution details is a
stable public API. (#1336) -
Added first-class typed memory pointers with
*T, including allocation helpers, dereference reads and writes, pointer field access, and mutable pointer-backed array indexing. New bounded memory-region APIs—MemSlice<T>,MemSpan,MemBuffer, andFixedMemBuffer<N>—distinguish read-only views, owned allocations, and writable capacity across ABI and EVM operations. Pointer-bearing values cannot escape into persistent or transient storage. A bare*at the start of a line is interpreted as dereference; multiline multiplication must keep the operator on the preceding line. (#1469) -
Added
fe build --from-metadata <PATH|->to rebuild a contract from a<Contract>.metadata.jsonrecompilation input (as produced byfe build --emit metadata);-reads the JSON from stdin. The recorded project is materialized into a temporary directory and built with the settings captured in the metadata: the contract fromsettings.compilationTarget(overridable with--contract) and the recorded optimizer level (an explicit-Owins, with a warning that the rebuilt bytecode no longer matches the verified artifact). A compiler version mismatch warns on stderr without aborting. Artifacts are written to--out-dir, defaulting to./out. This lets external toolchains such as Foundry or source verifiers recompile Fe contracts from a single self-contained JSON document. (#1505) -
Added
core::num::isqrtforu256, returning the integer square root rounded down. The implementation uses a fixed number of Newton iterations without input-dependent loops. (#1509) -
Added
StorageBytes::to_memoryto copy stored bytes into memory without ending the contract call, allowing further processing such as hashing or contract deployment. AddedStorageBytes::word_atfor indexed access to individual payload words. (#1510) -
Added
std::evm::encode_msg_calldatato encode a message selector and arguments into memory for low-level calls. AddedAddress::staticfor typedSTATICCALLoperations that forward the available gas and propagate the callee's revert data on failure. (#1511) -
Added
std::evm::packedfor tightly packed byte encoding, withencode_packedandkeccak_packedtuple helpers and a growablePackedbuilder for payloads assembled at runtime. Supported values include integers, addresses, booleans, strings, and byte sequences. Addedstd::evm::crypto::eip712_digestto compute a digest from a domain separator and struct hash. (#1512) -
Added
Call::call_with_defaultandAddress::call_with_defaultto return a caller-supplied default when a successful external call returns no data; non-empty returndata is still decoded strictly and reverts are propagated. Addedstd::evm::erc20::{safe_transfer, safe_transfer_from, safe_approve}for tokens that return eithertrueor no data. These ERC-20 helpers rejectfalsereturns and targets without code; the generalcall_with_defaulthelper also returns the default for successful calls to addresses without code. (#1514) -
Added source-oriented contract layout information to language-server hovers. Hovering a contract name shows its complete layout grouped under Storage, Transient Storage, and Immutable (Code), while hovering a contract field shows only the entries belonging to that field.
The hover labels inline fields and explicit or inferred layout parameters with their source paths and types, and shows index formulas and dimensions for static arrays. It no longer presents empty allocation cursors as occupied slots or exposes internal "root" terminology, and explains when a field's layout is invalid or unavailable. (#1515)
-
Added typed
DynArray<T>.get(index)access andstd::abi::MemVec<T>, a mutable memory array whose length is chosen at creation and remains fixed.MemVecsupports zero-initialized construction, independent copies of existingDynArrayvalues, indexed reads and writes, and conversion to an independent ABI-encodableDynArrayfor contract calls, return values, and event payloads. Supported elements occupy one static ABI word, including integers,Address,bool, and fixed-byte types. Reads use Solidity ABI decoding rules, and out-of-bounds reads or writes revert withPanic(0x32). (#1524)
Bugfixes
-
Report unsupported macro calls as compiler errors instead of panicking during semantic lowering. (#1132)
-
Reject associated type definitions in trait implementations when the type is not declared in the implemented trait. (#1193)
-
Fixed the bundled Tree-sitter grammar to parse chained
||conditions consistently with the compiler parser. (#1469) -
Fixed library modules being lowered into duplicate ingot main objects when building projects with dependencies. (#1478)
-
Improved the parser diagnostic for Rust-style turbofish syntax. Writing
Name::<...>(for exampleStorageMap::<u256, u256, 0>::new()) now reports a clear "remove the double colons" error pointing at the::, instead of a confusing "expected newline or}" message. Use the bareName<...>form instead. (#1498) -
Support functions and recv arms with more than 16 arguments in the Sonatina backend. (#1500)
-
Fixed method selection incorrectly reporting missing trait imports when an inapplicable blanket implementation shadowed a valid concrete implementation. Diagnostics no longer expose unsatisfied bounds involving traits that are not visible at the call site. (#1501)
-
Fixed a compiler error when a mutable
ownaggregate parameter (such asmut _ s: own [u256; 3]) is both projected (indexed or field-accessed) and reassigned inside the function. Such functions previously failed to compile with an internalSlotCarrierMismatcherror; they now compile correctly and keep the parameter's by-value calling convention. (#1503) -
Fixed a compiler panic when selecting a trait method from an
implwhosewhereclause constrains an associated-type projection. Satisfied projection bounds now type-check normally, while unsatisfied bounds produce the expected trait-bound diagnostic. (#1505) -
Fixed a compiler crash when generating bytecode for tuple or struct constants containing string literals of 16 bytes or fewer. (#1512)
-
Fixed a critical contract-layout aliasing bug. Repeating a type with an inferred layout parameter, such as
StorageMap<K, V, const SALT: u256 = _>, inside a struct, tuple, nested generic argument, type alias, enum, or static array now gives each structural occurrence an independent value. Previously, distinct maps could receive the same salt, causing writes through one field or array element to overwrite data belonging to another.Explicit layout values are now reserved before inferred values are assigned, so mixing explicit and inferred parameters cannot collide regardless of declaration order. Static arrays of layout-parameterized types receive checked per-element assignments, including nested arrays and enum payloads, while intentionally shared explicit parameters and enum overlays continue to share.
Layout assignments are preserved when values flow through aggregates, pattern matching, indexing, control flow, function and effect calls, and returns. Invalid, unresolved, overflowing, cyclic, or unsupported contract layouts now fail with diagnostics instead of producing partial layouts, silently aliasing data, or crashing the compiler. (#1515)
-
Fixed compiler crashes when emitting events with eight or more total fields. Events support up to 16 non-indexed data fields, with a type diagnostic when that limit is exceeded. Unsatisfied trait bounds involving string literals are now reported instead of allowing invalid constants to reach cod...
v26.2.0
26.2.0 (2026-06-23)
Features
-
Contract fields are now immutable by default unless declared with
mut. Immutable fields must be initialized before every successfulinitexit and are embedded into contract code; declare fields asmutto keep using storage-backed mutable contract state. Duringinit, immutable field reads before assignment observe the zero/default value, reassignment is allowed, and the last write is the value embedded into the deployed contract. Binding a field withoutmutas amuteffect (uses (mut field)) is an error everywhere exceptinit's code-backed fields; this applies to explicit handle fields (e.g.StorPtr<T>) as well.The compiler verifies initialization with a definite-assignment analysis: a field counts as initialized when it is assigned whole-value (including compound assignment such as
+=) on every path that reaches the end ofinit, whether directly or through helper functions that receive the field via amuteffect or amut Targument. Branches merge conservatively and loop bodies are assumed to possibly run zero times (conditions that are literaltrue/falseare folded), so assignments guarded by runtime-dependent loop conditions are not credited. Member-wise initialization of an aggregate field (p.a = ...; p.b = ...) does not count; assign the whole value instead. (#1334) -
fe docoverhaul for message-based contracts:msgvariants now render
as children of their parent msg page (matching enum variants), contract
pages gain dedicated init and message-handler sections, and#[test]
functions are hidden from generated docs by default (restore them with
--include-tests). The doc viewer also exposes CSS variables for fonts,
weights, and layout so downstream sites can retheme it without CSS
specificity battles. (#1419) -
Added
Option::ok_orandOption::ok_or_elsetocore, mirroring Rust's API, plus aPanic::from(code)shorthand constructor. Combined withResult::unwrap, this lets users attach a typed error value (e.g.Panic::from(POP_EMPTY)) to an Option-unwrap so reverts carry meaningful Solidity-compatible selectors instead of always landing onPanic(0x01). (#1430) -
StorageMap<K, V>now accepts every primitive integer type (u8–u128,usize,i8–i256,isize) andboolas a key, in addition to the previously supportedu256,Address, and tuples. The newStorageKeyimpls left-pad each key to 32 bytes viaWordRepr::to_word(), so slot derivation matches Solidity'smapping(intN/uintN/bool => V)convention exactly. Useful for storage layouts that want to pack indices into a single slot (e.g.mapping(uint128 => V)queues). (#1431) -
Improved optimization options for the default Sonatina backend:
-O1/--optimize 1is now distinct from-O2and is the default optimization level. It keeps Sonatina's optimization pipeline enabled while using lower exact-search caps for stack shuffling; usually getting close to-O2gas and bytecode while substantially reducing compile time.-O0/--optimize 0now and disables the stack shuffling exact solver entirely in favor of a greedy heuristic, making unoptimized builds much faster.
(#1435)
-
Added core
String<N>utilities for fixed-width byte round-trips, effective byte length, concatenation, and equality in const and runtime code. (#1437) -
Lossless
boolto integer casts withasare now allowed. (#1445) -
Exposed selected raw EVM operations through
std::evm::ops, including byte/sign-extension, balance/code inspection, gas price, and blob fee/hash reads. (#1453) -
Added marker-only
#[must_use]support for functions, structs, and enums, and markedcore::result::Resultas must-use so ignored fallible results are diagnosed unless explicitly discarded withlet _ = .... (#1468) -
Precompiles:
std::evm::cryptoprecompile wrappers nowResult<PrecompileError, T>
instead of reverting on precompile call failure.- Added typed wrappers for the remaining EVM crypto precompiles, including
RIPEMD-160, identity, Blake2F, KZG point evaluation, BLS12-381 operations, and
P-256 verification. ecrecovernow rejects non-canonical secp256k1 signatures before returning
a recovered address.- added
ecrecover_rawwhich does not perform canonical signature checks. (#1468)
-
Added
assert!builtin, e.g.assert!(ok). Takes an optional second string
literal argument:assert!(ok, "something's not ok"). Assertion failure results
in a revert, with Solidity-compatibleError(string)payload.assert!can
also be used inconst fns at compile time; assertion failure results in a
compile-time failure. (#1471) -
Added the
Boundedtrait incore::num, exposing inclusive numeric type bounds asT::min()andT::max()const fnmethods on all primitive integer types. (#1474) -
Added the
AbsandUnsignedAbstraits incore::num, providing magnitude operations asconst fnon all signed integer types.Absbundlesabs,checked_abs,wrapping_abs,saturating_abs, andoverflowing_abs, each taking a different stance on the asymmetricT::MINedge case.UnsignedAbs::unsigned_abs()returns the magnitude in the unsigned type of the same width — handlingT::MINwithout overflow. (#1474) -
Inherent
implblocks now support associatedconstitems. Consts may reference the impl's generic parameters and other consts of the same impl, are evaluated at compile time per instantiation, and can be used in both value and type positions (e.g. array sizes):pub struct Packed<const BITS: u256> {} impl<const BITS: u256> Packed<BITS> { const LANES: u256 = 256 / BITS const LANE_MASK: u256 = (1 << BITS) - 1 pub fn lanes(self) -> u256 { Self::LANES } }This is the idiomatic place for derived constants on a generic container; previously the math had to be repeated as local bindings in every method. Inherent consts take precedence over trait consts of the same name, with the trait const still reachable via a qualified path like
<Foo as Trait>::X.Further details:
- Consts are private to the defining module by default; mark them
pub constto export them. - Consts of the enclosing impl are in scope unqualified inside the impl, like trait consts in trait default methods.
- Inherent consts can be used as const generic arguments (
Holder<Buf::SIZE>). - A const on a conditional impl (
impl<T> Wrap<T> where T: Marker) is only available when the receiver satisfies the bound. - Two inherent impls of the same type that define the same const are a definition-site conflict, exactly like conflicting inherent methods (regardless of their
whereclauses). Collisions with an enum variant name or with an inherent associated function of the same name are also rejected. - A const initializer that is not const-evaluable (e.g. a non-
const fncall) is rejected at its definition, like a top-levelconst.
(#1479)
- Consts are private to the defining module by default; mark them
-
Added
fe build --emit metadata, which writes a Solidity-standard contractmetadata.jsonper contract (sources withkeccak256, compiler version, resolved build settings, transitive dependency sources, and ABI) so verifiers like Sourcify can reproduce and check the bytecode. (#1487)
Bugfixes
-
Fixed
fe testoutput so failure details are printed immediately after the corresponding failed test status when tests run in parallel. (#1420) -
Fixed a compiler panic when code_region_len or code_region_offset was called on an unresolved generic contract runtime parameter. (#1429)
-
Fixed a compiler panic when generic associated constants were used in const expressions before their concrete types were known. (#1429)
-
Fixed Sonatina ABI encoding and decoding for negative signed integers narrower than 256 bits. (#1434)
-
Sonatina:
- Fixed EVM encoded-pointer provenance across calls and memory operations, with more precise escape summaries for i256 pointer carriers, aggregates, malloc-derived pointers, and local/argument/nonlocal storage. This also improves memory-planning performance by avoiding unnecessarily conservative escape assumptions.
- Fixed GVN value-phi materialization so cached/generated value phis are rejected unless they cover the currently reachable predecessors.
- Improved stackify spill slot reuse logic. This fixes a bug where a scratch slot could be reused for values that overlap during phi/control-flow transitions.
(#1435)
-
Fixed ABfI encoding for
evm.callmessage payloads with multiple dynamic fields, and for dynamic custom error payloads. (#1439) -
Fixed expression-context
&&and||lowering so right-hand side expressions are only evaluated when short-circuiting requires them. (#1447) -
Fixed compiler panic when lowering zero-sized effect types. (#1449)
-
Allowed blank...
v26.1.0
Changelog
26.1.0 (2026-04-30)
Features
- Update the core ABI helper traits and APIs. Custom ABI implementations now use
AbiSize::HEAD_SIZE,payload_size,Decode::decode_payload, andAbiSpan::payload_end; encoders are created with a fixed output size, and root versus field encoding is split into explicit helpers such asencode_allocandencode_single_root_alloc. (#1404-abi) - Added
assert_msg(cond, message), which reverts with a Solidity-compatibleError(string)payload (selector0x08c379a0) whencondis false. (#1348) - Replace the git resolver backend from git2 (libgit2) to gitoxide (pure Rust). This removes the OpenSSL/libgit2 C dependency and adds sparse checkout support, allowing the resolver to fetch only the required subdirectory of a remote repository instead of the entire tree. (#1383)
- Expose missing
Ctxtrait APIs:origin,coinbase,prevrandao,gaslimit,chainid,basefee,selfbalance, andblockhash. (#1388) - Add
#[error]attribute for Solidity-compatible custom error types. Structs annotated with#[error]get auto-generatedErrorVariant<Sol>,AbiSize, andEncode<Sol>implementations with a compile-time computed 4-byte selector. A newrevert_error()function emits selector-prefixed ABI-encoded revert data. Includes a predefinedPanicerror type matching Solidity'sPanic(uint256). (#1395) - Improve
fe docand generated documentation bundles: message declarations and message variants now render with dedicated item kinds and complete signatures,fe doc --builtins --stdlib-path <path>can document a stdlib loaded from disk, docs JSON includes pre-rendered Markdown HTML, and the web viewer can load gzipped docs JSON bundles. (#1401) - Replace backend lowering with the staged SMIR/NSMIR/MIR pipeline. This expands compile-time function evaluation, including const calls that produce aggregate values and symbolic array repeat expressions such as
[value; N]whereNis a const generic. (#1404) - Add
static_assert(bool_expr)for compile-time assertions, with diagnostics that show evaluated comparison operands and operators when an assertion fails. (#1412) - Expand
const fnevaluation to support mutable locals, assignments, aggregate field and index writes,whileandwhile letloops withbreakandcontinue, match/destructuring patterns, and const operator trait implementations. This allows more ordinary helper code, including array and proof builders, to run during CTFE. (#1413) - The standard prelude now includes
sol,Bytes,Decode, andAbiDecoder, so common Solidity selector and ABI decoding code no longer needs explicit imports. (#1417) - Checked arithmetic overflow now reverts with a Solidity-compatible
Panic(uint256)payload (code0x11) instead of empty revert data. This makes overflow failures identifiable by off-chain tooling such as Foundry, Hardhat, and block explorers. - Extend
#[test(should_revert)]withpanicandselectorarguments for verifying revert payloads.#[test(should_revert, panic = 0x11)]checks that the test reverts with a Solidity-compatiblePanic(uint256)and the expected code.#[test(should_revert, selector = 0x4e487b71)]checks only the 4-byte error selector. - Make primitive numeric and boolean intrinsics,
IntDowncastmethods, and EVMaddmod/mulmodconst-evaluable. This enables modular arithmetic and field-arithmetic-heavy code to be used inconst fnandstatic_assert. Result::unwrap()now emits selector-prefixed revert data for#[error]types. Previously,unwrap()on aResult<E, T>whereEis an#[error]type would ABI-encode the error without the 4-byte selector. Now the monomorphizer routes these torevert_error()instead ofrevert(), producing Solidity-compatible error payloads.assert(false)now reverts with a Solidity-compatiblePanic(uint256)payload (code0x01) instead of empty revert data. This makes assertion failures identifiable by off-chain tooling.
Bugfixes
- Fix several array and aggregate codegen bugs. Readonly array locals, call results, constructor arguments, and view parameters now preserve their code-backed or borrowed representation until materialization is required. Code-backed arrays copied to storage are staged through memory before word loads and use storage slot offsets instead of byte offsets. Runtime array literals now populate each element before loading the aggregate value. (#1404-array-codegen)
- Fix never type (
!) handling in trait checking and lowering. The compiler now avoids probing trait implementations for bare!, producing the intended diagnostic for invalid uses, and treats extern functions declared-> !as intrinsically non-returning even when they appear in functions with generic or associated return types. (#1410-never-type) - Suppress downstream type mismatch diagnostics when the underlying type is already invalid. This reduces cascading error noise and makes compiler output easier to read. (#1386)
- Fix chained method call type inference (e.g.
result.map(fn1).map(fn2)). The compiler now correctly unifies types through canonicalized receivers, resolving incorrect type mismatch errors on valid method chains. (#1389) - Overhaul LSP stability and observability: worker-thread panics now surface as visible errors instead of being silently swallowed, a dual-layer logging system writes detailed diagnostics to workspace-local
.fe-lsp/log files with automatic rotation and retention, and a dispatch-deadlock in concurrent request handling has been fixed via an upgraded async-lsp dependency. (#1392) - Remove redundant
EvmResultExttrait andunwrap_or_revert()method. SinceResult::unwrap()already ABI-encodes errors on revert viapanic_with_value,unwrap_or_revert()was a leftover that duplicated this behavior. (#1395) - Fix several MIR correctness issues:
fe build --contractnow filters Sonatina IR output correctly, ingot builds work when contracts are re-exported from the root module, generic calls can forward concrete EVM effects, and escaping storage borrows are rejected. (#1404) - Report invalid dependency paths in
fe.tomlas configuration diagnostics instead of panicking. (#1408) - Fix
StorageBytes.encode_returnso multi-wordbytesvalues are ABI-encoded from allocated return memory instead of clobbering scratch memory. (#1409) - Fix CTFE evaluation of unchecked and wrapping numeric intrinsics to use fixed-width word semantics for wrapping negation, bitwise not, shifts, and division/remainder edge cases.
- Fix generic operator overload resolution so ambiguous trait method candidates are preserved and can be disambiguated by argument constraints. Generic wrappers such as field element types can now support mixed operator impls like
Fr<M> + u256.
Performance improvements
- Improve CTFE performance and scale by reducing repeated const interning, using copy-on-write aggregate stores, caching semantic bodies and instances, and raising the default CTFE step limit to 1,000,000. Larger constant computations such as Poseidon test vectors can now complete during normal checks.
Internal Changes - for Fe Contributors
- Bump sonatina to eb50941. (#1393)
v26.0.1
Changelog
26.0.1 (2026-04-13)
Bugfixes
- Suppress downstream type mismatch diagnostics when the underlying type is already invalid. This reduces cascading error noise and makes compiler output easier to read. (#1386)
- Fix chained method call type inference (e.g.
result.map(fn1).map(fn2)). The compiler now correctly unifies types through canonicalized receivers, resolving incorrect type mismatch errors on valid method chains. (#1389) - Overhaul LSP stability and observability: worker-thread panics now surface as visible errors instead of being silently swallowed, a dual-layer logging system writes detailed diagnostics to workspace-local
.fe-lsp/log files with automatic rotation and retention, and a dispatch-deadlock in concurrent request handling has been fixed via an upgraded async-lsp dependency. (#1392)
Internal Changes - for Fe Contributors
- Bump sonatina to eb50941. (#1393)
v26.0.0
v26.0.0-rc0
Cutting new release
v26.0.0-alpha.12
Cutting new release
v26.0.0-alpha.10
Cutting new release