[Service] Promotional Boost Contract Service for StarShop Frontend

[aguilar1x]

🎯 Objective

Develop a comprehensive TypeScript service layer for the Promotional Boost Contract that manages promotional campaigns, visibility boosts, payment processing, and slot management within the StarShop marketplace.

---

🏗 Service Structure

src/shared/services/promotional_boost/
  boost.service.ts                 // Main service class
  types/
    boost.types.ts                // TypeScript interfaces
    visibility.types.ts           // Visibility types
    payments.types.ts             // Payment types
  utils/
    boost.utils.ts                // Helper functions
  constants/
    boost.constants.ts            // Contract addresses, error codes

---

🗂 Requirements

1. Boost Management

• createBoost(config) - Create promotional boost
• getBoost(boostId) - Get boost details
• updateBoost(boostId, updates) - Update boost
• cancelBoost(boostId) - Cancel boost
• activateBoost(boostId) - Activate boost

2. Visibility Management

• setVisibilityLevel(productId, level) - Set visibility level
• getVisibilityLevel(productId) - Get current visibility
• boostVisibility(productId, duration) - Boost visibility
• getVisibilityStats(productId) - Get visibility statistics

3. Slot Management

• reserveSlot(slotType, duration) - Reserve promotional slot
• getAvailableSlots(slotType) - Get available slots
• releaseSlot(slotId) - Release slot
• getSlotStatus(slotId) - Get slot status

4. Payment Processing

• processBoostPayment(boostId, amount) - Process payment
• getPaymentStatus(boostId) - Get payment status
• refundBoostPayment(boostId) - Refund payment
• getBoostCost(config) - Calculate boost cost

---

[Chesblaw]

@aguilar1x can you assign me

[2021240]

I want to work on this issue

[tusharrrr1]

Hey I would like to work on this, assign me if possible

[Kelechiokpani]

I’d like to work on this because I enjoy solving problems around payments, visibility, and slot management. I can design a clean TypeScript service layer that makes boost creation, tracking, and payments reliable and easy to maintain.

[komyunghan]

Happy to implement this service.

I'll create src/services/promotionalBoost.ts wrapping the Promotional Boost contract's ABI with typed starknet.js calls (activate boost, deactivate, query status). The service follows the same pattern as other contract services in the repo. I'll add a React hook usePromotionalBoost and a basic test.

ETA: 2 days.