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

@vincenzopalazzovincenzopalazzo commented Aug 5, 2026

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

@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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

netlifyBot commented Aug 5, 2026•
edited
Loading

Copy link
Copy Markdown

✅ Deploy Preview for lightningdevkit ready!

NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.

@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman reviewed Aug 6, 2026
View reviewed changes

@benthecarmanbenthecarman 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 threaddocs/blog/bolt12-payer-proofs.md Outdated
Comment threaddocs/blog/bolt12-payer-proofs.md Outdated
Comment threaddocs/blog/bolt12-payer-proofs.md Outdated
Comment threaddocs/blog/bolt12-payer-proofs.md Outdated
@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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

vincenzopalazzo commented Aug 7, 2026

Copy link
Copy Markdown
MemberAuthor

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

vincenzopalazzo commented Aug 7, 2026

Copy link
Copy Markdown
MemberAuthor

left some notes but overall this reads very AI-y

What does not these days? :P

@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•
edited
Loading

Copy link
Copy Markdown
MemberAuthor

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

@vincenzopalazzo
vincenzopalazzoforce-pushed the blog/bolt12-payer-proofs branch from b4b3098 to 5e84c52CompareAugust 7, 2026 11:40
@benthecarman

benthecarman commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

still reads pretty ai-y imo

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

Reviewers

1 more reviewer
@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

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
@vincenzopalazzovincenzopalazzo
commented
Aug 5, 2026

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
@vincenzopalazzo
feat(blog): add BOLT 12 payer proofs post with diagram assets
dd0ec77
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
netlifyBot
commented
Aug 5, 2026•

edited

Loading

Copy link


Copy Markdown

✅ Deploy Preview for lightningdevkit ready!
NameLink
🔨 Latest commit5e84c52
🔍 Latest deploy loghttps://app.netlify.com/projects/lightningdevkit/deploys/6a75c43ea27ad0000830fc2b
😎 Deploy Previewhttps://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.
@vincenzopalazzo
fix(blog): set payer proofs publish date to today
ef1b0f7
Co-Authored-By: Vincenzo Palazzo <vincenzopalazzo@users.noreply.github.com>
benthecarman
benthecarman
reviewed
Aug 6, 2026
View reviewed changes
@benthecarmanbenthecarman
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 threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

Comment threaddocs/blog/bolt12-payer-proofs.md
Outdated

@vincenzopalazzo
fix(blog): address review feedback on payer proofs post
e71e5fd
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
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
vincenzopalazzo
commented
Aug 7, 2026

Copy link


Copy Markdown

MemberAuthor
left some notes but overall this reads very AI-y
What does not these days? :P
@vincenzopalazzo
fixup! feat(blog): add BOLT 12 payer proofs post with diagram assets
9281842
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•

edited

Loading

Copy link


Copy Markdown

MemberAuthor
Pushed a fuller rewrite aimed at the "reads very AI-y" cc @benthecarman :P
@vincenzopalazzo
vincenzopalazzoforce-pushed
the
blog/bolt12-payer-proofs
branch
from
b4b3098 to
5e84c52CompareAugust 7, 2026 11:40
@benthecarman
benthecarman
commented
Aug 7, 2026

Copy link


Copy Markdown

Contributor
still reads pretty ai-y imo
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


1 more reviewer

@benthecarmanbenthecarmanbenthecarman left review comments
Reviewers whose approvals may not affect merge requirements

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@vincenzopalazzo@benthecarman