{"id":23353878,"url":"https://github.com/epicchainlabs/epicchain-node","last_synced_at":"2025-04-07T19:20:33.557Z","repository":{"id":266116612,"uuid":"805200171","full_name":"epicchainlabs/epicchain-node","owner":"epicchainlabs","description":"EpicChain Node is a core component of the EpicChain blockchain network. Nodes are organized in a peer-to-peer network that ensures the secure storage and distribution of user data. By participating as a node in the EpicChain network, you contribute to the decentralization, security, and resilience of the blockchain.","archived":false,"fork":false,"pushed_at":"2024-12-09T05:12:07.000Z","size":3878,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-13T20:49:37.266Z","etag":null,"topics":["blockchain-node","blockchain-resilience","blockchain-security","decentralization","distributed-network","epicchain","epicchain-node","node-participation","peertopeer-network","secure-data-storage"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epicchainlabs.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-24T04:56:17.000Z","updated_at":"2024-12-09T05:12:11.000Z","dependencies_parsed_at":"2024-12-02T17:52:37.285Z","dependency_job_id":null,"html_url":"https://github.com/epicchainlabs/epicchain-node","commit_stats":null,"previous_names":["epicchainlabs/epicchain-node"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicchainlabs%2Fepicchain-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicchainlabs%2Fepicchain-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicchainlabs%2Fepicchain-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicchainlabs%2Fepicchain-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epicchainlabs","download_url":"https://codeload.github.com/epicchainlabs/epicchain-node/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247713262,"owners_count":20983683,"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-node","blockchain-resilience","blockchain-security","decentralization","distributed-network","epicchain","epicchain-node","node-participation","peertopeer-network","secure-data-storage"],"created_at":"2024-12-21T09:16:51.269Z","updated_at":"2025-04-07T19:20:33.515Z","avatar_url":"https://github.com/epicchainlabs.png","language":"Go","readme":"\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://fs.epicchain.org\"\u003eepicchain\u003c/a\u003e is a decentralized distributed object storage integrated with the \u003ca href=\"https://epicchain.org\"\u003eepicchain Blockchain\u003c/a\u003e.\n\u003c/p\u003e\n\n---\n\n[![Report](https://goreportcard.com/badge/github.com/epicchainlabs/epicchain-node)](https://goreportcard.com/report/github.com/epicchainlabs/epicchain-node)\n![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/nspcc-dev/epicchain-node?sort=semver)\n![License](https://img.shields.io/github/license/nspcc-dev/epicchain-node.svg?style=popout)\n\n# Overview\n\nepicchain nodes are organized in a peer-to-peer network that stores and distributes users' data. Any epicchain user may participate in the network, either providing storage resources to earn compensation or storing their data at a competitive price.\n\nUsers can reliably store object data in the epicchain network and have full control over data placement due to the decentralized architecture and flexible storage policies. Nodes execute these storage policies, allowing users to specify parameters such as geographical location, reliability level, number of nodes, type of disks, capacity, and more.\n\nDeep [epicchain Blockchain](https://epicchain.org) integration allows epicchain to be used by dApps directly from [epicchainVM](https://docs.epicchain.org/docs/en-us/basic/technology/epicchainvm.html) on the [Smart Contract](https://docs.epicchain.org/docs/en-us/intro/glossary.html) code level. This enables dApps to manipulate large amounts of data affordably.\n\nepicchain offers a native [gRPC API](https://github.com/epicchainlabs/epicchain-api) and protocol gateways for popular protocols such as [AWS S3](https://github.com/epicchainlabs/epicchain-s3-gw), [HTTP](https://github.com/epicchainlabs/epicchain-http-gw), [FUSE](https://wikipedia.org/wiki/Filesystem_in_Userspace), and [sFTP](https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol), allowing developers to integrate applications without extensive code rewriting.\n\n# Supported Platforms\n\nCurrently, we support GNU/Linux on amd64 CPUs with AVX/AVX2 instructions. More platforms will be supported after release `1.0`.\n\nThe latest version of epicchain-node is compatible with epicchain-contract [v0.19.1](https://github.com/epicchainlabs/epicchain-contract/releases/tag/v0.19.1).\n\n# Building\n\nTo compile all binaries, you need Go 1.20+ and `make`:\n```sh\nmake all\n```\nThe resulting binaries will appear in the `bin/` folder.\n\nTo make a specific binary, use:\n```sh\nmake bin/epicchain-\u003cname\u003e\n```\nSee the list of all available commands in the `cmd` folder.\n\n## Building with Docker\n\nBuilding can also be performed in a container:\n```sh\nmake docker/all                      # build all binaries\nmake docker/bin/epicchain-\u003cname\u003e     # build a specific binary\n```\n\n## Docker Images\n\nTo create Docker images suitable for use in [epicchain-dev-env](https://github.com/epicchainlabs/epicchain-dev-env/), use:\n```sh\nmake images\n```\n\n# Running\n\n## CLI\n\n`epicchain-cli` allows users to manage containers and objects by connecting to any node in the target network. Detailed descriptions of all commands and options are provided within the tool, but some specific concepts have additional documentation:\n* [Sessions](docs/cli-sessions.md)\n* [Extended headers](docs/cli-xheaders.md)\n* [Exit codes](docs/cli-exit-codes.md)\n\n`epicchain-adm` is a network setup and management utility for network administrators. Refer to [docs/cli-adm.md](docs/cli-adm.md) for more information.\n\nBoth `epicchain-cli` and `epicchain-adm` can take a configuration file as a parameter to simplify working with the same network/wallet. See [cli.yaml](config/example/cli.yaml) for an example. Control service-specific configuration examples are [ir-control.yaml](config/example/ir-control.yaml) and [node-control.yaml](config/example/node-control.yaml) for IR and SN nodes, respectively.\n\n## Node\n\nThere are two kinds of nodes: inner ring nodes and storage nodes. Most users will run storage nodes, while inner ring nodes are special and similar to epicchain consensus nodes in their network role. Both accept parameters from YAML or JSON configuration files and environment variables.\n\nSee [docs/sighup.md](docs/sighup.md) on how to reconfigure nodes without a restart.\n\nSee [docs/storage-node-configuration.md](docs/storage-node-configuration.md) on how to configure a storage node.\n\n### Example Configurations\n\nThese examples contain all possible configurations of epicchain nodes. While the parameters are correct, the provided values are for informational purposes only and not recommended for direct use. Real networks and configurations will differ significantly.\n\nSee [node.yaml](node.yaml) for configuration notes.\n- Storage node:\n  - YAML (with comments): [node.yaml](config/example/node.yaml)\n  - JSON: [node.json](config/example/node.json)\n  - Environment: [node.env](config/example/node.env)\n- Inner ring:\n  - YAML: [ir.yaml](config/example/ir.yaml)\n  - Environment: [ir.env](config/example/ir.env)\n\n# Private Network\n\nFor epicchain development, consider using [epicchain-dev-env](https://github.com/epicchainlabs/epicchain-dev-env/). For developing applications using epicchain, the lighter [epicchain-aio](https://github.com/epicchainlabs/epicchain-aio) container is recommended. For manual deployment, refer to [docs/deploy.md](docs/deploy.md).\n\n# Contributing\n\nWe welcome contributions! Please read the [contributing guidelines](CONTRIBUTING.md) before starting. Create a new issue first, describing the feature or topic you plan to implement.\n\n# Credits\n\nepicchain is maintained by [epicchainSPCC](https://nspcc.ru) with contributions from the community. Please see [CREDITS](CREDITS.md) for details.\n\n# License\n\n- [GNU General Public License v3.0](LICENSE)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepicchainlabs%2Fepicchain-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepicchainlabs%2Fepicchain-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepicchainlabs%2Fepicchain-node/lists"}