Skip to content

docs(builder-codes): pass dataSuffix per call in Wagmi, add volume - #2091

Merged
youssefea merged 1 commit into
masterfrom
docs/kb-gaps-devrel-819-builder-tools-base-app
Oct 9, 2026
Merged

youssefea merged 1 commit into
masterfrom
docs/kb-gaps-devrel-819-builder-tools-base-app

Conversation

@youssefea

Copy link
Copy Markdown
Contributor

What changed? Why?

  • Builder Codes for App Developers: the Wagmi setup now passes dataSuffix on each sendTransaction and writeContract call and in the dataSuffix capability for sendCalls. A dataSuffix set in createConfig is not applied to transactions sent through a connected wallet (dataSuffix passed to createConfig is not applied to transactions sent through the connector client wevm/wagmi#5248), so the previous config-level setup sent transactions without the Builder Code. The old "Legacy: Per-Transaction Approach" accordion is folded into the main Wagmi steps.
  • Clarifies that a Viem wallet client dataSuffix covers sendTransaction and writeContract, and is forwarded to the wallet as a capability for sendCalls.
  • Track User Analytics: adds a "Measure ETH and USDC Volume" step that shows how to sum native ETH value and USDC Transfer logs for attributed transactions. The overview links to it.

Notes to reviewers

The Wagmi behavior was reproduced with @wagmi/core 3.6.5 and viem 2.57.4 using an injected connector. Config-level dataSuffix produced no suffix on sendTransaction, writeContract or sendCalls. Per-call dataSuffix and the sendCalls capability both produced it.

How has it been tested?

node scripts/lint-mdx.js on both changed files; node scripts/validate-docs-structure.js; npm test. Type-checked the new volume snippet with tsc --strict and ran its logic against a Base mainnet USDC transfer. Checked the wagmi issue link.

Screenshots

Not captured. Affected pages: /specifications/builder-codes/for-app-developers, /specifications/builder-codes/overview.

Generated with Toshi

@mintlify

mintlify Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
base 🟢 Ready View Preview Oct 8, 2026, 12:57 PM

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

@cb-heimdall

cb-heimdall commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Heimdall Review Status

Requirement Status More Info
Reviews ✅ 1/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@linear

linear Bot commented Oct 8, 2026

Copy link
Copy Markdown

DEVREL-819

@youssefea
youssefea merged commit 55fadd2 into master Oct 9, 2026
15 checks passed
@youssefea
youssefea deleted the docs/kb-gaps-devrel-819-builder-tools-base-app branch October 9, 2026 13:37

This branch was successfully deployed

1 active deployment
staging - docs — 25ea69f9 Deployed Oct 8, 2026 by mintlify[bot]
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.

3 participants