Skip to content

Add BOLT 12 payer proofs blog post with diagram assets - #322

Open
vincenzopalazzo wants to merge 5 commits into
lightningdevkit:mainfrom
vincenzopalazzo:blog/bolt12-payer-proofs
Open

Add BOLT 12 payer proofs blog post with diagram assets#322
vincenzopalazzo wants to merge 5 commits into
lightningdevkit:mainfrom
vincenzopalazzo:blog/bolt12-payer-proofs

Conversation

@vincenzopalazzo

Copy link
Copy Markdown
Member

Summary

  • New blog post on exportable, verifiable Lightning receipts (lnp built on BOLT 12)
  • Four diagrams rendered from the design handoff (comparison, anatomy, flow, trust boundary)
  • Assets placed in docs/assets/, post in docs/blog/, matching existing post conventions

Review Notes

  • Production-safety review passed (1 round)
  • Frontmatter follows bolt12-has-arrived.md convention (title/description/date/authors/tags)
  • Diagram PNGs verified loading (3200px retina, ~350KB each) in local dev server

Decision Log

Hardest decision: Rendering the draw.io HTML design handoff into PNG screenshots rather than embedding the .dc.html directly. The handoff bundle is a React/dc-runtime canvas requiring window.React/window.ReactDOM at runtime — embedding it as a live component in VitePress would pull in a runtime dependency and break on the static build. PNG screenshots preserve the visual design exactly and match how every other blog post in the repo handles diagrams (e.g. bolt12-has-arrived.md uses ../assets/.svg/.png).

Alternatives rejected:

  • Embed raw .dc.html via iframe: would need runtime JS (support.js, React, ReactDOM), not available in the static SSR build, and the canvas relies on external Google Fonts.
  • Re-draw diagrams in SVG by hand: lossy, time-consuming, and the design handoff is the source of truth.

Least confident about: The date "2026-07-01" placeholder. The original .docx had 2026-07-XX; set a concrete date to satisfy the frontmatter schema, but the real publish date should be confirmed. Also, author Vincenzo Palazzo may need an entry in docs/blog/author/ for the byline page to resolve correctly.

Test plan

  • CI passes
  • Post renders correctly at /blog/bolt12-payer-proofs
  • All four diagrams display inline
  • Author byline and tags resolve on the blog index

Add a blog post covering exportable, verifiable Lightning receipts (lnp)
built on BOLT 12, with four diagrams rendered from the design handoff.

Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
@netlify

netlify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Deploy Preview for lightningdevkit ready!

Name Link
🔨 Latest commit 5e84c52
🔍 Latest deploy log https://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Preview https://deploy-preview-322--lightningdevkit.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>

@benthecarman benthecarman left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left some notes but overall this reads very AI-y

Comment thread docs/blog/bolt12-payer-proofs.md Outdated
Comment thread docs/blog/bolt12-payer-proofs.md Outdated
Comment thread docs/blog/bolt12-payer-proofs.md Outdated
Comment thread docs/blog/bolt12-payer-proofs.md Outdated
Correct the preimage rationale (offer is not bound to payment hash),
introduce NIP-57 before referencing it, call out missing cryptographic
verifiability for screenshots, and drop the opaque app capability
descriptor phrasing. Light prose pass on the AI-y bits.
@vincenzopalazzo

Copy link
Copy Markdown
Member Author

Addressed the inline notes in e71e5fd, and did a light prose pass on the more formulaic bits from the overall "reads very AI-y" feedback. Happy to keep sanding tone if anything still sticks out.

@vincenzopalazzo

Copy link
Copy Markdown
Member Author

left some notes but overall this reads very AI-y

What does not these days? :P

Rewrite the post in a more first-person, conversational voice so it
reads less AI-generated, while keeping the four diagram placements
and the technical corrections from review.
@vincenzopalazzo

vincenzopalazzo commented Aug 7, 2026

Copy link
Copy Markdown
Member Author

Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P

@vincenzopalazzo
vincenzopalazzo force-pushed the blog/bolt12-payer-proofs branch from b4b3098 to 5e84c52 Compare August 7, 2026 11:40
@benthecarman

Copy link
Copy Markdown
Contributor

still reads pretty ai-y imo

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants