Skip to content

Releases: alloy-rs/core

alloy-core v0.5.0

23 Nov 22:21
v0.5.0
e89c26b
Compare
Choose a tag to compare

Highlights

  • Implemented more utilities in [alloy-primitives] (#432)
  • Added sol-macro json-abi item generation through #[sol(abi)] (#422)
  • Added sol-macro SolEventInterface (#426)
  • Added support for SSZ (#407)
  • Added dyn-abi DynSolType::coerce_str (#380)
  • Renamed sol-types SolType::TokenType GAT and TokenType trait to Token (#417)

What's Changed

New Contributors

Full Changelog: v0.4.2...v0.5.0

alloy-core v0.4.2

09 Oct 17:01
v0.4.2
862f01e
Compare
Choose a tag to compare

Bug fix for alloy-primitives features. Main changes in v0.4.1.

What's Changed

Full Changelog: v0.4.1...v0.4.2

alloy-core v0.4.1

09 Oct 16:38
v0.4.1
9597caf
Compare
Choose a tag to compare

Highlights

What's Changed

Full Changelog: v0.4.0...v0.4.1

alloy-core v0.4.0

29 Sep 21:58
v0.4.0
7dc48eb
Compare
Choose a tag to compare

Highlights

What's Changed

New Contributors

Full Changelog: v0.3.2...v0.4.0

alloy-core v0.3.2

29 Sep 21:24
bf77435
Compare
Choose a tag to compare

What's Changed

New Contributors

Full Changelog: v0.3.1...v0.3.2

alloy-core v0.3.1

30 Jul 22:31
v0.3.1
87a6f80
Compare
Choose a tag to compare

What's Changed

New Contributors

Full Changelog: v0.3.0...v0.3.1

alloy-core v0.3.0

29 Sep 21:21
9b7d668
Compare
Choose a tag to compare

Highlights

What's Changed

New Contributors

Full Changelog: v0.2.0...v0.3.0

Alloy: Fast, battle-tested and well-documented building blocks for Ethereum, in Rust

23 Jun 18:18
e1fbe23
Compare
Choose a tag to compare

image

We’re excited to announce alloy-rs/core, a rewrite of the popular ethers-core package and the ethabi crate. Core offers:

  • Alloy Primitives: We provide new fundamental types for hashes, fixed-byte arrays, and signed and unsigned integers (built on Remco’s uint library). These types implement common traits sanely (no more truncated hashes like “0x1234…5678”), aim for no_std compatibility, and provide common helper functions for usage in applications.
  • Alloy RLP: A canonical RLP implementation.
  • Alloy RPC Types: All the RPC types when talking to a chain are available using our newly defined types.
  • Syn Solidity: A 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).
  • Alloy Solidity Types: A compile-time representation of Ethereum's type system with ABI and EIP-712 support. This allows for clean UX and high encoding/decoding speed without redundant layers of abstraction. This static abi encoder is built on a robust representation of Solidity’s type system in Rust. Users access it via the sol! procedural macro, which parses Solidity snippets to generate native Rust code. The static encoder benches at 2-3x faster (!!) than current Rust implementations which are 1+ order of magnitude faster than other languages.

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.

PRs included in this release:

Read more