{"id":17930400,"url":"https://github.com/wbnns/first-and-based","last_synced_at":"2025-10-14T09:38:00.545Z","repository":{"id":218711395,"uuid":"747160064","full_name":"wbnns/first-and-based","owner":"wbnns","description":"First and Based: Be the first person to mint a unique NFT in each new block on Base","archived":false,"fork":false,"pushed_at":"2024-04-04T17:11:03.000Z","size":580,"stargazers_count":4,"open_issues_count":3,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-11T03:54:30.013Z","etag":null,"topics":["base","ethereum","l2","layer2","nft","op-stack"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wbnns.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":"2024-01-23T11:41:57.000Z","updated_at":"2025-08-25T10:10:18.000Z","dependencies_parsed_at":"2024-12-16T06:37:41.438Z","dependency_job_id":null,"html_url":"https://github.com/wbnns/first-and-based","commit_stats":null,"previous_names":["wbnns/first-based","wbnns/first-and-based"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wbnns/first-and-based","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbnns%2Ffirst-and-based","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbnns%2Ffirst-and-based/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbnns%2Ffirst-and-based/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbnns%2Ffirst-and-based/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wbnns","download_url":"https://codeload.github.com/wbnns/first-and-based/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbnns%2Ffirst-and-based/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018618,"owners_count":26086404,"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-14T02:00:06.444Z","response_time":60,"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":["base","ethereum","l2","layer2","nft","op-stack"],"created_at":"2024-10-28T21:13:11.918Z","updated_at":"2025-10-14T09:38:00.518Z","avatar_url":"https://github.com/wbnns.png","language":"Solidity","readme":"# First \u0026 Based\n\nBe the first person to mint a unique NFT in each new block on Base\n\n## Overview\n\nFirst \u0026 Based is an generative NFT collection experiment, where each NFT represents a unique Base block. The uniqueness is enforced by tying the NFT's identifier (token ID) directly to the Base block number at the time of minting. This creates an exclusive opportunity for users to claim a specific block's NFT.\n\n## Contracts\n\n### `FirstBased.sol`\n\n- An ERC-721 NFT contract where each token represents a unique Base block.\n- The contract allows for the minting of NFTs, where each token is associated with the block number as its unique identifier.\n- Inherits from OpenZeppelin's `ERC721` and `Ownable`.\n\n### `MetadataRenderer.sol`\n\n- A contract that implements the `IMetadataRenderer` interface.\n- Responsible for generating on-chain SVG images and metadata for each `FirstBased` NFT.\n- SVG images include the phrase \"1ST ONCHAIN\" followed by the Ethereum block number at which the NFT is minted.\n\n### `IMetadataRenderer.sol`\n\n- An interface outlining the functions for a metadata renderer, used by `FirstBased`.\n\n### `Base64.sol`\n\n- A utility library for Base64 encoding, used in `MetadataRenderer` for encoding SVG images and metadata.\n\n## Installation\n\nTo get started with this project, clone the repository and install the dependencies:\n\n```bash\ngit clone https://github.com/wbnns/first-and-based.git\ncd first-and-based\nnpm install\n```\n\n## Deployment\n\nThe contracts are deployed using Hardhat. To deploy the contracts:\n\n1. Set up your `hardhat.config.js` with the desired network configurations.\n2. Compile the contracts using `npx hardhat compile`.\n3. Run the deployment script:\n\n```bash\nnpx hardhat run scripts/deploy.js --network \u003cnetwork-name\u003e\n```\n\n## Verification\n\nAfter deployment, verify the `FirstBased` contract on Basescan by providing the constructor arguments used during the deployment process.\n\n## Contributing\n\nBased contributions to the First and Based are welcome! To contribute:\n\n1. Fork the repository.\n2. Create a new branch for your feature (`git checkout -b feature/BasedFeature`).\n3. Commit your changes (`git commit -m 'Add some BasedFeature'`).\n4. Push to the branch (`git push origin feature/BasedFeature`).\n5. Open a pull request.\n\n## Repository Structure\n\n- `contracts/`: Contains the Solidity contracts.\n- `scripts/`: Contains the deployment script.\n- `test/`: Contains the tests for the contracts (if applicable).\n- `hardhat.config.js`: Hardhat configuration file.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwbnns%2Ffirst-and-based","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwbnns%2Ffirst-and-based","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwbnns%2Ffirst-and-based/lists"}