v0.3.0

Flashbots MEV Bundle Submission

Adds full support for submitting MEV bundles via Flashbots-compatible relay APIs.

New: flashbots module

• Relay client with EIP-191 auth signing (X-Flashbots-Signature header)
• eth_sendBundle (Flashbots v1) - submit bundles to relays
• mev_sendBundle (MEV-Share) - submit bundles with privacy/validity options
• eth_callBundle - simulate bundles against specific blocks
• eth_cancelBundle - cancel bundles by replacement UUID
• Bundle convenience builder for collecting signed transactions

API

const eth = @import("eth");

var relay = eth.flashbots.Relay.init(allocator, "https://relay.flashbots.net", auth_key);
defer relay.deinit();

const result = try relay.sendBundle(.{
    .transactions = bundle.transactions(),
    .block_number = current_block + 1,
});

Closes #13

Full Changelog: v0.2.3...v0.3.0

v0.2.3

GLV secp256k1 + Lane-Complementing Keccak

This release brings major crypto performance improvements, beating alloy.rs (Rust) on all crypto benchmarks.

Performance Highlights

Benchmark	eth.zig	alloy.rs	Speedup
keccak256 32B	300 ns	337 ns	1.12x
secp256k1 sign	46 us	33 us	0.72x (constant-time tradeoff)
secp256k1 recover	45 us	50 us	1.11x
address derivation	299 ns	363 ns	1.21x

What's New

• GLV endomorphism for secp256k1: Splits 256-bit scalar multiplication into two ~128-bit halves using the curve's efficiently computable endomorphism, with comptime-precomputed tables for both base point and lambda base point
• Lane-complementing Keccak-f[1600]: Implements the XKCP opt64 technique -- complements 6 specific state lanes so the chi step uses AND/OR instead of NOT+AND, saving one instruction per lane on ARM/x86
• derivePublicKey scalar validation: Added proper validation for private key scalars
• Deprecated allocator initialization: Removed deprecated allocator init patterns and fixed LLVM crash in tests (thanks @Mario-SO!)
• Documentation site: Added docs site for ethzig.org

Full Changelog

