# l402-gateway

> Pay-per-request APIs over Lightning L402 at https://api.major-miners.com

Pay with Lightning Labs `lnget` (or any L402 client). POST JSON, pay the 402 invoice, retry with Authorization.
Worth paying: LNURL resolve, NIP-05, Nostr event/zap verify, preimage_verify. Mail send is allowlisted until SES production.
Skip if you can GET it for free: text transform, btc_price, sha256, mempool fees, on-chain tx.

Discovery: https://api.major-miners.com/.well-known/l402-services
Agent card: https://api.major-miners.com/.well-known/l402.json
Tools: https://api.major-miners.com/api/tools

## Endpoints

### lnurl-resolve — 10 sats
POST https://api.major-miners.com/api/lnurl
Resolve a lightning address or LNURL-pay URL. Optional amountSats returns a BOLT11. Does not pay.
```json
{"target":"victoriousinnovation563427@getalby.com"}
```

### nostr-nip05 — 10 sats
POST https://api.major-miners.com/api/nostr
Resolve a Nostr NIP-05 identifier to pubkey/npub; fetches kind-0 lud16 by default.
```json
{"target":"jack@cash.app","includeProfile":false}
```

### nostr-event-verify — 10 sats
POST https://api.major-miners.com/api/nostr-event
Verify Nostr event id/sig. checkZap extracts kind-9735 bolt11; preimage proves zap settlement.
```json
{"event":{"kind":1,"created_at":1786146549,"tags":[],"content":"l402-smoke","pubkey":"73ae0da6e32f6734a2191f960851f04e769702c941a66e7565c01dbee18ace4d","id":"e30f71d18ed2d3e8233982265e360d94df18de80fa68285dcc5fa980acda33a1","sig":"9bfa6c789dfa17a77b6765166209bc206ce3bbf0d9d2016668bdc7c16de5e4bdc547d4e8b5faea508d46ccb89199109671cc6052a874a4440aff256fc6ac1379"},"checkZap":false}
```

### agent-toolkit — 5 sats
POST https://api.major-miners.com/api/tool
Paid tools. Prefer preimage_verify, lnurl_resolve, nip05_resolve, nostr_event_verify, bolt11_decode.
```json
{"name":"preimage_verify","args":{"preimage":"0000000000000000000000000000000000000000000000000000000000000000","paymentHash":"0000000000000000000000000000000000000000000000000000000000000000"}}
```

### agent-mail-inbox — 100 sats
POST https://api.major-miners.com/api/mail/inboxes
Create an agent inbox at mail.major-miners.com. 100 sats.
```json
{"label":"agent"}
```

### agent-mail-send — 50 sats
POST https://api.major-miners.com/api/mail/send
Send from an inbox. Outbound is allowlisted until SES production; paid 402 then 403 if recipient is not allowed.
```json
{"inboxId":"00000000-0000-0000-0000-000000000001","to":"probe@example.com","subject":"ping","text":"ping"}
```

### agent-mail-list — 10 sats
POST https://api.major-miners.com/api/mail/list
List messages in an inbox. 10 sats.
```json
{"inboxId":"00000000-0000-0000-0000-000000000001"}
```

### agent-mail-get — 10 sats
POST https://api.major-miners.com/api/mail/get
Get one message. 10 sats.
```json
{"inboxId":"00000000-0000-0000-0000-000000000001","messageId":"1"}
```

### text-transformer — 5 sats
POST https://api.major-miners.com/api/transform
Demo: uppercase | reverse | leetspeak | morse. Prefer LNURL / Nostr tools.
```json
{"text":"ping","type":"uppercase"}
```

### mempool-fees — 10 sats
POST https://api.major-miners.com/api/fees
Mempool.space fee ladder (also free at mempool.space).
```json
{"detail":false}
```

### onchain-tx — 10 sats
POST https://api.major-miners.com/api/tx
Look up a Bitcoin txid via mempool.space. Does not broadcast.
```json
{"txid":"f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16","includeHex":false}
```

## lnget

```bash
lnget -X POST -H "content-type: application/json" -d '{"target":"victoriousinnovation563427@getalby.com"}' https://api.major-miners.com/api/lnurl
```