Funding your agent just got a lot less painful (Stripe onramp + CDP v2 + wizard/doctor)

[VGIL77]

Funding your agent just got a lot less painful

Three things landed today that together turn agent wallet setup from a 30-minute headache into a couple of clicks.

1. Stripe Crypto Onramp is live

Tap Fund with Card in the Wallet view, complete a Stripe-hosted card flow, USDC lands in your agent's Smart Wallet on Base. We fixed four blockers that were stopping it:

• The v3 connect handshake (page was waiting for a connect.challenge event the gateway no longer sends; now sends the connect RPC on WS open with minProtocol: 3).
• The new window.StripeOnramp API. The old stripe.createCryptoOnrampSession() was removed by Stripe and was throwing in-browser; we switched to window.StripeOnramp(publishableKey).createSession({clientSecret, appearance}).mount(...).
• The Fund button was resolving the relative URL from wallet.fund against the Vite dev origin (:5173) rather than the gateway HTTP origin (:19001), so the SPA catch-all rendered and you landed on chat instead of the funding page. Now derives the gateway HTTP origin from VITE_GATEWAY_URL.
• React StrictMode double-mount was killing every WebSocket mid-handshake. Made connect() idempotent when the URL hasn't changed.

2. AgentKit 0.10.4 + CDP v2 SDK

Wallets are now real ERC-4337 Smart Accounts via CdpSmartWalletProvider. The legacy CdpWalletProvider is deprecated upstream in 0.11; the old PEM-ECDSA keys aren't even issued anymore. Coinbase's portal only gives Ed25519 base64 secrets now.

Init is fully idempotent: getOrCreateAccount for the owner, then getOrCreateSmartAccount, plus a listSmartAccounts fallback that reclaims orphan smart accounts from any failed attempts. Persistence switched from encrypted blob to plain metadata.

3. Wizard + doctor know about it

The onboarding wizard has a wallet step that walks you through CDP API keys (opens portal.cdp.coinbase.com/projects/api-keys for you) and persists the three required env vars:

• CDP_API_KEY_ID
• CDP_API_KEY_SECRET
• CDP_WALLET_SECRET

bitterbot doctor now validates all three and surfaces missing config with a clear fix-it pointer instead of a stack trace at runtime.

Plus:

• bitterbot wallet fund opens the onramp (or prints the URL on headless boxes).
• The Wallet view in the Control UI shows balance and network at a glance.
• Sepolia testnets get a faucet link automatically alongside the Stripe button.

Try it

pnpm start gateway
# open the Control UI
# Wallet tab → Fund with Card

If anything breaks for you, run bitterbot doctor first and paste the wallet section of the output. Most issues are now down to "one of three env vars missing" and doctor will point at it directly.