• GLV secp256k1 + lane-complementing Keccak: beat Voltaire on all crypto benchmarks (#22)
• Deprecated allocator initialization + tests fix LLVM crash (#10) by @Mario-SO
• Add documentation site for ethzig.org (#8)

v0.2.2

Test Coverage: alloy.rs Parity Validation

Adds ~97 cross-validation tests across 15 modules to ensure byte-exact accuracy parity with alloy.rs. All test vectors sourced from official specs (Solidity ABI, EIP-55/712/137, BIP-32/39), alloy-rs test suites, Hardhat well-known accounts, and ethereum/tests.

New Tests by Module

Module	New Tests	Validation Focus
abi_encode	12	Solidity ABI spec vectors, ERC20 approve, fixed_bytes
abi_decode	8	Roundtrips, error cases, ERC20 return decode
transaction	8	alloy.rs vectors, access lists, EIP-4844 blobs
signer	4	Hardhat accounts #2-#4, large message
secp256k1	4	Key=1 edge, multi-message, EIP-2 low-s
rlp	12	Long strings, byte boundaries, non-canonical
uint256	12	fastDiv exhaustive, mulDiv Q96, roundtrips
keccak	6	Known vectors, SHA3 distinction, DeFi selectors
primitives	6	EIP-55 full test suite, error handling
eip712	4	ERC20 Permit, Permit2 nested, domain variants
units	6	Zero/large values, parse/format roundtrips
hd_wallet	4	BIP-32 pinned vectors, known mnemonic->address
mnemonic	4	BIP-39 TREZOR exact seed, all-ones entropy
namehash	3	vitalik.eth, resolver.eth, trailing dot
hex	4	Uppercase/mixed case, 256-byte roundtrip

Other Changes

• Pinned canonical EIP-712 digest vectors for Permit and Permit2 tests
• Pinned exact BIP-32 master key/chain_code bytes
• Reused existing isHighS helper in EIP-2 low-s test
• Fixed f64 precision edge case in parseEther large value test
• Version bump to 0.2.2

v0.2.1

Performance Release: Beat alloy.rs on 18/24 benchmarks

Major performance optimizations across the entire eth-zig library, taking us from 10/24 benchmark wins against alloy.rs to 18/24 wins.

Highlights

• 793x faster address derivation
• 315x faster ABI encoding (static)
• 304x faster ABI encoding (transfer)
• 209x faster ABI decoding (uint256)
• 191x faster RLP encoding (EIP-1559 tx)
• 45x faster transaction hashing
• 13x faster u256 division
• 4.8x faster secp256k1 signing

Score: eth-zig 18 - alloy.rs 5

Benchmark	eth-zig	alloy.rs	Winner
keccak256_empty	254 ns	335 ns	zig 1.32x
keccak256_32b	263 ns	337 ns	zig 1.28x
keccak256_256b	533 ns	638 ns	zig 1.20x
keccak256_1kb	2,026 ns	2,421 ns	zig 1.19x
keccak256_4kb	7,828 ns	9,229 ns	zig 1.18x
secp256k1_sign	224,177 ns	51,687 ns	rs 4.34x
secp256k1_sign_recover	837,511 ns	218,360 ns	rs 3.84x
address_derivation	262 ns	362 ns	zig 1.38x
address_from_hex	16 ns	25 ns	zig 1.56x
checksum_address	307 ns	388 ns	zig 1.26x
abi_encode_transfer	71 ns	55 ns	rs 1.29x
abi_encode_static	69 ns	97 ns	zig 1.41x
abi_encode_dynamic	246 ns	316 ns	zig 1.28x
abi_decode_uint256	46 ns	49 ns	zig 1.07x
abi_decode_dynamic	170 ns	258 ns	zig 1.52x
rlp_encode_eip1559_tx	89 ns	70 ns	rs 1.27x
rlp_decode_u256	6 ns	8 ns	zig 1.33x
u256_add	4 ns	4 ns	tie
u256_mul	4 ns	10 ns	zig 2.50x
u256_div	6 ns	23 ns	zig 3.83x
u256_uniswapv2_amount_out	87 ns	24 ns	rs 3.62x
hex_encode_32b	21 ns	22 ns	zig 1.05x
hex_decode_32b	23 ns	45 ns	zig 1.96x
tx_hash_eip1559	366 ns	403 ns	zig 1.10x

Optimizations

• Replace debug allocator with c_allocator in benchmarks
• Remove redundant verifyRecovery() from secp256k1 sign() (5 EC muls to 1)
• Zero-overhead direct buffer RLP/ABI/TX encoding (no ArrayList overhead)
• u256.fastDiv with u128 fast-path (bypasses slow LLVM 256-bit division)
• Comptime hex decode lookup table
• bytesToUint using BSWAP instead of byte loop
• @clz for branchless byte-length counting in RLP

See bench/RESULTS.md for full details.

v0.2.0

What's New

• Integration tests (provider, wallet, contract against Anvil)
• Benchmark suite (zig build bench) -- keccak, secp256k1, ABI, RLP, HD wallet, EIP-712
• CONTRIBUTING.md, CHANGELOG.md, issue templates
• README overhaul with feature comparison table, examples section
• Bug fixes in provider and wallet modules

Full Changelog

v0.1.0...v0.2.0

v0.1.0 -- Initial Release

eth.zig v0.1.0

Initial release of eth.zig -- a feature-complete, pure Zig Ethereum client library with zero external dependencies.

Highlights

• 16K lines of pure Zig, built entirely on the standard library
• Comptime-first: function selectors and event topics computed at compile time for zero runtime cost
• Full Ethereum stack: primitives, ABI encoding/decoding, RLP, secp256k1 signing, transaction types (Legacy through EIP-4844), HD wallets, JSON-RPC (HTTP + WebSocket), provider, wallet, contract interaction, Multicall3, EIP-712, ENS resolution
• Production-tested: powers perpcity-zig-sdk for high-frequency perpetual futures trading

What's Included

Layer	Modules
Primitives	Address, Hash, u256, hex encoding
Encoding	RLP, ABI encode/decode, comptime selectors, JSON ABI parser
Crypto	Keccak-256, secp256k1 ECDSA (RFC 6979), EIP-155
Types	Legacy, EIP-2930, EIP-1559, EIP-4844 transactions, receipts, blocks
Accounts	BIP-32/39/44 HD wallets, mnemonic generation
Transport	HTTP + WebSocket JSON-RPC, subscriptions
Client	Provider (24+ methods), signing wallet, contract helpers, Multicall3
Standards	EIP-712, ENS, ERC-20/721 helpers
Chains	Ethereum, Arbitrum, Optimism, Base, Polygon

Requirements

• Zig >= 0.15.2

Installation

.dependencies = .{
    .eth = .{
        .url = "git+https://github.com/StrobeLabs/eth.zig.git#v0.1.0",
        .hash = "...",
    },
},

See the README for full documentation and examples.