{"id":18705065,"url":"https://github.com/aave/gho-core","last_synced_at":"2025-04-07T10:25:06.774Z","repository":{"id":70210777,"uuid":"483380314","full_name":"aave/gho-core","owner":"aave","description":null,"archived":false,"fork":false,"pushed_at":"2023-12-19T15:19:47.000Z","size":12565,"stargazers_count":205,"open_issues_count":3,"forks_count":56,"subscribers_count":10,"default_branch":"main","last_synced_at":"2023-12-19T16:07:40.361Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aave.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audits/01-03-2023_ABDK.pdf","citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-04-19T19:21:23.000Z","updated_at":"2024-01-17T11:38:46.704Z","dependencies_parsed_at":"2023-12-19T16:06:52.818Z","dependency_job_id":"4e5a2558-4f07-4aa2-92ee-d5137e1e36c6","html_url":"https://github.com/aave/gho-core","commit_stats":null,"previous_names":[],"tags_count":2,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aave%2Fgho-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aave%2Fgho-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aave%2Fgho-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aave%2Fgho-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aave","download_url":"https://codeload.github.com/aave/gho-core/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247633321,"owners_count":20970303,"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":[],"created_at":"2024-11-07T12:09:37.284Z","updated_at":"2025-04-07T10:25:06.743Z","avatar_url":"https://github.com/aave.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build pass](https://github.com/aave/gho/actions/workflows/node.js.yml/badge.svg)](https://github.com/aave/gho/actions/workflows/node.js.yml)\n\n```\n        .///.                .///.     //.            .//  `/////////////-\n       `++:++`              .++:++`    :++`          `++:  `++:......---.`\n      `/+: -+/`            `++- :+/`    /+/         `/+/   `++.\n      /+/   :+/            /+:   /+/    `/+/        /+/`   `++.\n  -::/++::`  /+:       -::/++::` `/+:    `++:      :++`    `++/:::::::::.\n  -:+++::-`  `/+:      --++/---`  `++-    .++-    -++.     `++/:::::::::.\n   -++.       .++-      -++`       .++.    .++.  .++-      `++.\n  .++-         -++.    .++.         -++.    -++``++-       `++.\n `++:           :++`  .++-           :++`    :+//+:        `++:----------`\n -/:             :/-  -/:             :/.     ://:         `/////////////-\n```\n\n# Gho\n\nThis repository contains the source code, tests and deployments for both GHO itself and the first facilitator integrating Aave. The repository uses [Hardhat](https://hardhat.org/) development framework.\n\n## Description\n\nGHO is a decentralized, protocol-agnostic crypto-asset intended to maintain a stable value. GHO is minted and burned by approved entities named Facilitators.\n\nThe first facilitator is the Aave V3 Ethereum Pool, which allows users to mint GHO against their collateral assets, based on the interest rate set by the Aave Governance. In addition, there is a FlashMint module as a second facilitator, which facilitates arbitrage and liquidations, providing instant liquidity.\n\nFurthermore, the Aave Governance has the ability to approve entities as Facilitators and manage the total amount of GHO they can generate (also known as bucket's capacity).\n\n## Documentation\n\nSee the link to the technical paper\n\n- [Technical Paper](./techpaper/GHO_Technical_Paper.pdf)\n- [Developer Documentation](https://docs.gho.xyz/)\n\n## Audits and Formal Verification\n\nYou can find all audit reports under the [audits](./audits/) folder\n\n- [2022-08-12 - OpenZeppelin](./audits/2022-08-12_Openzeppelin-v1.pdf)\n- [2022-11-10 - OpenZeppelin](./audits/2022-11-10_Openzeppelin-v2.pdf)\n- [2023-03-01 - ABDK](./audits/2023-03-01_ABDK.pdf)\n- [2023-02-28 - Certora Formal Verification](./certora/reports/Aave_Gho_Formal_Verification_Report.pdf)\n- [2023-07-06 - Sigma Prime](./audits/2023-07-06_SigmaPrime.pdf)\n- [2023-06-13 - Sigma Prime (GhoSteward)](./audits/2023-06-13_GhoSteward_SigmaPrime.pdf)\n- [2023-09-20 - Emanuele Ricci @Stermi (GHO Stability Module)](./audits/2023-09-20_GSM_Stermi.pdf)\n- [2023-10-23 - Sigma Prime (GHO Stability Module)](./audits/2023-10-23_GSM_SigmaPrime.pdf)\n- [2023-12-07 - Certora Formal Verification (GHO Stability Module)](./certora/reports/Formal_Verification_Report_of_GHO_Stability_Module.pdf)\n- [2024-03-14 - Certora Formal Verification (GhoStewardV2)](./audits/2024-03-14_GhoStewardV2_Certora.pdf)\n- [2024-06-11 - Certora Formal Verification (UpgradeableGHO)](./audits/2024-06-11_UpgradeableGHO_Certora.pdf)\n- [2024-06-11 - Certora Formal Verification (Modular Gho Stewards)](./audits/2024-09-15_ModularGhoStewards_Certora.pdf)\n\n## Getting Started\n\nClone the repository and run the following command to install dependencies:\n\n```sh\nnpm i\nforge i\n```\n\nIf you need to interact with GHO in the Goerli testnet, provide your Alchemy API key and mnemonic in the `.env` file:\n\n```sh\ncp .env.example .env\n# Fill ALCHEMY_KEY and MNEMONIC in the .env file with your editor\ncode .env\n```\n\nCompile contracts:\n\n```sh\nnpm run compile\n```\n\nRun the test suite:\n\n```sh\nnpm run test\n```\n\nDeploy and setup GHO in a local Hardhat network:\n\n```sh\nnpm run deploy-testnet\n```\n\nDeploy and setup GHO in Goerli testnet:\n\n```sh\nnpm run deploy-testnet:goerli\n```\n\n## Connect with the community\n\nYou can join the [Discord](http://aave.com/discord) channel or the [Governance Forum](https://governance.aave.com/) to ask questions about the protocol or talk about Gho with other peers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faave%2Fgho-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faave%2Fgho-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faave%2Fgho-core/lists"}