{"id":13499329,"url":"https://github.com/aeternity/aeternity","last_synced_at":"2025-05-14T14:08:03.345Z","repository":{"id":37431067,"uuid":"99802036","full_name":"aeternity/aeternity","owner":"aeternity","description":"æternity blockchain - scalable blockchain for the people - smart contracts, state channels, names, tokens","archived":false,"fork":false,"pushed_at":"2025-04-30T09:16:57.000Z","size":37530,"stargazers_count":1079,"open_issues_count":265,"forks_count":241,"subscribers_count":128,"default_branch":"master","last_synced_at":"2025-04-30T09:23:56.295Z","etag":null,"topics":["aeternity","bitcoin","blockchain","crypto","cryptocurrency","cryptography","erlang","ethereum","mining","scaling","smart-contracts","testnet"],"latest_commit_sha":null,"homepage":"http://www.aeternity.com","language":"Erlang","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aeternity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2017-08-09T11:44:30.000Z","updated_at":"2025-04-30T09:17:00.000Z","dependencies_parsed_at":"2023-11-23T12:27:29.395Z","dependency_job_id":"c848fc8b-7bc5-4bb6-b07e-9b917afb0d1c","html_url":"https://github.com/aeternity/aeternity","commit_stats":{"total_commits":5208,"total_committers":99,"mean_commits":52.60606060606061,"dds":0.8310291858678955,"last_synced_commit":"d505be6ec9a57c34f0fd97483b577c66ce57f95d"},"previous_names":[],"tags_count":138,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeternity%2Faeternity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeternity%2Faeternity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeternity%2Faeternity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeternity%2Faeternity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aeternity","download_url":"https://codeload.github.com/aeternity/aeternity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254159590,"owners_count":22024562,"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":["aeternity","bitcoin","blockchain","crypto","cryptocurrency","cryptography","erlang","ethereum","mining","scaling","smart-contracts","testnet"],"created_at":"2024-07-31T22:00:32.247Z","updated_at":"2025-05-14T14:08:03.325Z","avatar_url":"https://github.com/aeternity.png","language":"Erlang","readme":"# Aeternity node\n\n[![CircleCI][circleci badge]][circleci]\n[![License][license badge]][license]\n[![Build Tool][build tool]][rebar3]\n\nA new blockchain for æpps.\n\nOptimized for scalability via smart contracts inside state-channels.\n\nHas a built-in oracle for integration with real-world data.\n\nComes with a naming system, for developerability.\n\nWritten in Erlang.\n\nTo install and run the Aeternity node, see the instructions [below](#how-to-start) or just follow the progress of the project via GitHub Issues.\n\nIf you have discovered a bug or security vulnerability please get in touch. The Aeternity Crypto Foundation pays bug bounties up to 100.000 AE Tokens for critical vulnerabilities. Please get in touch via [security@aeternity-foundation.org](mailto:security@aeternity-foundation.org).\n\n[pivotal]: https://www.pivotaltracker.com/n/projects/2124891\n[hackerone]: https://hackerone.com/aeternity\n\n## Documentation\n\nFor an overview of the installation process for different platforms,\nbuilding the package from source, configuration and operation of the Aeternity\nnode please refer to [Aeternity node documentation](https://docs.aeternity.io/).\n\nWe keep our protocol, APIs and research spec in separate [protocol][protocol]\nrepository.\n\n[protocol]: https://github.com/aeternity/protocol\n\n# How to start\n\nWe [publish packages][releases] for major platforms on GitHub.\nEach release comes with [release notes][release-notes] describing the\nchanges of the Aeternity node in each particular version.\n\nPlease use the [latest published stable release][latest-release] rather than the [`master` branch][master].\nThe `master` branch tracks the ongoing efforts towards the next stable release to be published though it is not guaranteed to be stable.\n\n[releases]: https://github.com/aeternity/aeternity/releases\n[release-notes]: /docs/release-notes\n[latest-release]: https://github.com/aeternity/aeternity/releases/latest\n[master]: https://github.com/aeternity/aeternity/tree/master\n\n## Quick Install\n\n**Linux / Mac**\n\nBy using the installer to install the latest stable version:\n```bash\nbash \u003c(curl -s https://install.aeternity.io/install.sh)\n```\nSee the documentation for [starting](https://docs.aeternity.io/en/stable/operation/#start-the-node) and [configuring](https://docs.aeternity.io/en/stable/configuration/#example) the node.\n\n## Docker\n\nAlternatively, you can run the node client as a docker container:\n\n**Linux / Mac**\n\nOr running a docker container (latest tag):\n```bash\nmkdir -p ~/.aeternity/maindb\ndocker pull aeternity/aeternity\ndocker run -p 3013:3013 -p 3015:3015 \\\n    -v ~/.aeternity/maindb:/home/aeternity/node/data/mnesia \\\n    aeternity/aeternity\n```\n**Windows**\n```bash\nmkdir %APPDATA%\\aeternity\\maindb\ndocker pull aeternity/aeternity\ndocker run -p 3013:3013 -p 3015:3015 -v %APPDATA%/aeternity/maindb:/home/aeternity/node/data/mnesia aeternity/aeternity\n```\n\n#### Restore from snapshot\n\nTo speed up the initial blockchain synchronization the node database can be restored from a snapshot following the below steps:\n\n* delete the contents of the database if the node has been started already\n* download the database snapshot\n* verify if the snapshot checksum matches the downloaded file\n* unarchive the database snapshot\n\n**Note that the docker container must be stopped before replacing the database**\n\nThe following snippet can be used to replace the current database with the latest mainnet snapshot assuming the database path is ` ~/.aeternity/maindb`:\n\n```bash\nrm -rf ~/.aeternity/maindb/ \u0026\u0026 mkdir -p ~/.aeternity/maindb/\ncurl -o ~/.aeternity/mnesia_main_v-1_latest.tar.zst https://aeternity-database-backups.s3.eu-central-1.amazonaws.com/main_backup_v1_full_latest.tar.zst\nCHECKSUM=$(curl https://aeternity-database-backups.s3.eu-central-1.amazonaws.com/main_backup_v1_full_latest.tar.zst.md5)\ndiff -qs \u003c(echo $CHECKSUM) \u003c(openssl md5 -r ~/.aeternity/mnesia_main_v-1_latest.tar.zst | awk '{ print $1; }')\ntest $? -eq 0 \u0026\u0026 tar --use-compress-program=unzstd -xf ~/.aeternity/mnesia_main_v-1_latest.tar.zst -C ~/.aeternity/maindb/\n```\n\n\n## Additional resources\n\n* [Threat Model](https://github.com/aeternity/aetmodel/blob/master/ThreatModel.md)\n\n\n[circleci]: https://circleci.com/gh/aeternity/aeternity\n[circleci badge]: https://circleci.com/gh/aeternity/aeternity.svg?style=shield\n[license badge]: https://img.shields.io/badge/license-ISC-blue.svg\n[license]: https://github.com/aeternity/aeternity/blob/master/LICENSE\n[build tool]: https://img.shields.io/badge/build%20tool-rebar3-orange.svg\n[rebar3]: https://www.rebar3.org\n","funding_links":[],"categories":["Node and middleware","Erlang","Infrastructure \u0026 core components","Web 3.0"],"sub_categories":["Node and Middleware"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faeternity%2Faeternity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faeternity%2Faeternity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faeternity%2Faeternity/lists"}