[Service] Multi Auction Contract Service for StarShop Frontend

[aguilar1x]

🎯 Objective

Develop a comprehensive TypeScript service layer for the Multi Auction Contract that manages multiple concurrent auctions, bidding mechanisms, and auction distribution within the StarShop marketplace.

---

🏗 Service Structure

src/shared/services/multi_auction/
  auction.service.ts               // Main service class
  types/
    auction.types.ts              // TypeScript interfaces
    bid.types.ts                  // Bid-related types
    distribution.types.ts         // Distribution types
  utils/
    auction.utils.ts              // Helper functions
  constants/
    auction.constants.ts          // Contract addresses, error codes

---

🗂 Requirements

1. Auction Management

• createAuction(config) - Create new auction
• getAuction(auctionId) - Get auction details
• updateAuction(auctionId, updates) - Update auction
• cancelAuction(auctionId) - Cancel auction
• listAuctions(status?, limit?) - List auctions with filters

2. Bidding Operations

• placeBid(auctionId, amount) - Place bid on auction
• updateBid(auctionId, newAmount) - Update existing bid
• withdrawBid(auctionId) - Withdraw bid
• getBid(auctionId, bidder) - Get bidder's bid
• getHighestBid(auctionId) - Get highest bid

3. Auction Execution

• endAuction(auctionId) - End auction
• distributeAuction(auctionId) - Distribute auction proceeds
• claimWinnings(auctionId) - Claim auction winnings
• getAuctionResults(auctionId) - Get final results

4. Distribution Management

• getDistribution(auctionId) - Get distribution details
• processDistribution(auctionId) - Process distribution
• getDistributionStatus(auctionId) - Get distribution status

---

[am-miracle]

I'm an experienced frontend developer. I'd love to work on this

[komyunghan]

Happy to build this service.

I'll create src/services/multiAuction.ts covering create auction, place bid, end auction, and query current highest bid. The hook useMultiAuction will poll for bid updates and expose loading/error states consistent with the repo's patterns.

ETA: 2 days.