Skip to content

docs: intentId on widget callbacks + callback reference revision - #116

Open
miguelmota wants to merge 1 commit into
mainfrom
docs/widget-callback-intent-id
Open

miguelmota wants to merge 1 commit into
mainfrom
docs/widget-callback-intent-id

Conversation

@miguelmota

@miguelmota miguelmota commented Sep 17, 2026

Copy link
Copy Markdown
Member

Summary

Documents the intentId field arriving on the widget lifecycle callback payloads in 0xtrails@0.19.0. The changelog entry is marked Unreleased and needs a date once that version is published.

intentId

  • sdk/configuration.mdx: the general-callbacks table gains a Payload column, plus a new Callback payloads section explaining sessionId vs intentId, when intentId is null (passthrough), and the exported CheckoutEventBase / TransactionConfirmationEvent types.
  • Mode pages (pay, fund, swap, earn, withdraw): lifecycle tables show intentId on success/error and note that *Start fires before quoting.
  • Success-handler examples across sdk/, use-cases/, examples/ now correlate on intentId instead of sessionId.
  • New sdk/changelog/0xtrails-0.19.0.mdx and a card on the changelog index.

Revision fixes found while auditing the callback docs against the SDK

  • use-cases/pay.mdx passed sessionId to getIntentReceipt({ intentId }), which never matched anything. It now uses the real intentId.
  • Removed the walletOptions row from the shared props table; no focused component or TrailsWidget exposes that prop.
  • examples/x402.mdx handler type updated to the new payload shape.

Checks

  • mintlify broken-links passes
  • Set the 0.19.0 release date once the SDK version is published

🤖 Generated with Claude Code using Claude Fable 5.1

…ference

Document the new intentId field on every post-quote widget callback,
add a Callback payloads section to the configuration reference, switch
the success-handler examples to correlate on intentId, fix the pay use
case that passed sessionId as an intent id, drop the nonexistent
walletOptions prop, and add the 0xtrails@0.19.0 changelog entry.

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

mintlify Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
trails 🟢 Ready View Preview Sep 17, 2026, 5:00 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@miguelmota miguelmota self-assigned this Sep 17, 2026
@miguelmota
miguelmota marked this pull request as ready for review September 17, 2026 17:06

@ScreamingHawk ScreamingHawk 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.

LGTM! (Pending 0.19.0 release)

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