# Gifts

Gifts in Pumpkin are not cosmetic decorations. They are a native economic primitive inside the Live Market Layer: a direct, realtime way for audiences to reward creators and guests, reinforce social proof, and amplify discovery—without pushing monetization outside the product.

To preserve consistency across mobile app stores and the web, Pumpkin uses a dual-rail value system:

* **Coins**: the spending unit used to send gifts
* **Crystals**: the earning unit received by gift recipients

This separation enables clean settlement, flexible redemption, and predictable user experience across platforms.

{% @mermaid/diagram content="flowchart TB
%% USERS
S\[Sender / Viewer] -->|Send gift| G\[Gift action in Live Room]
G -->|Recipient gets| C\[Crystals credited]

%% COINS ACQUISITION
subgraph Coins Acquisition
A1\[iOS/Android App] -->|Apple Pay / Google Play| COIN\[Coins balance]
W1\[Web] -->|Fiat or Crypto| COIN
end

%% SENDER USES COINS
COIN -->|Spend Coins| G

%% RECIPIENT REDEMPTION
subgraph Crystal Redemption
C -->|App| COIN\_APP\[Coins]
C -->|Web| COIN\_WEB\[Coins]
C -->|Web| CRYPTO\[Crypto]
C -->|Web| FIAT\[Fiat]
end
" %}

#### 1) Core mechanics

**1.1 Spending: gifts require Coins**

A viewer must hold Coins to send gifts. Coins are consumed at the moment a gift is delivered (to one person or multiple recipients in the room).

**1.2 Receiving: gifts generate Crystals**

Recipients do not receive Coins directly. They receive Crystals, which represent earned value attributable to gifts received during live sessions.

Crystals are a unified “earned balance” across Pumpkin platforms, while redemption options vary by platform to satisfy different payment rails and user needs.

#### 2) How users obtain Coins

Pumpkin supports platform-specific purchasing flows:

* **In-app (Android/iOS):** Coins are purchased using
  * **Google Play Billing** (Android)
  * **Apple Pay / Apple In-App Purchase** (iOS)
* **Web:** Coins are obtained via exchange using
  * **crypto → coins**, or
  * **fiat → coins**

#### 3) How recipients redeem Crystals

Crystals can be redeemed differently depending on platform:

* **In-app (Android/iOS):**
  * **Crystals → Coins**
* **Web:**
  * **Crystals → Coins**
  * **Crystals → Crypto**
  * **Crystals → Fiat**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pumpkin.xyz/product/gifts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.