@quantabit/activity-sdk

QuantaBit Activity SDK - Campaign activities, lottery, promotions, and more

📦 Installation

npm install @quantabit/activity-sdk
# or
yarn add @quantabit/activity-sdk

🚀 Quick Start

1. Setup Provider

import { ActivityProvider } from "@quantabit/activity-sdk";
import "@quantabit/activity-sdk/styles.css";

function App() {
  return (
    <ActivityProvider
      apiUrl="https://api.example.com/v1"
      token="your-auth-token"
      language="en"
      onWin={(prize) => console.log("Congratulations! You won:", prize)}
    >
      <YourComponent />
    </ActivityProvider>
  );
}

2. Using Components

import { ActivityList, ActivityCard, LotteryWheel } from '@quantabit/activity-sdk';

// Activity list
<ActivityList
  showFilter
  onActivityClick={(activity) => console.log(activity)}
/>

// Activity card
<ActivityCard
  activity={activityData}
  showCountdown
  onParticipate={handleParticipate}
/>

// Lottery wheel
<LotteryWheel
  prizes={[
    { id: '1', name: '10 Points', icon: '🪙' },
    { id: '2', name: 'Coupon', icon: '🎫' },
    { id: '3', name: 'Thanks for playing', icon: '🙏' },
  ]}
  chances={3}
  onDraw={handleDraw}
  onComplete={(prize) => console.log('Won:', prize)}
/>

3. Using Hooks

import { useActivity } from "@quantabit/activity-sdk";

function MyComponent() {
  const {
    activities, // Activity list
    currentActivity, // Current activity
    myPrizes, // My prizes
    loading,
    loadActivities, // Load activities
    participate, // Participate in activity
    draw, // Execute lottery draw
  } = useActivity();

  return <div>...</div>;
}

📚 Components

| Component | Description | | -------------- | --------------------------------------------- | | LotteryWheel | Spin wheel lottery component | | ActivityCard | Activity card (cover, countdown, join button) | | ActivityList | Activity list with status filtering |

📖 Activity Types

import { ActivityType, LotteryType } from "@quantabit/activity-sdk";

// Activity types
ActivityType.LOTTERY; // Lottery
ActivityType.PROMOTION; // Promotion
ActivityType.CAMPAIGN; // Campaign
ActivityType.AIRDROP; // Airdrop
ActivityType.CONTEST; // Contest

// Lottery types
LotteryType.WHEEL; // Spin wheel
LotteryType.CARD; // Card flip
LotteryType.BOX; // Mystery box
LotteryType.SCRATCH; // Scratch card

📄 License

MIT License

🌐 Brand & Links

• Official Mainnet: QuantaBit Chain
• Developer Platform: Developer Platform
• Open Platform: Open Platform
• Payment Platform: Pay Platform
• Feedback: Feedback