Evolve

Evolve is a modular Rust SDK for building blockchain applications with Ethereum compatibility.

Warning

Alpha software: Evolve is in active development and is not production-ready.

What Evolve Provides

• Account-centric execution model
• Deterministic state transition engine
• Ethereum transaction and JSON-RPC compatibility
• Composable SDK modules and standards

Getting Started

Prerequisites

• Rust 1.86.0 or later
• just

Build and Validate

git clone https://github.com/01builders/evolve.git
cd evolve
just --list
just build
just test
just quality

Run a Dev Node

just node-init
just node-run

Default RPC endpoint: http://localhost:8545.

Run evd (and optionally ev-node) with Docker Compose

Run evd only:

docker compose up --build evd

Run evd + ev-node:

docker compose -f docker-compose.yml -f docker-compose.ev-node.yml up --build

Notes:

• evd JSON-RPC is exposed on http://localhost:8545
• evd gRPC is exposed on localhost:50051
• ev-node gets EVD_GRPC_ENDPOINT=evd:50051 in the compose network
• if your ev-node image needs explicit startup flags, override command for the ev-node service with an extra compose override file

Documentation

Read the docs for implementation details instead of this README.

Start Here

• Documentation Home
• SDK Overview
• Module System Overview

Build Modules and Accounts

• Creating Modules
• Module Architecture
• Macros Reference
• Accounts Concept

State Collections and Storage

• Storage in Modules
• Collections Reference
• Collections Crate

Pre-built Modules and Standards

• Pre-built Modules Reference
• Standards Reference
• SDK Extensions

Testing, Determinism, and Operations

• Module Testing
• Determinism
• STF Architecture
• Server Operations
• Production Notes

License

Apache-2.0