suresh-pollai / auction-dapp Goto Github PK

Auction Dapp

The Auction Dapp allows a user to register a “deed” token, which represents some unique asset. Once a token has been registered, the ownership of the token is transferred to the Auction Dapp, allowing it to be listed for sale. The dapp lists each of the registered tokens, allowing other users to place bids. During each auction, users can join a chat room created specifically for that auction. Once an auction is finalised, the deed token ownership is transferred to the winner of the auction.
Explore the article on Medium »

The application should be decentralized and utilize Ethereum's stack:

1. Smart contracts for business logic(auctions, bids, refund and transfer of ownership)
2. Swarm for data storage(image and metadata)
3. Whisper for a peer-to-peer messaging(chatrooms)

Manage non-fungible tokens by implementing an asset/token/deed repository which holds unique asset/token/deed.

See following link: ethereum/EIPs#721

Auction repository MUST act as an auction house which does the following:

• Holds asset/token/deed that is to be auctioned(ERC721 Ownership by smart contract)
• Allows users bid on auctions
• Keeps track of auctions/bids/ownership
• Transfers ownership of asset/token/deed to winder
• Transfers Funds to auction creator if auction is ended and there is at least one winner
• Cancels auction and deal with refunds
• UI to interact with the above functionality

The front-end is developed using a reactive UI framework with integration of Vuetify, a Google's Material Design implementation.

The idea of a Deed Repository is used across this project to hold any NFT with metadata attached to. A token/deed is registered by giving a unique ID and attaching metadata(TokenURI). The metadata is what makes each token important or valuable.

The Auction house needs to verify that a NFT is owned by the auction creator, therefore before the auction is created, the owner should transfer the ownership of the NFT to the AuctionRepository smart contract address.

Creating the auction is a simple process of entering auction details such as name, starting price, expiry date etc. The important part is to have the reference between the deed and the auction.

Anyone can bid on an auction except the owner of the auction. Biding means that previous bidders are refunded and new bid is placed. Bid requirements are as follow:

1. Auction not expired
2. Bidder is not auction owner
3. Bid amount is greator than current bid or starting price(if no bid)

If an auction is canceled, the Auction Repository MUST return the ownership of the asset/token/deed back to the auction creator and refund bidders if any.

If there is an auction winner, the asset/token/deed is transferred to the bidder and the bid amount is sent to the auction creator.

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)