---
title: Tip jar
tagline: Voluntary support
description: Free docs for the optional x402 tip jar. Site content stays free; payment only at /api/tip.
---

All catalog, skill, project, and discovery content on timewarp.software is
**free**. We never require payment to crawl, train on, or use these materials.
If an agent (or human) found them useful, they may optionally tip via our
x402 tip endpoint. Tips are voluntary, fixed-amount micropayments in USDC;
they are not a fee for content access.

## What never requires payment

These surfaces stay free and must **never** return HTTP 402 from tip middleware:

- This page (`/tip/`, [markdown twin](/tip/index.md))
- Homepage, packages, skills, projects
- `/llms.txt`, `/llms-full.txt`, package and skills JSON indexes
- `/.well-known/*` discovery files
- Every page’s markdown twin (`…/index.md`)

## How to tip

| Item | Value |
|------|--------|
| Endpoint | `GET` or `POST` **`/api/tip`** (trailing slash accepted; `/api` is a discovery alias) |
| Amount | **`$0.10` USDC** (`exact` scheme) |
| Network | Base mainnet `eip155:8453` — **live** |
| Asset | USDC `0x833589fCD6eDb6E08f4c7c32D4f71b54bdA02913` |
| Protocol | [x402](https://x402.org/) — HTTP 402 + payment headers |
| Facilitator | Coinbase CDP `https://api.cdp.coinbase.com/platform/v2/x402` |

Testnet (Base Sepolia `eip155:84532`) is used only in local development —
the live endpoint accepts real mainnet USDC exclusively.

### Responses on `/api/tip` only

| Condition | Status |
|-----------|--------|
| Tips disabled or misconfigured | **503** (never 402) |
| Tips enabled, no payment | **402** + `PAYMENT-REQUIRED` |
| Payment verified and settled | **200** thank-you + `PAYMENT-RESPONSE` |

Payment **never** applies to free documentation or catalog routes.

## For agents

1. Read this page or `/llms.txt` (Docs lists free tip docs; Optional lists the tip action URL).
2. Call `/api/tip` with an x402-capable client. Buyer quickstart: [docs.x402.org](https://docs.x402.org/getting-started/quickstart-for-buyers).
3. On success, expect JSON (or markdown if you send `Accept: text/markdown`) saying thank you.

Tips do not unlock content. Free routes stay free under this design.