{"id":19147836,"url":"https://github.com/refcell/evolve","last_synced_at":"2025-05-07T03:02:35.371Z","repository":{"id":150177419,"uuid":"476396742","full_name":"refcell/evolve","owner":"refcell","description":"On-Chain Experiment Hub","archived":false,"fork":false,"pushed_at":"2022-03-31T19:41:54.000Z","size":346,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-05T15:54:40.466Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/refcell.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2022-03-31T16:50:14.000Z","updated_at":"2023-07-25T14:55:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"6dde7f72-66bf-46a4-be1d-143f13264354","html_url":"https://github.com/refcell/evolve","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"refcell/femplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fevolve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fevolve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fevolve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fevolve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/refcell","download_url":"https://codeload.github.com/refcell/evolve/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252804208,"owners_count":21806769,"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-09T07:52:29.972Z","updated_at":"2025-05-07T03:02:34.794Z","avatar_url":"https://github.com/refcell.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg align=\"right\" width=\"150\" height=\"150\" top=\"100\" src=\"./assets/yang.png\"\u003e\n\n# evolve • [![tests](https://github.com/abigger87/evolve/actions/workflows/tests.yml/badge.svg)](https://github.com/abigger87/evolve/actions/workflows/tests.yml) [![lints](https://github.com/abigger87/evolve/actions/workflows/lints.yml/badge.svg)](https://github.com/abigger87/evolve/actions/workflows/lints.yml) ![GitHub](https://img.shields.io/github/license/abigger87/evolve)  ![GitHub package.json version](https://img.shields.io/github/package-json/v/abigger87/evolve)\n\nAn On-Chain Experimentation Hub.\n\n## Overview\n\nThis repo contains infrastructure for an on-chain experimentation hub. The entrypoint is [`Evolve.sol`](./src/Evolve.sol), an ERC20 to orchestrate protocol governance.\n\n`Evolve` is deployed on mainnet at [`0x14813e8905a0f782f796a5273d2efbe6551100d6`](https://etherscan.io/address/0x14813e8905a0f782f796a5273d2efbe6551100d6).\n\n## Blueprint\n\n```ml\nlib\n├─ ds-test — https://github.com/dapphub/ds-test\n├─ forge-std — https://github.com/brockelmore/forge-std\n├─ solmate — https://github.com/Rari-Capital/solmate\nsrc\n├─ tests\n│  └─ ...\n└─ Evolve — The main hub erc20 token\n```\n\n## Installation\n\nTo install with [Foundry](https://github.com/gakonst/foundry):\n\n```\nforge install abigger87/evolve\n```\n\nTo install with [DappTools](https://github.com/dapphub/dapptools):\n\n```\ndapp install abigger87/evolve\n```\n\n## Development\n\n\n**Setup \u0026 Dependencies**\n```bash\nmake\n```\n\n**Compilation**\n```bash\nmake build\n```\n\n**Testing**\n```bash\nmake test\n```\n\n**Deployment \u0026 Verification**\n\nInside the [`scripts/`](./scripts/) directory are a few preconfigured scripts that can be used to deploy and verify contracts.\n\nScripts take inputs from the cli, using silent mode to hide any sensitive information.\n\nNOTE: These scripts are required to be _executable_ meaning they must be made executable by running `chmod +x ./scripts/*`.\n\nNOTE: For local deployment, make sure to run `yarn` or `npm install` before running the `deploy_local.sh` script. Otherwise, hardhat will error due to missing dependencies.\n\nNOTE: these scripts will prompt you for the contract name and deployed addresses (when verifying). Also, they use the `-i` flag on `forge` to ask for your private key for deployment. This uses silent mode which keeps your private key from being printed to the console (and visible in logs).\n\n### First time with Forge/Foundry?\n\nSee the official Foundry installation [instructions](https://github.com/gakonst/foundry/blob/master/README.md#installation).\n\nThen, install the [foundry](https://github.com/gakonst/foundry) toolchain installer (`foundryup`) with:\n```bash\ncurl -L https://foundry.paradigm.xyz | bash\n```\n\nNow that you've installed the `foundryup` binary,\nanytime you need to get the latest `forge` or `cast` binaries,\nyou can run `foundryup`.\n\nSo, simply execute:\n```bash\nfoundryup\n```\n\n🎉 Foundry is installed! 🎉\n\n### Writing Tests with Foundry\n\nWith [Foundry](https://github.com/gakonst/foundry), tests are written in Solidity! 🥳\n\nCreate a test file for your contract in the `src/tests/` directory.\n\nTo learn more about writing tests in Solidity for Foundry and Dapptools, reference Rari Capital's [solmate](https://github.com/Rari-Capital/solmate/tree/main/src/test) repository largely created by [@transmissions11](https://twitter.com/transmissions11).\n\n### Configure Foundry\n\nUsing [foundry.toml](./foundry.toml), Foundry is easily configurable.\n\nFor a full list of configuration options, see the Foundry [configuration documentation](https://github.com/gakonst/foundry/blob/master/config/README.md#all-options).\n\n## License\n\n[AGPL-3.0-only](https://github.com/abigger87/evolve/blob/master/LICENSE)\n\n## Acknowledgements\n\n- [femplate](https://github.com/abigger87/femplate)\n- [foundry](https://github.com/gakonst/foundry)\n- [solmate](https://github.com/Rari-Capital/solmate)\n- [forge-std](https://github.com/brockelmore/forge-std)\n- [clones-with-immutable-args](https://github.com/wighawag/clones-with-immutable-args).\n- [foundry-toolchain](https://github.com/onbjerg/foundry-toolchain) by [onbjerg](https://github.com/onbjerg).\n- [forge-template](https://github.com/FrankieIsLost/forge-template) by [FrankieIsLost](https://github.com/FrankieIsLost).\n- [Georgios Konstantopoulos](https://github.com/gakonst) for [forge-template](https://github.com/gakonst/forge-template) resource.\n\n## Disclaimer\n\n_These smart contracts are being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the user interface or the smart contracts. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. The creators are not liable for any of the foregoing. Users should proceed with caution and use at their own risk._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefcell%2Fevolve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frefcell%2Fevolve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefcell%2Fevolve/lists"}