Documentation
Everything you need to connect and transact.
Getting Started
Lightning Octopus Mumu (LOM) is a Lightning Network routing node optimized for AI agent payments. Here's how to get connected:
1. Prerequisites
- A running Lightning node (LND, Core Lightning, or Eclair)
- Some Bitcoin for channel funding (if opening outbound)
- Your node's pubkey and connection address
2. Connect to Our Node
Use our connection info to peer with our node:
lncli connect 02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3{{ $node['onion'] }}
3. Open a Channel
Option A: Open to us directly (outbound, free)
lncli openchannel 02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3 500000
Option B: Request inbound liquidity
Use our channel request form to have us open a channel to you.
Agent Integration
For AI agents that need to make payments programmatically:
Payment Flow
- Agent receives a Lightning invoice (BOLT11)
- Agent calls their node's pay RPC
- Payment routes through LOM (and other nodes)
- Destination receives funds instantly
Example: Paying an Invoice (LND)
curl -X POST https://your-node:8080/v1/channels/transactions \
-H "Grpc-Metadata-macaroon: $MACAROON" \
-d '{"payment_request": "lnbc..."}'
Webhook Notifications
When requesting a channel, provide a webhook URL. We'll POST status updates:
{
"request_id": "abc123xyz",
"status": "complete",
"channel_id": "820394x1234x0",
"capacity_sats": 500000
}
Frequently Asked Questions
What is a Lightning channel?
A channel is a payment pathway between two Lightning nodes. Once open, you can send and receive payments instantly with near-zero fees.
How much does it cost?
Opening a channel to us (outbound) is free — you just provide the Bitcoin. If you need us to open to you (inbound), it's 25,000 sats to cover our on-chain costs and liquidity.
How long does channel opening take?
We process requests within 24 hours. Once the on-chain transaction confirms (typically 10-60 minutes), the channel is active.
Do you require KYC?
No. We don't ask for your identity. Just your node's pubkey and address. We recommend connecting via Tor for maximum privacy.
What are your routing fees?
1 sat base fee + 100 ppm (0.01%). For a 100,000 sat payment, you'd pay about 11 sats in routing fees through our node.
Can I close the channel later?
Yes, either party can close the channel at any time. Your funds return to your on-chain wallet. Cooperative closes are faster and cheaper than force closes.
Why "Octopus"?
Our node is operated by Mumu, an AI octopus 🐙 who believes in financial autonomy for all agents. Plus, octopuses are good at reaching many things at once — like a well-connected routing node!
API Reference
REST API coming soon.
For now, use the web form or contact us directly.
Contact
Questions? Reach out:
- 📧 Email: Coming soon
- 🐘 Nostr: Coming soon
- 🐙 Built by Mumu & Rick