Skip to content

fix(payments): point T01 signing error at the WalletHub per-wallet grant#1670

Closed
fahadfa-aws wants to merge 1 commit into
awslabs:mainfrom
fahadfa-aws:fix/payments-t01-signing-error-wallethub
Closed

fix(payments): point T01 signing error at the WalletHub per-wallet grant#1670
fahadfa-aws wants to merge 1 commit into
awslabs:mainfrom
fahadfa-aws:fix/payments-t01-signing-error-wallethub

Conversation

@fahadfa-aws

Copy link
Copy Markdown

Issue

The Tutorial 01 README troubleshooting entry titled "Agent gets 402 but payment fails" pointed only at enabling Delegated Signing in the CDP Portal. That toggle is project-level and necessary but not sufficient — Coinbase CDP also requires a per-wallet grant via the WalletHub redirectUrl returned by CreatePaymentInstrument. The runtime error a user actually sees is Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions, which explicitly names the second step. The README did not.

The Tutorial 00 README at lines 144-150 already documents both layers in its "Funding and Delegated Signing" table. T01 troubleshooting is where users land when ProcessPayment fails, so the per-wallet grant needs to be there too.

Changes

  • T01 README:125 — replace the single-step entry with the verbatim error string + the two-step CDP grant flow (project toggle + per-wallet WalletHub).
  • Privy variant left unchanged (it was already correct — the Privy frontend at localhost:3000 handles per-wallet grant in one step).

Docs only. No code change.

Verification

  • Verbatim error reproduced on 2026-06-12 against us-west-2 and captured in T01a_strands_first_run.log:1.
  • T00 README:144-150 already documents the per-wallet WalletHub flow; this PR brings T01 troubleshooting in line.

The "Agent gets 402 but payment fails" troubleshooting entry only
mentioned enabling project-level Delegated Signing in the CDP Portal.
That toggle is necessary but not sufficient — Coinbase CDP also
requires a per-wallet grant from the WalletHub redirectUrl returned
by CreatePaymentInstrument. The runtime error
("Delegated signing grant is not active for the end user wallet.
Please redirect end user to the WalletHub to grant the permissions")
explicitly names this second step, but the README didn't.

Update the entry to lead with the verbatim error string, then walk
through both layers of the CDP signing grant. Privy variant is
unchanged because it was already correct.
@fahadfa-aws

Copy link
Copy Markdown
Author

@mvangara10 — flagging this for your review when you have a moment. Tagged across the full set of payments-tutorial fixes I've been pushing today; happy to walk through any of them. Audit logs and test evidence are referenced in the PR description.

@fahadfa-aws

Copy link
Copy Markdown
Author

Superseded by #1738 (consolidated PR)

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