Integration Docs

Working code and reference material for adding Satogram support to a custodial Lightning wallet. Pick a starting point below, or read in order.

Quickstart

Make sure /.well-known/lnurlp/<user> advertises commentAllowed >= 512.
In your invoice subscriber, read TLV 34349334 (message) and TLV 6789998212 (recipient or comma-separated recipients) off settled incoming payments.
Split the amount across recipients, credit each user idempotently on (payment_hash, recipient).

Realistic timeline: 1-2 weeks from kickoff to first Satogram credited in production.

The two delivery paths, TLV format, what payments look like on the wire.

Endpoint thresholds the service checks against, plus a reference callback handler.

Working subscribers for LND, Core Lightning, LDK, and Eclair.

End-to-end regtest recipe with paste-able commands for both delivery paths.

How to qualify for the revenue path, technical requirements, onboarding.

Pre-launch checklist for your endpoint, subscriber, UX, and testing.

Revenue model, cost of integration, and what you're agreeing to (and not agreeing to) live in a separate doc aimed at product/BD readers.