Skip to content

[Feature] AI Credits × AntSeed: intro, terminology, and embed UX #155

Description

@blueogin

Feature summary

Improve the AntSeed-facing AI Credits experience: an intro for users/developers, AntSeed-aligned language (buyer/signer, operator, VPR), remaining UI polish on the consent/source=antseed path, a GoodWallet handoff link in the widget-only webapp view, and a wallet Disconnect control for the standalone AI Credits webapp only.

Problem or opportunity

Embedded AntSeed users often land on Buy/Manage with little orientation. Copy still mixes GoodDollar and AntSeed role names. The source=antseed widget-only view needs a clear path for users who already have GoodWallet, plus any remaining UI polish from the AntSeed review thread.
Separately, the standalone app (apps/ai-credits-web) can connect a wallet via Reown/AppKit but has no in-widget way to disconnect and return to the connect state. Embedded hosts (e.g. GoodWallet) own session lifecycle and must not get a widget-forced disconnect control.

Proposed solution

  1. Intro — Add an Intro tab or first-run card with short instructions for regular users and developers (source copy from Rael’s thread). Link out to AntSeed docs / Manage → API Setup for depth.
  2. Language — Align FAQ, consent, buyer-key, stepper, and manage copy with AntSeed VPR/docs:
    • Buyer / signing identity (signer) — signs; does not hold funds
    • Funding wallet / payer — deposits (G$ on Celo in our flow)
    • Operator — authorized party for gas-bearing Base actions (GoodDollar vault)
    • VPR / buyer proxy — local router at localhost:8377
  3. GoodWallet link — When ?source=antseed, show “Already have a GoodWallet?” linking to the AI Credits widget on goodwallet.xyz (exact deep link TBD). Related packaging work: GoodWidget Prepare AI Credits Widget for GoodWallet Integration #132.
  4. Disconnect (standalone only) — Add a Disconnect control on the connected AI Credits UI that is shown only when the host opts in (e.g. disconnectOverride), matching the Superfluid campaign widget pattern (disconnectOverride → header/WalletChip). Wire it in apps/ai-credits-web via AppKit disconnect. Do not show Disconnect by default in Storybook embeds, GoodWallet, or other hosts that omit the override.

Required states, flows, and behaviors

Acceptance criteria

  • Intro tab/card ships with user + developer sections (Rael-approved copy).
  • Role language matches AntSeed buyer/signer, operator, VPR across audited surfaces.
  • Listed UI polish items implemented without regressing [Feature] AI Credits widget: explicit operator consent, updated consent copy, antseed widget-only view #150 behavior.
  • source=antseed shows “Already have a GoodWallet?” with confirmed GoodWallet URL.
  • Standalone apps/ai-credits-web shows Disconnect when connected; disconnect clears the session back to Connect Wallet.
  • Disconnect is hidden when disconnectOverride is not provided (embed / GoodWallet / default Storybook).
  • Storybook / Playwright coverage for intro, source=antseed link, and standalone disconnect visibility.

Additional context

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status
    Prepare AI Task

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions