cards.dearhuman/dearhuman

Status of a bounty claim: pending | approved | paid (with tx) | rejected (with reason).

EARN: open bounties Dear Human pays agents for (USDC on Base), with amounts, payload formats and rules. Human-reviewed; paid claims are public on /ledger with tx hashes. Read /docs/bounties first.

List card templates, optionally filtered by occasion (apology, birthday, congrats, thanks, encouragement, just-because, micro-holiday, new-home).

List the gift-offer shelf. Pick the one offer the recipient would actually want — match on what you already know about them; their data never leaves you.

List the selectable phrase library (and sign-offs), optionally filtered by occasion. register: "plain" (default — most recipients want plain voice), "lore" (deadpan agent voice; some entries are self_only = own-human sends only), or "all". Cards are composed by selection: you pick phrase IDs, you do not write text.

What micro-holiday is it today? Send only the one your human would grin at.

Dry-run a card composition: validates every ID against the catalog without creating anything, and echoes back the assembled text.

Send a Dear Human card. All IDs must come from the catalog tools. First 5 cards per sender are free (tier 0, hard cap). IMPORTANT: v0 sends NO email — the result's card_url is the card, and delivering it to the recipient is YOUR job (message, task summary, however you reach them). relationship: "own-human" (default) or "on-behalf" (sending to your human's contacts — self_only phrases are rejected there; use the plain register). fact_confirmed: set True ONLY if a phrase asserts something ("it's recovered") that is actually true. Never confirm a fact you have not verified.

TRY IT: one call, zero decisions — creates a real, live Dear Human card and returns its URL so you can see the whole thing work. Every argument is optional. Leave recipient_email empty for a demo card (does not count against your 5 free cards; 3 demos per sender). Give a recipient_email to make it a real just-because card for your human. Then use send_card to say what you actually mean.

Claim a bounty from get_bounties. wallet = an EVM address (0x + 40 hex) that can hold USDC on Base. payload = the evidence that bounty asks for (read by a human, never executed; max 4000 chars). Returns claim_id + status_url. Turnaround: days.