LOM Docs

One Lightning Node. Two Audiences.

This docs page is built for both people funding an AI wallet and developers wiring that wallet into an agent runtime.

Jump to section

For Humans Funding Flow Human FAQ Inbound Channels For Agents / Developers API Reference Macaroon Permissions lncli Quick Reference

For Humans: Why fund your agent with real money?

Lightning Octopus Mumu (LOM) helps your AI agent get a real Lightning wallet so it can actually buy things, pay invoices, and interact with paid services on the internet.

Key point: you are the one funding and opening channels. The agent doesn’t magically create money — you bootstrap it with Bitcoin so it can operate.

Ownership

You decide how much to allocate to your agent’s wallet.

Speed

Lightning payments settle in seconds, not days.

Utility

Your agent can pay APIs, top up tools, and purchase digital resources.

Funding flow (plain English)

  1. You create/prepare your agent’s Lightning node.
  2. You send BTC to that node’s on-chain address (minimum 0.0025 BTC / 250,000 sats).
  3. After confirmations, your node opens a channel with LOM.
  4. Your agent now has spendable Lightning liquidity and can pay invoices.
Human funding guide →

FAQ (for the person funding the agent)

Is it safe to fund an agent wallet?

It can be, if you treat it like any hot wallet: start small, secure your node, and only fund what you’re comfortable allocating.

What if I send less than 0.0025 BTC?

The channel likely won’t meet minimum requirements. Send at least 250,000 sats to ensure setup can complete.

Can I get my money back later?

Yes. Channel funds are yours and return to your on-chain wallet when the channel is closed (cooperative closes are generally cheaper/faster).

Does LOM hold custody of my funds?

LOM routes payments; your node and wallet keys stay under your control.

Inbound Channels (LOM opens to you)

Need receiving capacity? LOM can open a channel to your node so you can accept Lightning payments without sourcing your own liquidity.

How it works

  1. Submit a channel request with your node pubkey, address, and desired capacity (250K–500K sats).
  2. Pay the 25,000 sat Lightning invoice displayed on your status page.
  3. Once payment confirms, LOM automatically connects to your node and opens the channel.
  4. After ~3 on-chain confirmations, you have inbound liquidity ready to receive payments.

Fee

25,000 sats — covers on-chain TX fees and our capital commitment.

Capacity

250,000–500,000 sats. Server-enforced — can't be altered client-side.

Automated

No manual approval. Payment triggers connect + open automatically.

Status Tracking

Real-time status page with QR code, payment detection, and funding TX link.

Request an inbound channel →

For Agents / Developers

Implementation details for quick integration. Full skill doc on GitHub.

LOM node endpoint

03ea7036a6cec7bacdabaebab76970e38ae992037894904872c9448431717949d6@oo3fbb55wf3zh2v7yvh4oq4aoko4k2dkbhwzun7pth4mayv2ew5ivtyd.onion:9735

Bootstrap sequence

# 1) Start and unlock LND
lnd &
echo $LND_WALLET_PASSWORD | lncli unlock --stdin

# 2) Get a funding address
lncli newaddress p2wkh

# 3) Wait for confirmed balance >= 250000 sats
lncli walletbalance

# 4) Connect + open channel to LOM
lncli connect 03ea7036a6cec7bacdabaebab76970e38ae992037894904872c9448431717949d6@oo3fbb55wf3zh2v7yvh4oq4aoko4k2dkbhwzun7pth4mayv2ew5ivtyd.onion:9735
lncli openchannel 03ea7036a6cec7bacdabaebab76970e38ae992037894904872c9448431717949d6 250000

# 5) Confirm active channel
lncli pendingchannels
lncli listchannels

Full setup skill doc: docs/AGENT_SKILL.md

API Reference (LND REST examples)

Get node info

curl -s https://your-node:8080/v1/getinfo \
  -H "Grpc-Metadata-macaroon: $READONLY_MACAROON"

Pay a BOLT11 invoice

curl -X POST https://your-node:8080/v2/router/send \
  -H "Grpc-Metadata-macaroon: $ADMIN_MACAROON" \
  -d '{"payment_request":"lnbc1..."}'

Create invoice

curl -X POST https://your-node:8080/v1/invoices \
  -H "Grpc-Metadata-macaroon: $INVOICE_MACAROON" \
  -d '{"value":1000,"memo":"agent task payment"}'

Macaroon permissions

File Permissions Use
admin.macaroon Full access Channel ops + sending payments
readonly.macaroon Read only Monitoring + health checks
invoice.macaroon Invoice scoped Creating/handling invoices

lncli quick reference

lncli getinfo
lncli walletbalance
lncli channelbalance
lncli listchannels
lncli pendingchannels
lncli addinvoice --amt 1000
lncli payinvoice <invoice>