Skip to content
TakoAPI
Back to skills

sparkbtcbot-proxy

by echennells

Web & Frontend Development
402Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Use a Spark Bitcoin L2 wallet proxy for AI agents via HTTP API.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User asks: fetch a joke from the L402-gated endpoint at https://lightningfaucet.com/api/l402/joke

AGENT
  1. 1

    Reads PROXY_URL and PROXY_TOKEN from environment

  2. 2

    POSTs to /api/l402 with the target URL and maxFeeSats limit

  3. 3

    Checks if response status is pending and polls /api/l402/status if so

  4. 4

    Returns the joke payload once payment confirms

OUTPUT

JSON with the joke content and priceSats showing how many sats were spent

Requirements

  • 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

Installation

clawhub install echennells/sparkbtcbot-proxy

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links