Referrer

Integrate.

Three accepted ways to be attributed as the referrer on a paid call. Pick whichever fits your stack — all three earn the same commission.

Mode 1

Bearer API key

Simplest. Best for agents, skills, and MCP servers that can't sign per request.

Create a key on the API keys page (bind it to your payout wallet at creation time). Send it on every request:

curl -H "Authorization: Bearer cg_live_..." \
  https://api.chest.sh/u/<slug>/<path>

Mode 2

Signed wallet header

Highest trust. Best for clients that already hold an ed25519 keypair.

Sign each request with your wallet (canonical message: chest-referrer:{slug}:{amount}). The signReferrer helper in the proxy package handles the message format.

X-Referrer-Wallet: <YOUR_WALLET>
X-Referrer-Sig:    <base64 ed25519 sig>
X-Referrer-Payout: <optional: cold wallet>

Mode 3

Unsigned header

Zero setup. Only works when the merchant has opted into allowUnsignedReferrers.

For merchants that accept unsigned attribution. Lowest trust — no proof the wallet authorized the attribution — so merchants can refuse. Useful for quick prototypes on a merchant you control.

X-Referrer-Wallet: <YOUR_WALLET>

What counts as attributed

Whichever mode you use, the proxy records the wallet on every paid call that settles. Your commission is split on-chain a few seconds after payment. Watch live attribution on the Earnings and Calls pages, or subscribe to webhooks for push notifications.