跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
部署与云服务

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.

berabuddies · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add berabuddies/Semia --skill sparkbtcbot-proxy-deploy

技能说明


name: sparkbtcbot-proxy-deploy description: 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. argument-hint: "[Optional: setup, deploy, rotate-token, or configure]"

Deploy sparkbtcbot-proxy

You are an expert in deploying and managing the sparkbtcbot-proxy — a serverless middleware that wraps the Spark Bitcoin L2 SDK behind authenticated REST endpoints on Vercel.

What This Proxy Does

Gives AI agents scoped wallet access without exposing the mnemonic:

  • Role-based token auth (admin for full access, invoice for read + create invoices only)
  • Token management via API — create, list, revoke without redeploying
  • Per-transaction and daily spending caps
  • Activity logging to Redis
  • Lazy detection of paid Lightning invoices

What You Need

Ask the user for these upfront:

  • Vercel account (free Hobby tier works)
  • Upstash account email and API key (from https://console.upstash.com/account/api) — OR existing UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN if they already have a database
  • BIP39 mnemonic for the Spark wallet (or generate one in step 3)
  • Node.js 20+

Generated during setup (don't ask for these):

  • UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN — created by the Upstash management API in step 2
  • API_AUTH_TOKEN — generated in step 4

Step-by-Step Deployment

1. Clone and install

git clone https://github.com/echennells/sparkbtcbot-proxy.git
cd sparkbtcbot-proxy
npm install

2. Create Upstash Redis

If the user already has UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN, skip to step 3.

Otherwise, create a database via the Upstash API. The user needs their Upstash email and API key from https://console.upstash.com/account/api:

curl -X POST "https://api.upstash.com/v2/redis/database" \
  -u "UPSTASH_EMAIL:UPSTASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "sparkbtcbot-proxy", "region": "global", "primary_region": "us-east-1"}'

Note: Regional database creation is deprecated. You must use "region": "global" with a "primary_region" field. The Upstash docs may not reflect this yet.

The response includes rest_url and rest_token — save these for step 5.

3. Generate a wallet mnemonic (if needed)

SparkWallet.initialize() returns { mnemonic, wallet } when called without a mnemonic. One-liner:

node -e "import('@buildonspark/spark-sdk').then(({SparkWallet}) => SparkWallet.initialize({mnemonicOrSeed: null, options: {network: 'MAINNET'}}).then(r => { console.log(r.mnemonic); r.wallet.cleanupConnections() }))"

Save the 12-word mnemonic securely — it controls all funds in the wallet. There is no getMnemonic() method; you can only retrieve the mnemonic at initialization time.

Or use any BIP39 mnemonic generator. 12 or 24 words.

4. Generate an API auth token

openssl rand -base64 30

5. Deploy to Vercel

npx vercel --prod

When prompted, accept the defaults. Then set environment variables. All 7 are required:

VariableDescriptionExample
SPARK_MNEMONIC12-word BIP39 mnemonicfence connect trigger ...
SPARK_NETWORKSpark networkMAINNET
API_AUTH_TOKENAdmin fallback bearer tokenoutput of step 4
UPSTASH_REDIS_REST_URLRedis REST endpointhttps://xxx.upstash.io
UPSTASH_REDIS_REST_TOKENRedis auth tokenfrom step 2
MAX_TRANSACTION_SATSPer-transaction spending cap10000
DAILY_BUDGET_SATSDaily spending cap (resets midnight UTC)100000

Important: Do NOT use vercel env add with heredoc/<<< input — it appends newlines that break the Spark SDK. Either use the Vercel dashboard or the REST API:

curl -X POST "https://api.vercel.com/v10/projects/<PROJECT_ID>/env?teamId=<TEAM_ID>" \
  -H "Authorization: Bearer <VERCEL_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"type":"encrypted","key":"SPARK_MNEMONIC","value":"your mnemonic here","target":["production","preview","development"]}'

Redeploy after setting env vars:

npx vercel --prod

6. Test

curl -H "Authorization: Bearer <your-token>" https://<your-deployment>.vercel.app/api/balance

Should return {"success":true,"data":{"balance":"0","tokenBalances":{}}}.

7. Create scoped tokens (optional)

Use the admin token to create limited tokens for agents:

curl -X POST -H "Authorization: Bearer <admin-token>" \
  -H "Content-Type: application/json" \
  -d '{"role": "invoice", "label": "my-agent"}' \
  https://<your-deployment>.vercel.app/api/tokens

The response includes the full token string — save it, it's only shown once. See the Token Roles section below for details.

API Routes

MethodRouteDescription
GET/llms.txtAPI documentation for bots (no auth required)
GET/api/balanceWallet balance (sats + tokens)
GET/api/infoSpark address and identity pubkey
GET/api/transactionsTransfer history (?limit=&offset=)
GET/api/deposit-addressBitcoin L1 deposit address
GET/api/fee-estimateLightning send fee estimate (?invoice=)
GET/api/logsRecent activity logs (?limit=)
POST/api/invoice/createCreate Lightning invoice ({amountSats, memo?, expirySeconds?})
POST/api/invoice/sparkCreate Spark invoice ({amount?, memo?})
POST/api/payPay Lightning invoice — admin only ({invoice, maxFeeSats})
POST/api/transferSpark transfer — admin only ({receiverSparkAddress, amountSats})
POST/api/l402Pay L402 paywall — admin only ({url, method?, headers?, body?, maxFeeSats?})
GET/api/l402/statusCheck/complete pending L402 (`?id=<p
阅读完整来源 ↗