# Tokenomics

### SP Token

SP (Spree Points) is the only token in the Spree system. There is no governance token.

| Property  | Value                                   |
| --------- | --------------------------------------- |
| Standard  | ERC-20                                  |
| Decimals  | 18                                      |
| Supply    | Unlimited (minted and burned on demand) |
| Backing   | 1:1 by stablecoins in CollateralVaults  |
| Transfers | Restricted to whitelisted addresses     |

SP supply expands when users deposit stablecoins and contracts when users redeem. There is no fixed supply cap. A CollateralVault holds one stablecoin for every SP in circulation, verified by on-chain invariant checks.

### Branded SP

Each brand can deploy its own ERC-20 token through the PointsFactory. Branded tokens:

* Are 1:1 backed by base SP locked in the PointsFactory
* Have their own name and symbol (e.g., "FLY Points", "EVENT Rewards")
* Support EIP-2612 gasless approvals
* Have no transfer restrictions (unlike base SP)
* Are interoperable through base SP as a bridge asset

Branded tokens do not have a separate supply model. Every branded token maps to one locked SP.

### Pending SP (pSP)

pSP is an ERC-20 token managed by the PendingSPVault. Every pSP exists within a campaign context, and the PendingSPVault holds SP 1:1 behind each pSP.

| Property  | Value                                 |
| --------- | ------------------------------------- |
| Standard  | ERC-20 (campaign-scoped balances)     |
| Decimals  | 18                                    |
| Supply    | Limited by campaign budgets           |
| Backing   | 1:1 by SP in PendingSPVault           |
| Transfers | Campaign-scoped, whitelist-restricted |

Settlement burns the pSP and releases the underlying SP. Expiration burns the pSP and recycles the SP into the campaign budget.

### Token Flow

```
Stablecoins (USDC, etc.)
        │
        │ deposit
        ▼
   ┌─────────┐
   │   SP    │ ←── 1:1 backed by stablecoins
   └────┬────┘
        │
   ┌────┼────────────────────┐
   │    │                    │
   ▼    ▼                    ▼
┌──────┐ ┌──────┐      ┌─────────┐
│Brand │ │ pSP  │      │ Rewards │
│Tokens│ │      │      │  Vault  │
└──┬───┘ └──┬───┘      └────┬────┘
   │        │               │
   │    settle / expire     │ revenue
   │        │               │
   │        ▼               ▼
   │     SP released    Bonus Rewards
   │     or recycled    (at brand discretion)
   │
   └──► Interop: Brand A Tokens ↔ SP ↔ Brand B Tokens
```

All value flows through SP. Stablecoins enter the system via minting. SP circulates through branded tokens, conditional rewards, rewards vaults, and lending markets. Stablecoins exit the system when SP is redeemed.


---

# 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://spree-finance.gitbook.io/spreefinance/how-it-works/tokenomics.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.
