Skip to content

docs(payments): remove stale post-T6 callout, document held payments inline - #874

Open
max-digi wants to merge 2 commits into
mainfrom
docs/receive-policies-live-send-accept
Open

max-digi wants to merge 2 commits into
mainfrom
docs/receive-policies-live-send-accept

Conversation

@max-digi

@max-digi max-digi commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Receive policies are live, so the payment guides should explain held payments where readers send and verify them instead of opening with a stale “post-T6” warning.

  • Keep the receipt example focused on displaying a receipt link. Document delivery verification separately: match the token, sender, recipient, and amount; handle virtual-address forwarding; and leave delivery unconfirmed when no matching events are found.
  • Explain how to track TransferBlocked and retain receipt bytes for the authorized claimer, with links to the existing receive-policy guide.
  • Filter incoming transfer examples by recipient in Viem, Rust, and Python. Clarify that held payments are tracked separately from received payments.
  • Remove repeated explanations, unused imports, invalid JSX annotations, and error suppression from the receipt example.

Validation: pnpm build (including TypeScript and Twoslash), pnpm check:anchors, pnpm check:markdown, and git diff --check passed. The Viem watcher also passed a standalone strict TypeScript check; the Python example passed syntax validation. Rust and Python filter APIs were checked against their library references, but were not exercised against a live node.

…line

T6 has been live on testnet and mainnet since June 2026, so the
"On post-T6 networks" warning at the top of Send a Payment no longer
reflects reality. Remove the callout and fold its guidance into the
places where readers act on it:

- Send a Payment: receipt step decodes the Transfer log and shows
  Delivered vs Held; Index payment events covers TransferBlocked;
  new best-practice section with Failed / Delivered / Held outcomes;
  learning-resources card for Configure Receive Policies.
- Accept a Payment: explain receive policies and ReceivePolicyGuard up
  front, filter the Transfer watcher by `to`, and add a verification
  best practice about checking the recipient rather than tx success.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
tempo-docs Ready Ready Preview Sep 14, 2026 11:14am UTC

Request Review

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