# Satogram

> Satogram is a Lightning Network broadcast messaging service. Senders pay upfront to deliver a short message + sats to thousands of lightning addresses across the network. This site hosts the integration guide for custodial Lightning wallet providers who want their users to receive Satograms (and, optionally, take a delivery fee on incoming Satograms).

The integration guide below covers everything a wallet engineer or their AI agent needs to add Satogram support to an LND, Core Lightning, LDK, or Eclair node, including reference code, an end-to-end regtest test recipe, and a pre-launch checklist.

## Full guide (one-file ingest)

- [Full integration guide as a single file](https://satogram.xyz/llms-full.txt): every section concatenated, ready for an agent to consume in a single fetch. **Recommended starting point for AI agents.**

## Integration guide sections

- [Why integrate](https://satogram.xyz/integrate/business): the business case for custodial wallet providers, covering revenue model, costs, and what you're agreeing to.
- [How it works](https://satogram.xyz/integrate/docs/how-it-works): the two delivery paths (per-recipient LNURL-pay and batch keysend), TLV format, and what payments look like on the wire.
- [LNURL-pay setup](https://satogram.xyz/integrate/docs/lnurl-pay-setup): endpoint requirements the Satogram service checks against, plus a reference Go callback handler.
- [Detecting payments](https://satogram.xyz/integrate/docs/detecting-payments): working subscription handlers for LND (Go), Core Lightning (Python plugin), LDK (Rust), and Eclair (REST + WebSocket).
- [Testing](https://satogram.xyz/integrate/docs/testing): end-to-end regtest recipe with paste-able commands for both delivery paths, plus negative tests.
- [Batch keysend opt-in](https://satogram.xyz/integrate/docs/batch-keysend-opt-in): how to qualify for the batch keysend path, technical requirements, and onboarding steps with the operator.
- [Operational checklist](https://satogram.xyz/integrate/docs/checklist): pre-launch checklist covering LNURL-pay endpoint, invoice subscriber, UX, and testing.

## Landing pages

- [For wallet providers (landing)](https://satogram.xyz/integrate): the entry point for wallet operators and their developers.
- [Integration docs index](https://satogram.xyz/integrate/docs): TOC for the technical docs section.

## Contact

- Email: satograms@gmail.com
- Telegram: https://t.me/satograms
- X / Twitter: https://twitter.com/Satograms

## Optional

- [Help (end users)](https://satogram.xyz/help): docs for users who want to *send* Satograms (not for wallet integrators).
- [Create (end users)](https://satogram.xyz/create): UI for end users to send a Satogram.
- [Developer tools](https://satogram.xyz/devtools): general developer-facing endpoints not specific to wallet integration.