Orange Wallet

What This Skill Does

Orange Wallet provides a robust, developer-friendly interface for managing Lightning Network payments directly within AI agents. By utilizing a graduated-custody model, it offers a seamless blend of instant, low-cost custodial transactions via the Spark backend and self-custodial security as funds scale. This skill effectively turns your AI agent into a mini-bank, capable of receiving payments, managing channels, and interacting with the Lightning network through simple, machine-readable JSON shell commands. It serves as an ideal bridge for autonomous agents that require micro-transaction capabilities to perform tasks, pay for resources, or accept compensation for services.

Installation

Installation requires Rust and the Protocol Buffers compiler. First, ensure you have Rust installed via rustup. Next, install the protobuf compiler using your system package manager (e.g., brew install protobuf on macOS or sudo apt install protobuf-compiler on Debian/Ubuntu). Once prerequisites are met, clone the repository from openclaw/skills, navigate to the orange-skill directory, and run cargo install --path .. Configuration is handled via a config.toml file; ensure you define a valid storage path, a reliable chain source (Esplora/Electrum), and your LSP details. Always remember to back up the seed file generated in your storage directory, as it is your only method for wallet recovery.

Use Cases

• Autonomous Payment Processing: Enable your agent to accept Lightning payments for data retrieval or compute tasks.
• Agent-to-Agent Economies: Facilitate value exchange between independent agents requiring API access.
• Micro-transaction APIs: Monetize specific agent capabilities by generating invoices on-the-fly.
• Automated Resource Purchasing: Allow your agent to pay for its own API keys or server uptime using earned funds.

Example Prompts

1. "Orange, generate a Lightning invoice for 5000 sats so I can pay for the data analysis report you just finished."
2. "Check the current balance of the agent wallet and confirm if the last payment from the webhook was processed successfully."
3. "Start the orange daemon in the background with my webhook endpoint so we are ready to receive incoming service payments."

Tips & Limitations

This is alpha-grade software. While it is highly capable, the 'vibe-coded' nature of the project means you should treat it as experimental. Never store life-changing amounts of Bitcoin in this wallet. The graduated-custody model is convenient, but rely on your own security audits if you intend to push this to production. Always monitor your daemon logs to ensure stable channel connections, and remember that lightning channels require active maintenance to remain responsive. Regularly audit your config.toml to ensure your LSP is trusted and performant.