Skip to content

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

Open
vincenzopalazzo wants to merge 2 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 2 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 ef1b0f7
🔍 Latest deploy log https://app.netlify.com/projects/lightningdevkit/deploys/6a73cf28e310eb0008abf236
😎 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>
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.

1 participant