docs(build-on-base): add Gasless USDC Transfers (EIP-3009) reference - #153
Open
osr21 wants to merge 1 commit into
Open
docs(build-on-base): add Gasless USDC Transfers (EIP-3009) reference#153osr21 wants to merge 1 commit into
osr21 wants to merge 1 commit into
Conversation
Collaborator
🟡 Heimdall Review Status
|
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
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.
What
Adds
references/gasless-usdc-transfers.mdto the build-on-base skill, plus a Task Routing row inSKILL.md.The reference covers the EIP-3009
transferWithAuthorizationpattern for gasless USDC transfers: the authorization envelope, exact EIP-712 domain values (including thenamemismatch trap — USDC is"USD Coin"but EURC is"EURC"), token addresses for Base and Base Sepolia, a relayer-side validation checklist (validBefore cap, BigInt parsing, rate limiting, surfacing revert reasons), and the smart-wallet caveat.Why
The skill's existing references cover Base Account / Base Pay flows, but agents asked to implement "pay with USDC without ETH" for EOA wallets have no routing target — and this pattern has two failure modes that repeatedly burn builders and are invisible until runtime:
name→ generic "invalid signature" revert with no hint the domain is the problem.getCode) and routing to batched calls + paymaster instead — and notes the same audit applies to EIP-2612permit.Both are documented from production experience running this exact pattern (BasePay's gasless relay on Base mainnet), not from spec reading.
Scope
Docs only — one new reference file, one table row in SKILL.md. No changes to existing references or plugins. Follows the frontmatter and cross-linking conventions of the existing reference files.
Companion runnable demo submitted to base/demos as
apps/gasless-usdc-payments/.