{"id":13632065,"url":"https://github.com/artgenexyz/nft-contracts","last_synced_at":"2025-04-07T15:10:44.853Z","repository":{"id":37090898,"uuid":"394639106","full_name":"artgenexyz/nft-contracts","owner":"artgenexyz","description":"Open-source NFT contracts used by Buildship","archived":false,"fork":false,"pushed_at":"2024-03-30T10:30:44.000Z","size":5915,"stargazers_count":199,"open_issues_count":7,"forks_count":61,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-04-09T16:24:42.751Z","etag":null,"topics":["erc1155","erc721","ethereum","nft","smart-contracts","solidity"],"latest_commit_sha":null,"homepage":"https://buildship.xyz","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/artgenexyz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-08-10T12:07:48.000Z","updated_at":"2024-04-08T16:28:07.000Z","dependencies_parsed_at":"2023-10-01T19:21:20.446Z","dependency_job_id":"a2349aa2-1f13-4715-9c4d-bfa6853fad37","html_url":"https://github.com/artgenexyz/nft-contracts","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artgenexyz%2Fnft-contracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artgenexyz%2Fnft-contracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artgenexyz%2Fnft-contracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artgenexyz%2Fnft-contracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/artgenexyz","download_url":"https://codeload.github.com/artgenexyz/nft-contracts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675607,"owners_count":20977378,"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":["erc1155","erc721","ethereum","nft","smart-contracts","solidity"],"created_at":"2024-08-01T22:02:50.159Z","updated_at":"2025-04-07T15:10:44.835Z","avatar_url":"https://github.com/artgenexyz.png","language":"Solidity","funding_links":[],"categories":["Solidity"],"sub_categories":[],"readme":"# NFT Contracts by Buildship\n\n[![Hardhat Tests](https://github.com/buildship-dev/nft-contracts/actions/workflows/hardhat.yml/badge.svg)](https://github.com/buildship-dev/nft-contracts/actions/workflows/hardhat.yml)\n\n\u003e [Donate on Gitcoin](https://gitcoin.co/grants/5779/buildship) if you like this repo ❤️‍🔥\n\nThis is a collection of smart-contracts that help you to launch your own 10k-avatar collection like [CryptoPunks](https://www.larvalabs.com/cryptopunks), [Bored Ape Yacht Club](https://boredapeyachtclub.com/) or [Pudgy Penguins](https://www.pudgypenguins.io/).\n\nMade by https://buildship.xyz. If you can't code, use our simple web-app to deploy!\n\nUSE AT YOUR OWN RISK. Most of the features are in production already, however this doesn't guarantee any security. Unreleased and speculative code is located in `contracts/experiments` directory.\n\nFeatures include:\n\n## ERC721CommunityImplementation.sol\n- Limited supply\n- Mint N tokens in one transaction\n- Generative art\n- Lazy Mint – buyers pays for mint\n- Manually start/stop sale\n- Reserve X tokens for team or community\n- Deployed by Factory using Clones\n- Supports `NFTExtension` to upgrade mint and tokenURI functions\n\n## ERC721CommunityBase.sol\n- Same features as ERC721CommunityImplementation\n- Import and inherit in your own projects\n\n```solidity\ncontract MyPFPNFT is ERC721CommunityBase {\n\n    constructor() ERC721CommunityBase(\n        0.1 ether, // public mint price, you can change later\n        10000, // total supply\n        100, // reserved\n        20, // max mint per transaction\n        0, // royalty fee\n        \"ipfs://Qm/\", // baseURI\n        \"Bored Ape Yacht Club\", \n        \"BAYC\",\n        false // should start at 1 or at 0?\n    ) {}\n\n}\n```\n\n## ERC721CommunityImplementation_\n\nA copy of ERC721CommunityImplementation without any mention of Buildship. It's used as a base interface for Buildship Fuelpass subscribers (https://buildship.xyz/fuelpass).\n\n```bash\ncolordiff contracts/ERC721CommunityImplementation_.sol contracts/ERC721CommunityImplementation.sol\n```\n\n## NFTExtension\n- Can be added to main NFT using `addExtension`\n- Support changing mint and tokenURI functions\n\n## How to use:\n\n### Init\n\n```bash\nnpm i\ntouch .mnemonic\nnode scripts/generate_mnemonic.mjs\nvim .mnemonic # input generated mnemonic\n\ncp .env.example .env\nvim .env # input your keys\n```\n\n### Development\n\nWhen you change something, run:\n\n```bash\nnpx hardhat compile\n```\n\nThen, to test your code:\n\n```bash\nnpx hardhat test\n```\n\n### Checking different versions of ERC721CommunityImplementation:\n\n```bash\ncolordiff contracts/ERC721CommunityBase.sol contracts/ERC721CommunityImplementation.sol --context=1\ncolordiff contracts/ERC721CommunityBase_ERC1155.sol contracts/ERC721CommunityBase.sol --context=1\n```\n\n### Deploy to production\n\nYou can deploy using Hardhat. Refer to Hardhat scripts and console guides for deployment.\nhttps://hardhat.org/guides/deploying.html\n\nHowever, we also support deploying with your Metamask:\n\n### Upload to IPFS for Frontend Deploy\n\nInstead of deploying from your local machine, you can compile and send it for deployment from  the Buildship web app.\n\n```bash\nhh upload contracts/Greeter.sol --args '\"hello\",\"bar\"'\n```\n\nIt needs network selection to run, but it doesn't matter which you use. You can run with development network.\n\nIn the end, you get IPFS hash to the uploaded bytecode. Use in on https://gate-rinkeby.buildship.xyz/deploy/bafkreid4l4ru7sngq6fcvpizljo7hpm6dmcwjory4kcrbpbkde2xih75au?args=[]\n\n### Thanks\n\nThanks to Gitbook.com for providing free access to their platform to host our docs! https://learn.buildship.xyz/\n\nERC721A for their mint-optimized ERC721 https://erc721a.org/\n\nOur contributors\n\nBuildship users who have given us their trust and used our code on mainnet, already processing \u003e5M$ in total volume and \u003e35,000 NFT minted! https://dune.xyz/caffeinum/buildship_xyz\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartgenexyz%2Fnft-contracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartgenexyz%2Fnft-contracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartgenexyz%2Fnft-contracts/lists"}