Maestro Bitcoin Skill

Minimal skill for agents that query Maestro Bitcoin APIs directly using the current SIWX + JWT + x402 credit purchase flow.

Published on ClawHub: https://clawhub.ai/Vardominator/maestro-skill

What This Skill Is

• Direct HTTP usage of Maestro endpoints.
• Mainnet-first policy for production intent (eip155:1, optional eip155:8453 fallback by user approval).
• Client flow based on SIWX challenge, JWT session, and range-based credit purchases.

Client Flow Summary

1. Call endpoint without auth.
2. Receive 402 with accepts + extensions.sign-in-with-x.
3. Sign SIWX and retry with Sign-In-With-X.
4. Receive JWT (Authorization) and 402 purchase guidance.
5. Choose a purchase amount in range, sign ERC-3009 authorization, retry with Authorization + X-PAYMENT.
6. On success, read response plus credit headers (X-Credits-Remaining, X-Credit-Cost, X-Credits-Purchased) and Payment-Response when present.

Header Semantics

• Authorization: New JWT after successful SIWX auth.
• X-Credits-Remaining: Remaining credits after a successful charged request.
• X-Credit-Cost: Credits consumed by the request path.
• X-Credits-Purchased: Credits added by payment on that request (purchase path only).
• Payment-Response: Settlement metadata (base64 JSON), typically includes tx hash.

Outcome expectations:

• 200 with existing credits: X-Credits-Remaining + X-Credit-Cost.
• 200 with purchase: adds X-Credits-Purchased + Payment-Response.
• 402 insufficient credits: usually no X-Credits-*; body contains accepts.
• 402 SIWX expired/invalid message: fresh challenge (accepts + extensions.sign-in-with-x).
• 401 SIWX nonce expired/replayed: error JSON, no credit headers.

Credit Purchase Amounts

• Base credit cost: $0.000025 per credit.
• Minimum purchase: $0.10 (4,000 credits)
• Maximum purchase: $50.00 (2,000,000 credits)

Common examples:

• $1.00 -> 40,000 credits
• $5.00 -> 200,000 credits
• $10.00 -> 400,000 credits

Required Capability

• Wallet signer access (PRIVATE_KEY or CDP Agent Wallet)
• USDC + ETH gas on the selected network