{"id":13534626,"url":"https://github.com/iotexproject/iotex-core","last_synced_at":"2026-05-08T01:13:11.008Z","repository":{"id":37412959,"uuid":"130281002","full_name":"iotexproject/iotex-core","owner":"iotexproject","description":"Official implementation of IoTeX blockchain protocol in Go. An ultra-efficient EVM blockchain offering 1000 TPS with instant 1-block finality. Perfect for DeFi, DePIN tokenomics, Identities, and any trusted logic requiring Web3 composability","archived":false,"fork":false,"pushed_at":"2025-05-13T07:11:17.000Z","size":81721,"stargazers_count":1556,"open_issues_count":215,"forks_count":337,"subscribers_count":95,"default_branch":"master","last_synced_at":"2025-05-13T08:25:50.420Z","etag":null,"topics":["blockchain","crypto","cryptography","depin","distributed-systems","internet-of-everything","internet-of-things","machinefi"],"latest_commit_sha":null,"homepage":"https://iotex.io","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/iotexproject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-04-19T22:56:20.000Z","updated_at":"2025-05-12T21:12:01.000Z","dependencies_parsed_at":"2022-07-13T18:21:10.324Z","dependency_job_id":"d50a67fc-ffde-449d-8a22-24ec7ca95bbd","html_url":"https://github.com/iotexproject/iotex-core","commit_stats":{"total_commits":3370,"total_committers":110,"mean_commits":"30.636363636363637","dds":0.8691394658753709,"last_synced_commit":"76a6cad13ad8f8335ed8aba9aacf8fcdeb337d17"},"previous_names":[],"tags_count":260,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiotex-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiotex-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiotex-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiotex-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iotexproject","download_url":"https://codeload.github.com/iotexproject/iotex-core/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052668,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["blockchain","crypto","cryptography","depin","distributed-systems","internet-of-everything","internet-of-things","machinefi"],"created_at":"2024-08-01T08:00:33.371Z","updated_at":"2025-12-25T09:36:36.812Z","avatar_url":"https://github.com/iotexproject.png","language":"Go","funding_links":[],"categories":["Uncategorized","Go","Top Internet of Things (IOT)"],"sub_categories":["Uncategorized"],"readme":"# iotex-core \n\nOfficial Golang implementation of the IoTeX protocol, the modular DePIN Layer-1 network.\n\n[![Join the forum](https://img.shields.io/badge/Discuss-IoTeX%20Community-blue)](https://community.iotex.io/c/research-development/protocol)\n[![Go version](https://img.shields.io/badge/go-1.18.5-blue.svg)](https://github.com/moovweb/gvm)\n[![Go Report Card](https://goreportcard.com/badge/github.com/iotexproject/iotex-core)](https://goreportcard.com/report/github.com/iotexproject/iotex-core)\n[![Coverage](https://codecov.io/gh/iotexproject/iotex-core/branch/master/graph/badge.svg)](https://codecov.io/gh/iotexproject/iotex-core)\n[![Godoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](https://godoc.org/github.com/iotexproject/iotex-core)\n[![Releases](https://img.shields.io/github/release/iotexproject/iotex-core/all.svg?style=flat-square)](https://github.com/iotexproject/iotex-core/releases)\n[![LICENSE](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n\u003ca href=\"https://iotex.io/\"\u003e\u003cimg src=\"logo/IoTeX.png\" height=\"200px\"/\u003e\u003c/a\u003e\n\n\u003ca href=\"https://iotex.io/devdiscord\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://github.com/iotexproject/halogrants/blob/880eea4af074b082a75608c7376bd7a8eaa1ac21/img/btn-discord.svg\" height=\"36px\"\u003e\n\u003c/a\u003e\n\n## What is IoTeX?\n\nIoTeX is the modular infrastructure for DePIN projects to deploy in full or integrate modules into existing frameworks. Please visit [IoTeX homepage](https://iotex.io) official website to learn more about IoTeX network.\n\n## What is DePIN?\n\nDePIN stands for Decentralized Physical Infrastructure Networks, a new approach to building and maintaining physical world infrastructure. This infrastructure can range from WiFi hotspots in wireless networks to solar-powered home batteries in energy networks. DePINs are developed in a decentralized manner by individuals and companies globally, making them accessible to everyone. In return, contributors receive financial compensation and an ownership stake in the network they’re building and the services they provide through token incentives. DePINs are enabled by widespread internet connectivity and advancements in blockchain infrastructure and cryptography. To learn more about DePIN, please visit [What is DePIN?](https://iotex.io/blog/what-are-decentralized-physical-infrastructure-networks-depin/).\n\n### Explore DePIN Projects?\n\n[DePIN Scan](https://depinscan.io/)  is the go-to explorer for DePIN projects. DePIN Scan tracks crypto token prices, real-time device data, and offers a variety of views for DePIN projects.\n\n## Run a delegate?\n\nPlease visit [IoTeX Delegate Manual](https://github.com/iotexproject/iotex-bootstrap) for detailed setup process.\n\n## Building the source code\n\n### Minimum requirements\n\n| Components | Version | Description |\n|----------|-------------|-------------|\n| [Golang](https://golang.org) | \u0026ge; 1.22.12 | Go programming language |\n| [Protoc](https://developers.google.com/protocol-buffers/) | \u0026ge; 3.6.0 | Protocol buffers, required only when you rebuild protobuf messages |\n\n### Compile\n\nDownload the code to your desired local location (doesn't have to be under `$GOPATH/src`)\n```\ngit clone git@github.com:iotexproject/iotex-core.git\ncd iotex-core\n```\n\nIf you put the project code under your `$GOPATH\\src`, you will need to set up an environment variable\n```\nexport GO111MODULE=on\nset GO111MODULE=on (for windows)\n```\n\nBuild the project for general purpose (server, ioctl) by\n\n```\nmake\n```\n\nBuild the project for broader purpose (server, ioctl, injector...) by\n```\nmake all \n```\n\nIf the dependency needs to be updated, run\n\n```\ngo get -u\ngo mod tidy\n```\nIf you want to learn more advanced usage about `go mod`, you can find out [here](https://github.com/golang/go/wiki/Modules).\n\nRun unit tests only by\n\n```\nmake test\n```\n\nBuild the docker image by\n\n```\nmake docker\n```\n\n### Run iotex-core\n\nStart (or resume) a standalone server to operate on a blockchain by\n\n```\nmake run\n```\n\nRestart the server from a clean state by\n\n```\nmake reboot\n```\n\nIf \"make run\" fails due to corrupted or missing state database while block database is in normal condition, e.g.,\nfailing to get factory's height from underlying DB, please try to recover state database by\n\n```\nmake recover\n```\n\nThen, \"make run\" again.\n\n### Use CLI\n\nUsers could interact with iotex blockchain by\n\n```\nioctl [command]\n```\n\nRefer to [CLI document](https://docs.iotex.io/developer/ioctl/install.html) for more details.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=iotexproject/iotex-core\u0026type=Date)](https://star-history.com/#iotexproject/iotex-core\u0026Date)\n\n## Contact\n\n- Mailing list: [iotex-dev](iotex-dev@iotex.io)\n- Dev Forum: [forum](https://community.iotex.io/c/research-development/protocol)\n- Bugs: [issues](https://github.com/iotexproject/iotex-core/issues)\n\n## Contribution\nWe are glad to have contributors out of the core team; contributions, including (but not limited to) style/bug fixes,\nimplementation of features, proposals of schemes/algorithms, and thorough documentation, are welcomed. Please refer to\nour [contribution guideline](CONTRIBUTING.md) for more\ninformation. Development guide documentation is [here](https://github.com/iotexproject/iotex-core/wiki/Developers%27-Guide).\n\nFor any major protocol level changes, we use [IIP](https://github.com/iotexproject/iips) to track the proposal, decision\nand etc.\n\n## Contributors\n\nThank you for considering contributing to the IoTeX framework!\n\n\u003ca href=\"https://github.com/iotexproject/iotex-core/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=iotexproject/iotex-core\" /\u003e\n\u003c/a\u003e\n\n## License\nThis project is licensed under the [Apache License 2.0](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotexproject%2Fiotex-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiotexproject%2Fiotex-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotexproject%2Fiotex-core/lists"}