{"id":15158154,"url":"https://github.com/muhdhammad/foundry-erc20","last_synced_at":"2026-01-27T20:19:29.804Z","repository":{"id":254854392,"uuid":"847794978","full_name":"Muhdhammad/foundry-erc20","owner":"Muhdhammad","description":"Implementation of a standard ERC20 token with OpenZeppelin.","archived":false,"fork":false,"pushed_at":"2024-09-09T17:18:10.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T02:29:32.922Z","etag":null,"topics":["erc20-tokens","ethereum","evm","foundry","smart-contracts","solidity"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Muhdhammad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-08-26T15:02:10.000Z","updated_at":"2024-09-09T17:18:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"1638a9a2-0448-4c11-acb5-f24bf464af6f","html_url":"https://github.com/Muhdhammad/foundry-erc20","commit_stats":{"total_commits":7,"total_committers":2,"mean_commits":3.5,"dds":0.2857142857142857,"last_synced_commit":"ad3837c38643cfc2134d4eff250875a0d7e36e21"},"previous_names":["muhdhammad/foundry-erc20"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-erc20","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-erc20/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-erc20/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-erc20/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Muhdhammad","download_url":"https://codeload.github.com/Muhdhammad/foundry-erc20/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237990598,"owners_count":19398458,"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":["erc20-tokens","ethereum","evm","foundry","smart-contracts","solidity"],"created_at":"2024-09-26T20:40:52.452Z","updated_at":"2025-10-24T14:31:59.835Z","avatar_url":"https://github.com/Muhdhammad.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Getting Started 🚀\n\n## About \nA project to create and deploy a standard ERC20 token using Foundry and OpenZeppelin.\n## Requirements\n[git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git):  \nEnsure Git is installed. Verify by running ```git --version```. If you see something like ```git version x.x.x```, you're all set.\n\n\n[foundry](https://getfoundry.sh/):  \nEnsure Foundry is installed. Check with ```forge --version```. If you see a version string like ```forge 0.2.0 (f2518c9 2024-08-06T00:18:13.943817879Z)```, you're good to go.\n\n## Usage\n### OpenZeppelin-Contracts\n### Explore the Docs \nDive into the [OpenZeppelin Contracts Documentation](https://docs.openzeppelin.com/contracts/4.x/) for detailed guidance and examples.\n### Get Involved\nCheck out the [OpenZeppelin GitHub Repository](https://github.com/OpenZeppelin/openzeppelin-contracts) to see the code and contribute to the community.\n### Installation OpenZeppelin package\nTo get started with OpenZeppelin Contracts, install the package\n```\nforge install OpenZeppelin/openzeppelin-contracts\n```\n\n### Spin Up a Local Node\nStart your local blockchain node to deploy contracts:\n```\nmake anvil\n```\n\n### Deploy\nWith your local node up and running, deploy your contracts with:\n```\nmake deploy\n```\n\n### Deployment to testnet or mainnet\n1. Setup Environment Variables \n\nYou'll need to configure your environment with `$SEPOLIA_RPC_URL` and `PRIVATE_KEY` in a `.env` file:\n\n- `$PRIVATE_KEY`: Your account's private key (e.g., from [Metamask](https://metamask.io/)). **SERIOUS NOTE:** For development, use a key without real funds.\n\n- `$SEPOLIA_RPC_URL`: URL of the Sepolia testnet node you're using. You can get this from any free service provider like [Alchemy](https://www.alchemy.com/).\n\n- **Optionally:** Add `ETHERSCAN_API_KEY` if you want to verify your contract on [Etherscan](https://etherscan.io/).\n\n2. Get testnet ETH \n \nGo to [faucets.chain.link](https://faucets.chain.link/) or any other faucet to get testnet ETH, you should see ETH appear in you wallet.\n\n3. Deploy\n\nYou can deploy to testnet Sepolia or any other network.\n```\nmake deploy-sepolia\n```\n\n## Scripts\nAfter deploy to a testnet or local net, you can run the scripts.\n\nUsing cast deployed locally example:\n```\ncast send \u003cERC20_CONTRACT_ADDRESS\u003e \"transfer()\"  --value 0.1ether --private-key \u003cPRIVATE_KEY\u003e --rpc-url $SEPOLIA_RPC_URL\n```\n\n\n### Testing\n\nThis project consists of basic unit testing to ensure its functionality.\n\n```\nforge test\n```\nYou can also,\n```\n// Only run test functions matching the specified regex pattern.\n\nforge test --match-test testFunctionName\n```\n\nor\n```\nforge test --fork-url $SEPOLIA_RPC_URL\n```\n\n### Test Coverage\n```\nforge coverage\n```\n\n## Gas Estimation\nYou can estimate how much gas different things cost by running\n```\nforge snapshot\n```\nYou'll see any output file called `.gas-snapshot`\n\n## Additional Note ⚠️\n\nBest practice to use your `$PRIVATE_KEY` is to encode it and then use it, you should never hard copy paste your private key with the real funds in the `.env` file.\n\n## Thanks 🙌\nThank you for staying engaged with this project, if you appreciated this, feel free to follow!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhdhammad%2Ffoundry-erc20","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuhdhammad%2Ffoundry-erc20","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhdhammad%2Ffoundry-erc20/lists"}