{"id":15291911,"url":"https://github.com/muhdhammad/foundry-nft","last_synced_at":"2026-05-06T05:33:21.294Z","repository":{"id":255745496,"uuid":"853522077","full_name":"Muhdhammad/foundry-nft","owner":"Muhdhammad","description":"Demonstrates creating IPFS-hosted NFTs and on-chain SVG NFTs.","archived":false,"fork":false,"pushed_at":"2024-09-09T17:10:16.000Z","size":277,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T15:12:14.613Z","etag":null,"topics":["blockchain","erc721","ethereum","foundry","nft","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-09-06T20:32:02.000Z","updated_at":"2024-09-09T17:23:28.000Z","dependencies_parsed_at":"2024-09-09T20:36:27.617Z","dependency_job_id":null,"html_url":"https://github.com/Muhdhammad/foundry-nft","commit_stats":null,"previous_names":["muhdhammad/foundry-nft"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-nft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-nft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-nft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muhdhammad%2Ffoundry-nft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Muhdhammad","download_url":"https://codeload.github.com/Muhdhammad/foundry-nft/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245247311,"owners_count":20584327,"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","erc721","ethereum","foundry","nft","smart-contracts","solidity"],"created_at":"2024-09-30T16:15:04.322Z","updated_at":"2026-05-06T05:33:21.228Z","avatar_url":"https://github.com/Muhdhammad.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Getting Started 🚀\n\n## About \nThis project focuses on developing two distinct types of NFTs\n1. IPFS Hosted NFT\n2. SVG NFT (hosted 100% on-chain)\n\nHere are the simple NFTs used for the projects.\n\n\n\u003cdiv style=\"display: flex; align-items: center; gap: 10px;\"\u003e\n  \u003cimg src=\"img/mylo.png\" width=\"200\" height=\"200\" alt=\"Basic NFT\"\u003e\n  \u003cimg src=\"img/happymood.png\" width=\"150\" height=\"150\" alt=\"Happy Mood\"\u003e\n  \u003cimg src=\"img/sadmood.png\" width=\"150\" height=\"150\" alt=\"Sad Mood\"\u003e\n\u003c/div\u003e\n\n---\n\n## Quickstart\n```\ngit clone https://github.com/Muhdhammad/foundry-nft.git\ncd foundry-nft\nforge install\nforge build\n```\n\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### 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 IPFS NFT\n\n```\nmake deploy ARGS=\"--network sepolia\"\n```\n\n4. Deploy SVG NFT\n```\nmake deployMood ARGS=\"--network sepolia\"\n```\n\n\n### Testing\n\nThis project consists of three basic testings to ensure its functionality.\n1. Unit \n2. Integration\n3. Forked\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## Base-64\nTo get base64 of an image, run\n```\necho \"data:image/svg+xml;base64,$(base64 -i ./img/happymood.svg)\"\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## Formatting\nTo format your code\n```\nforge fmt\n```\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\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhdhammad%2Ffoundry-nft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuhdhammad%2Ffoundry-nft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhdhammad%2Ffoundry-nft/lists"}