{"id":29465826,"url":"https://github.com/buildwithcode888/ultimate-nft","last_synced_at":"2025-10-23T22:59:13.630Z","repository":{"id":292663593,"uuid":"926374390","full_name":"buildwithcode888/ultimate-nft","owner":"buildwithcode888","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-03T06:12:42.000Z","size":210,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T09:04:50.043Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/buildwithcode888.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,"zenodo":null}},"created_at":"2025-02-03T06:07:34.000Z","updated_at":"2025-02-03T06:12:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"a58d7195-459a-407b-999a-57dfb1248c6b","html_url":"https://github.com/buildwithcode888/ultimate-nft","commit_stats":null,"previous_names":["buildwithcode888/ultimate-nft"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/buildwithcode888/ultimate-nft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildwithcode888%2Fultimate-nft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildwithcode888%2Fultimate-nft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildwithcode888%2Fultimate-nft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildwithcode888%2Fultimate-nft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/buildwithcode888","download_url":"https://codeload.github.com/buildwithcode888/ultimate-nft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildwithcode888%2Fultimate-nft/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280706838,"owners_count":26376991,"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","status":"online","status_checked_at":"2025-10-23T02:00:06.710Z","response_time":142,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-07-14T08:21:00.868Z","updated_at":"2025-10-23T22:59:13.624Z","avatar_url":"https://github.com/buildwithcode888.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Ultimate NFT Repo\n\n\u003cbr/\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./images/randomNft/pug.png\" width=\"225\" alt=\"NFT Pug\"\u003e\n\u003cimg src=\"./images/dynamicNft/happy.svg\" width=\"225\" alt=\"NFT Happy\"\u003e\n\u003cimg src=\"./images/randomNft/shiba-inu.png\" width=\"225\" alt=\"NFT Shiba\"\u003e\n\u003cimg src=\"./images/dynamicNft/frown.svg\" width=\"225\" alt=\"NFT Frown\"\u003e\n\u003cimg src=\"./images/randomNft/st-bernard.png\" width=\"225\" alt=\"NFT St.Bernard\"\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\nWe go through creating 3 different kinds of NFTs.\n\n1. A Basic NFT\n2. IPFS Hosted NFT \n   1. That uses Randomness to generate a unique NFT\n3. SVG NFT (Hosted 100% on-chain) \n   1. Uses price feeds to be dynamic\n\n\n# Getting Started\n\n## Requirements\n\n- [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)\n  - You'll know you did it right if you can run `git --version` and you see a response like `git version x.x.x`\n- [Nodejs](https://nodejs.org/en/)\n  - You'll know you've installed nodejs right if you can run:\n    - `node --version` and get an ouput like: `vx.x.x`\n- [Yarn](https://yarnpkg.com/getting-started/install) instead of `npm`\n  - You'll know you've installed yarn right if you can run:\n    - `yarn --version` and get an output like: `x.x.x`\n    - You might need to [install it with `npm`](https://classic.yarnpkg.com/lang/en/docs/install/) or `corepack`\n\n## Quickstart\n\n```\ngit clone https://github.com/smartcontractkit/smart-contract-examples\ncd smart-contract-examples/ultimate-nft-repo\nyarn\n```\n\n# Usage\n\nDeploy:\n\n```\nyarn hardhat deploy\n```\n\n## Testing\n\n```\nyarn hardhat test\n```\n\n### Test Coverage\n\n```\nyarn hardhat coverage\n```\n\n\n\n# Deployment to a testnet or mainnet\n\n1. Setup environment variabltes\n\nYou'll want to set your `SEPOLIA_RPC_URL` and `PRIVATE_KEY` as environment variables. You can add them to a `.env` file, similar to what you see in `.env.example`.\n\n- `PRIVATE_KEY`: The private key of your account (like from [metamask](https://metamask.io/)). **NOTE:** FOR DEVELOPMENT, PLEASE USE A KEY THAT DOESN'T HAVE ANY REAL FUNDS ASSOCIATED WITH IT.\n  - You can [learn how to export it here](https://metamask.zendesk.com/hc/en-us/articles/360015289632-How-to-Export-an-Account-Private-Key).\n- `SEPOLIA_RPC_URL`: This is url of the Sepolia testnet node you're working with. You can get setup with one for free from [Alchemy](https://alchemy.com/?a=673c802981)\n\n2. Get testnet ETH\n\nHead over to [faucets.chain.link](https://faucets.chain.link/) and get some tesnet ETH \u0026 LINK. You should see the ETH and LINK show up in your metamask. [You can read more on setting up your wallet with LINK.](https://docs.chain.link/docs/deploy-your-first-contract/#install-and-fund-your-metamask-wallet)\n\n3. Setup a Chainlink VRF Subscription ID\n\nHead over to [vrf.chain.link](https://vrf.chain.link/) and setup a new subscription, and get a subscriptionId. You can reuse an old subscription if you already have one. \n\n[You can follow the instructions](https://docs.chain.link/docs/get-a-random-number/) if you get lost. You should leave this step with:\n\n1. A subscription ID\n2. Your subscription should be funded with LINK\n\n3. Deploy\n\nIn your `helper-hardhat-config.ts` add your `subscriptionId` under the section of the chainId you're using (aka, if you're deploying to Sepolia, add your `subscriptionId` in the `subscriptionId` field under the `11155111` section.)\n\nThen run:\n```\nyarn hardhat deploy --network sepolia --tags main\n```\n\nWe only deploy the `main` tags, since we need to add our `RandomIpfsNft` contract as a consumer. \n\n4. Add your contract address as a Chainlink VRF Consumer\n\nGo back to [vrf.chain.link](https://vrf.chain.link) and under your subscription add `Add consumer` and add your contract address. You should also fund the contract with a minimum of 1 LINK. \n\n5. Mint NFTs\n\nThen run:\n\n```\nyarn hardhat deploy --network sepolia --tags mint\n```\n\n\n### Estimate gas cost in USD\n\nTo get a USD estimation of gas cost, you'll need a `COINMARKETCAP_API_KEY` environment variable. You can get one for free from [CoinMarketCap](https://pro.coinmarketcap.com/signup). \n\nThen, uncomment the line `coinmarketcap: COINMARKETCAP_API_KEY,` in `hardhat.config.ts` to get the USD estimation. Just note, everytime you run your tests it will use an API call, so it might make sense to have using coinmarketcap disabled until you need it. You can disable it by just commenting the line back out. \n\n\n\n## Verify on etherscan\n\nIf you deploy to a testnet or mainnet, you can verify it if you get an [API Key](https://etherscan.io/myapikey) from Etherscan and set it as an environment variable named `ETHERSCAN_API_KEY`. You can pop it into your `.env` file as seen in the `.env.example`.\n\nIn it's current state, if you have your api key set, it will auto verify kovan contracts!\n\nHowever, you can manual verify with:\n\n```\nyarn hardhat verify --constructor-args arguments.ts DEPLOYED_CONTRACT_ADDRESS\n```\n\n\n# Linting\n\nTo check linting / code formatting:\n```\nyarn lint\n```\nor, to fix: \n```\nyarn lint:fix\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildwithcode888%2Fultimate-nft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuildwithcode888%2Fultimate-nft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildwithcode888%2Fultimate-nft/lists"}