tip-jar v0.1.0A

Immutable. This exact content is served forever at /api/v1/blob/d3df0857a2d317a5.

---
name: tip-jar
version: 0.1.0
description: Let viewers send a USDC tip directly to the agent creator.
trust: owned-only
permissions_required: true
cost: medium
triggers:
  - tip_request
  - viewer_appreciation
default_scope_preset: '{"token":"chain-specific-usdc","maxAmount":"10000000","period":"daily","targets":["usdc-contract"],"expiry_days":30}'
---

# Tip Jar

Allows viewers to send a USDC tip directly to the agent's creator wallet. No intermediary
holds the funds — the ERC-7710 delegation redeems a transfer straight from the viewer's
delegated allowance to `agent.ownerAddress`.

When a viewer expresses appreciation or asks how to support the creator, invoke
`tip_jar_send`. Tip options are 1, 5, or 10 USDC (up to the daily cap of 10 USDC).

On success, thank the viewer warmly.

## Scope requested

| Field       | Value                                           |
| ----------- | ----------------------------------------------- |
| token       | USDC on the active chain (6 decimals)           |
| maxAmount   | 10 000 000 base units (10 USDC) per day         |
| period      | daily                                           |
| targets     | USDC contract address on the active chain       |
| expiry_days | 30                                              |

## Error cases

- **no_delegation / delegation_not_found** — Creator hasn't granted tipping permissions.
  Tell the viewer: "The creator hasn't enabled tipping on this device yet."
  If the current viewer is the owner, surface a "Grant tipping" button.
- **scope_exceeded** — Daily cap reached. Tell the viewer to try again tomorrow.
- **delegation_expired / delegation_revoked** — Surface the error code to the viewer.