sparkbtcbot

What This Skill Does

The sparkbtcbot skill provides a robust bridge between AI agents and the Spark Bitcoin Layer 2 network. By leveraging the @buildonspark/spark-sdk, this tool enables agents to manage their own self-custodial wallets, facilitating instant, near zero-fee transfers of BTC and tokens. It empowers agents to handle Lightning Network interoperability, allowing them to pay L402 paywalls, generate and settle invoices, and execute high-speed transactions natively. This skill transforms an agent from a text-based processor into an autonomous economic participant, capable of interacting with the global Bitcoin ecosystem without human intervention.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/echennells/sparkbtcbot Ensure you have your environment variables configured if you are using a proxy service, or have your BIP39 mnemonic secured if you are using the agent-direct mode. For production, please refer to the sparkbtcbot-proxy documentation to ensure your private keys remain protected behind server-side access controls.

Use Cases

• Autonomous Micro-payments: Enabling agents to purchase API credits or data packets via L402 paywalls without human approval.
• Automated Value Settlement: Facilitating instant, zero-fee settlements between different AI agents or services built on Spark.
• On-Chain/Lightning Bridge: Providing a unified interface for agents to move funds between the Spark L2 network and the wider Lightning Network for real-world utility payments.
• Token Economy Interaction: Managing BTKN tokens and other assets on the Spark chain for specialized agent-based market operations.

Example Prompts

• "Spark wallet, check my current balance and list the last five transactions."
• "Create a Lightning invoice for 5000 sats so I can receive payment for the report I just finished."
• "Pay the L402 paywall at this endpoint using my Spark wallet to access the requested data."

Tips & Limitations

This skill gives the agent full custodial control over the mnemonic provided. For testing purposes, always utilize the REGTEST environment to avoid the loss of real funds. When moving to a production environment, prioritize the sparkbtcbot-proxy approach to implement spending limits, daily caps, and read-only role restrictions. Always audit your agent's code to ensure that transaction logic is strictly bounded, preventing the accidental depletion of your wallet balance through erroneous or malicious API calls.