{"id":13562551,"url":"https://github.com/axone-protocol/axoned","last_synced_at":"2025-10-05T14:06:52.397Z","repository":{"id":43999740,"uuid":"454104351","full_name":"axone-protocol/axoned","owner":"axone-protocol","description":"⛓️ Axone blockchain πŸ’«","archived":false,"fork":false,"pushed_at":"2025-05-08T10:26:01.000Z","size":6937,"stargazers_count":169,"open_issues_count":26,"forks_count":122,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-08T11:36:16.277Z","etag":null,"topics":["ai","blockchain","contribution-welcome","cosmos-sdk","golang","help-wanted","orchestration"],"latest_commit_sha":null,"homepage":"https://axone.xyz","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/axone-protocol.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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}},"created_at":"2022-01-31T17:32:05.000Z","updated_at":"2025-05-08T10:26:04.000Z","dependencies_parsed_at":"2023-02-12T21:45:40.549Z","dependency_job_id":"e642de22-1669-4c2e-beeb-eb763afc7a2c","html_url":"https://github.com/axone-protocol/axoned","commit_stats":{"total_commits":1064,"total_committers":18,"mean_commits":"59.111111111111114","dds":0.5958646616541353,"last_synced_commit":"c44b87af7b8e04394126edceb47e69ff2ffc5b76"},"previous_names":["axone-protocol/axoned"],"tags_count":21,"template":false,"template_full_name":"okp4/template-oss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axone-protocol%2Faxoned","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axone-protocol%2Faxoned/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axone-protocol%2Faxoned/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axone-protocol%2Faxoned/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/axone-protocol","download_url":"https://codeload.github.com/axone-protocol/axoned/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254493365,"owners_count":22080127,"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":["ai","blockchain","contribution-welcome","cosmos-sdk","golang","help-wanted","orchestration"],"created_at":"2024-08-01T13:01:09.828Z","updated_at":"2025-10-05T14:06:52.391Z","avatar_url":"https://github.com/axone-protocol.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"[![axone github banner](https://raw.githubusercontent.com/axone-protocol/.github/main/profile/static/axone-banner.png)](https://axone.xyz)\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://discord.gg/axone\"\u003e\u003cimg src=\"https://img.shields.io/discord/946759919678406696.svg?label=discord\u0026labelColor=7289DA\u0026logo=discord\u0026logoColor=white\u0026color=gray\u0026style=for-the-badge\" /\u003e\u003c/a\u003e \u0026nbsp;\n \u003ca href=\"https://www.linkedin.com/company/axone-protocol/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n \u003ca href=\"https://twitter.com/axonexyz\"\u003e\u003cimg src=\"https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n \u003ca href=\"https://blog.axone.xyz\"\u003e\u003cimg src=\"https://img.shields.io/badge/Medium-12100E?style=for-the-badge\u0026logo=medium\u0026logoColor=white\" /\u003e\u003c/a\u003e \u0026nbsp;\n \u003ca href=\"https://www.youtube.com/channel/UCiOfcTaUyv2Szv4OQIepIvg\"\u003e\u003cimg src=\"https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge\u0026logo=youtube\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Axone - Orchestration Layer for AI\n\n[![lint](https://img.shields.io/github/actions/workflow/status/axone-protocol/axoned/lint.yml?label=lint\u0026style=for-the-badge\u0026logo=github)](https://github.com/axone-protocol/axoned/actions/workflows/lint.yml)\n[![build](https://img.shields.io/github/actions/workflow/status/axone-protocol/axoned/build.yml?label=build\u0026style=for-the-badge\u0026logo=github)](https://github.com/axone-protocol/axoned/actions/workflows/build.yml)\n[![test](https://img.shields.io/github/actions/workflow/status/axone-protocol/axoned/test.yml?label=test\u0026style=for-the-badge\u0026logo=github)](https://github.com/axone-protocol/axoned/actions/workflows/test.yml)\n[![codecov](https://img.shields.io/codecov/c/github/axone-protocol/axoned?style=for-the-badge\u0026token=O3FJO5QDCA\u0026logo=codecov)](https://codecov.io/gh/axone-protocol/axoned)\n[![Go Report Card](https://goreportcard.com/badge/github.com/axone-protocol/axoned/v13?style=for-the-badge)](https://goreportcard.com/report/github.com/axone-protocol/axoned/v13)\n[![docker-pull](https://img.shields.io/docker/pulls/axoneprotocol/axoned?label=downloads\u0026style=for-the-badge\u0026logo=docker)](https://hub.docker.com/r/axoneprotocol/axoned)\n[![Godoc Reference](https://img.shields.io/badge/godoc-reference-blue.svg?logo=go\u0026logoColor=white\u0026labelColor=gray\u0026label=\u0026style=for-the-badge)](https://pkg.go.dev/github.com/axone-protocol/axoned/v13)\n\n[![conventional commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=for-the-badge\u0026logo=conventionalcommits)](https://conventionalcommits.org)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge)](https://github.com/semantic-release/semantic-release)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?style=for-the-badge)](https://github.com/axone-protocol/.github/blob/main/CODE_OF_CONDUCT.md)\n[![license](https://img.shields.io/github/license/axone-protocol/axoned.svg?label=License\u0026style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)\n\n\u003e `Axone` is a public [dPoS](https://en.bitcoinwiki.org/wiki/DPoS) layer 1 specifically designed for connecting, sharing, and monetizing any resources in the AI stack. It is an open network dedicated to collaborative AI workflow management that is universally compatible with any data, model, or infrastructure. Data, algorithms, storage, compute, APIs... Anything on-chain and off-chain can be shared.\n\n## The protocol\n\n`axoned` is the node of the [AXONE](https://axone.xyz) network built on the [Cosmos SDK] πŸ’« \u0026 [Tendermint] consensus, which allows companies \u0026 individuals to define on-chain rules, share any off-chain resources \u0026 create a new generation of applications on top of them.\n\n- πŸ“– Read the [introduction blog post](https://blog.axone.xyz/) to understand the project’s vision.\n- 🧠 Explore the [white paper](https://docs.axone.xyz/docs/whitepaper/abstract) for a deeper look at the protocol architecture and network economics.\n\nLooking for more?\n\n- If you’re searching for Axone' smart contracts β†’ [github.com/axone-protocol/contracts](https://github.com/axone-protocol/contracts)\n- For the Axone SDK β†’ [github.com/axone-protocol/axone-sdk](https://github.com/axone-protocol/axone-sdk)\n- For the MCP server implementation β†’ [github.com/axone-protocol/axone-mcp](https://github.com/axone-protocol/axone-mcp)\n\n## Want to become a validator?\n\nValidators are responsible for securing the axone network. Validator responsibilities include maintaining a functional [node](https://docs.axone.xyz/docs/nodes/run-node) with constant uptime and providing a sufficient amount of $AXONE as stake. In exchange for this service, validators receive block rewards and transaction fees.\n\nWant to become a validator? πŸ‘‰ [Checkout the documentation!](https://docs.axone.xyz/docs/nodes/introduction)\n\nLooking for a network to join ? πŸ‘‰ [Checkout the networks!](https://github.com/axone-protocol/networks)\n\n## Supported platforms\n\nThe `axoned` blockchain currently supports the following builds:\n\n| **Platform** | **Arch** | **Status** |\n| ------------ | -------- | :--------------------: |\n| Darwin | amd64 | βœ… |\n| Darwin | arm64 | βœ… |\n| Linux | amd64 | βœ… |\n| Linux | arm64 | βœ… |\n| Windows | amd64 | ️🚫\u003cbr/\u003e Not supported |\n\n\u003e Note: as the blockchain depends on [CosmWasm/wasmvm](https://github.com/CosmWasm/wasmvm), we only support the targets\n\u003e supported by this project.\n\n## Releases\n\nAll releases can be found [here](https://github.com/axone-protocol/axoned/releases).\n\n`axoned` follows the [Semantic Versioning 2.0.0](https://semver.org/) to determine when and how the version changes, and\nwe also apply the philosophical principles of [release early - release often](https://en.wikipedia.org/wiki/Release_early,_release_often).\n\n## Install\n\n### From release\n\n```sh\ncurl https://i.jpillora.com/axone-protocol/axoned! | bash\n```\n\n### From source\n\n```sh\nmake install\n```\n\n### Using docker\n\n```sh\ndocker run -ti --rm axoneprotocol/axoned --help\n```\n\n## Developing \u0026 contributing\n\n`axoned` is written in [Go] and built using [Cosmos SDK]. A number of smart contracts are also deployed on the\nAXONE blockchain and hosted in the [axone-protocol/contracts](https://github.com/axone-protocol/contracts) project.\n\n### Prerequisites\n\n- install [Go] `1.24+` following instructions from the [official Go documentation](https://golang.org/doc/install);\n- use [gofumpt](https://github.com/mvdan/gofumpt) as formatter. You can integrate it in your favorite IDE following these [instructions](https://github.com/mvdan/gofumpt#installation) or invoke the makefile `make format-go`;\n- verify that [Docker] is properly installed and if not, follow the [instructions](https://docs.docker.com) for your environment;\n- verify that [`make`](https://fr.wikipedia.org/wiki/Make) is properly installed if you intend to use the provided `Makefile`.\n\n### Makefile\n\nThe project comes with a convenient `Makefile` that helps you to build, install, lint and test the project.\n\n```text\n$ make \u003ctarget\u003e\n\nTargets:\n Lint:\n lint Lint all available linters\n lint-go Lint go source code\n lint-go-golangci Lint go source code with golangci-lint\n lint-go-modernize Lint go source code with modernize\n lint-proto Lint proto files\n Format:\n format Run all available formatters\n format-go Format go files\n format-proto Format proto files\n Build:\n build Build all available artefacts (executable, docker image, etc.)\n build-go Build node executable for the current environment (default build)\n build-go-all Build node executables for all available environments\n build-docker Build docker image\n Install:\n install Install node executable\n Test:\n test Pass all the tests\n test-go Pass the test for the go source code\n Chain:\n chain-init Initialize the blockchain with default settings.\n chain-start Start the blockchain with existing configuration (see chain-init)\n chain-stop Stop the blockchain\n chain-upgrade Test the chain upgrade from the given FROM_VERSION to the given TO_VERSION.\n Clean:\n clean Remove all the files from the target folder\n Proto:\n proto Generate all resources for proto files (go, doc, etc.)\n proto-gen Generate all the code from the Protobuf files\n Documentation:\n doc Generate all the documentation\n doc-proto Generate the documentation from the Protobuf files\n doc-command Generate markdown documentation for the command\n doc-predicate Generate markdown documentation for all the predicates (module logic)\n Mock:\n mock Generate all the mocks (for tests)\n Release:\n release-assets Generate release assets\n Dependencies:\n deps Install all the dependencies (tools, etc.)\n deps-tparse Install tparse (v0.17.0)\n deps-heighliner Install heighliner (v1.7.4)\n deps-cosmovisor Install cosmovisor (v1.7.1)\n deps-golangci-lint Install golangci-lint (v2.4.0)\n deps-modernize Install modernize (v0.20.0)\n Help:\n help Show this help.\n\nThis Makefile depends on docker. To install it, please follow the instructions:\n- for macOS: https://docs.docker.com/docker-for-mac/install/\n- for Windows: https://docs.docker.com/docker-for-windows/install/\n- for Linux: https://docs.docker.com/engine/install/\n```\n\n### Build\n\nTo build the `axoned` node, invoke the goal `build-go` of the `Makefile`:\n\n```sh\nmake build-go\n```\n\nThe binary will be generated under the folder `target/dist`.\n\n### Build a docker image\n\nThis project leverages [heighliner](https://github.com/strangelove-ventures/heighliner) to simplify the management and\ncreation of production-grade container images. To build a Docker image, use the `build-docker` target in the `Makefile`:\n\n```sh\nmake build-docker\n```\n\n### Run a local network\n\nTo initialize a local network configuration, invoke the goal `chain-init` of the `Makefile`:\n\n```sh\nmake chain-init\n```\n\nThe node home directory will be generated under the folder `target/deployment/localnet`. The configuration contains a single validator node.\n\nTo start the network, invoke the goal `chain-start` of the `Makefile`:\n\n```sh\nmake chain-start\n```\n\nA wallet is preconfigured with some tokens, you can use it as follows:\n\n```sh\naxoned --home target/deployment/localnet tx bank send validator [to_address] [amount]\n```\n\n## Bug reports \u0026 feature requests\n\nIf you notice anything not behaving how you expected, if you would like to make a suggestion or would like\nto request a new feature, please open a [**new issue**](https://github.com/axone-protocol/axoned/issues/new/choose). We appreciate any help\nyou're willing to give!\n\n\u003e Don't hesitate to ask if you are having trouble setting up your project repository, creating your first branch or\n\u003e configuring your development environment. Mentors and maintainers are here to help!\n\n## Audit\n\n| Date | Auditor | Version | Report |\n| ---------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 2024/08/22 | [BlockApex](https://blockapex.io/) | [2f0f84d (v10.0.0)](https://github.com/axone-protocol/axoned/tree/2f0f84d369852bdb178e299a88c1b8eeb0654b8e) | [Axone Blockchain - Final Audit Report.pdf](https://github.com/BlockApex/Audit-Reports/blob/15d8765ac45b4a83bb2f1446fc9bf869c123f8d2/Axone%20Blockchain%20-%20Final%20Audit%20Report.pdf) |\n\n## Community\n\nThe [**AXONE Discord Server**](https://discord.gg/axone) is our primary chat channel for the open-source community,\nsoftware developers and node operators.\n\nPlease reach out to us and say hi πŸ‘‹, we're happy to help there.\n\n[Cosmos SDK]: https://v1.cosmos.network/sdk\n[Docker]: https://www.docker.com/\n[Go]: https://go.dev\n[Tendermint]: https://tendermint.com/\n\n## You want to get involved? 😍\n\nSo you want to contribute? Great! ❀️ We appreciate any help you're willing to give. Don't hesitate to open issues and/or\nsubmit pull requests.\n\nWe believe that collaboration is key to the success of the Axone project. Join our Community discussions on the [Community space](https://github.com/orgs/axone-protocol/discussions) to:\n\n- Engage in conversations with peers and experts.\n- Share your insights and experiences with Axone.\n- Learn from others and expand your knowledge of the protocol.\n\nThe Community space serves as a hub for discussions, questions, and knowledge-sharing related to Axone.\nWe encourage you to actively participate and contribute to the growth of our community.\n\nPlease check out Axone health files:\n\n- [Contributing](https://github.com/axone-protocol/.github/blob/main/CONTRIBUTING.md)\n- [Code of conduct](https://github.com/axone-protocol/.github/blob/main/CODE_OF_CONDUCT.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxone-protocol%2Faxoned","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxone-protocol%2Faxoned","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxone-protocol%2Faxoned/lists"}