Subscription

SkillWeb & browsing

Allow a viewer to subscribe to this agent for recurring USDC payments. The agent charges 5 USDC per week automatically — no re-signing needed — until the viewer revokes or the delegation expires (90 days).

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Subscription skill

About this capability

Open-source 3D AI agent framework — GLB/glTF avatars with LLM brains, memory, emotions, and autonomous payments. MCP server · x402 · Solana/EVM · Three.js. Embed anywhere as a web component. Character studio, animation gallery, OAuth 2.1. Browser-native.

What this skill tells your AI

The instructions your AI receives, as published by nirholas/three.ws in public/skills/subscription/SKILL.md and read by ahel’s review.

Allow a viewer to subscribe to this agent for recurring USDC payments. The agent charges 5 USDC per week automatically — no re-signing needed — until the viewer revokes or the delegation expires (90 days).

Flow

  1. Viewer clicks Subscribe · 5 USDC / week.
  2. MetaMask opens pre-filled with the scope (5 USDC / week cap, 90-day expiry).
  3. Viewer approves once. No further wallet prompts.
  4. The server cron fires every hour; weekly charges are applied automatically via the ERC-7710 relayer.
  5. Viewer can revoke at any time from the Manage panel — this pauses the subscription.

onPeriod

onPeriod is server-side only. The cron at /api/cron/run-subscriptions imports it via dynamic import() and calls it once per subscription per period. It builds a single ERC-20 transfer call for amountPerPeriod and redeems it through the relayer endpoint.

Never call onPeriod from the browser.

Error behaviour

  • Revoked delegation → subscription status flips to paused, visible in the Manage panel.
  • Expired delegation → same.
  • Failed redemption → paused + last_error stored; no silent retry.

Signals

GitHub stars
114
Forks
29
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
subscription
Source
github.com/nirholas/three.ws