bolt12-cli 0.1.0

Swiss-knife CLI for BOLT12 offers, invoices, and payer proofs
# bolt12-cli

Minimal Rust/LDK Swiss knife for BOLT 12. Decode offers, invoices, and payer
proofs to curated JSON. Verify official `lnp1` payer proofs and the
offer + invoice + preimage triple.

Logic lives in `bolt12-common`. `bolt12-cli` is clap + JSON on stdout.

## Install

```sh
cargo install bolt12-cli
```

The binary is `bolt12`.

## Build

```sh
cargo build --release
```

## Decode

HRP is auto-detected (`lno` / `lni` / `lnp`).

```sh
bolt12 decode lno1...
bolt12 decode lni1...
bolt12 decode lnp1...
```

`decode lnp1` parses through LDK, which also verifies the proof. Invalid proofs
cannot be decoded.

Invoice JSON includes `unknown_invoice_tlvs` when any TLV type in 160–239 is
not a BOLT 12 invoice field. The key is omitted when the list is empty.

## Verify

Official payer proof: LDK cryptographic checks plus `pays_offers_recipient`
(invoice issuer can sign for this offer's recipient, not "this paid this
exact offer"):

```sh
bolt12 verify lnp1... --offer lno1...
```

Ocean-style payment triple:

```sh
bolt12 verify --offer lno1... --invoice lni1... --preimage <64 hex chars>
```

Success is `{ "valid": true, "checks": [...] }` and exit 0. A failed check is
the same shape with `"valid": false` and exit 1. Argument/decode errors are
`{ "error": "...", "message": "..." }` and exit 1.

## Tests

```sh
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all
```