# User Guides

<details>

<summary>How to Trade Cards</summary>

1. **Creating a Trade Offer**:
   * Use `/trade offers create`
   * Select up to 3 cards from your inventory to offer
   * Optionally add a point value
   * Confirm your offer
2. **Viewing Trade Offers**:
   * Use `/trade offers list` to see all active offers
   * Browse offers in the Trading channel
3. **Accepting a Trade**:
   * Click the "Accept Trade" button on any trade offer
   * Review the trade details carefully
   * Confirm to complete the trade
4. **Canceling Your Trade Offer**:
   * Use `/trade offers cancel {offerId}`
   * The offer will be removed from the list and channel

Note: Trade offers expire after 24 hours if not accepted.

</details>

<details>

<summary>Checking Your Inventory</summary>

* Use the `/inventory` command to see all your collected items
* Your inventory displays:
  * Cards organized by collection
  * Rarity information
  * Point balance
  * Direct link to your wallet login

</details>

<details>

<summary>Tracking Your Progress</summary>

1. Use the `/progress` command to check your collection status
2. The progress view shows:
   * Collection completion percentage
   * Owned vs. missing cards
   * Direct reward claims available
   * Quick access to your Giftoin App profile

</details>

<details>

<summary>Setting Up the Bot (Admin Guide)</summary>

1. **Initial Setup**:
   * Use `/setup` in any channel
   * Enter your authorization code when prompted
   * Wait for the setup process to complete
2. **Configuring Channels**:
   * After setup, all required channels will be created
   * You can rename channels without affecting functionality
   * Customize channel permissions as needed
3. **Role Assignment**:
   * Use `/grant-role` to assign Giftoin Admin or Moderator roles
   * Members role is assigned automatically through interaction
4. **Publishing the Bot**:
   * Use `/publish` when ready to make the bot available to all members
   * Ensure all mandatory channels exist before publishing
   * Configure audience access settings as needed

</details>

<details>

<summary>Managing Giveaways</summary>

* Use `/giveaway create`
* Set the prize, duration, and winner count
* Configure announcement settings:
  * Public announcements
  * Private DM notifications (at least one method required)
* Set duration using the "1m 1h 1d" format (e.g., "2h 30m" for 2 hours and 30 minutes)
* **Monitoring Active Giveaways**:
  * Use `/giveaway list` to view all active and scheduled giveaways
  * Filter by status (in-progress/scheduled)
* **Viewing Giveaway Details**:
  * Use `/giveaway view {giveawayId}` to see:
    * Configuration settings
    * Participation data
    * Winner information (if ended)
* **Canceling a Giveaway**:
  * Use `/giveaway cancel` and select the giveaway to cancel
  * Confirm cancellation when prompted

</details>

<details>

<summary>Viewing Statistics</summary>

1. Use `/admin stats` to access comprehensive metrics
2. Available statistics include:
   * Daily and weekly usage
   * Trading activity
   * User engagement
   * Giveaway participation
   * Collection completion rates

</details>