NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io, #2053 most downloaded on crates.io
syn-powered Solidity parser
Latest stable
1.7.3
Last release 2 months ago
10 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
78 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
refactor: change identical resolve traits to Specifier by @prestwich in https://github.com/alloy-rs/core/pull/550
JsonAbi::to_sol by @DaniPopes in https://github.com/alloy-rs/core/pull/558Log<LogData> by @DaniPopes in https://github.com/alloy-rs/core/pull/573Bytes map to Bytes in SolType by @rachel-bousfield in https://github.com/alloy-rs/core/pull/545coerce_str by @ay in https://github.com/alloy-rs/core/pull/577Full Changelog: https://github.com/alloy-rs/core/compare/v0.6.4...v0.7.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
coerce_str (#577)Log<LogData> (#573)JsonAbi::to_sol (#558)test: bless tests by @DaniPopes in https://github.com/alloy-rs/core/pull/530
cfg(doc) by @DaniPopes in https://github.com/alloy-rs/core/pull/538DynSolType.coerce_json to convert array of numbers to bytes by @youngkashew in https://github.com/alloy-rs/core/pull/541uint! by @DaniPopes in https://github.com/alloy-rs/core/pull/537TxKind by @onbjerg in https://github.com/alloy-rs/core/pull/542from_slice functions by @DaniPopes in https://github.com/alloy-rs/core/pull/546Full Changelog: https://github.com/alloy-rs/core/compare/v0.6.3...v0.6.4
DynSolType.coerce_json to convert array of numbers to bytes (#541)from_slice functions (#546)cfg(doc) (#538)chore: fix winnow deprecation warnings by @DaniPopes in https://github.com/alloy-rs/core/pull/507
binary_search in SolInterface::valid_selector by @DaniPopes in https://github.com/alloy-rs/core/pull/506SolInterface::abi_decode_raw by @DaniPopes in https://github.com/alloy-rs/core/pull/508#[sol(rpc)] to generate type-safe provider contract calls by @DaniPopes in https://github.com/alloy-rs/core/pull/510alloy-core prelude crate by @DaniPopes in https://github.com/alloy-rs/core/pull/521alloy-core meta crate in README.md overview by @DaniPopes in https://github.com/alloy-rs/core/pull/523Params by @DaniPopes in https://github.com/alloy-rs/core/pull/526Full Changelog: https://github.com/alloy-rs/core/compare/v0.6.2...v0.6.3
Params (#526)alloy-core meta crate in README.md overview (#523)alloy-core prelude crate (#521)#[sol(rpc)] to generate type-safe provider contract calls (#510)SolInterface::abi_decode_raw (#508)binary_search in SolInterface::valid_selector (#506)fix(signature): construct Signature bytes using v+27 when we do not have an EIP155 v by @Evalir in https://github.com/alloy-rs/core/pull/503
signature): construct Signature bytes using v+27 when we do not have an EIP155 v by @Evalir in https://github.com/alloy-rs/core/pull/503Full Changelog: https://github.com/alloy-rs/core/compare/v0.6.1...v0.6.2
signature] Construct Signature bytes using v+27 when we do not have an EIP155 v (#503)feat(primitives): add Address::from_private_key by @DaniPopes in https://github.com/alloy-rs/core/pull/483
Address::from_private_key by @DaniPopes in https://github.com/alloy-rs/core/pull/483sol! by @leruaa in https://github.com/alloy-rs/core/pull/493primitives): Add y_parity_byte_non_eip155 to Parity by @Evalir in https://github.com/alloy-rs/core/pull/499Full Changelog: https://github.com/alloy-rs/core/compare/v0.6.0...v0.6.1
primitives] Add y_parity_byte_non_eip155 to Parity (#499)sol! (#493)Address::from_private_key (#483)refactor: Log implementation by @prestwich in https://github.com/alloy-rs/core/pull/465
Full Changelog: https://github.com/alloy-rs/core/compare/v0.5.4...v0.6.0
chore(sol-types): make PanicKind non_exhaustive by @DaniPopes in https://github.com/alloy-rs/core/pull/458
Full Changelog: https://github.com/alloy-rs/core/compare/v0.5.3...v0.5.4
feat(primitives): update Bytes formatting, add UpperHex by @DaniPopes in https://github.com/alloy-rs/core/pull/446
RevertReason enum by @tcoratger in https://github.com/alloy-rs/core/pull/450Full Changelog: https://github.com/alloy-rs/core/compare/v0.5.2...v0.5.3
RevertReason enum (#450)test: add some regression tests by @DaniPopes in https://github.com/alloy-rs/core/pull/443
Full Changelog: https://github.com/alloy-rs/core/compare/v0.5.1...v0.5.2
Fixes unintended MSRV breakage in sol-macro. Main changes in v0.5.0.
Fixes unintended MSRV breakage in sol-macro. Main changes in v0.5.0.
Full Changelog: https://github.com/alloy-rs/core/compare/v0.5.0...v0.5.1
Implemented more utilities in [alloy-primitives]
alloy-primitives] (#432)sol-macro json-abi item generation through #[sol(abi)] (#422)sol-macro SolEventInterface (#426)dyn-abi DynSolType::coerce_str (#380)sol-types SolType::TokenType GAT and TokenType trait to Token (#417)SolCall::abi_decode_returns by @DaniPopes in https://github.com/alloy-rs/core/pull/367alloy-sol-types): Switch incorrect function docs by @Evalir in https://github.com/alloy-rs/core/pull/374DynSolType::coerce_str by @DaniPopes in https://github.com/alloy-rs/core/pull/380SolInterface::MIN_DATA_LENGTH overflow by @DaniPopes in https://github.com/alloy-rs/core/pull/383Param.ty is not always a valid TypeSpecifier by @DaniPopes in https://github.com/alloy-rs/core/pull/386u?int to u?int256 by @DaniPopes in https://github.com/alloy-rs/core/pull/397separated instead of separated0 by @DaniPopes in https://github.com/alloy-rs/core/pull/403abi::Decoder by @DaniPopes in https://github.com/alloy-rs/core/pull/404JsonAbi::to_sol by @DaniPopes in https://github.com/alloy-rs/core/pull/408coerce_str by @DaniPopes in https://github.com/alloy-rs/core/pull/410TokenType GAT and trait to Token by @DaniPopes in https://github.com/alloy-rs/core/pull/417SolType::ENCODED_SIZE default by @DaniPopes in https://github.com/alloy-rs/core/pull/418json-abi item generation by @DaniPopes in https://github.com/alloy-rs/core/pull/422SolEventInterface: SolInterface for contract events enum by @DaniPopes in https://github.com/alloy-rs/core/pull/426bytes and string specialization by @DaniPopes in https://github.com/alloy-rs/core/pull/435Full Changelog: https://github.com/alloy-rs/core/compare/v0.4.2...v0.5.0
SolType::ENCODED_SIZE default (#418)coerce_str (#410)u?int to u?int256 (#397)Param.ty is not always a valid TypeSpecifier (#386)SolInterface::MIN_DATA_LENGTH overflow (#383)SolCall::abi_decode_returns (#367)bytes and string specialization (#435)SolEventInterface: SolInterface for contract events enum (#426)json-abi item generation (#422)JsonAbi::to_sol (#408)abi::Decoder (#404)DynSolType::coerce_str (#380)TokenType GAT and trait to Token (#417)separated instead of separated0 (#403)SolType::ENCODED_SIZE default (#418)Param.ty is not always a valid TypeSpecifier (#386)Bug fix for alloy-primitives features. Main changes in v0.4.1.
Bug fix for alloy-primitives features. Main changes in v0.4.1.
Full Changelog: https://github.com/alloy-rs/core/compare/v0.4.1...v0.4.2
`alloy-primitives` now has a primitive `Log` struct
alloy-primitives now has a primitive Log struct (https://github.com/alloy-rs/core/pull/271)alloy-json-abi items (#329)SolValue convenience trait to alloy-sol-types (#333)std::fmt::Display on more syn-solidity items (#337, #339)sol! generated items is now displayed in documentation code blocks (#356)resolve module private by @DaniPopes in https://github.com/alloy-rs/core/pull/324SolValue, make Encodable an impl detail by @DaniPopes in https://github.com/alloy-rs/core/pull/333TypeArray::is_abi_dynamic by @DaniPopes in https://github.com/alloy-rs/core/pull/353to_sol by @DaniPopes in https://github.com/alloy-rs/core/pull/354Full Changelog: https://github.com/alloy-rs/core/compare/v0.4.0...v0.4.1
to_sol (#354)TypeArray::is_abi_dynamic (#353)SolValue, make Encodable an impl detail (#333)resolve module private (#324)TypeArray::is_abi_dynamic (#353)SolValue, make Encodable an impl detail (#333)`syn-solidity` is now (almost) complete, as it can also parse all expression, statements, and Yul. Special thanks to @Will-Smith11, @mouseless-eth, an
syn-solidity is now (almost) complete, as it can also parse all expression, statements, and Yul. Special thanks to @Will-Smith11, @mouseless-eth, and @0xMemoryGrinder! (#314, https://github.com/alloy-rs/core/issues/268, #199)alloy-json-abi items (like Function and Event) can now be used in combination with alloy-dyn-abi to ABI-encode their input or output parameters through JsonAbiExt (#243)encode, encode_single and functions and their respectives in decode* and SolType::* were renamed to encode_sequence and encode respectively. *_params functions remain unchanged (#274)encode and decode-like functions with abi_; alloy-sol-types ABI-related items were moved into the abi module (#311)alloy-sol-type-parser got 10% to 50% faster, but now rejects any whitespace (#292)slice::Iter where possible by @DaniPopes in https://github.com/alloy-rs/core/pull/256eip712_data_word by @prestwich in https://github.com/alloy-rs/core/pull/258Bytes conversion impls by @DaniPopes in https://github.com/alloy-rs/core/pull/280bytes::Buf for our own Bytes by @DaniPopes in https://github.com/alloy-rs/core/pull/279FixedBytes for sol_data::FixedBytes by @DaniPopes in https://github.com/alloy-rs/core/pull/276rand by @DaniPopes in https://github.com/alloy-rs/core/pull/282FixedBytes to int conversion impls by @DaniPopes in https://github.com/alloy-rs/core/pull/281Eip712Domain::encode_data by @DaniPopes in https://github.com/alloy-rs/core/pull/277SolError, SolInterface structs and implementations by @DaniPopes in https://github.com/alloy-rs/core/pull/285all_derives = false, fix custom type printing by @DaniPopes in https://github.com/alloy-rs/core/pull/272Function by @DaniPopes in https://github.com/alloy-rs/core/pull/290Function::signature_full by @DaniPopes in https://github.com/alloy-rs/core/pull/289#[automatically_derived] by @DaniPopes in https://github.com/alloy-rs/core/pull/294winnow by @DaniPopes in https://github.com/alloy-rs/core/pull/292hex! macro from primitives re-export by @DaniPopes in https://github.com/alloy-rs/core/pull/299ResolveSolType documentation by @DaniPopes in https://github.com/alloy-rs/core/pull/296Spanned impls by @DaniPopes in https://github.com/alloy-rs/core/pull/301decode_revert_reason to alloy and add tests by @alessandromazza98 in https://github.com/alloy-rs/core/pull/308abi_ by @DaniPopes in https://github.com/alloy-rs/core/pull/311Full Changelog: https://github.com/alloy-rs/core/compare/v0.3.2...v0.4.0
all_derives = false, fix custom type printing (#272)eip712_data_word (#258)ResolveSolType documentation (#296)Spanned impls (#301)Function::signature_full (#289)Function (#290)SolError, SolInterface structs and implementations (#285)FixedBytes to int conversion impls (#281)rand (#282)FixedBytes for sol_data::FixedBytes (#276)bytes::Buf for our own Bytes (#279)Bytes conversion impls (#280)abi_ (#311)hex! macro from primitives re-export (#299)#[automatically_derived] (#294)decode_revert_reason to alloy and add tests (#308)Spanned impls (#301)fix(sol-macro): don't panic when encountering functions without names by @DaniPopes in https://github.com/alloy-rs/core/pull/217
T: Into<Cow<str>> in eip712_domain! by @DaniPopes in https://github.com/alloy-rs/core/pull/222B160 by @DaniPopes in https://github.com/alloy-rs/core/pull/235FixedBytes<N> <-> [u8; N] conversions by @DaniPopes in https://github.com/alloy-rs/core/pull/239type field by @DaniPopes in https://github.com/alloy-rs/core/pull/233Full Changelog: https://github.com/alloy-rs/core/compare/v0.3.1...v0.3.2
type field (#233)FixedBytes<N> <-> [u8; N] conversions (#239)T: Into<Cow<str>> in eip712_domain! (#222)B160 (#235)docs: update README.md by @DaniPopes in https://github.com/alloy-rs/core/pull/208
ethabi Contract methods by @andyrobert3 in https://github.com/alloy-rs/core/pull/195Full Changelog: https://github.com/alloy-rs/core/compare/v0.3.0...v0.3.1
ethabi Contract methods (#195)alloy-rlp and alloy-rlp-derive are now maintained in a separate repository ( ), and as such may differ in versioning
alloy-rlp and alloy-rlp-derive are now maintained in a separate repository (https://github.com/alloy-rs/rlp), and as such may differ in versioningalloy-sol-type-parser: A simple parser for Solidity type stringsalloy-dyn-abi: Run-time ABI and EIP-712 implementationsalloy-json-abi: JSON-ABI implementationdomain macro and add more docs by @prestwich in https://github.com/alloy-rs/core/pull/147dyn-abi to performance parity with ethabi by @prestwich in https://github.com/alloy-rs/core/pull/144SolEnum and SolInterface by @DaniPopes in https://github.com/alloy-rs/core/pull/153#[sol] attributes and JSON ABI support by @DaniPopes in https://github.com/alloy-rs/core/pull/173ruint2 with ruint by @DaniPopes in https://github.com/alloy-rs/core/pull/192Full Changelog: https://github.com/alloy-rs/core/compare/v0.2.0...v0.3.0
#[sol] attributes and JSON ABI support (#173)SolEnum and SolInterface (#153)ruint2 with ruint (#192)dyn-abi to performance parity with ethabi (#144)fix: hex breaking change by @DaniPopes in https://github.com/alloy-rs/core/pull/50
We’re excited to announce alloy-rs/core, a rewrite of the popular ethers-core package and the ethabi crate. Core offers:
syn-powered Solidtiy parser, specifically designed for Rust procedural macros. It aims to mimic the behavior of the official Solidity compiler (Solc) when it comes to parsing valid Solidity code. This is a powerful abstraction which we leverage for building performant compile-time functionalities, like static ABI coders (see below).Here is a low-level example of how you can use these new primitives:
use alloy_primitives::Address;
use alloy_sol_types::{sol, SolType};
// Type definition: generates a new struct that implements `SolType`
sol! {
type MyType is uint256;
}
// Type aliases
type B32 = sol! { bytes32 };
// This is equivalent to the following:
// type B32 = alloy_sol_types::sol_data::Bytes<32>;
type SolArrayOf<T> = sol! { T[] };
type SolTuple = sol! { tuple(address, bytes, string) };
let _ = <sol!(bool)>::encode_single(&true);
let _ = B32::encode_single(&[0; 32]);
let _ = SolArrayOf::<sol!(bool)>::encode_single(&vec![true, false]);
let _ = SolTuple::encode_single(&(Address::ZERO, vec![0; 32], "hello".to_string()));
Here's a higher-level example, showing a roundtrip ABI encoding of an ERC20 transfer:
use alloy_primitives::{Address, U256};
use alloy_sol_types::{sol, SolCall};
use hex_literal::hex;
sol! {
#[derive(Debug, PartialEq)]
interface IERC20 {
function transfer(address to, uint256 amount) external returns (bool);
}
}
// random mainnet ERC20 transfer
// https://etherscan.io/tx/0x947332ff624b5092fb92e8f02cdbb8a50314e861a4b39c29a286b3b75432165e
let data = hex!(
"a9059cbb"
"0000000000000000000000008bc47be1e3abbaba182069c89d08a61fa6c2b292"
"0000000000000000000000000000000000000000000000000000000253c51700"
);
let expected = IERC20::transferCall {
to: Address::from(hex!("8bc47be1e3abbaba182069c89d08a61fa6c2b292")),
amount: U256::from(9995360000_u64),
};
assert_eq!(data[..4], IERC20::transferCall::SELECTOR);
let decoded = IERC20::IERC20Calls::decode(&data, true).unwrap();
assert_eq!(decoded, IERC20::IERC20Calls::transfer(expected));
assert_eq!(decoded.encode(), data);
Alloy is really powerful!
These crates will act as the solid foundation we’ve always wanted for Ethereum in Rust, informed by the lessons from our last 3 years of Rust Ethereum engineering. The code for these crates is under active development on github. We love new contributors. The pre-1.0.0 version of these crates are available on [crates.io](https://crates. io/crates/alloy-primitives), and docs.rs.
primitives by @prestwich in https://github.com/alloy-rs/core/pull/19const-hex instead of hex by @DaniPopes in https://github.com/alloy-rs/core/pull/25crates/* by @DaniPopes in https://github.com/alloy-rs/core/pull/31sol! by @DaniPopes in https://github.com/alloy-rs/core/pull/53sol! AST and macro expansion by @DaniPopes in https://github.com/alloy-rs/core/pull/61syn-solidity by @DaniPopes in https://github.com/alloy-rs/core/pull/63feature(doc_cfg, doc_auto_cfg) by @DaniPopes in https://github.com/alloy-rs/core/pull/67getrandom, document in README.md by @DaniPopes in https://github.com/alloy-rs/core/pull/71sol! contracts by @DaniPopes in https://github.com/alloy-rs/core/pull/77SolType for {Ui,I}nt<N> and FixedBytes<N> with const-generics by @DaniPopes in https://github.com/alloy-rs/core/pull/92repr(C) to json-abi items by @DaniPopes in https://github.com/alloy-rs/core/pull/100TokenType::is_dynamic a constant by @DaniPopes in https://github.com/alloy-rs/core/pull/114Encodable trait by @prestwich in https://github.com/alloy-rs/core/pull/121Full Changelog: https://github.com/alloy-rs/core/commits/v0.2.0
(This was going to be a v0.1.0 release, but we did an internal one first)
repr(C) to json-abi items (#100)primitives (#19)Encodable trait (#121)TokenType::is_dynamic a constant (#114)sol! contracts (#77)syn-solidity (#63)sol! (#53)const-hex instead of hex (#25)getrandom, document in README.md (#71)feature(doc_cfg, doc_auto_cfg) (#67)crates/* (#31)SolType for {Ui,I}nt<N> and FixedBytes<N> with const-generics (#92)sol! AST and macro expansion (#61)<!-- generated by git-cliff -->
sol! contracts (#77)syn-solidity (#63)feature(doc_cfg, doc_auto_cfg) (#67)<!-- generated by git-cliff -->
One column per quarter.