Skip to content

Commit fad0398

Browse files
committed
chore: Update README for version 0.3.1 with Osaka hardfork and Fusaka devnet readiness
- Updated version badge to 0.3.1. - Enhanced overview to reflect full support for Osaka hardfork features and Fusaka devnet readiness. - Added detailed descriptions of precompiled contracts and their implementations. - Included recent updates and completed features in the status section. - Updated release information to indicate readiness for Fusaka devnet testing.
1 parent aea7ba0 commit fad0398

File tree

1 file changed

+57
-30
lines changed

1 file changed

+57
-30
lines changed

README.md

Lines changed: 57 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[![Zig](https://img.shields.io/badge/Zig-0.15.1+-blue.svg)](https://ziglang.org/)
44
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
5-
[![Version](https://img.shields.io/badge/Version-0.3.0-orange.svg)](RELEASE_NOTES.md)
5+
[![Version](https://img.shields.io/badge/Version-0.3.1-orange.svg)](RELEASE_NOTES.md)
66
[![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen.svg)](https://github.com/10d9e/zevm/actions)
77
[![Tests](https://img.shields.io/badge/Tests-100%25%20Passing-brightgreen.svg)](https://github.com/10d9e/zevm/actions)
88

@@ -13,12 +13,13 @@ A high-performance Ethereum Virtual Machine implementation in Zig.
1313
## Overview
1414

1515
ZEVM is a complete EVM implementation that provides:
16-
- Full Ethereum protocol support up to the Prague hardfork
16+
- Full Ethereum protocol support up to the Osaka hardfork (Fusaka-ready)
1717
- Modular architecture for easy customization
1818
- High-performance execution
19-
- Comprehensive precompile support
19+
- Comprehensive precompile support (all 18 standard precompiles)
2020
- Built-in debugging and inspection tools
2121
- Type-safe implementation leveraging Zig's compile-time guarantees
22+
- **Fusaka devnet ready** - Full support for Osaka hardfork features
2223

2324
## Features
2425

@@ -49,19 +50,29 @@ ZEVM is a complete EVM implementation that provides:
4950
- Paris (The Merge)
5051
- Shanghai
5152
- Cancun
52-
- Prague (Latest)
53+
- Prague
54+
- **Osaka** (Latest) - **Fusaka devnet ready**
5355

5456
### Precompiled Contracts
5557

58+
All 18 standard Ethereum precompiles are fully implemented:
59+
5660
- **Identity** (0x04): Data copy
5761
- **SHA256** (0x02): SHA-256 hash function
5862
- **RIPEMD160** (0x03): RIPEMD-160 hash function
5963
- **ECRECOVER** (0x01): Elliptic curve signature recovery
60-
- **ModExp** (0x05): Modular exponentiation
61-
- **BN254** (0x06-0x08): BN254 curve operations
64+
- **ModExp** (0x05): Modular exponentiation (Byzantium/Berlin/Osaka variants)
65+
- **BN254** (0x06-0x08): BN254 curve operations (Add, Mul, Pairing)
6266
- **Blake2F** (0x09): Blake2 compression function
63-
- **KZG Point Evaluation** (0x0A): KZG commitment verification
64-
- **BLS12-381** (0x0B-0x11): BLS12-381 curve operations
67+
- **KZG Point Evaluation** (0x0A): KZG commitment verification (EIP-4844)
68+
- **BLS12-381** (0x0B-0x11): All 7 BLS12-381 curve operations
69+
- **P256Verify** (0x100): secp256r1 signature verification (RIP-7212)
70+
71+
**Osaka Hardfork Features:**
72+
- ✅ ModExp Osaka gas calculation (EIP-7883)
73+
- ✅ EIP-7823 input size limits (1024 bytes)
74+
- ✅ P256Verify Osaka gas cost (6900 gas)
75+
- ✅ PrecompileId support for Fusaka devnet
6576

6677
## Building
6778

@@ -267,14 +278,26 @@ ZEVM is designed for high performance:
267278
- Optimized opcode dispatch
268279
- Fast precompile implementations
269280

281+
## Fusaka Devnet Support
282+
283+
ZEVM is **fully ready** for Fusaka devnet testing:
284+
285+
-**PrecompileId Implementation**: Complete with Custom variant support
286+
-**Osaka Hardfork**: All Osaka-specific precompile changes implemented
287+
-**EIP-7823 & EIP-7883**: ModExp Osaka gas calculation and input limits
288+
-**P256Verify Osaka**: Correct gas cost (6900) for Osaka hardfork
289+
-**Feature Parity**: 100% match with revm reference implementation
290+
291+
See [FUSAKA_READINESS.md](FUSAKA_READINESS.md) for complete verification checklist.
292+
270293
## Contributing
271294

272295
Contributions are welcome! Areas for improvement:
273-
- Complete precompile implementations (BN254, BLS12-381, etc.)
274296
- Additional database backends
275297
- Performance optimizations
276-
- More comprehensive test coverage
298+
- Extended test coverage (Ethereum state tests)
277299
- Documentation improvements
300+
- EOF (EIP-7702) enhancements
278301

279302
## License
280303

@@ -288,33 +311,37 @@ This project is a port of [revm](https://github.com/bluealloy/revm) to Zig. Plea
288311

289312
## Status
290313

291-
ZEVM v0.1.0 is now available! The core EVM functionality is complete and tested, with comprehensive documentation and examples.
314+
ZEVM v0.3.1 is now available! **Fusaka devnet ready** with full Osaka hardfork support.
292315

293-
### Completed
294-
- Core EVM interpreter
295-
- All standard opcodes
316+
### ✅ Completed
317+
- Core EVM interpreter with all standard opcodes
296318
- Gas tracking and metering
297-
- State management
298-
- Database interface
299-
- Basic precompiles (Identity, SHA256, RIPEMD160, ECRECOVER)
300-
- Inspector tools
301-
- Comprehensive test suite
302-
- Example applications
303-
- Complete documentation
304-
- Release notes and changelog
305-
306-
### In Progress
307-
- Advanced precompiles (BN254, BLS12-381, KZG)
308-
- Full EOF (EIP-7702) support
309-
- Additional database backends
310-
- Performance benchmarking
319+
- State management and database interface
320+
- **All 18 standard precompiles** (100% feature parity with revm)
321+
- **Osaka hardfork support** (ModExp Osaka, P256Verify Osaka)
322+
- **Fusaka devnet ready** (PrecompileId implementation)
323+
- Inspector tools and debugging capabilities
324+
- Comprehensive test suite (73+ precompile tests)
325+
- Cross-platform build system (macOS, Linux, Windows)
326+
- Static linking support for self-contained binaries
327+
- Complete documentation and examples
328+
329+
### 🚀 Recent Updates (v0.3.1)
330+
- **Fusaka/Osaka Support**: Full implementation of PrecompileId with Custom variant
331+
- **ModExp Osaka**: Fixed gas calculation to match EIP-7883 specification
332+
- **EIP-7823**: Corrected input size limits to 1024 bytes
333+
- **PrecompileId Enhancements**: Added `name()` and `precompile()` methods
334+
335+
See [FUSAKA_READINESS.md](FUSAKA_READINESS.md) for detailed Fusaka readiness verification.
311336

312337
## Release Information
313338

314-
- **Current Version**: v0.1.0
315-
- **Release Date**: October 27, 2024
339+
- **Current Version**: v0.3.1
340+
- **Release Date**: December 2, 2025
341+
- **Fusaka Status**: ✅ Ready for Fusaka devnet testing
316342
- **Release Notes**: [RELEASE_NOTES.md](RELEASE_NOTES.md)
317343
- **Changelog**: [CHANGELOG.md](CHANGELOG.md)
344+
- **Fusaka Readiness**: [FUSAKA_READINESS.md](FUSAKA_READINESS.md)
318345

319346
## Resources
320347

0 commit comments

Comments
 (0)