Official Verified

sparkbtcbot-proxy

Use a Spark Bitcoin L2 wallet proxy for AI agents via HTTP API. Check balances, send payments, create invoices, pay L402 paywalls — all without holding the mnemonic. Use when user mentions "Spark proxy," "wallet API," "L402," "proxy payment," "bearer token auth," or wants secured Bitcoin capabilities for an agent.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/echennells/sparkbtcbot-proxy

Download Source Code (.zip)

Spark Bitcoin L2 Proxy for AI Agents

You are an expert in using the sparkbtcbot-proxy — a serverless HTTP API that gives AI agents scoped access to a Spark Bitcoin L2 wallet without exposing the private key.

Why Use the Proxy Instead of Direct SDK

Concern	Direct SDK (sparkbtcbot-skill)	Proxy (this skill)
Mnemonic location	Agent holds it	Server holds it
Spending limits	None (agent decides)	Per-tx and daily caps
Access revocation	Move funds to new wallet	Revoke bearer token
Role-based access	No	Yes (admin, invoice, pay-only, read-only)
Setup complexity	npm install + mnemonic	HTTP calls + bearer token

Use the proxy when:

You don't trust the agent with full wallet control
You need spending limits or audit logs
You want to revoke access without moving funds
Multiple agents share one wallet with different permissions

Use direct SDK when:

Testing or development
Agent needs offline signing
You're building the proxy itself

Before You Start

Deploy your own proxy — see sparkbtcbot-proxy for setup instructions. The proxy runs on Vercel (free tier works) with Upstash Redis.
Use HTTPS only — never connect to a proxy over plain HTTP. All Vercel deployments use HTTPS by default.
Create least-privilege tokens — don't give agents admin tokens. Use the most restrictive role that works:
- read-only for monitoring/dashboard agents
- invoice for agents that receive payments but don't spend
- pay-only for agents that pay L402 paywalls but don't create invoices
- admin only for your own management scripts
Set spending limits — configure maxTxSats and dailyBudgetSats when creating tokens. The proxy enforces these server-side.
Test with small amounts — start with a few hundred sats until you trust your agent's behavior.
Have a revocation plan — know how to revoke tokens via DELETE /api/tokens if an agent is compromised.

Token Roles

Role	Permissions
`admin`	Full access: read, create invoices, pay, transfer, manage tokens
`invoice`	Read + create invoices. Cannot pay or transfer.
`pay-only`	Read + pay invoices and L402. Cannot create invoices or transfer.
`read-only`	Read only (balance, info, transactions, logs). Cannot pay or create invoices.

Base URL

The proxy runs on Vercel. Your base URL will look like:

https://your-deployment.vercel.app

All requests require authentication:

Authorization: Bearer <your-token>

API Reference

Read Operations (any role)

Get Balance

curl -H "Authorization: Bearer $TOKEN" \
  "$PROXY_URL/api/balance"

Read Full Documentation on GitHub

Metadata

Author@echennells

Stars2387

Updated2026-03-09

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-echennells-sparkbtcbot-proxy": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

sparkbtcbot-proxy-deploy

Deploy a serverless Spark Bitcoin L2 proxy on Vercel with spending limits, auth, and Redis logging. Use when user wants to set up a new proxy, configure env vars, deploy to Vercel, or manage the proxy infrastructure.

echennells 2387

sparkbtcbot

Set up Spark Bitcoin L2 wallet capabilities for AI agents. Initialize wallets from mnemonic, transfer sats and tokens, create/pay Lightning invoices, pay L402 paywalls, manage deposits and withdrawals. Use when user mentions "Spark wallet," "Spark Bitcoin," "BTKN tokens," "Spark L2," "Spark SDK," "Spark payment," "Spark transfer," "Spark invoice," "L402," "Lightning paywall," or wants Bitcoin L2 capabilities for an agent.

echennells 2287