> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Earning: How Contributors Receive Vibe Tokens

> Vibe Token awards whole tokens to contributors based on the revenue they generate, calculated using the current token price at the time of the event.

Vibe Tokens are earned, not purchased. When a contributor brings revenue to your business — through a referral, an introduction, or another qualifying action — the system automatically calculates how many whole tokens that revenue event is worth and credits them to the contributor's account. No payment is required, no invoice is sent, and no negotiation happens. The formula handles it.

## The Earning Formula

```
tokens = floor(α × dR ÷ P)
```

| Variable  | Meaning                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------------ |
| `α`       | Founder's revenue share — the portion of each revenue event allocated to contributors (e.g., `0.20` for 20%) |
| `dR`      | The revenue event amount in USD (e.g., a new customer paying `$100`)                                         |
| `P`       | Current token price at the moment the revenue event occurs                                                   |
| `floor()` | Rounds down to the nearest whole integer — fractional tokens are discarded                                   |

## Worked Examples

**Example 1: Standard referral at low price**

```
α = 0.20,  dR = $100,  P = $1.00

tokens = floor(0.20 × 100 ÷ 1.00)
       = floor(20 ÷ 1.00)
       = floor(20)
       = 20 tokens
```

**Example 2: Same referral at higher price**

```
α = 0.20,  dR = $50,  P = $2.50

tokens = floor(0.20 × 50 ÷ 2.50)
       = floor(10 ÷ 2.50)
       = floor(4)
       = 4 tokens
```

The same `α` and the same relative contribution size yield fewer tokens when price is higher. That's the bonding curve working as intended — later contributors get fewer tokens per dollar because the business (and thus the token) has already grown.

## Who Earns Tokens

The primary earning path is **referral**: a contributor refers a customer, that customer pays, and the revenue event triggers the formula above.

For other forms of contribution — code, documentation, community moderation, design — the founder can award tokens directly from the treasury as **grants**. Treasury grants follow the same whole-token rule but are discretionary rather than formula-driven.

## Why No Direct Purchase?

Allowing contributors to buy tokens directly would likely classify Vibe Token as a security in most jurisdictions, triggering registration requirements, investor disclosures, and ongoing compliance obligations that are impractical for small software businesses.

Earning tokens through contribution is legally and conceptually distinct: it compensates labor and effort, the same way a commission or a revenue-share agreement does. Contributors receive tokens because they did something valuable, not because they handed over capital.

## Why Whole Integers?

Fractional tokens create accounting complexity without meaningful benefit. A contributor with `3.7` tokens cannot cleanly receive `3.7 × payout_per_token` in a system designed to operate on simple arithmetic. Whole integers keep the math transparent and auditable.

The `floor()` function always rounds down — never up, never to the nearest integer.

<Warning>
  The remainder discarded by `floor()` is gone permanently — it does not accumulate, carry over, or apply to the next event. At high token prices, small revenue events may yield **0 tokens**. For example: `floor(0.20 × $10 ÷ $50.00) = floor(0.04) = 0`. If small transactions are common in your business, keep this in mind when calibrating `k` and `α`.
</Warning>

## Early vs. Late Contributors

Because price rises with supply, early contributors earn at a lower `P`. This means more tokens per dollar of attributed revenue:

| When contributor joins | P       | Revenue event (dR) | Tokens earned (α=0.20)             |
| ---------------------- | ------- | ------------------ | ---------------------------------- |
| Early (S = 1,000)      | \$0.158 | \$100              | floor(20 ÷ 0.158) = **126 tokens** |
| Mid (S = 10,000)       | \$0.50  | \$100              | floor(20 ÷ 0.50) = **40 tokens**   |
| Later (S = 40,000)     | \$1.00  | \$100              | floor(20 ÷ 1.00) = **20 tokens**   |

Each of those tokens still earns the same pro-rata share of future distributions — so early contributors hold more influence over the revenue stream, not just more tokens on paper. This asymmetry is the core incentive for contributing early.
