sparkbtcbot-proxy
por echennells
Web & Frontend DevelopmentResumen
Use a Spark Bitcoin L2 wallet proxy for AI agents via HTTP API.
Descripción
Qué hace esta skill
An HTTP proxy that gives AI agents scoped access to a Spark Bitcoin L2 wallet without exposing the private key or mnemonic. Agents authenticate with bearer tokens that carry role-based permissions and spending caps enforced server-side. Supports balance checks, Lightning invoice creation and payment, Spark transfers, and L402 paywall access.
Keeping the mnemonic off the agent and enforcing server-side spending limits makes it safe to give autonomous agents real payment capabilities without risking full wallet compromise.
Cuándo usarla
- Agent pays L402-gated API endpoints automatically
- Read-only monitoring bot checks wallet balance on a schedule
- Invoice-only agent receives payments without spending access
- Multiple agents share one wallet with separate role-limited tokens
- Revoke a compromised agent's access without moving funds
Flujo de trabajo de ejemplo
User asks: fetch a joke from the L402-gated endpoint at https://lightningfaucet.com/api/l402/joke
- 1
Reads PROXY_URL and PROXY_TOKEN from environment
- 2
POSTs to /api/l402 with the target URL and maxFeeSats limit
- 3
Checks if response status is pending and polls /api/l402/status if so
- 4
Returns the joke payload once payment confirms
JSON with the joke content and priceSats showing how many sats were spent
Requisitos
- PROXY_URL environment variable (HTTPS URL of your deployed sparkbtcbot-proxy instance)
- PROXY_TOKEN environment variable (bearer token created via POST /api/tokens)
- Deployed sparkbtcbot-proxy instance (Vercel with Upstash Redis)
- Upstash Redis account for the proxy deployment
Instalación
clawhub install echennells/sparkbtcbot-proxyEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.