{"id":16433016,"url":"https://github.com/nour-karoui/nft-auction","last_synced_at":"2026-05-21T05:04:22.675Z","repository":{"id":120552288,"uuid":"602229533","full_name":"nour-karoui/NFT-Auction","owner":"nour-karoui","description":"An auction platform that allows you to put into auction your NFTs and participate in auctions in order to win NFTs.","archived":false,"fork":false,"pushed_at":"2023-02-19T10:50:04.000Z","size":2733,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-11T07:36:45.251Z","etag":null,"topics":["blockchain","erc1155","ethersjs","nft-marketplace","opensea-api","smart-contracts","solidity","web3"],"latest_commit_sha":null,"homepage":"http://auction-cienne.s3-website.eu-central-1.amazonaws.com/","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/nour-karoui.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":"2023-02-15T19:11:56.000Z","updated_at":"2023-09-05T14:02:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"e9f35fc2-20e0-49bd-95ad-510ad54aa197","html_url":"https://github.com/nour-karoui/NFT-Auction","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nour-karoui/NFT-Auction","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nour-karoui%2FNFT-Auction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nour-karoui%2FNFT-Auction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nour-karoui%2FNFT-Auction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nour-karoui%2FNFT-Auction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nour-karoui","download_url":"https://codeload.github.com/nour-karoui/NFT-Auction/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nour-karoui%2FNFT-Auction/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33289546,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T02:57:32.698Z","status":"ssl_error","status_checked_at":"2026-05-21T02:57:31.990Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blockchain","erc1155","ethersjs","nft-marketplace","opensea-api","smart-contracts","solidity","web3"],"created_at":"2024-10-11T08:44:53.815Z","updated_at":"2026-05-21T05:04:22.661Z","avatar_url":"https://github.com/nour-karoui.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"HELLO \u003cimg src=\"https://raw.githubusercontent.com/MartinHeinz/MartinHeinz/master/wave.gif\" width=\"30px\"\u003e This is Auction-cienne\n---\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/nour-karoui/NFT-auction#readme\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-yes-brightgreen.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/nour-karoui/NFT-Auction/graphs/commit-activity\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Maintenance\" src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/nour-karoui/NFT-Auction/blob/main/license\" target=\"_blank\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/github/license/bishkou/password-pwnd\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## ✂️ How is this project divided?\nThe project is divided into 2 main sections:\n1. ***Auction-truffle:*** The truffle project, containing all the smart contracts used for this project and their deployments configurations.\n2. ***Auction's platform:*** The Dapp that allows users to auction with their NFT and participate in open auctions. [*Visit Auction-cienne*](http://auction-cienne.s3-website.eu-central-1.amazonaws.com/)\n\n## 🙌 What is Auction-cienne?\nIt is a **decentralized app for NFT auction** hosted on **Goerli Testnet** built with ***Truffle Framework***, ***ReactJs*** and ***ethers.js*** library.\n1. Any user can put his owned NFTs into auction.\n2. Any user can participate in the auction and bid on an NFT.\n3. The auction lasts 72 hours and gets 6 more hours with every bid more than 0.5 ETHER.\n4. The first bidder wins after 12 hours without bids, the next bidders win after 6 hours only.\n\n\n## 🎯 Running and Testing the project\n\u003e **In order to just run the DApp, you can skip this section since the smart contracts are already deployed. This section is for those who want to run, modify and test the smart contracts whether locally or in a testnet**\n\nAfter cloning this repo, we will start with running and testing the blockchain part.\n### 📒 The blockchain part\n\n---\n\n\u003e Deploying the contract on a Testnet takes more time than deploying it locally so be patient.\n\nMake sure to create .env file following the **.env.example** file\n\nRun this command to install dependencies:\n```shell\n    cd auction-truffle\n    npm install\n```\n\n**These are the main commands that would help you interact with our smart contracts:**\n1. Compiling the contracts (this will generate a JSON file for each contract found in build/contracts)\n    ```shell\n        truffle compile\n    ```\n2. Deploying the contracts\n    ```shell\n        truffle migrate --network \u003cNETWORK_NAME\u003e\n        truffle run verify \u003cCONTRACT_NAME\u003e\n    ```\n3. Interacting with the contracts\n    ```shell\n        truffle console --network \u003cnetwork-name\u003e\n    ```\n### 🚀 Running The Auction-cienne's DApp\n\n---\n\n\u003e **To run the DApp you need both a Metamask wallet attached to your Browser, and owned NFTs on Opensea, also you need some Goerli Ether**\n\n\u003e You can get some Goerli ETH on [This Faucet](https://goerlifaucet.com/).\n\n\u003cimg width=\"358\" alt=\"image\" src=\"https://user-images.githubusercontent.com/47257753/211004734-9d0b3b93-606f-4270-9791-22ec10397e1b.png\"\u003e\n\n\u003e You can create an NFT on [Testnet Opensea](https://testnets.opensea.io/asset/create).\n\n#### Running the DApp\nTo interact with the auction-cienne app\n```shell\n    npm start\n```\n## 🔨 Areas of Improvements\n1. Automating the contract deployment and integration with frontend (updating ABI and address).\n2. Add unit tests to both smart contract and frontend.\n3. Add events to smart contract and event listening to frontend.\n4. Automate the process of transferring NFT at the end of the auction, (with chainlink client for eg).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnour-karoui%2Fnft-auction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnour-karoui%2Fnft-auction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnour-karoui%2Fnft-auction/lists"}