docs(headless-sdk): refactor implementation for zero-config AppKit#80
Merged
Conversation
Wallet setup is now zero-config: the SDK owns the entire Reown AppKit wiring, so a host installs only @walletconnect/pay-* and never touches @reown/*, wagmi, or viem. Reflects buyer-experience PRs #956 + #972. - implementation: replace manual createAppKit + Wagmi/Query provider wiring with <PayAppKitProvider> (React) / createPayAppKit (JS); drop the hand-written signer for the built-in createAppKitSigner; show the AppKit setup and checkout assembly as React/JavaScript CodeGroups. - packages-reference: document createPayAppKit, createAppKitSigner, SUPPORTED_NETWORKS, and the /react PayAppKitProvider / usePayAppKit / getPayAppKitInstance exports. - how-it-works: point the Signer seam at createAppKitSigner. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
enesozturk
commented
Jul 8, 2026
- install: keep pay-react on the same line as the other packages - providers metadata url: simplify to https://example.com - point example-app links (implementation + overview) to WalletConnect/walletconnect-pay-examples/tree/main/gateway Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tomiir
reviewed
Jul 8, 2026
tomiir
approved these changes
Jul 8, 2026
createAppKitSigner is the single entrypoint for AppKit hosts; it wraps pay-state's signing internally. The raw strategies are only the low-level fallback for a custom, non-AppKit wallet — reword so they don't read as two co-equal options. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refactors the PSP Headless SDK docs (shipped in #76) for the new zero-config AppKit setup landing in buyer-experience #956 + #972.
What's new in the SDK
Wallet connection is now zero-config —
@walletconnect/pay-appkitowns the entire Reown AppKit wiring. A host installs only@walletconnect/pay-*and never touches@reown/*,wagmi, orviem:<PayAppKitProvider projectId metadata>from@walletconnect/pay-appkit/react.createPayAppKit({ projectId, metadata })factory call.createAppKitSigner(wallet)— no hand-wired signing strategies.Changes
implementation.mdx(full rewrite, −194 net lines)@walletconnect/pay-*; the reown/wagmi/viem/query stack is transitive and unconfigured.createAppKit+WagmiAdapter/SolanaAdapter+ module-scope singleton step, the hand-writtenlib/signer.tsstep, and the obsolete@reownversion-pinning note.<CodeGroup>s with React + JavaScript tabs.<Warning>that the proxy routes are a starting point (add auth/rate-limit/allowlist), and a two-card reference-apps group (headless-checkout+headless-checkout-vanilla).packages-reference.mdx— documentscreatePayAppKit,createAppKitSigner,SUPPORTED_NETWORKS/EVM_NETWORKS, and the/reactPayAppKitProvider/usePayAppKit/getPayAppKitInstanceexports; reframes the raw signing strategies as low-level primitives.how-it-works.mdx—Signerseam row + wiring note point atcreateAppKitSigner/<PayAppKitProvider>.Note
The documented JavaScript path uses
createPayAppKit(the SDK's@reown-free factory). Theheadless-checkout-vanillaexample still constructs AppKit with raw@reown/appkitand hasn't been migrated yet — worth aligning separately so the example matches the docs.🤖 Generated with Claude Code