{"id":30087316,"url":"https://github.com/evstack/ev-node","last_synced_at":"2026-02-05T11:01:55.164Z","repository":{"id":37446948,"uuid":"335571729","full_name":"evstack/ev-node","owner":"evstack","description":"A modular framework for building performant networks, pushing the boundary of today in order to build the apps of tomorrow. ","archived":false,"fork":false,"pushed_at":"2026-01-30T18:27:57.000Z","size":45220,"stargazers_count":363,"open_issues_count":48,"forks_count":248,"subscribers_count":23,"default_branch":"main","last_synced_at":"2026-01-31T06:22:33.283Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evstack.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-02-03T09:28:24.000Z","updated_at":"2026-01-30T22:29:40.000Z","dependencies_parsed_at":"2024-01-02T00:28:38.525Z","dependency_job_id":"6f0baf40-8d51-4700-99ca-8db6d6c69a6f","html_url":"https://github.com/evstack/ev-node","commit_stats":null,"previous_names":["lazyledger/optimint","celestiaorg/optimint","celestiaorg/rollmint","rollkit/rollkit"],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/evstack/ev-node","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evstack%2Fev-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evstack%2Fev-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evstack%2Fev-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evstack%2Fev-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evstack","download_url":"https://codeload.github.com/evstack/ev-node/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evstack%2Fev-node/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29120481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T10:47:47.471Z","status":"ssl_error","status_checked_at":"2026-02-05T10:45:08.119Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-09T03:02:24.913Z","updated_at":"2026-02-05T11:01:55.159Z","avatar_url":"https://github.com/evstack.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# EV-node\n\nEv-node is the basis of the Evolve Stack. For more in-depth information about Evolve, please visit our [website][docs].\n\n\u003c!-- markdownlint-disable MD013 --\u003e\n[![Go Report Card](https://goreportcard.com/badge/github.com/evstack/ev-node)](https://goreportcard.com/report/github.com/evstack/ev-node)\n[![codecov](https://codecov.io/gh/evstack/ev-node/branch/main/graph/badge.svg?token=CWGA4RLDS9)](https://codecov.io/gh/evstack/ev-node)\n[![GoDoc](https://godoc.org/github.com/evstack/ev-node?status.svg)](https://godoc.org/github.com/evstack/ev-node)\n\u003c!-- markdownlint-enable MD013 --\u003e\n\n\u003e **⚠️ Version Notice**: Do not use tags or releases before v1.*. Pre-v1 releases are not stable and should be considered abandoned.\n\n## Using Evolve\n\nEvolve supports multiple sync modes:\n\n- **Hybrid sync**: Sync from both DA layer and P2P network (default when peers are configured)\n- **DA-only sync**: Sync exclusively from DA layer by leaving P2P peers empty (see [Configuration Guide](docs/learn/config.md#da-only-sync-mode))\n- **P2P-priority sync**: Prioritize P2P with DA as fallback\n\n### Example Implementation: TestApp CLI\n\nThe easiest way to understand how to use Evolve is by exploring our example implementation, TestApp.\n\nRequires Go version \u003e= 1.22.\n\nTestApp is a CLI tool that demonstrates how to run different kinds of nodes using the Evolve framework.\nIt serves as a reference implementation and helps you understand how to build your own Evolve-based blockchain.\n\n#### Install\n\nTo install the example `testapp`, simply run the following command at the root of the\nev-node repo:\n\n```bash\nmake install\n```\n\nThe latest TestApp example is now installed. You can verify the installation by running:\n\n```bash\ntestapp version\n```\n\n#### Quick Start\n\nYou can spin up a local TestApp network (powered by Evolve) with the following command:\n\n```bash\ntestapp start\n```\n\n## Building with Evolve\n\nEvolve is the first sovereign application framework that allows you to launch\na sovereign, customizable blockchain as easily as a smart contract.\nTestApp serves as a reference implementation to help you get started with your own Evolve-based blockchain.\n\nCheck out our tutorials on our [website][docs].\n\n## Onboarding with Claude Code\n\nUse [Claude Code](https://claude.ai/code) to explore the codebase:\n\n```bash\ncd ev-node \u0026\u0026 claude\n```\n\nExample prompts:\n\n| Goal | Prompt |\n|------|--------|\n| Overview | \"How does ev-node work?\" |\n| Block package | \"Explain block production flow\" |\n| DA layer | \"How does the DA layer work?\" |\n| Sequencing | \"Explain single vs based sequencer\" |\n\nThe `.claude/skills/ev-node-explainer/` skill provides architecture docs for block, DA, and sequencing systems.\n\n## Contributing\n\nWe welcome your contributions! Everyone is welcome to contribute, whether it's\nin the form of code, documentation, bug reports, feature\nrequests, or anything else.\n\nIf you're looking for issues to work on, try looking at the\n[good first issue list](https://github.com/evstack/ev-node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).\nIssues with this tag are suitable for a new external contributor and is a great\nway to find something you can help with!\n\nSee\n[the contributing guide](https://github.com/evstack/ev-node/blob/main/CONTRIBUTING.md)\nfor more details.\n\nPlease join our\n[Community Discord](https://discord.com/invite/YsnTPcSfWQ)\nto ask questions, discuss your ideas, and connect with other contributors.\n\n### Helpful commands\n\n```sh\n# Run unit tests\nmake test\n\n# Generate protobuf files (requires Docker)\nmake proto-gen\n\n# Run linters (requires golangci-lint, markdownlint, hadolint, and yamllint)\nmake lint\n\n# Lint protobuf files (requires Docker and buf)\nmake proto-lint\n\n```\n\n### Tools\n\n1. Install [golangci-lint](https://golangci-lint.run/welcome/install/)\n1. Install [markdownlint](https://github.com/DavidAnson/markdownlint)\n1. Install [hadolint](https://github.com/hadolint/hadolint)\n1. Install [yamllint](https://yamllint.readthedocs.io/en/stable/quickstart.html)\n\n## Audits\n\n| Date | Auditor | Version | Report |\n|---|---|---|---|\n| 2024/01/12 | [Informal Systems](https://informal.systems/) | [eccdd...bcb9d](https://github.com/evstack/ev-node/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [informal-systems.pdf](docs/audit/informal-systems.pdf) |\n| 2024/01/10 | [Binary Builders](https://binary.builders/)   | [eccdd...bcb9d](https://github.com/evstack/ev-node/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [binary-builders.pdf](docs/audit/binary-builders.pdf)   |\n\n[docs]: \u003chttps://ev.xyz\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevstack%2Fev-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevstack%2Fev-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevstack%2Fev-node/lists"}