{"id":16990369,"url":"https://github.com/aalmada/honest-nft","last_synced_at":"2026-04-13T23:04:46.185Z","repository":{"id":230031078,"uuid":"777330284","full_name":"aalmada/honest-nft","owner":"aalmada","description":"An implementation of an ERC721 featuring contract-based fairness and trust mechanisms.","archived":false,"fork":false,"pushed_at":"2024-07-29T22:22:08.000Z","size":1387,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T21:51:22.509Z","etag":null,"topics":["nft","web3","web3-react","web3-solidity"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/aalmada.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-03-25T16:41:59.000Z","updated_at":"2024-03-27T11:41:46.000Z","dependencies_parsed_at":"2024-03-27T13:46:31.693Z","dependency_job_id":"f0ad72ce-c4cc-46e5-8766-d9942427639b","html_url":"https://github.com/aalmada/honest-nft","commit_stats":null,"previous_names":["aalmada/honest-nft"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalmada%2Fhonest-nft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalmada%2Fhonest-nft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalmada%2Fhonest-nft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalmada%2Fhonest-nft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aalmada","download_url":"https://codeload.github.com/aalmada/honest-nft/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244898458,"owners_count":20528341,"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":["nft","web3","web3-react","web3-solidity"],"created_at":"2024-10-14T03:09:50.022Z","updated_at":"2026-04-13T23:04:46.143Z","avatar_url":"https://github.com/aalmada.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Honest NFT\n\n**Note:** This project is still under active development, and not all features are implemented. Expect frequent updates and changes.\n\n**Honest NFT** is an Ethereum-based project that combines an **ERC721 smart contract** with a **React front end** to create a decentralized application (DApp) for minting Non-Fungible Tokens (NFTs). Let's break down the components:\n\n1. **Smart Contract**\n\n    - The **ERC721** standard ensures that each NFT is unique and indivisible.\n    - Trust is established through code, making it transparent and tamper-proof.\n    - Users can mint new NFTs, and the contract enforces their authenticity.\n    - Developed using:\n        - [Solidity](https://soliditylang.org/)\n        - [OpenZeppelin](https://www.openzeppelin.com/contracts)\n        - [TypeScript](https://www.typescriptlang.org/)\n        - [Hardhat](https://hardhat.org/)\n        - [Viem](https://viem.sh/)\n\n2. **Front End**\n    - The front end provides a user-friendly interface for interacting with Honest NFT.\n    - Key features include:\n        - **Minting NFTs**: Users can create their own NFTs.\n        - **Backoffice UI**: An administrative interface for managing the NFT drop.\n    - Developed using:\n        - [TypeScript](https://www.typescriptlang.org/)\n        - [Vite](https://vitejs.dev/)\n        - [React](https://react.dev/)\n        - [React Query](https://tanstack.com/query/v3/)\n        - [Ant Design](https://ant.design/)\n        - [ConnectKit](https://docs.family.co/connectkit)\n        - [Wagmi](https://wagmi.sh/)\n        - [Viem](https://viem.sh/)\n\n## Getting Started\n\n1. **Clone the Repository:**\n\n    ```bash\n    git clone https://github.com/aalmada/honest-nft.git\n    cd honest-nft\n    ```\n\n2. **Install Dependencies:**\n\n    - The repository is set up as a monorepo managed using [pnpm](https://pnpm.io/), a fast, disk space efficient package manager.\n\n    - Execute the following to install dependencies:\n\n        ```bash\n        pnpm install\n        ```\n\n3. **Deploy the Smart Contract:**\n\n    - The smart contract development project is in folder `packages/blockchain`.\n\n    - Set the following [configuration variables](https://hardhat.org/hardhat-runner/docs/guides/configuration-variables):\n\n        - `COINMARKETCAP_KEY` - Used to get fiat values in gas reports. Get key from https://coinmarketcap.com/api/pricing/.\n        - `ETHERSCAN_API` - Used to verify contract on Etherscan. Get key from https://etherscan.io/apis.\n\n    - Compile and deploy the smart contract:\n\n        ```bash\n        cd packages/blockchain\n        pnpm compile\n        pnpm hardhat run scripts/deploy.js --network sepolia\n        ```\n\n4. **Start the React Development Server:**\n\n    - The frontend development project is in folder `packages/frontend`.\n\n    - Add a `.env.local` file into the project folder. Copy the contents from the `.env.example` file.\n\n    - Execute the following to start the React server:\n\n        ```bash\n        cd packages/frontend\n        pnpm start\n        ```\n\n## Usage\n\n-   Visit the front end in your browser (usually at `http://localhost:3000`) and connect your Ethereum wallet (e.g., MetaMask).\n-   Mint new NFTs or explore the marketplace.\n\n## Contributing\n\nContributions are welcome! Please create a pull request with your changes.\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faalmada%2Fhonest-nft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faalmada%2Fhonest-nft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faalmada%2Fhonest-nft/lists"}